هذه المقالة موجّهة للمطوّرين الذين يقدّمون نصوص Google البرمجية من خادمهم. نقترح تفعيل السلوك الخاص بمنطقة محدّدة من أجل الاستفادة من ميزات مثل وضع الموافقة المتقدّم والتحكّم في سلوك العلامة استنادًا إلى الموقع الجغرافي للمستخدمين.
قبل البدء
يفترض هذا الدليل أنك أنجزت ما يلي:
- إعداد حاوية خادم في أداة "إدارة العلامات من Google"
- إعداد خادم وضع العلامات
- إعداد عرض النص البرمجي للطرف الأول
الخطوة 1: إعداد عنوان الطلب
عليك إرسال عناوين طلبات محدَّدة تحتوي على معلومات منطقة المستخدم، كما هو موضَّح في الأقسام أدناه.
يمكنك البدء مباشرةً من الخطوة 2 في الحالات التالية:
- أنت تستخدم App Engine. يرسل App Engine العناوين الجغرافية تلقائيًا.
- يتم استخدام مزوّد بنية أساسية مختلف عن مزوّدي الخدمات الواردة أدناه. يجب إعداد رؤوس مخصّصة.
تشغيل السحابة الإلكترونية باستخدام موازن حمولة Google Cloud Platform
يمكنك إرسال معلومات رصد الموقع الجغرافي إما باستخدام جميع عناوين طلبات HTTP، أو لطلبات محدّدة. بما أنّ إضافة عناوين الطلبات المخصّصة سيتم فرض رسوم على أساس كل مليون طلب، نقترح تضمين المعلومات الجغرافية فقط لطلبات عرض النصوص البرمجية من Google. يتطلّب هذا الخيار في البداية مزيدًا من الإعداد، ولكنّه يساعدك على إدارة بنيتك الأساسية من الناحية الاقتصادية قدر الإمكان.
طلبات النصوص البرمجية
ولتضمين الرؤوس الجغرافية لطلبات النصوص البرمجية فقط، عليك إعداد خلفية جديدة وإنشاء قواعد توجيه.
لإنشاء خلفية جديدة:
- فتح جهاز موازنة حمل Google Cloud Platform
- في جهاز موازنة التحميل، افتح قسم تهيئة الخلفية. إنشاء خدمة خلفية جديدة.
- اضبط خدمة الخلفية الجديدة:
- نوع الخلفية: اختَر نوع مجموعة نقطة نهاية الشبكة التي يستخدمها تطبيقك. في حال استخدام Cloud Run، اختَر مجموعة نقاط نهاية الشبكة بدون خادم.
- في الخلفية الجديدة، اختر مجموعة نقاط نهاية الشبكة لنشر أداة "إدارة العلامات من Google" من جهة الخادم.
- افتح قسم الإعدادات المتقدّمة. أضِف عناوين الطلبات المخصّصة.
اسم العنوان قيمة العنوان بلد من X-Gclb {client_region} منطقة X-Gclb {client_region_subdivision} - احفظ خدمة الخلفية الجديدة.
لضبط قواعد التوجيه:
- في جهاز موازنة الحمل، افتح قسم قواعد التوجيه. اختَر الوضع مسار المضيف المتقدم وقاعدةه.
- عدِّل المَعلمة
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
- احفظ التغييرات.
جميع الطلبات
لإرسال معلومات الموقع الجغرافي مع جميع طلبات HTTP، يجب إضافة عناوين طلبات مخصّصة إلى خدمة الخلفية الحالية، راجِع مستندات Google Cloud. أنشئ عناوين طلبات مخصّصة جديدة لكل عنوان أدناه:
اسم العنوان | قيمة العنوان |
---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
موازن حمولة Google Cloud Platform
يمكنك إرسال معلومات رصد الموقع الجغرافي إما باستخدام جميع عناوين طلبات HTTP، أو لطلبات محدّدة. بما أنّ إضافة عناوين الطلبات المخصّصة سيتم فرض رسوم على أساس كل مليون طلب، نقترح تضمين المعلومات الجغرافية فقط لطلبات عرض النصوص البرمجية من Google. يتطلّب هذا الخيار في البداية مزيدًا من الإعداد، ولكنّه يساعدك على إدارة بنيتك الأساسية من الناحية الاقتصادية قدر الإمكان.
طلبات النصوص البرمجية
ولتضمين الرؤوس الجغرافية لطلبات النصوص البرمجية فقط، عليك إعداد خلفية جديدة وإنشاء قواعد توجيه.
لإنشاء خلفية جديدة:
- فتح جهاز موازنة حمل Google Cloud Platform
- في جهاز موازنة التحميل، افتح قسم تهيئة الخلفية. إنشاء خدمة خلفية جديدة.
- اضبط خدمة الخلفية الجديدة:
- نوع الخلفية: اختَر نوع مجموعة نقطة نهاية الشبكة التي يستخدمها تطبيقك. في حال استخدام Cloud Run، اختَر مجموعة نقاط نهاية الشبكة بدون خادم.
- في الخلفية الجديدة، اختر مجموعة نقاط نهاية الشبكة لنشر أداة "إدارة العلامات من Google" من جهة الخادم.
- افتح قسم الإعدادات المتقدّمة. أضِف عناوين الطلبات المخصّصة.
اسم العنوان قيمة العنوان بلد من X-Gclb {client_region} منطقة X-Gclb {client_region_subdivision} - احفظ خدمة الخلفية الجديدة.
لضبط قواعد التوجيه:
- في جهاز موازنة الحمل، افتح قسم قواعد التوجيه. اختَر الوضع مسار المضيف المتقدم وقاعدةه.
- عدِّل المَعلمة
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
- احفظ التغييرات.
جميع الطلبات
لإرسال معلومات الموقع الجغرافي مع جميع طلبات 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](https://developers.google.cn/static/tag-platform/tag-manager/server-side/img/aws-headers.png?authuser=7&hl=ar)
الباب الأمامي باللون الأزرق السماوي
باستخدام محرّك القواعد، يمكنك إنشاء مجموعة قواعد تتضمّن إجراء تعديل عنوان الطلب مع عملية الربط التالية:
اسم العنوان | قيمة العنوان |
---|---|
إكس-أزور-كونتري | {geo_country} |
![لقطة شاشة لإعدادات الباب الأمامي في Azure](https://developers.google.cn/static/tag-platform/tag-manager/server-side/img/azure-headers.png?authuser=7&hl=ar)
خافت
فعِّل "إضافة رؤوس المواقع الجغرافية للزوار" في قسم الإحالات الناجحة المُدارة:
سيؤدي ذلك تلقائيًا إلى إضافة العنوان التالي مع قيمته:
اسم العنوان | قيمة العنوان |
---|---|
CF-IPCountry | بلد المستخدم |
![لقطة شاشة لإعدادات Cloudflare](https://developers.google.cn/static/tag-platform/tag-manager/server-side/img/cloudflare-headers.png?authuser=7&hl=ar)
الخطوة 2: إعداد متغيّر منطقة الزائر
في حال إعداد رؤوس جغرافية كما هو محدّد أعلاه، تكتشف أداة "إدارة العلامات من Google" تلقائيًا المنطقة أو البلد من خلال قراءة عنوان طلب HTTP. بدلاً من ذلك، يمكنك إعداد رؤوس مخصصة.
الرصد التلقائي
- فتح أداة "إدارة العلامات من Google"
- افتح حاوية الخادم.
- في قائمة المتغيّرات، اضبِط قائمة المتغيّرات المضمّنة.
- اختر منطقة الزائر.
وستكون الرؤوس الجغرافية متاحة الآن للاستخدام في متغير منطقة الزائر.
عناوين مخصَّصة
- فتح أداة "إدارة العلامات من Google"
- افتح حاوية الخادم.
- في قائمة المتغيّرات، أنشئ متغيّرًا جديدًا من تحديد المستخدِم من نوع منطقة الزائر.
- في ضبط المتغيّر، اختر متغيّر مخصّص.
في قائمة المتغيّرات، أنشئ متغيّرَين جديدَين لعنوان الطلب: أحدهما لبلدك والآخر لرمز القسم الفرعي. املأ القيم برموز البلدان في عناوين طلبات HTTP.
استخدِم المتغيّرات التي أنشأتها في متغيّر منطقة الزائر كما هو موضّح في لقطة الشاشة.
أدخِل اسمًا للمتغيّر واحفظه.
الخطوة 3: تفعيل الإعدادات الخاصة بالمنطقة في البرنامج
لاستخدام منطقة الزائر لمعالجة طلبات HTTP الواردة، يجب إضافتها إلى العميل.
اختَر العميل أو أنشئ عميلاً جديدًا تريد تطبيق إعداد المنطقة عليه. البرامج المتوافقة هي:
- "إدارة العلامات من Google": حاوية الويب
- "إحصاءات Google": "إحصاءات Google 4"
- "إحصاءات Google": Universal Analytics
في حال ضبط برامج "إحصاءات Google 4" أو Universal Analytics، ضَع علامة في المربّع مسارات gtag.js التلقائية لأرقام تعريف محدّدة وأدخِل رقم تعريف القياس لحاوية الويب.
ضع علامة في المربّع تفعيل الإعدادات الخاصة بالمنطقة. أضِف المتغيّر {{visitor Region}} الذي أنشأته في الخطوة السابقة إلى حقل المنطقة.
احفظ برنامجك.
الخطوة 4: التأكّد من تطبيق إعدادات المنطقة
لاختبار عمل الإعدادات:
- افتح وضع المعاينة لحاوية الخادم.
- تحميل موقعك الإلكتروني أثناء استخدام العرض للطرف الأول.
- في نافذة المعاينة، انقر على عميل Universal Analytics "إحصاءات Google 4" (GA4) أو Universal Analytics هذا.
- للاطّلاع على المنطقة الفعلية، غيِّر زر الاختيار Display المتغيّرات إلى قيم.
- ✅ تكون عملية التنفيذ صحيحة إذا كانت سمة المنطقة تعرِض رمز بلد.
- ❌ إذا كانت السمة Region تعرض السمة
undefined
أو كانت غير متوفّرة، لن يتلقّى الخادم أي بيانات عن المنطقة. تحقّق من إعداد عناوين HTTP للخادم وفقًا للمتغيرات المحدّدة مسبقًا التي تبحث عنها أداة "إدارة العلامات من Google"، اطّلِع على إعداد عنوان الطلب.