إعداد بوابة علامة Google للمعلِنين

Google Cloud

عليك إعداد خلفية جديدة تبحث عن الموقع الجغرافي التقريبي لزائر الموقع الإلكتروني وتنشئ قواعد توجيه في جهاز موازنة حمل التطبيقات الخارجية الحالي.

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

1. افتح جهاز موازنة الحمل (load balancer) على Google Cloud Platform

2. في جهاز موازنة الحمل، افتح قسم إعداد الخلفية. أنشئ خدمة خلفية جديدة.

3. اضبط خدمة الخلفية الجديدة باستخدام معلومات رصد الموقع الجغرافي:

   • حدِّد اسمًا، مثل measurement-be-svc.
   • اضبط نوع الخلفية على مجموعة نقاط نهاية الشبكة على الإنترنت.
   • اضبط البروتوكول (Protocol) على HTTPS واترك المهلة (Timeout) بالقيمة التي تم ملؤها مسبقًا.
   • ضِمن الخلفيات، انقر على القائمة المنسدلة مجموعة نقاط نهاية الشبكة على الإنترنت وأنشئ مجموعة جديدة من نقاط نهاية الشبكة على الإنترنت:
     • اضبط نوع مجموعة نقاط نهاية الشبكة على مجموعة نقاط نهاية الشبكة على الإنترنت (عالمية، إقليمية).
     • اضبط النطاق على عام.
     • اضبط الإضافة من خلال على اسم النطاق المؤهَّل بالكامل والمنفذ.
     • اضبط اسم النطاق المؤهَّل بالكامل على G-12345.fps.goog.
     • انقر على إنشاء لإنشاء نقطة النهاية.
     • أغلِق علامة التبويب مجموعة نقاط نهاية الشبكة للعودة إلى علامة التبويب خدمة الخلفية الجديدة.
   • ابحث عن اسم مجموعة نقاط نهاية الشبكة الجديدة واختَرها.
   • افتح قسم الإعدادات المتقدّمة. أضِف عناوين الطلبات المخصّصة التالية.

     اسم العنوان	قيمة العنوان
     Host	G-12345.fps.goog
     X-Forwarded-CountryRegion	{client_region_subdivision}
     X-Forwarded-Geolocation	latlong={client_city_lat_long};city={client_city}

   • راجِع الإعدادات الأخرى. لا تتطلّب عملية الدمج هذه استخدام Cloud CDN أو Cloud Armor، لذا يمكنك إيقافهما بأمان.
   • احفظ خدمة الخلفية الجديدة.

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

1. في جهاز موازنة الحمل، افتح قسم قواعد التوجيه.

