ForHosting KIT · تحسين محركات البحث (SEO)

تحقق من قواعد تسمية حملات UTM

تحقق من اسم مثل summer-sale-q3 وفق قاعدة التسمية التي اختارها فريقك، واعرف أي القواعد نجحت وأيها خالفت، حتى لا يقسم حرف كبير أو مسافة واحدة تقارير التحليلات لديك. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

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

مثال محلول

إذا أدخلت

اسم الحملة: summer-sale-q3
النمط: lowercase-hyphenated-by-quarter

تحصل على

المتوقع: lowercase hyphenated text ending in q1, q2, q3, or q4

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

اختاروا قاعدة تناسب نظام التقارير لديكم

لا تفيد قاعدة التسمية إلا عندما يستطيع جميع المشاركين تطبيقها بلا تخمين. اختاروا النمط المدعوم الذي يطابق القاعدة الموثقة لدى فريقكم. يقبل lowercase-hyphenated أسماء مثل spring-launch وpartner-webinar-2026، ويرفض المسافات والشرطات السفلية والأحرف الكبيرة والفواصل المكررة وعلامات الترقيم.

استخدموا lowercase-hyphenated-by-quarter عندما يجب أن ينتهي كل اسم بـ q1 أو q2 أو q3 أو q4، مثل summer-sale-q3. يلائم خيار الأحرف الكبيرة تصنيفات مثل EMEA-PRODUCT-Q4، بينما يمنع alphanumeric جميع الفواصل. تحديد النمط إلزامي لأن الحكم على الاسم بمعزل عن القاعدة غير ممكن؛ فقد يكون كل من summer-sale وSUMMER-SALE صحيحاً وفق نظام مختلف.

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

اقرؤوا نتيجة التحقق وصححوا المخالفات

تتضمن الاستجابة اسم الحملة المرسل، واسم النمط بعد توحيده، ومؤشر الصلاحية العام، وقائمة الفحوص، والمخالفات، ووصفاً موجزاً للتنسيق المتوقع. تعني النتيجة الصالحة أن الاسم كاملاً يطابق جميع متطلبات القاعدة المختارة. وتقدم النتيجة false معلومات أوضح من الرفض العام.

فعند فحص Summer-Sale-Q3 وفق lowercase-hyphenated-by-quarter، يفشل شرط الأحرف الصغيرة وشرط لاحقة الربع لأن القاعدة تتطلب q صغيرة. ويفشل الاسم المحتوي على مسافات في فحص الفاصل، بينما تقع q5 خارج النطاق المسموح. استخدموا violations للرسائل الموجزة أو القرارات الآلية، وchecks عندما تحتاجون إلى عرض القواعد الناجحة والفاشلة معاً.

تزيل الأداة المسافات المحيطة، لكنها لا تعيد كتابة الاسم ولا تخمّن بديلاً. وهذا يحمي معرّفات التحليلات من تغييرات غير مراجعة. صححوا القيمة الأصلية، ثم أعيدوا الفحص، ولا تنشروا إلا عندما تكون valid بقيمة true.

إذا كان النمط مفقوداً أو فارغاً أو غير مدعوم، تعيد الطلبية خطأ إدخال بدلاً من افتراض قاعدة ضمنية.

تحققوا قبل أن تبدأ الروابط بالانتشار

أفضل وقت للتحقق من اسم حملة UTM هو مباشرة قبل إنشاء رابط التتبع أو اعتماده. في النموذج، شغّلوا الفحص عند مغادرة حقل الاسم واعرضوا القواعد المخالفة بجواره. وفي مسار النشر، اعتبروا valid false إخفاقاً في المراجعة قبل نسخ الروابط إلى الإعلانات أو النشرات أو الشبكات الاجتماعية أو رموز QR أو مواد الشركاء.

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

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

راجعوا إطلاقاً ربع سنوي

اشترطوا لاحقة صغيرة من q1 إلى q4 كي تتجمع التقارير بدقة حسب الربع المخطط.

