تفعيل السلوك الخاص بمنطقة محدّدة للعلامات

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

إذا كنت تعرض نصًا برمجيًا من نطاق طرف أول، عليك تقديم معلومات الموقع الجغرافي للمستخدم في عنوان الطلب لتتمكّن من استخدام المَعلمتَين event_location.country و event_location.region. إذا كان عنوان IP متوفّرًا في عنوان الطلب، تكون له الأولوية في تحديد الموقع الجغرافي. وإلا، يتم استخدام المَعلمتَين event_location.country وevent_location.region لإرسال معلومات البلد والمنطقة على التوالي.

قبل البدء

يفترض هذا الدليل أنّك نفّذت ما يلي:

الخطوة 1: إعداد عنوان الطلب

عليك إرسال عناوين طلبات محدّدة تحتوي على معلومات منطقة المستخدم، كما هو موضّح في الأقسام أدناه.

يمكنك البدء مباشرةً من الخطوة 2 في الحالات التالية:

  • إذا كنت تستخدم App Engine، يرسل App Engine عناوين الموقع الجغرافي تلقائيًا.
  • إذا كنت تستخدم مقدّم بنية أساسية مختلفًا عن المقدّمين المذكورين أدناه، عليك إعداد عناوين مخصّصة.

Cloud Run مع موازنة الحمل في Google Cloud Platform

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

طلبات النصوص البرمجية

لتضمين عناوين الموقع الجغرافي لطلبات النصوص البرمجية فقط، عليك إعداد واجهة خلفية جديدة وإنشاء قواعد توجيه.

لإنشاء واجهة خلفية جديدة:

  1. افتح موازنة الحمل في Google Cloud Platform
  2. في موازنة الحمل، افتح قسم إعدادات الواجهة الخلفية. أنشِئ خدمة الخلفية جديدة.
    لقطة شاشة لإعدادات الخلفية
  3. اضبط خدمة الواجهة الخلفية الجديدة:
    • نوع الواجهة الخلفية: اختَر نوع مجموعة نقاط نهاية الشبكة التي يستخدمها تطبيقك. إذا كنت تستخدم Cloud Run، اختَر مجموعة نقاط نهاية الشبكة بدون خادم.
    • في واجهة خلفية جديدة، اختَر مجموعة نقاط نهاية الشبكة الخاصة بنشر "إدارة العلامات" من جهة الخادم.
      لقطة شاشة للخدمة الخلفية الجديدة
  4. افتح قسم الإعدادات المتقدّمة. أضِف عناوين طلبات مخصّصة.
    اسم العنوان قيمة العنوان
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. احفظ خدمة الواجهة الخلفية الجديدة.

لضبط قواعد التوجيه:

  1. في موازنة الحمل، افتح قسم قواعد التوجيه. اختَر الوضع المسار والقاعدة المتقدّمان للمضيف.
  2. عدِّل المَعلمة pathRules لربط gtm.js و/gtag/js و/gtag/destination بخدمة الواجهة الخلفية الجديدة.
    pathRules:
- paths:
  - /gtm.js
  - /gtag*
  service: projects/project_id/global/backendServices/new backend service
