إعداد النطاق الخاص

هذه المقالة موجّهة للمطوّرين الذين يريدون استضافة وضع العلامات من جهة الخادم في سياق الطرف الأول نفسه المستخدَم في موقعهم الإلكتروني. إنّ عرض الإعلانات من المصدر نفسه هو من أفضل الممارسات التي تتيح لك الاستفادة من مزايا الأمان والاستمرارية لملفّات تعريف الارتباط التي يضبطها السيرفر. تنطبق التعليمات أدناه على إعداد عرض الإعلانات من المصدر نفسه بغض النظر عن علامة Google التي تم نشرها على موقعك الإلكتروني (gtag.js أو gtm.js).

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

يوضّح الجدول التالي كيفية استضافة خادم وضع العلامات عندما يكون الموقع الإلكتروني الرئيسي مستضافًا على www.example.com:

المصدر نفسه (أفضل ممارسة) النطاق الفرعي النطاق التلقائي
مثال لعنوان URL https://www.example.com/metrics https://metrics.example.com https://metrics.run.app
الوصول إلى ملفات تعريف الارتباط التي يضبطها الخادم الاستفادة الكاملة من مزايا الأمان والمتانة الاستفادة الكاملة من مزايا الأمان والمتانة لا شيء. يمكن ضبط ملفات تعريف ارتباط JavaScript فقط.
درجة تعقيد الإعداد اضبط شبكة توصيل المحتوى أو أداة موازنة التحميل لإعادة توجيه الطلبات. قد تحتاج إلى تعديل إدخالات نظام أسماء النطاقات. تعديل إدخالات نظام أسماء النطاقات تأتي مُعدَّة مسبقًا.

اختَر خيار التنفيذ للبدء.

المتطلبات الأساسية

يفترض هذا الدليل أنّك تستوفي الشروط التالية:

  • إعداد حاوية خادم في إدارة العلامات من Google
  • إعداد خادم وضع العلامات
  • شبكة توصيل المحتوى (CDN) أو جهاز موازنة الحمل الذي يمكنه إعادة توجيه الطلبات
  • إذا كنت تستخدم App Engine: يجب أن يعمل خادم وضع العلامات بالإصدار 2.2.0 أو إصدار أحدث. لضمان توافق خادم وضع العلامات مع الإصدارات المستقبلية، عليك نقل البيانات إلى Cloud Run.

ضبط النطاق المخصّص

يمكنك إعداد حاوية الخادم لتشغيلها على مسار من النطاق نفسه الذي يقع فيه موقعك الإلكتروني. على سبيل المثال، إذا كان موقعك الإلكتروني يعرض زيارات الويب على www.example.com، احجز مسارًا مثل www.example.com/metrics لحاوية الخادم.

مخطّط بياني لعملية وضع العلامات من جهة الخادم التي تم إعدادها على المصدر نفسه

1. اختَر مسارًا لنطاقك لاستخدامه مع خادم وضع العلامات.

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

تشمل أمثلة المسارات التي قد تريد استخدامها ما يلي: /collect و/metrics /data

يُرجى تدوين سلسلة المسار هذه. ستستخدمه في جميع الخطوات اللاحقة بدلاً من /metrics حيثما يظهر: /metrics

2. توجيه الزيارات إلى خادم وضع العلامات

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

  1. أضِف مصدرًا أو خلفية تشير إلى موقعك الإلكتروني.
  2. استبدِل عنوان Host باسم مضيف الموقع الإلكتروني، مثل example.com
  3. السماح بإعادة توجيه جميع ملفات تعريف الارتباط وسلاسل طلبات البحث إذا لم يكن لدى المنصة هذا الخيار، من المرجّح أن يتم إجراء ذلك تلقائيًا.
  4. أضِف مصدرًا أو خلفية أخرى تشير إلى خادم وضع العلامات. يمكن أن يكون النطاق الذي يوفّره مقدّم خدمات السحابة الإلكترونية، مثل metrics.run.app
  5. استبدِل عنوان Host ليكون مساويًا للنطاق المحدّد أعلاه. السماح بإعادة توجيه كل ملفات تعريف الارتباط وسلاسل طلبات البحث
  6. أضِف قاعدة مسار، مثل /metrics/*، لتوجيه الزيارات إلى الخادم المخصّص لوضع العلامات.
  7. اضبط مسار وضع العلامات من جهة الخادم المحجوز ليكون له أولوية أعلى من القاعدة التلقائية.
  8. عدِّل نظام أسماء النطاقات لتوجيهه إلى شبكة توصيل المحتوى (CDN) أو أداة موازنة التحميل إذا لم يسبق لك إجراء ذلك. قد يستغرق نشر تعديلات نظام أسماء النطاقات بعض الوقت.
  9. انتقِل إلى نقطة نهاية /healthy في النطاق الذي أعددته للتو، مثل https://example.com/metrics/healthy. من المفترض أن يظهر لك رمز ok.

3- تعديل عنوان URL للخادم في أداة "إدارة العلامات من Google"

عليك تعديل إعدادات حاوية الخادم لكي تتمكّن من تحديد بادئة المسار ومعالجة الطلبات بشكل صحيح.

اتّبِع الخطوات التالية لتعديل نقطة النهاية الجديدة:

  1. افتح "إدارة العلامات من Google".
  2. افتح حاوية الخادم التي تم إعدادها على المصدر نفسه للموقع الإلكتروني.
  3. ضمن علامة التبويب المشرف > إعدادات الحاوية، أزِل جميع عناوين URL السابقة. هذا الإجراء ضروري لأنّ جميع عناوين URL لحاويات الخادم يجب أن تتشارك المسار نفسه.
  4. انقر على إضافة عنوان URL وأدخِل عنوان URL بما في ذلك بادئة المسار.
  5. احفظ الإعدادات ثم ارجع إلى مساحة العمل.
  6. انقر على الزر معاينة لبدء جلسة تصحيح أخطاء جديدة وإرسال طلب في علامة تبويب منفصلة.
  7. انقر على الطلب الذي تم إرساله. تأكَّد من أنّ العميل قد طالب بالطلب القادم.

تحديد المشاكل الشائعة وحلّها

  1. لا تعرض المعاينة الطلبات الواردة
    1. انتقِل إلى مستكشف سجلّات مشروعك على السحابة الإلكترونية. تأكَّد من أنّ عملية نشر وضع العلامات من جهة الخادم تتلقّى زيارات. إذا لم يكن الأمر كذلك، اتّبِع التعليمات الواردة في الخطوة 1.
    2. تأكَّد من أنّ شبكة توصيل المحتوى (CDN) أو أداة موازنة التحميل تعيد توجيه ملفات تعريف الارتباط.
    3. تأكَّد من توفّر خادم معاينة واحد ومن ضبط PREVIEW_SERVER_URL على خوادم وضع العلامات.
    4. تأكَّد من أنّ خادم المعاينة قيد التشغيل من خلال الانتقال إلى الرمز PREVIEW_SERVER_URL + /healthy. من المفترض أن يظهر لك رمز ok.
  2. العملاء لا يطالبون بالطلبات: عدِّل عنوان URL في إعدادات الحاوية لاستخدام المسار المحجوز. إذا لم يحتوي عنوان URL على المسار أو إذا كانا مختلفَين، لن تعمل التطبيقات بشكل صحيح.