ForHosting KIT · قراءة المواقع ومراقبتها

أنشئ رابط UTM بمعلمات حملة مرمّزة

أنشئ عنوان URL للحملة جاهزًا للمشاركة من دون جمع علامات الاستفهام أو العطف أو القيم المرمّزة يدويًا.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخل عنوان URL أساسيًا مطلقًا، وأي مجموعة من المصدر والوسيط والحملة والمصطلح والمحتوى. يحافظ المنشئ على معلمات الاستعلام العادية، ويستبدل معلمات UTM المطابقة، ويُبقي الجزء المرجعي في موضعه النهائي الصحيح، ثم يعيد رابطًا صالحًا واحدًا. يناسب ذلك مختصي التسويق والمطورين الذين يحتاجون إلى نتيجة متوقعة في مسارات النشر والبريد والإعلان وإعداد التقارير.

ابدأ بوجهة مطلقة وحقول حملة منظّمة

ابدأ بالوجهة الكاملة التي تتضمن المخطط والمضيف، مثل https://example.com/offers. يُرفض المسار النسبي مثل /offers لأنه لا يملك أصلًا مستقلًا، وقد يُحلّ بصورة مختلفة بحسب المكان الذي يُفتح منه. أضف الحقول التي تصف الزيارة: يحدد المصدر الناشر أو المنصة، ويصف الوسيط القناة، وتجمع الحملة النشاط المرتبط ضمن مبادرة واحدة. يمكن أن يسجل المصطلح كلمة بحث مدفوعة، بينما يميز المحتوى بين التصاميم والمواضع والأزرار وصيغ الرسائل. يمكنك إدخال الحقول التي تستخدمها خطة القياس لديك فقط. تكتب النتيجة هذه القيم بالأسماء القياسية utm_source وutm_medium وutm_campaign وutm_term وutm_content. يجعل فصل القيم في مدخلات مستقلة الأتمتة أكثر أمانًا من قبول سلسلة استعلام مجمعة جزئيًا. كما يسهل مراجعة قواعد التسمية لأن لكل خاصية موضعًا واضحًا قبل إنشاء الرابط النهائي. وإذا كانت الوجهة تتضمن معلمة عادية مثل معرّف منتج أو رمز إحالة أو اختيار لغة، فإن تلك المعلمة تبقى في النتيجة ولا تُحذف.

دع الترميز يحمي المسافات والمحارف المحجوزة

تتضمن تسميات الحملات كثيرًا من المسافات وعلامات الترقيم والشرطات المائلة وعلامات العطف والمحارف الخارجة عن ASCII الأساسي. وقد يؤدي نسخ هذه المحارف حرفيًا إلى سلسلة الاستعلام إلى تغيير طريقة تفسير المتصفح للرابط. يستخدم هذا المنشئ قواعد URL القياسية وتسلسل الاستعلام لترميز كل قيمة مقدمة. فمثلًا تظل حملة باسم July launch وقيمة محتوى باسم hero CTA واضحتين، مع تحولهما إلى مكونين آمنين في عنوان URL الناتج. تُرمّز علامة العطف داخل التسمية بوصفها بيانات، فلا تُفهم خطأً على أنها فاصل قبل معلمة أخرى. وتُحلل معلمات الاستعلام الحالية وتُسلسل بالآلية القياسية نفسها. إذا احتوى عنوان URL الأساسي على أحد مفاتيح UTM الخمسة وقدمت له قيمة بديلة، تكون الأولوية للقيمة الجديدة ولا ينشئ النظام مفاتيح مكررة ملتبسة. يبقى الجزء المرجعي مثل #details بعد سلسلة الاستعلام الكاملة في موضعه الصحيح. يزيل هذا السلوك الحاجة إلى الجمع اليدوي الهش، ويعطي النتيجة نفسها دائمًا للمدخلات نفسها، من دون طلب شبكة أو إعادة توجيه.

استخدم روابط متسقة في مسارات النشر والتحليل

