حقول عناوين URL التي تمت ترقيتها

تفصل عناوين URL التي تمّت ترقيتها عناوين URL للصفحات المقصودة عن مَعلمات التتبّع، ما يتيح لك إدارة منطق التتبّع بدون بدء عمليات إعادة مراجعة الإعلانات عند تغيير مَعلمات التتبّع.

تتيح لك عناوين URL التي تمّت ترقيتها تحديد أجزاء التتبّع والصفحة المقصودة من عنوان URL من خلال حقول منفصلة:

• عناوين URL النهائية (final_urls): تمثّل قائمة بالصفحات المقصودة الفعلية لإعلانك أو كلمتك الرئيسية أو رابط أقسام موقعك. يجب أن يكون عنوان URL النهائي هو ما يراه المستخدم في شريط المتصفّح بعد النقر على الإعلان.
• عناوين URL النهائية للأجهزة الجوّالة (final_mobile_urls): تمثّل قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة لإعلانك أو كلمتك الرئيسية أو رابط أقسام موقعك بعد جميع عمليات إعادة التوجيه عبر النطاقات.
• عناوين URL النهائية للتطبيق (final_app_urls): تمثّل قائمة بعناوين URL النهائية للتطبيق التي سيتم استخدامها على الأجهزة الجوّالة إذا كان المستخدم قد ثبَّت التطبيق المحدّد.
• نموذج التتبّع (tracking_url_template): نموذج اختياري لتحديد مَعلمات تتبّع أو عمليات إعادة توجيه إضافية. سنستخدم هذا النموذج لتجميع عنوان URL المقصود الفعلي لربطه بالإعلان.
• لاحقة عنوان URL النهائي (final_url_suffix): مَعلمات اختيارية يتم إلحاقها مباشرةً بنهاية عنوان URL لصفحتك المقصودة من أجل تتبُّع نشاط الصفحة المقصودة (على سبيل المثال، باستخدام التتبُّع الموازي).
• المَعلمات المخصّصة (url_custom_parameters): مَعلمات ValueTrack اختيارية يمكنك تعيين معرّفاتك الخاصة لها.

للحصول على مواصفات تفصيلية، يُرجى الاطّلاع على صفحة مرجع Ad.

أوصاف الحقول

توضّح الأقسام التالية حقول عنوان URL تمت ترقيته.

روابط عناوين URL النهائية (final_urls)

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

تتّبع عناوين URL النهائية قواعد التجاوز نفسها التي تتّبعها عناوين URL المقصودة. على سبيل المثال، يتجاوز عنوان URL النهائي على مستوى الكلمة الرئيسية عنوان URL النهائي على مستوى الإعلان.

تنطبق أيضًا جميع قواعد التحقّق الحالية لعناوين URL المقصودة على عناوين URL النهائية. يمكنك استخدام علامات عناوين URL في عناوين URL النهائية. يجب أن تكون جميع العلامات إما علامات ValueTrack صالحة أو مَعلمات مخصّصة. يمكنك استخدام ما يصل إلى أربعة مستويات من التداخل عند تحديد علامات عناوين URL:

{ifmobile:{ifsearch:{keyword:cp={_customP}}}}

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

عناوين URL النهائية للأجهزة الجوّالة (final_mobile_urls)

إذا أردت توجيه المستخدمين إلى صفحة مقصودة مختلفة على الأجهزة الجوّالة، يمكنك تقديم عنوان URL نهائي منفصل مفضَّل للأجهزة الجوّالة. ومع ذلك، إذا كنت تفضّل استخدام مَعلمات ValueTrack، يمكنك استخدام مَعلمات ValueTrack الحالية {device} و{ifmobile} بدلاً من هذا الحقل.

عناوين URL النهائية للتطبيق (final_app_urls)

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

نموذج التتبُّع (tracking_url_template)