2. أضِف قواعد المضيف والمسار التالية:

   المضيف	المسار	الخلفية
   *	/metrics/*	measurement-be-svc

3. عدِّل إعدادات جهاز موازنة الحمل.

4. في المتصفّح، تحقَّق من الإعدادات بالانتقال إلى: https://example.com/metrics/healthy. يجب أن تتضمّن الصفحة النص ok. تأكَّد من تضمين معلومات الموقع الجغرافي بالانتقال إلى: https://example.com/metrics/?validate_geo=healthy. يجب أن تتضمّن الصفحة النص ok.

Cloudflare

لعرض علامتك باستخدام "بوابة علامات التتبّع من Google للمعلِنين"، يمكنك استخدام Cloudflare Snippets لإعادة توجيه الطلبات.

إنشاء المقتطف

1. في لوحة بيانات Cloudflare، انتقِل إلى الصفحة الرئيسية للحساب (Account Home) > example.com > القواعد (Rules) > المقتطفات (Snippets).
2. انقر على إنشاء مقتطف.
3. أدخِل اسمًا لمقتطف الرمز يتضمّن رقم تعريف علامتك (مثل google_tag_gateway_gtm_1234). يمكن أن يحتوي الاسم على أحرف صغيرة وأرقام وشرطات سفلية فقط، لذا استبدِل أي واصلات (-) في رقم تعريف علامتك بشرطات سفلية (_).
4. عدِّل العنصر النائب G-12345 باستخدام معرِّف علامة التتبُّع من Google المحدّد.

5. ألصِق مقتطف الرمز المقدَّم في المحرِّر:

   export default {
     async fetch(request) {
       const newRequest = new Request(request);
       const url = new URL(request.url);
       url.hostname = 'fps.goog';
       newRequest.headers.set('X-Gtg-Implementation', 'Snippet');
       newRequest.headers.set('X-Gtg-Tag-Id', 'G-12345');
       newRequest.headers.append('X-Forwarded-For', request.headers.get('CF-Connecting-IP'));
       newRequest.headers.set('X-Forwarded-Country', request.cf.country);
       newRequest.headers.set('X-Forwarded-Region', request.cf.regionCode);
       newRequest.headers.set(
         'X-Forwarded-Geolocation',
         `latlong=${request.cf.latitude},${request.cf.longitude};` +
           `city=${request.cf.city}`,
       );
       return await fetch(url, newRequest);
     },
   };
   

6. انقر على قاعدة المقتطف للانتقال إلى صفحة الإعداد.

ضبط قاعدة المقتطف

1. في صفحة القاعدة الخاصة بمقتطفك، انقر على تعبير الفلتر المخصّص.
2. انقر على تعديل التعبير والصِق ما يلي: (starts_with(http.request.uri.path, "/metrics/"))
3. انقر على تم لحفظ قاعدة المقتطف.
4. انقر على نشر لتفعيل المقتطف.
5. في المتصفّح، تحقَّق من الإعدادات بالانتقال إلى: https://example.com/metrics/healthy. يجب أن تتضمّن الصفحة النص ok. تأكَّد من تضمين معلومات الموقع الجغرافي بالانتقال إلى: https://example.com/metrics/?validate_geo=healthy. يجب أن تتضمّن الصفحة النص ok.

Akamai

لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك إضافة قاعدة جديدة في موقعك لإعادة توجيه الطلبات وإضافة معلومات رصد الموقع الجغرافي.

إنشاء قاعدة إعادة التوجيه

1. إنشاء إصدار جديد من إعدادات التسليم في مدير المواقع
2. ضمن قسم إعدادات ضبط الموقع، أضِف Rule جديدًا
   • أدخِل اسمًا، مثل Route measurement
3. أضِف شرط مطابقة (Match) جديدًا
   • اضبط القوائم المنسدلة الخاصة بشرط المطابقة على المسار (Path) وواحد من (is one of)
   • اضبط قيمة شرط المطابقة على /metrics/*
4. أضِف سلوكًا (Behavior) جديدًا
   • اختَر سلوك الموقع التلقائي (Standard Property Behavior) واختَر سلوك خادم المصدر (Origin Server)
   • اضبط اسم مضيف خادم المصدر (Origin Server Hostname) على G-12345.fps.goog
   • اضبط إعادة توجيه عنوان المضيف (Forward Host Header) على اسم مضيف المصدر (Origin Hostname)
5. احفظ القاعدة الجديدة وفعِّل التغييرات
   • احرص على اختبار قاعدة إعادة التوجيه الجديدة في بيئة اختبار قبل طرحها في بيئة الإنتاج
   • نصيحة: تأكَّد من عدم وجود أي قواعد تعدّل عناوين الاستجابة الصادرة أو تزيلها. قد يؤدي ذلك إلى تعذُّر تفعيل نصوص Google البرمجية في حال عدم توفّر عنوان الاستجابة Content-Type.

تضمين معلومات رصد الموقع الجغرافي

1. اختَر قاعدة إعادة التوجيه (التي تم إنشاؤها أعلاه) ضمن إعدادات ضبط الموقع

2. إضافة سلوك جديد

   • اختَر سلوك الموقع التلقائي (Standard Property Behavior) واختَر سلوك استهداف المحتوى (Content Targeting (EdgeScape))
   • اضبط تفعيل على true

3. احفظ السلوك الجديد وفعِّل التغييرات.

   • احرص على اختبار قاعدة إعادة التوجيه الجديدة في بيئة اختبار قبل طرحها في بيئة الإنتاج

4. في المتصفّح، تحقَّق من الإعدادات بالانتقال إلى: https://example.com/metrics/healthy. يجب أن تتضمّن الصفحة النص ok. تأكَّد من تضمين معلومات الموقع الجغرافي بالانتقال إلى: https://example.com/metrics/?validate_geo=healthy. يجب أن تتضمّن الصفحة النص ok.

‫Amazon CloudFront

لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك ضبط سلوك التوزيع لإعادة توجيه الطلبات وإضافة معلومات رصد الموقع الجغرافي.

إضافة مصدر جديد

1. انتقِل إلى صفحة CloudFront في Amazon Web Services (AWS)
2. اختَر التوزيعة (Distribution) في CloudFront
3. في علامة التبويب المصادر (Origins)، أنشئ مصدرًا باستخدام الإعدادات التالية:
   • اضبط نطاق المصدر (Origin domain) على G-12345.fps.goog
   • اضبط البروتوكول (Protocol) على HTTPS فقط (HTTPS Only)

إنشاء سلوك إعادة التوجيه

1. انتقِل إلى صفحة CloudFront في AWS
2. اختَر التوزيعة (Distribution) في CloudFront
3. في علامة التبويب السلوكيات (Behaviors)، أنشئ سلوكًا جديدًا باستخدام الإعدادات التالية:
   • اضبط نمط المسار على /metrics/*
   • اضبط المصدر ومجموعات المصدر (Origin and origin groups) على G-12345.fps.goog
   • اضبط ضغط العناصر تلقائيًا (Compress objects automatically) على لا (No)
   • اضبط سياسة بروتوكول المُشاهد على HTTPS فقط
   • اضبط طُرق HTTP المسموح بها (Allowed HTTP Methods) على GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE
   • ضمن مفتاح ذاكرة التخزين المؤقت وطلبات المصدر (Cache key and origin requests)، اختَر سياسة ذاكرة التخزين المؤقت وسياسة طلب المصدر (Cache policy and origin request policy)
     • اضبط سياسة ذاكرة التخزين المؤقت على CachingDisabled
     • اضبط سياسة طلب المصدر (Origin request policy) على AllViewerExceptHostHeader
4. في قائمة السلوك (Behavior)، تأكَّد من أنّ Precedence الخاص بالسلوك الجديد أعلى من جميع السلوكيات الأخرى
   • لتغيير Precedence، اختَر سلوكك وانقر على زر نقل إلى الأعلى (Move up) إلى أن يصبح السلوك فوق كل السلوكيات الأخرى.
5. في المتصفّح، تحقَّق من الإعدادات بالانتقال إلى: https://example.com/metrics/healthy. يجب أن تُظهر الصفحة ok.

تضمين معلومات رصد الموقع الجغرافي

1. لإعادة توجيه معلومات رصد الموقع الجغرافي اللازمة، اضبط العناوين (Headers) على AllViewerExceptHostHeader في سلوك إعادة التوجيه.
   • يمكنك الاطّلاع على القائمة الكاملة بعناوين المواقع الجغرافية للمشاهدين في CloudFront في هذه المقالة
2. انتظِر بضع دقائق حتى يتم تفعيل التوزيعة. في المتصفّح، تحقَّق من الإعدادات بالانتقال إلى: https://example.com/metrics/?validate_geo=healthy. يجب أن تُظهر الصفحة ok.

Fastly

لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك ضبط شبكة توصيل المحتوى Fastly لإعادة توجيه الطلبات وإضافة معلومات الموقع الجغرافي. تتضمّن هذه العملية إنشاء شرط واحد ومضيف واحد ومقتطفَين من VCL.

إنشاء الشرط والمضيف

أولاً، عليك إعداد شرط لتحديد الطلبات الموجّهة إلى البوابة ومضيف لتوجيهها إلى Google.

1. أنشئ شرطًا جديدًا باستخدام الإعداد التالي:

   • النوع: Request
   • الاسم: Google Tag Gateway Path (أو أي اسم آخر تفضّله)
   • شرط التطبيق… (Apply if…‎): req.url.path ~ "^/metrics"

2. أنشئ مضيفًا جديدًا باستخدام الإعدادات التالية:

   • اسم/عنوان المضيف: fps.goog

3. اضبط المضيف الجديد باستخدام الإعدادات الإضافية التالية:

   • انقر على إرفاق شرط واختَر الشرط الذي أنشأته في الخطوة 1.
   • اضبط تجاهل المضيف (Override host) على fps.goog.
   • اترك الإعدادات الأخرى على الوضع التلقائي.
   • انقر على تعديل لحفظ المضيف.

إضافة معرِّف علامة التتبُّع من Google وعناوين الموقع الجغرافي

الخطوة التالية هي إضافة مقتطفات لغة VCL لإرفاق معرِّف علامة التتبُّع من Google وبيانات الموقع الجغرافي للعميل. يجب إنشاء مقتطفَين منفصلَين، أحدهما vcl_miss والآخر vcl_pass، باستخدام الرمز البرمجي نفسه تمامًا.

1. في الخدمة التي تستعين بها، انتقِل إلى مقتطفات VCL (VCL Snippets) وأنشئ مقتطفًا يتضمّن الحقول التالية:

   • الاسم: Geo_MISS (أو أي اسم آخر تفضّله)
   • موضع الإعلان: Within Subroutine
   • الروتين الفرعي: vcl_miss

   • VCL:

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlong=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

2. أنشئ مقتطفًا آخر يتضمّن الحقول التالية:

   • الاسم: Geo_PASS (أو أي اسم آخر تفضّله)
   • النوع: vcl_pass

   • VCL:

     if (req.url.path ~ "^/metrics") {
       set bereq.http.X-Gtg-Tag-Id = "G-12345";
       set bereq.http.X-Forwarded-Country = client.geo.country_code;
       set bereq.http.X-Forwarded-Region = client.geo.region;
       set bereq.http.X-Forwarded-Geolocation = "latlong=" +
         client.geo.latitude + "," + client.geo.longitude + ";city=" +
         client.geo.city;
     }
     

   من المفترض أن يكون لديك الآن مقتطفان جديدان منفصلان. يضمن ذلك إضافة عناوين رصد الموقع الجغرافي إلى أي طلب يجب جلبه من المضيف، سواء كان بالحالة "البيانات غير متوفرة في ذاكرة التخزين المؤقت" (cache miss) ‏(vcl_miss) أو "البيانات متوفرة في ذاكرة التخزين المؤقت" (cache pass) ‏(vcl_pass).

تفعيل الإعدادات الكاملة والتحقّق منها

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

1. انقر على تفعيل (Activate) لتفعيل جميع التغييرات الجديدة.

2. تحقَّق من الإعدادات عن طريق إجراء الاختبارَين التاليَين في المتصفّح:

   • الاختبار 1 (علامة التتبّع والتوجيه): انتقِل إلى https://example.com/metrics/healthy
   • الاختبار 2 (رصد الموقع الجغرافي): انتقِل إلى https://example.com/metrics/?validate_geo=healthy

   يجب أن تعرض كلتا الصفحتين ok

غير ذلك

لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك ضبط شبكة توصيل المحتوى أو جهاز موازنة الحمل لتوجيه الطلبات إلى نقطة نهاية "بوابة علامات التتبّع من Google للمعلِنين".

1. أضِف مصدرًا أو خادمًا خلفيًا يشير إلى G-12345.fps.goog.
2. تجاهل عنوان المضيف ليكون مساويًا G-12345.fps.goog. اسمَح بإعادة توجيه جميع ملفات تعريف الارتباط وسلاسل طلب البحث.
3. مرِّر معلومات رصد الموقع الجغرافي للزائر بتضمين أحد العناوين التالية:
   • ‫X-Forwarded-CountryRegion - بلد المستخدِم ومنطقته في رمز واحد بمعيار ISO 3166-2 (مثلاً: US-CA)
   • ‫X-Forwarded-Country وX-Forwarded-Region:
     • ‫X-Forwarded-Country - بلد المستخدِم برمز ISO 3166-1 alpha-2 (مثلاً: US)
     • ‫X-Forwarded-Region - منطقة المستخدم برمز القسم الفرعي (مثلاً: CA)
   • في حال تضمين كلتا مجموعتَي العناوين، سيتم استخدام X-Forwarded-CountryRegion.
4. أضِف قاعدة مسار لـ /metrics/* لتوجيه الزيارات إلى "بوابة علامات التتبّع من Google للمعلنين".
5. اضبط المسار المحجوز ليكون له أولوية أعلى من القاعدة التلقائية.
6. في المتصفّح، تحقَّق من الإعدادات بالانتقال إلى: https://example.com/metrics/healthy. يجب أن تُظهر الصفحة ok. تأكَّد من تضمين معلومات الموقع الجغرافي بالانتقال إلى: https://example.com/metrics/?validate_geo=healthy. يجب أن تُظهر الصفحة ok.

gtag.js

في أعلى القسم <head>، ابحث عن سطرَي النص البرمجي اللذين يتضمّنان معرِّف علامة التتبُّع من Google:

<!-- Google tag (gtag.js) -->
<script async src="//www.googletagmanager.com/gtag/js?id=G-12345"></script>

واستبدِلها بمسار القياس بدلاً من ذلك:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

gtm.js

في أعلى قسم <head>، استبدِل مقتطف "إدارة العلامات من Google" بما يلي:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->