هذا المستند مخصّص للمستخدمين الذين يريدون نشر "بوابة علامات التتبّع من Google للمعلِنين". ننصحك باستخدام "بوابة علامات التتبّع من Google للمعلِنين" للحصول على إعدادات علامات التتبّع الأكثر استدامة.
نظرة عامة
تسمح لك "بوابة علامات التتبّع من Google للمعلِنين" بنشر "علامة تتبُّع من Google" باستخدام البنية الأساسية الخاصة بالطرف الأول، والتي تتم استضافتها على نطاق موقعك الإلكتروني. وتقع هذه البنية التحتية بين موقعك الإلكتروني وخدمات Google. سيساعدك الإعداد الموضّح في هذه المستندات على قياس أداء موقعك الإلكتروني بشكل أفضل. يمكنك إعدادها باستخدام شبكة توصيل المحتوى (CDN) أو جهاز موازنة الحمل أو خادم الويب الحالي.
في عمليات الإعداد العادية لـ "علامة Google"، تطلب صفحة الويب الخاصة بك "علامة Google" من نطاق على Google. عندما يتم تفعيل العلامة، ترسل طلبات القياس مباشرةً إلى منتج Google. باستخدام "بوابة علامات التتبّع من Google للمعلنين"، يحمّل موقعك الإلكتروني علامة التتبّع من Google من نطاق الطرف الأول. عندما يتم تفعيل العلامة، سيتم إرسال بعض طلبات القياس إلى Google باستخدام نطاق الطرف الأول.
يوضّح هذا المخطّط البياني مسار المعلومات في "بوابة علامات التتبُّع من Google للمعلِنين":
قبل البدء
يفترض هذا الدليل أنّ موقعك الإلكتروني قد تمّ إعداده مسبقًا باستخدام ما يلي:
- علامة Google أو حاوية في "إدارة العلامات من Google"
- شبكة توصيل المحتوى (CDN) أو جهاز موازنة الحمل الذي يمكنه إعادة توجيه الطلبات إلى نقاط نهاية خارجية
للبدء، اختَر نوع الإعداد.
1. اختيار مسارات القياس
يجب حجز مسار قياس فريد على نطاق موقعك الإلكتروني لعرض كل علامة أو حاوية في "إدارة العلامات من Google".
متطلبات مسار القياس:
- يجب ألا تكون المسارات قيد الاستخدام حاليًا على نطاقك.
- يجب ألا يكون كل مسار هو المسار الجذر /.
- يجب ألا يتجاوز كل مسار 100 حرف.
إدارة العلامات من Google:
إذا كنت تستخدم أداة "إدارة العلامات من Google"، عليك تقديم معرّف الحاوية فقط (مثل GTM-XXXXXX). هذا الإعداد الفردي يكفي لجميع العلامات (مثل "إحصاءات Google" و"إعلانات Google" وما إلى ذلك) التي تمت إضافتها إلى هذه الحاوية.
بالنسبة إلى كل حاوية أو علامة مستقلة فريدة، ستحتاج إلى مسار عرض فريد ومعرّفه المقابل.
لإعداد "بوابة علامات التتبّع من Google للمعلِنين"، اختَر أي مسار غير مستخدَم حاليًا على موقعك الإلكتروني. للحدّ من احتمال التعارض مع مسار موجود على الموقع الإلكتروني، يمكنك اختيار أي مجموعة من الأحرف والأرقام، أو إذا كنت تريد مسارًا أسهل للقراءة، يمكنك اختيار استخدام كلمة مثل /gtm أو /metrics أو /analytics أو أي كلمة أخرى تريدها.
على سبيل المثال:
| حالة الاستخدام | رقم التعريف | مسار عرض علامة التتبُّع | نقطة نهاية المصدر |
|---|---|---|---|
| Standalone Tag 1 | G-12345 |
/abjfo/ |
g-12345.fps.goog/abjfo/ |
| Standalone Tag 2 | G-67890 |
/fjdso/ |
g-67890.fps.goog/fjdso/ |
| حاوية GTM | GTM-ABCDEF |
/cvfjk/ |
gtm-abcdef.fps.goog/cvfjk/ |
املأ ما يلي لملء الأمثلة في هذا المستند.
Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics
كيفية التعامل مع علامات أو حاويات متعدّدة:
إذا كانت علاماتك في حاوية GTM نفسها، لن تحتاج إلى تكرار عملية الإعداد هذه. ما عليك سوى إضافة حاوية واحدة على "إدارة العلامات من Google"، وسيتم التعامل مع جميع العلامات داخلها.
إذا كانت علاماتك في حاويات منفصلة في "إدارة العلامات من Google" أو غير مرتبطة... يجب تكرار عملية الإعداد هذه لكل نسخة. ينطبق ذلك في حال تشغيل ما يلي:
- حاويات متعدّدة ومنفصلة في "إدارة العلامات من Google"
- العلامات الفردية (مثل G-XXXXXX) التي لا تكون داخل حاوية.
عند إجراء ذلك، يجب تخصيص مسار فريد لعرض العلامات لكل حاوية أو علامة.
2. حركة المرور على الطريق
يفترض هذا القسم أنّ موقعك الإلكتروني يستخدم حاليًا شبكة توصيل محتوى أو جهاز موازنة حمل يتيح توجيه الزيارات حسب المسارات.
Google Cloud
عليك إعداد نظام خلفي جديد يبحث عن الموقع الجغرافي التقريبي لزائر الموقع الإلكتروني وإنشاء قواعد توجيه في موازنة الحمل للتطبيقات الخارجية الحالية.
إنشاء الخلفية الجديدة
في موازن التحميل، افتح قسم إعدادات الخلفية. أنشئ خدمة خلفية جديدة.