لا يمثل الرابط الموسوم الصحيح إلا جزءًا من عملية إسناد موثوقة. ضع قاعدة للتسمية قبل إنشاء دفعات كبيرة؛ تستخدم فرق كثيرة قيمًا صغيرة الأحرف للمصدر والوسيط، ومعرّفات ثابتة للحملات، وتسميات محتوى مرتبطة بتصميم أو موضع. يحافظ المنشئ عمدًا على النص الذي تقدمه بدل تغيير حالة الأحرف أو ابتكار أسماء، فتظل حوكمة البيانات تحت إدارتك. اربطه بمحرر بريد أو قائمة نشر اجتماعي أو جدول حملات أو نظام إدارة محتوى أو قائمة تحقق داخلية كلما أُنتجت الروابط. احفظ المدخلات المنظّمة بجوار عنوان URL الناتج، كي يستطيع المحللون تتبع تسمية في لوحة المعلومات إلى سجل الحملة الذي أنشأها. اختبر الوجهة ضمن عملية النشر، ولا سيما عندما يحتوي الرابط الأصلي على معلمات خاصة بالتطبيق. لا تختصر هذه القدرة الرابط، ولا تتصل بالوجهة، ولا تتحقق من وجود الصفحة، ولا تضبط حساب التحليلات؛ بل تبني عنوان URL محليًا فقط. يجعل هذا النطاق المحدد دمجها سهلًا مع الموافقة أو فحص الروابط أو الاختصار أو رموز QR. الاستخدام التفاعلي في المتصفح مجاني، وتبلغ كلفة طلب API الآلي $0.002.

حالات الاستخدام

وسم وجهات النشرات البريدية

أنشئ روابط مرمّزة للأزرار والنصوص، مع الحفاظ على معلمات المنتج واللغة والإحالة الموجودة مسبقًا في كل وجهة.

إعداد روابط الحملات الاجتماعية

عيّن لكل منصة وتصميم قيمًا متسقة للمصدر والوسيط والحملة والمحتوى قبل إدخال المنشورات إلى قائمة النشر.

أتمتة صادرات الحملات المدفوعة

ابنِ روابط الوجهة النهائية من سجلات منظّمة، بما فيها المصطلحات ومعرّفات التصاميم الاختيارية، من دون جمع مخصص للاستعلام.

الأسئلة الشائعة

ما كلفة الطلب الآلي؟

تبلغ كلفة كل طلب API مقدار $0.002. ويمكنك أيضًا إنشاء رابط مجانًا مباشرة في المتصفح على هذه الصفحة.

ما مدخلات URL المقبولة؟

يجب أن يكون عنوان URL الأساسي مطلقًا، أي يتضمن مخططًا ويمكن تحليله مستقلًا. تُرفض المسارات النسبية.

ماذا يحدث لمعلمات الاستعلام الحالية؟

تبقى محفوظة. وإذا أدخلت مفتاح UTM موجودًا، تستبدل القيمة الجديدة قيمة ذلك المفتاح.

هل تُرمّز المسافات والمحارف الخاصة؟

نعم. تُسلسل القيم وفق قواعد استعلام URL القياسية كي لا تغيّر المحارف المحجوزة بنية الاستعلام.

هل يجب إدخال حقول UTM الخمسة كلها؟

لا. المصدر والوسيط والحملة والمصطلح والمحتوى اختيارية كل على حدة؛ لا تُضاف أو تُستبدل إلا الحقول المقدمة.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/web/utm-link-build

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/web/utm-link-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/launch?ref=homepage#details"}'

const res = await fetch("https://api.kit.forhosting.com/web/utm-link-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "url": "https://example.com/launch?ref=homepage#details"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/utm-link-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "url": "https://example.com/launch?ref=homepage#details"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/utm-link-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"url":"https://example.com/launch?ref=homepage#details"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"url":"https://example.com/launch?ref=homepage#details"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/utm-link-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "url": "https://example.com/launch?ref=homepage#details"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.utm_link_build",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`timeout_sec`	30
`max_crawl_pages`	25

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←