إعداد وضع الطرف الأول

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

نظرة عامة

ملاحظة: وضع الطرف الأول في وضع تجريبي. يمكن أن يساعد إعداد "وضع الطرف الأول" في تحسين أداء إعداد علامتك، ما يؤدي إلى استرداد إشارات القياس المفقودة بطريقة مصممة بالتوافق مع معايير الخصوصية. إذا كان لديك سؤال أو مشكلة في الإعداد، يُرجى التواصل معنا على [e-mail].

يتيح لك وضع الطرف الأول نشر علامة Google باستخدام البنية الأساسية للطرف الأول والمستضافة على نطاق موقعك الإلكتروني (مثل example.com). وتقع هذه البنية الأساسية بين موقعك الإلكتروني وخدمات Google، ما يجعل البنية الأساسية للطرف الأول التكنولوجيا الوحيدة للتفاعل مباشرةً مع مستخدمي موقعك الإلكتروني. يضيف "وضع الطرف الأول" طبقة من أمان البيانات ويفعِّل عناصر تحكُّم إضافية في خصوصية البيانات، مثل التشويش الكامل لعناوين IP، بدون التأثير في القياس. سيساعدك الإعداد الوارد في هذا المستند في استرداد إشارات قياس أكثر بنسبة% X على موقعك الإلكتروني. يمكنك إعداد هذه الخدمة باستخدام شبكة توصيل المحتوى (CDN) الحالية أو جهاز موازنة الحمل أو خادم الويب، لتفعيل وضع الطرف الأول.

في عمليات إعداد علامة Google العادية، تطلب صفحتك على الويب علامة Google من نطاق Google (مثل www.googletagmanager.com). عند تنشيط العلامة، تُرسِل طلبات القياس مباشرةً إلى منتج Google. في وضع الطرف الأول، يحمّل موقعك الإلكتروني علامة Google من نطاق الطرف الأول (مثل example.com). عند تنشيط العلامة، يتم إرسال طلبات القياس إلى نطاق الطرف الأول، حيث تتم إعادة توجيهها إلى منتج Google ذي الصلة.

ستتمكّن من مواصلة القياس الكامل عند التبديل من إعداد علامة Google العادية إلى ضبط وضع الطرف الأول.

يمثّل هذا المخطّط البياني تدفق المعلومات في وضع الطرف الأول:

قبل البدء

يفترض هذا الدليل أنّه سبق أن تم إعداد موقعك الإلكتروني باستخدام:

• علامة Google أو حاوية "إدارة العلامات من Google"
• شبكة توصيل المحتوى (CDN) أو جهاز موازنة الحمل الذي يمكنه إعادة توجيه الطلبات إلى نقاط نهاية خارجية

1- اختيار مسار عرض العلامة

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

اختَر أي مسار تريده لإعداد وضع الطرف الأول. تشمل أمثلة المسارات التي قد ترغب في استخدامها: /metrics، أو /securemetric، أو /analytics، أو يُفضل أن تكون سلسلة أبجدية رقمية عشوائية لا تستخدمها بالفعل على موقعك الإلكتروني.

املأ ما يلي لملء الأمثلة في هذا المستند.

Your domain: example.com
Google tag ID: GTM-123456
Tag serving path: /metrics

تنبيه: يعيد هذا الإعداد توجيه جميع الزيارات باستخدام المسار الذي تم اختياره. لتجنّب التأثير في موقعك الإلكتروني، اختَر مسارًا غير مستخدم.

‫2. توجيه حركة المرور

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

Google Cloud

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

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

1. فتح جهاز موازنة حمل Google Cloud Platform

2. في جهاز موازنة الحمل، افتح القسم ضبط الخلفية. أنشِئ خدمة خلفية جديدة.

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

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

     اسم العنوان	قيمة العنوان
     Host	GTM-123456.fps.goog
     X-Gclb-Country	{client_region}
     X-Gclb-Region	{client_region_subdivision}

   • راجِع الإعدادات الأخرى. ولست بحاجة إلى استخدام 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

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

إنشاء إدخال CNAME

ملاحظة: لن تستخدم العلامات إدخال CNAME هذا، بل تستخدمه Cloudflare لتوجيه الطلبات داخليًا.