اضبط خدمة الخلفية الجديدة باستخدام معلومات الموقع الجغرافي:
- حدِّد اسمًا، مثل
measurement-be-svc. - اضبط نوع الخلفية على مجموعة نقاط نهاية شبكة الإنترنت.
- اضبط البروتوكول على HTTPS واترك المهلة بالقيمة التي تم ملؤها مسبقًا.
- ضمن الخلفيات، انقر على القائمة المنسدلة مجموعة نقاط نهاية الشبكة على الإنترنت
وأنشئ مجموعة نقاط نهاية شبكة جديدة على الإنترنت:
- اضبط نوع مجموعة نقاط نهاية الشبكة على مجموعة نقاط نهاية الشبكة على الإنترنت (عالمية، إقليمية).
- اضبط النطاق على عام.
- اضبط الإضافة من خلال على اسم النطاق المؤهَّل بالكامل والمنفذ.
- اضبط اسم النطاق المؤهَّل بالكامل على
G-12345.fps.goog. - انقر على إنشاء لإنشاء نقطة النهاية.
- أغلِق علامة التبويب مجموعة نقاط نهاية الشبكة للعودة إلى علامة التبويب خدمة الخلفية الجديدة.
- ابحث عن اسم مجموعة نقاط نهاية الشبكة الجديدة واختَرها.
- افتح قسم الإعدادات المتقدّمة. أضِف عناوين طلبات مخصّصة على النحو التالي.
اسم العنوان قيمة العنوان HostG-12345.fps.googX-Forwarded-Country{client_region}X-Forwarded-Region{client_region_subdivision} - راجِع الإعدادات الأخرى. لا يتطلّب هذا التكامل استخدام Cloud CDN أو Cloud Armor، لذا يمكنك إيقافهما بأمان.
- احفظ خدمة الخلفية الجديدة.
- حدِّد اسمًا، مثل
ضبط قواعد التوجيه
في موازن التحميل، افتح قسم قواعد التوجيه.
أضِف قواعد المضيف والمسار التالية:
المضيف المسار الخلفية */metrics/*measurement-be-svcعدِّل إعدادات موازن التحميل.
في المتصفّح، تأكَّد من عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/healthy. يجب أن تتضمّن الصفحة النصok. تأكَّد من تضمين المعلومات الجغرافية من خلال الانتقال إلى:https://example.com/metrics/?validate_geo=healthy. يجب أن تتضمّن الصفحة النصok.
Cloudflare
لعرض علامتك في بوابة علامة Google للمعلِنين، عليك إنشاء إدخال CNAME لنطاق فرعي جديد، وإنشاء قاعدة مصدر لإعادة توجيه الطلبات، وإنشاء قاعدة تحويل لتضمين معلومات الموقع الجغرافي. لإكمال عملية الإعداد هذه، يجب أن يكون لديك خطة Cloudflare Enterprise. إذا لم تكن لديك خطة Enterprise، ننصحك باستخدام الإعداد التلقائي في Cloudflare بدلاً من ذلك.
إنشاء إدخال CNAME
اختَر نطاقًا فرعيًا لحجزه لإدخال CNAME. يُرجى ملء ما يلي لملء الأمثلة في هذا المستند. لا يتم عرض سجلّ CNAME هذا خارج إعدادات Cloudflare، لذا يمكن اختيار أي اسم.
CNAME subdomain: fps
- في علامة التبويب "نظام أسماء النطاقات"، افتح قسم السجلات.
- أضِف سجلّاً جديدًا بالإعدادات التالية:
- اضبط النوع على CNAME.
- اضبط الاسم على
fps. - اضبط الاستهداف على
G-12345.fps.goog.
- احفظ سجلّ CNAME.
إنشاء قاعدة المنشأ
- في علامة التبويب "القواعد"، افتح قواعد المصدر وأنشئ قاعدة.
- أدخِل اسم قاعدة، مثل
Route measurement. - مطابقة الطلبات الواردة استنادًا إلى تعبير فلتر مخصّص والنقر على تعديل التعبير
- ألصِق التعبير التالي في أداة الإنشاء:
(http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics")) - تعديل عنوان المضيف إلى إعادة الكتابة إلى...
G-12345.fps.goog. - عدِّل سجلّ نظام أسماء النطاقات إلى تجاهل إلى...
fps.example.com. - احفظ قاعدة المنشأ.
- إذا كانت هناك قواعد مصدر أخرى، عليك زيادة موضع القاعدة التي تم إنشاؤها حديثًا لكي يتم تنفيذها بعد أي مسارات أخرى ذات أحرف بدل.
- في المتصفّح، تحقَّق من عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/healthy. يجب أن تعرض الصفحةok.
تضمين معلومات الموقع الجغرافي
- في علامة التبويب "القواعد"، افتح الإعدادات.
- فعِّل الخيار إضافة عناوين المواقع الجغرافية للزوّار.
- انتظِر بضع دقائق حتى يتم نشر القاعدة. في المتصفّح، أثبِت صحة عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/?validate_geo=healthy. يجب أن يظهر في الصفحةok.
Akamai
لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك إضافة قاعدة جديدة في موقعك لإعادة توجيه الطلبات وإضافة معلومات الموقع الجغرافي.
إنشاء قاعدة إعادة التوجيه
- إنشاء إصدار جديد من إعدادات العرض في "إدارة المواقع"
- ضمن قسم إعدادات ضبط المواقع، أضِف
Rule- جديدًا.
- أدخِل اسمًا، مثل
Route measurement
- أدخِل اسمًا، مثل
- إضافة مطابقة جديدة
- اضبط القوائم المنسدلة الخاصة بالمطابقة على المسار وهو أحد الخيارات التالية.
- اضبط قيمة المطابقة على
/metrics/*
- إضافة سلوك جديد
- اختَر سلوك الموقع التلقائي (Standard Property Behavior) واختَر السلوك خادم المصدر (Origin Server).
- اضبط اسم مضيف خادم المصدر على
G-12345.fps.goog - اضبط توجيه عنوان المضيف على اسم المضيف الأصلي.
- حفظ القاعدة الجديدة ونشر التغييرات
- احرص على اختبار قاعدة إعادة التوجيه الجديدة في بيئة الاختبار قبل طرحها في بيئة الإنتاج.
- ملاحظة: تأكَّد من عدم وجود أي قواعد تعدّل أو تزيل عناوين الاستجابة الصادرة. قد يؤدي ذلك إلى تعذّر تنفيذ نصوص Google البرمجية في حال عدم توفّر عنوان الاستجابة
Content-Type.
تضمين معلومات الموقع الجغرافي
اختَر قاعدة إعادة التوجيه (التي تم إنشاؤها أعلاه) ضمن إعدادات ضبط الموقع
إضافة سلوك جديد
- اختَر سلوك الموقع التلقائي (Standard Property Behavior) واختَر السلوك استهداف المحتوى (EdgeScape) (Content Targeting (EdgeScape)).
- اضبط تفعيل على
true
احفظ السلوك الجديد ونفِّذ التغييرات.
- احرص على اختبار قاعدة إعادة التوجيه الجديدة في بيئة الاختبار قبل طرحها في بيئة الإنتاج.
في المتصفّح، تأكَّد من عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/healthy. يجب أن تتضمّن الصفحة النصok. تأكَّد من تضمين المعلومات الجغرافية من خلال الانتقال إلى:https://example.com/metrics/?validate_geo=healthy. يجب أن تتضمّن الصفحة النصok.
Amazon CloudFront
لعرض علامتك باستخدام "بوابة علامات التتبّع من Google للمعلِنين"، عليك ضبط سلوك التوزيع لإعادة توجيه الطلبات وإضافة معلومات الموقع الجغرافي.
إضافة مصدر جديد
- الانتقال إلى صفحة CloudFront في Amazon Web Services (AWS)
- اختَر التوزيع في CloudFront
- في علامة التبويب المصادر، أنشئ مصدرًا باستخدام الإعدادات التالية:
- اضبط نطاق المصدر على
G-12345.fps.goog - ضبط البروتوكول على HTTPS فقط
- اضبط نطاق المصدر على
إنشاء سلوك إعادة التوجيه
- الانتقال إلى صفحة CloudFront في AWS
- اختَر التوزيع في CloudFront
- في علامة التبويب السلوكيات، أنشئ سلوكًا جديدًا باستخدام الإعدادات التالية:
- اضبط نمط المسار على
/metrics/* - اضبط نقطة الانطلاق ومجموعات نقاط الانطلاق على
G-12345.fps.goog - اضبط ضغط الكائنات تلقائيًا على لا
- اضبط سياسة بروتوكول المشاهد على HTTPS فقط
- اضبط طُرق HTTP المسموح بها على GET وHEAD وOPTIONS وPUT وPOST وPATCH وDELETE
- ضمن مفتاح ذاكرة التخزين المؤقت وطلبات المصدر، اختَر
سياسة ذاكرة التخزين المؤقت وسياسة طلب المصدر
- اضبط سياسة ذاكرة التخزين المؤقت على CachingDisabled
- اضبط سياسة طلب المصدر على AllViewerExceptHostHeader
- اضبط نمط المسار على
- في قائمة السلوك، تأكَّد من أنّ قيمة
Precedenceللسلوك الجديد أعلى من قيم جميع السلوكيات الأخرى- لتغيير
Precedence، اختَر السلوك الذي تريده وانقر على الزر نقل إلى الأعلى إلى أن يصبح أعلى من جميع السلوكيات الأخرى.
- لتغيير
- في المتصفّح، تحقَّق من عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/healthy. يجب أن تعرض الصفحةok.
تضمين معلومات الموقع الجغرافي
- لإعادة توجيه معلومات الموقع الجغرافي اللازمة، اضبط العناوين على
AllViewerExceptHostHeader في سلوك إعادة التوجيه.
- يمكنك الاطّلاع على القائمة الكاملة بعناوين مواقع المشاهدين في CloudFront بالتفصيل في هذه المقالة
- انتظِر بضع دقائق حتى يتم نشر التوزيعة. في المتصفّح،
أثبِت صحة عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/?validate_geo=healthy. يجب أن يظهر في الصفحةok.
Fastly
لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك ضبط خدمة شبكة توصيل المحتوى (CDN) من Fastly لإعادة توجيه الطلبات وإضافة معلومات الموقع الجغرافي. تتضمّن هذه العملية إنشاء شرط واحد ومضيف واحد ومقتطفَين من VCL.
إنشاء الشرط والمضيف
أولاً، عليك إعداد شرط لتحديد الطلبات الموجّهة إلى البوابة ومضيف لتوجيهها إلى Google.
أنشئ شرطًا جديدًا باستخدام الإعداد التالي:
- النوع:
Request - الاسم:
Google Tag Gateway Path(أو أي اسم تفضّله) - التطبيق إذا…:
req.url.path ~ "^/metrics"
- النوع:
أنشئ مضيفًا جديدًا باستخدام الإعدادات التالية:
- اسم المضيف/العنوان:
fps.goog
- اسم المضيف/العنوان:
اضبط المضيف الجديد باستخدام هذه الإعدادات الإضافية:
- انقر على إرفاق شرط واختَر الشرط الذي أنشأته في الخطوة 1.
- اضبط تجاهل المضيف على
fps.goog. - اترك الإعدادات الأخرى على الوضع التلقائي.
- انقر على تعديل لحفظ المضيف.
إضافة معرّف "علامة Google" وعناوين Geolocation
بعد ذلك، ستضيف مقتطفات VCL (لغة إعدادات Varnish) لإرفاق رقم تعريف "علامة Google" وبيانات الموقع الجغرافي للعميل. يجب إنشاء مقتطفَين منفصلَين، أحدهما لـ vcl_miss والآخر لـ vcl_pass، باستخدام الرمز نفسه تمامًا.
في خدمتك، انتقِل إلى مقتطفات VCL وأنشئ مقتطفًا يتضمّن الحقول التالية:
- الاسم:
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 = "latlog=" + client.geo.latitude + "," + client.geo.longitude + ";city=" + client.geo.city; }
- الاسم:
أنشِئ مقتطفًا آخر يتضمّن الحقول التالية:
- الاسم:
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 = "latlog=" + client.geo.latitude + "," + client.geo.longitude + ";city=" + client.geo.city; }
من المفترض أن يكون لديك الآن مقتطفان جديدان منفصلان. يضمن ذلك إضافة عناوين تحديد الموقع الجغرافي إلى أي طلب يجب جلبه من المضيف، سواء كان "خطأ في ذاكرة التخزين المؤقت" (
vcl_miss) أو "نجاح في ذاكرة التخزين المؤقت" (vcl_pass).- الاسم:
تفعيل عملية الإعداد الكاملة وإثبات ملكيتها
بعد إنشاء المضيف والشرط ومقتطفات VCL، يمكنك الآن تفعيل الإعداد الكامل واختباره.
- انقر على تفعيل لنشر جميع التغييرات الجديدة.
تحقَّق من الإعدادات من خلال إجراء الاختبارَين التاليَين في المتصفّح:
- الاختبار 1 (العلامة والتوجيه): انتقِل إلى
https://example.com/metrics/healthy - الاختبار 2 (الموقع الجغرافي): انتقِل إلى
https://example.com/metrics/?validate_geo=healthy
يجب أن تعرض كلتا الصفحتين
ok- الاختبار 1 (العلامة والتوجيه): انتقِل إلى
غير ذلك
لعرض علامتك في "بوابة علامات التتبّع من Google للمعلِنين"، عليك ضبط شبكة توصيل المحتوى (CDN) أو موازنة التحميل لتوجيه الطلبات إلى نقطة نهاية "بوابة علامات التتبّع من Google للمعلِنين".
- أضِف مصدرًا أو خلفية تشير إلى
G-12345.fps.goog. - تجاوز عنوان المضيف ليكون مساويًا
G-12345.fps.goog. السماح بإعادة توجيه جميع ملفات تعريف الارتباط وسلاسل طلب البحث - مرِّر معلومات الموقع الجغرافي للزائر من خلال تضمين أحد العناوين التالية:
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.
- أضِف قاعدة مسار
/metrics/*لتوجيه الزيارات إلى "بوابة علامات التتبّع من Google للمعلِنين". - اضبط المسار المحجوز ليكون له أولوية أعلى من القاعدة التلقائية.
- في المتصفّح، تأكَّد من عملية الإعداد من خلال الانتقال إلى:
https://example.com/metrics/healthy. يجب أن تعرض الصفحةok. تأكَّد من تضمين المعلومات الجغرافية من خلال الانتقال إلىhttps://example.com/metrics/?validate_geo=healthy. يجب أن يظهر في الصفحةok.
الخطوة 3: تعديل النصوص البرمجية على الموقع الإلكتروني لاستخدام "مسار القياس"
استبدِل النصوص البرمجية على كل صفحة من صفحات الموقع الإلكتروني بأحد الخيارَين التاليَين:
gtag.js
في أعلى القسم <head>، ابحث عن سطرَي البرنامج النصي اللذين يتضمّنان رقم تعريف
علامة Google:
<!-- Google tag (gtag.js) -->
<script async src="https://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 -->
اختبار إعدادات القياس
لاختبار إعدادات القياس، اضبط حاويتك على أن تحتوي على علامة واحدة على الأقل يتمّ تنشيطها.
- انتقِل إلى Tag Assistant وعايِن حاويتك.
- تنقَّل في موقعك الإلكتروني لتشغيل الأحداث.
ضمن الملخّص > الناتج > علامة التبويب النتائج المُرسَلة، تأكّد من توجيه النتائج إلى
/metrics.