يتيح لك حقل نموذج التتبّع تحديد أي مَعلمات تتبّع أو عمليات إعادة توجيه إضافية. عند تحديد هذه المَعلمة، سيتم استخدامها بدلاً من عناوين URL النهائية لتجميع عنوان URL المقصود الفعلي لإعلانك. وتتتبّع خدمة التتبّع النقرة وتُعيد توجيه المستخدم إلى صفحة مقصودة. يجب أن يتطابق عنوان URL للصفحة المقصودة مع عنوان URL النهائي. يمكن أن يتضمّن هذا النموذج عنوان URL النهائي باستخدام مَعلمات ValueTrack، مثل {lpurl}.

لاحقة عنوان URL النهائي (final_url_suffix)

يتيح لك حقل لاحقة عنوان URL النهائي تحديد مَعلمات التتبّع التي سيتم إلحاقها بنهاية عنوان URL للصفحة المقصودة. من خلال التتبّع الموازي، يتم توجيه المستخدمين مباشرةً إلى عنوان URL النهائي بينما يتم قياس عدد النقرات في الخلفية، لذا يجب وضع أي مَعلمات تحتاجها الصفحة المقصودة في final_url_suffix (أو مباشرةً في final_urls) بدلاً من نموذج التتبّع.

كما هو الحال مع نماذج التتبّع، تلغي final_url_suffix المحدّدة على مستوى كيان أدنى (مثل كلمة رئيسية أو إعلان) تلك المحدّدة على مستوى كيان أعلى (مثل مجموعة إعلانية أو حملة أو عميل).

المَعلمات المخصّصة (url_custom_parameters)

تتيح لك المَعلمات المخصّصة إنشاء مَعلماتك الخاصة، على غرار مَعلمات ValueTrack. يمكن أن يكون ذلك مفيدًا عندما تريد استخدام معرّفاتك الخاصة، على سبيل المثال، في تحديد الإعلانات. بدلاً من ترميز رقم تعريف بشكل ثابت في عنوان URL المقصود للإعلان، يمكنك تحديد رقم التعريف للإعلان، واستخدام مَعلمة مخصّصة لكل إعلان، ثم الإشارة إلى المَعلمة المخصّصة في عنوان URL النهائي أو نموذج التتبّع أو كليهما، كما تفعل مع أي مَعلمة ValueTrack أخرى.

يمكن أن يحتوي اسم المَعلمة المخصّصة على أحرف أبجدية رقمية فقط. عند الإشارة إلى المَعلمة المخصّصة في عناوين URL النهائية ونماذج التتبّع، يجب وضع المَعلمة المخصّصة بين قوسين، وإضافة شرطة سفلية إلى اسمها، على سبيل المثال، {_promoCode}.

ملاحظة: عند ضبط قيم المَعلمات المخصّصة لكيان متوافق، يجب أن يكون للعناصر في قائمة url_custom_parameters (مثل عناصر عنصر Ad) قيمة key فريدة. لا يراعي التحقّق من التفرّد حالة الأحرف، لذا لا يمكن أن تحتوي قائمتك على عنصر يتضمّن key="promoCode" وعنصر آخر يتضمّن key="promocode". إذا كانت لديك سلع متعددة تحمل سمة key نفسها في قائمة url_custom_parameters، سيتعذّر تنفيذ طلبك وستظهر رسالة الخطأ DistinctError.DUPLICATE_ELEMENT.

كما هو الحال مع عناوين URL النهائية، تلغي المَعلمات المخصّصة في كيان ذي مستوى أدنى القيم للكيانات ذات المستوى الأعلى. يمكنك استخدام ما يصل إلى ثماني مَعلمات مخصّصة لكيان معيّن. يجب ألا يتجاوز المفتاح والقيمة 16 و200 بايت على التوالي.

مثال

يعرض مقتطف JSON التالي مثالاً على ضبط عنصر Ad باستخدام حقول عناوين URL التي تمّت ترقيتها:

{
  "finalUrls": ["https://www.example.com/shoes"],
  "finalUrlSuffix": "src=google&promo={_promoCode}",
  "trackingUrlTemplate": "https://www.tracker.com/?u={lpurl}&alloc={_promoCode}",
  "urlCustomParameters": [
    {
      "key": "promoCode",
      "value": "summer15"
    }
  ]
}