راقبوا مسار الروابط الآلي

تحققوا من المعرّفات المنشأة قبل توزيع الروابط عبر الإعلانات أو البريد أو الشبكات أو الشركاء.

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

ما الأنماط المدعومة؟

الأنماط المدعومة هي lowercase-hyphenated-by-quarter وlowercase-hyphenated وlowercase-underscore-separated وuppercase-hyphenated وalphanumeric.

هل تصحح الأداة الاسم غير الصالح؟

لا. تعرض القواعد المخالفة من دون تغيير معرّف تحليلي بصمت، فقد يتطلب ذلك موافقة بشرية.

هل تميز لواحق الأرباع حالة الأحرف؟

نعم. تتطلب قاعدة الأرباع حرف q صغيراً في النهاية يتبعه 1 أو 2 أو 3 أو 4.

لماذا يجب اختيار قاعدة تسمية قبل فحص الاسم؟

لأن الاسم لا يمكن الحكم عليه وحده: قد يكون summer-sale وSUMMER-SALE صحيحين كلاهما وفق قواعد مختلفة. واشتراط القاعدة يمنع أي إعداد افتراضي صامت من قبول اسم وفق قاعدة لم يقصدها فريقك.

لماذا أفحص اسم الحملة قبل مشاركة الرابط؟

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

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/seo/utm-campaign-name-validate

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

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

curl -X POST https://api.kit.forhosting.com/seo/utm-campaign-name-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}'

const res = await fetch("https://api.kit.forhosting.com/seo/utm-campaign-name-validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "campaign_name": "summer-sale-q3",
    "pattern": "lowercase-hyphenated-by-quarter"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/utm-campaign-name-validate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "campaign_name": "summer-sale-q3",
    "pattern": "lowercase-hyphenated-by-quarter"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/utm-campaign-name-validate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"campaign_name":"summer-sale-q3","pattern":"lowercase-hyphenated-by-quarter"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/utm-campaign-name-validate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "campaign_name": "summer-sale-q3",
  "pattern": "lowercase-hyphenated-by-quarter"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الأخطاء

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

ملاحظات تقنية

اختاروا قاعدة تناسب نظام التقارير لديكم

أما المعرّفات بأسلوب snake فيناسبها lowercase-underscore-separated الذي يقبل lifecycle_email_q2.

تحققوا قبل أن تبدأ الروابط بالانتشار

وفي جدول البيانات أو المعالجة المجمعة، استدعوا API مرة لكل اسم مقترح وأعيدوا الصفوف غير الصالحة إلى المسؤولين عنها. التحقق المبكر مهم لأن تغيير utm_campaign بعد التوزيع يجزئ القياسات إلى قيم منفصلة؛ وحتى اختلاف حالة الأحرف قد ينشئ صفاً جديداً. يتوفر المتصفح للفحص اليدوي، وتبلغ تكلفة كل طلب API مقدار $0.002.

حالات التكامل

احموا نموذج إنشاء الحملات

ارفضوا قيم utm_campaign غير المتسقة قبل نشر رابط التتبع أو تصديره.

أسئلة تقنية

ماذا يحدث إذا أغفلتم النمط؟

يعيد الطلب خطأ invalid_input لأن التحقق يتطلب قاعدة تسمية محددة صراحة.

ما تكلفة عملية التحقق عبر API؟

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

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

شغّل الأداة مجانًا

مثال محلول

اختاروا قاعدة تناسب نظام التقارير لديكم

اقرؤوا نتيجة التحقق وصححوا المخالفات

تحققوا قبل أن تبدأ الروابط بالانتشار

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

راجعوا إطلاقاً ربع سنوي

راقبوا مسار الروابط الآلي

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

ملاحظات تقنية

اختاروا قاعدة تناسب نظام التقارير لديكم

تحققوا قبل أن تبدأ الروابط بالانتشار

حالات التكامل

احموا نموذج إنشاء الحملات

أسئلة تقنية

شكرًا