- paths:
  - /*
  service: projects/project_id/global/backendServices/original backend service
  3. احفظ التغييرات.

جميع الطلبات

لإرسال معلومات الموقع الجغرافي مع جميع طلبات HTTP، عليك إضافة عناوين طلبات مخصّصة إلى خدمة الواجهة الخلفية الحالية، راجِع مستندات Google Cloud. أنشِئ عنوان طلب مخصّصًا جديدًا واحدًا لكل عنوان أدناه:

اسم العنوان قيمة العنوان
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

موازنة الحمل في Google Cloud Platform

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

طلبات النصوص البرمجية

لتضمين عناوين الموقع الجغرافي لطلبات النصوص البرمجية فقط، عليك إعداد واجهة خلفية جديدة وإنشاء قواعد توجيه.

لإنشاء واجهة خلفية جديدة:

  1. افتح موازنة الحمل في Google Cloud Platform
  2. في موازنة الحمل، افتح قسم إعدادات الواجهة الخلفية. أنشِئ خدمة الخلفية جديدة.
    لقطة شاشة لإعدادات الخلفية
  3. اضبط خدمة الواجهة الخلفية الجديدة:
    • نوع الواجهة الخلفية: اختَر نوع مجموعة نقاط نهاية الشبكة التي يستخدمها تطبيقك. إذا كنت تستخدم Cloud Run، اختَر مجموعة نقاط نهاية الشبكة بدون خادم.
    • في واجهة خلفية جديدة، اختَر مجموعة نقاط نهاية الشبكة الخاصة بنشر "إدارة العلامات" من جهة الخادم.
      لقطة شاشة للخدمة الخلفية الجديدة
  4. افتح قسم الإعدادات المتقدّمة. أضِف عناوين طلبات مخصّصة.
    اسم العنوان قيمة العنوان
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. احفظ خدمة الواجهة الخلفية الجديدة.

لضبط قواعد التوجيه:

  1. في موازنة الحمل، افتح قسم قواعد التوجيه. اختَر الوضع المسار والقاعدة المتقدّمان للمضيف.
  2. عدِّل المَعلمة pathRules لربط gtm.js و/gtag/js و/gtag/destination بخدمة الواجهة الخلفية الجديدة.
    pathRules:
- paths:
  - /gtm.js
  - /gtag*
  service: projects/project_id/global/backendServices/new backend service
- paths:
  - /*
  service: projects/project_id/global/backendServices/original backend service
  3. احفظ التغييرات.

جميع الطلبات

لإرسال معلومات الموقع الجغرافي مع جميع طلبات HTTP، عليك إضافة عناوين طلبات مخصّصة إلى خدمة الواجهة الخلفية الحالية، راجِع مستندات Google Cloud. أنشِئ عنوان طلب مخصّصًا جديدًا واحدًا لكل عنوان أدناه:

اسم العنوان قيمة العنوان
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

Amazon Web Services (AWS) CloudFront

أنشِئ سياسة طلب مصدر لإضافة العنوانَين CloudFront-Viewer-Country و CloudFront-Viewer-Country-Region إلى الطلب.

سيؤدي ذلك إلى إضافة العناوين التالية تلقائيًا مع قيمها:

اسم العنوان قيمة العنوان
CloudFront-Viewer-Country بلد المستخدم
CloudFront-Viewer-Country-Region التقسيم الفرعي للمستخدم
إعدادات العناوين في AWS CloudFront

Azure Front Door

باستخدام محرك القواعد، أنشِئ مجموعة قواعد تتضمّن إجراء تعديل عنوان الطلب مع الربط التالي:

اسم العنوان قيمة العنوان
X-Azure-Country {geo_country}
لقطة شاشة لإعدادات Azure Front Door

Cloudflare

فعِّل الخيار "إضافة عناوين موقع الزائر" في قسم التحويلات المُدارة:

سيؤدي ذلك إلى إضافة العنوان التالي تلقائيًا مع قيمته:

اسم العنوان قيمة العنوان
CF-IPCountry بلد المستخدم
لقطة شاشة لإعدادات Cloudflare

الخطوة 2: إعداد المتغيّر "منطقة الزائر"

إذا كنت قد أعددت عناوين الموقع الجغرافي كما هو موضّح أعلاه، سترصد "إدارة العلامات من Google" المنطقة أو البلد تلقائيًا من خلال قراءة عنوان طلب HTTP. بدلاً من ذلك، يمكنك إعداد عناوين مخصّصة.

الرصد التلقائي

  1. افتح أداة Google Tag Manager
  2. افتح حاوية الخادم.
  3. في قائمة المتغيّرات ، اضبط قائمة المتغيّرات المضمّنة.
  4. اختَر منطقة الزائر.

ستتوفّر الآن عناوين الموقع الجغرافي لاستخدامها في المتغيّر منطقة الزائر.

عناوين مخصّصة

  1. افتح أداة Google Tag Manager
  2. افتح حاوية الخادم.
  3. في قائمة المتغيّرات ، أنشِئ متغيّرًا جديدًا يحدّده المستخدم من النوع منطقة الزائر.
  4. في ضبط المتغيّر ، اختَر متغيّر مخصّص.

  5. في قائمة المتغيّرات ، أنشِئ متغيّرَين جديدَين من النوع عنوان الطلب: أحدهما لبلدك والآخر لرمز التقسيم الفرعي. املأ القيم برمزَي البلد في عنوانَي طلب HTTP.

  6. استخدِم المتغيّرات التي أنشأتها في المتغيّر منطقة الزائر كما هو موضّح في لقطة الشاشة.

    لقطة شاشة لإعدادات المتغيّر

  7. أضِف اسمًا للمتغيّر واحفظه.

الخطوة 3: تفعيل الإعدادات الخاصة بالمنطقة في عميلك

لاستخدام منطقة الزائر لمعالجة طلبات HTTP الواردة، عليك إضافتها إلى عميلك.

  1. اختَر العميل Google Tag Manager: حاوية الويب.

  2. ضَع علامة في المربّع بجانب تفعيل الإعدادات الخاصة بالمنطقة. أضِف المتغيّر {{منطقة الزائر}} الذي أنشأته في الـ خطوة السابقة إلى الحقل المنطقة.

  3. احفظ عميلك.

الخطوة 4: التأكّد من تطبيق إعدادات المنطقة

لاختبار ما إذا كانت إعداداتك تعمل:

  1. افتح وضع المعاينة لحاوية الخادم.
  2. حمِّل موقعك الإلكتروني أثناء استخدام عرض المحتوى من نطاق طرف أول.
  3. في نافذة المعاينة، انقر على العميل إحصاءات Google‏ 4 الذي تم طلبه. لقطة شاشة للعميل
  4. للاطّلاع على المنطقة الفعلية، غيِّر الزرّ الدائري عرض المتغيّرات إلى القيم. لقطة شاشة لحقل منطقة الزائر
    • ✅ يكون التنفيذ صحيحًا إذا كانت السمة المنطقة تعرض رمز بلد.
    • ❌ إذا كانت السمة المنطقة تعرض undefined أو كانت غير متوفّرة، يعني ذلك أنّ خادمك لا يتلقّى أي بيانات منطقة. تحقَّق مما إذا تم إعداد عناوين HTTP للخادم وفقًا للمتغيّرات المحدّدة مسبقًا التي تبحث عنها Google Tag Manager، راجِع إعداد عنوان الطلب.

الخطوات التالية