اختَر نطاقًا فرعيًا لحجزه لإدخال CNAME. املأ ما يلي لملء الأمثلة في جميع أنحاء هذا المستند. لا يتم مطلقًا الكشف عن سجلّ CNAME هذا خارج إعدادات Cloudflare، لذا يكون الاسم عشوائيًا.

CNAME subdomain: fps

1. في علامة التبويب "نظام أسماء النطاقات"، افتح قسم السجلات.
2. أضِف سجلّاً جديدًا بالإعدادات التالية:
   • اضبط النوع على CNAME.
   • اضبط الاسم على fps.
   • اضبط الهدف على GTM-123456.fps.goog.
3. احفظ سجلّ CNAME.

إنشاء قاعدة المصدر

1. في علامة التبويب "القواعد"، افتح قواعد المصدر وأنشئ قاعدة.
2. أدخِل اسم قاعدة، مثل Route measurement.
3. طابِق الطلبات الواردة استنادًا إلى تعبير فلتر مخصّص وانقر على تعديل التعبير.
4. الصق التعبير التالي في أداة الإنشاء: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. تعديل عنوان المضيف إلى إعادة الكتابة إلى... GTM-123456.fps.goog.
6. عدِّل سجلّ نظام أسماء النطاقات إلى تجاوز إلى... fps.example.com.
7. احفظ قاعدة المصدر.
8. وإذا كانت هناك قواعد مصدر أخرى، يمكنك زيادة موضع القاعدة التي تم إنشاؤها حديثًا ليتم تنفيذها بعد أي مسارات أخرى لأحرف البدل.
9. في المتصفِّح، تأكَّد من صحة الإعداد من خلال الانتقال إلى: https://example.com/metrics/healthy. من المفترض أن تظهر على الصفحة النص ok.

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

1. في علامة التبويب "القواعد"، افتح تحويل القواعد.
2. أنشئ قاعدة تعديل عنوان الطلب.
3. طبِّق القاعدة على جميع الطلبات الواردة.
4. تعديل عنوان الطلب باستخدام الإعدادات التالية:
   • اضبط عامل التشغيل على ضبط الديناميكي.
   • اضبط اسم العنوان على X-CfIpCountryRegion.
   • اضبط القيمة على ip.src.subdivision_1_iso_code.
5. نشر قاعدة التحويل.
6. الانتظار بضع دقائق حتى يتم نشر القاعدة. في المتصفِّح، تحقَّق من الإعداد من خلال الانتقال إلى: https://example.com/metrics/?validate_geo=healthy. من المفترض أن تظهر على الصفحة ok.

(اختياري) إزالة عناوين IP للزائرين

لا يتطلب وضع الطرف الأول عنوان IP للزائر حتى يعمل بشكل صحيح. يمكنك إزالة جميع عناوين IP للزوّار باستخدام إزالة عناوين IP للزوّار الإحالات الناجحة المُدارة.

غير ذلك

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

1. أضِف مصدرًا أو خلفية تشير إلى GTM-123456.fps.goog.
2. تجاهُل عنوان المضيف ليصبح مساويًا لـ GTM-123456.fps.goog. اسمح بإعادة توجيه جميع ملفات تعريف الارتباط وسلاسل الاستعلام.
3. أضِف قاعدة مسار لـ /metrics/* من أجل توجيه الزيارات إلى وضع الطرف الأول.
4. يمكنك ضبط المسار المحجوز للحصول على أولوية أعلى من القاعدة التلقائية.
5. في المتصفِّح، تحقَّق من الإعداد من خلال الانتقال إلى: https://example.com/metrics/healthy. من المفترض أن تظهر على الصفحة النص ok.

الخطوة 3: تعديل النصوص البرمجية على الموقع الإلكتروني لاستخدام مسار القياس

استبدل النصوص البرمجية في كل صفحة من صفحات الموقع بأحد النصوص التالية:

gtag.js

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

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GTM-123456"></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 -->

الخطوة 4: اختبار إعدادات القياس

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

1. انتقِل إلى Tag Assistant وعايِن حاويتك. تنقّل في موقعك الإلكتروني لتشغيل العلامات.

2. في علامة التبويب الملخص > الإخراج > النتائج المرسلة، تحقق من توجيه النتائج إلى /metrics.

   

الخطوة 5: التعقيبات

قدِّم ملاحظات حول وضع الطرف الأول من خلال نموذج الملاحظات.