إعداد وضع العلامات من جهة الخادم باستخدام Cloud Run

يوضّح هذا الدليل كيفية تنفيذ ما يلي:

  • توفير خادم معاينة لتفعيل ميزة المعاينة للحاوية
  • توفير خادم وضع علامات للتعامل مع الزيارات المباشرة
  • زيادة أو تقليل عدد الخوادم التي تشغّل حاوية Google Tag Manager
  • احرص على تحديث إصدار خادم وضع العلامات بعد توفير الخادم.

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

  1. يجب أن يكون لديك حساب على Google Cloud Platform. إذا لم يكن لديك حساب، يمكنك إنشاء حساب جديد على GCP.
  2. يجب أن يكون لديك حساب فوترة على Google Cloud Platform. إذا لم يكن لديك حساب، يمكنك إنشاء حساب فوترة على Google Cloud Platform (يتطلّب دور "منشئ حساب الفوترة").
  3. يجب أن يكون لديك دور "منشئ مشروع" ودور "مستخدم حساب الفوترة". مزيد من المعلومات حول إضافة أدوار

توفير خادم معاينة ووضع علامات

يمكنك توفير خدمة Cloud Run تلقائيًا في "إدارة العلامات من Google" أو يدويًا في Google Cloud.

تعديل إعدادات الخدمة

لتغيير إعدادات الخدمة، اتّبِع الخطوات التالية:

  1. افتح Cloud Run.
  2. اختَر الخدمة التي تريد تعديلها.
  3. انقر على تعديل ونشر نسخة جديدة.
  4. أدخِل التغييرات وانقر على نشر.

تكلفة Cloud Run

في إعدادات Cloud Run هذه، تبلغ تكلفة كل خادم 45 دولارًا أمريكيًا شهريًا تقريبًا. كل خادم هو مثيل Cloud Run يتضمّن وحدة معالجة مركزية افتراضية واحدة وذاكرة بسعة 0.5 غيغابايت باستخدام نموذج التسعير الذي يتيح تخصيص وحدة المعالجة المركزية دائمًا.

ننصحك بتشغيل مثيلَين على الأقل للحدّ من خطر فقدان البيانات في حال حدوث انقطاع في الخادم. ومع ذلك، يمكنك اختيار تشغيل عدد أقل (أو أكثر) من الخوادم. نتوقّع أن تتمكّن ميزة التوسيع التلقائي لنطاق الخوادم من 2 إلى 10 من معالجة ما بين 35 و350 طلبًا في الثانية، مع العلم أنّ الأداء سيختلف حسب عدد العلامات ووظائفها.

سيزيد Cloud Run عدد المثيلات أو يقلّله بشكل ديناميكي وفقًا للحِمل. إعداد max-instances هو أسوأ سيناريو للمبلغ الذي ستحتاج إلى دفعه مقابل الموارد. ولن توفّر Cloud Run هذا العدد الكبير من المثيلات إلا عند الضرورة.

تقدير تكلفة Cloud Run

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

اختياري: نقل البيانات من App Engine

إذا سبق لك إنشاء عملية نشر في App Engine وتأكّدت من أنّها لم تعُد تتلقّى أي زيارات، عليك إيقاف تطبيق App Engine لتجنُّب تحصيل رسوم غير متوقّعة.

اختياري: النشر في مناطق متعدّدة

إذا كان موقعك الإلكتروني متاحًا على مستوى العالم أو إذا كنت تريد توفير التكرار في الخدمة، يمكنك نشر خوادم وضع العلامات في مناطق متعدّدة.

قبل البدء:

  1. إنشاء جهاز موازنة حمل
  2. دوِّن BACKEND_NAME الذي اخترته.

لإضافة المزيد من المناطق إلى عملية النشر، اتّبِع الخطوات التالية:

  1. استبدِل REGION بالمنطقة التي تم نشر خادم المعاينة فيها. قد تكون هذه الحقول مملوءة مسبقًا إذا اتّبعت خيارات سطر الأوامر لتوفير خادم المعاينة ووضع العلامات.
  2. استبدِل CONTAINER_CONFIG بسلسلة إعدادات الحاوية من أداة "إدارة العلامات". قد يكون هذا الحقل مملوءًا إذا اتّبعت خيارات سطر الأوامر لتوفير خادم المعاينة ووضع العلامات.
  3. استبدِل NEW_REGION بالمنطقة الجديدة التي تريد نشر خادم وضع العلامات فيها.
  4. استبدِل BACKEND_NAME بالاسم الذي اخترته أثناء توفير جهاز موازنة الحمل.
  5. اختياري: لإضافة منطقة أخرى، استبدِل المتغيّر NEW_REGION وأعِد تشغيل مقتطف الرمز.
    gcloud run deploy "server-side-tagging" \
    --region NEW_REGION \
    --image gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable \
    --platform managed \
    --ingress all \
    --min-instances 2 \
    --max-instances 10 \
    --timeout 60 \
    --allow-unauthenticated \
    --no-cpu-throttling \
    --update-env-vars PREVIEW_SERVER_URL="$(
      gcloud run services describe server-side-tagging-preview \--region "REGION" \
      --format="value(status.url)")",CONTAINER_CONFIG="CONTAINER_CONFIG" && \

    gcloud compute network-endpoint-groups create server-side-tagging-neg \
    --region=NEW_REGION \
    --network-endpoint-type=SERVERLESS \
    --cloud-run-service="server-side-tagging" && \

    gcloud compute backend-services add-backend --global "BACKEND_NAME" \
    --network-endpoint-group-region=NEW_REGION \
    --network-endpoint-group=server-side-tagging-neg

اختياري: إيقاف التسجيل

تسجيل الطلبات

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

لإيقاف تسجيل الطلبات، اتّبِع الخطوات التالية:

  1. في Google Cloud Platform، افتح Logs Router. تأكَّد من أنّك في المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشروع GCP، تعرض نموذجًا لمعرّف حاوية في أداة "إدارة العلامات".
  2. بالنسبة إلى النوع: حزمة Cloud Logging، الاسم: سطر _Default، انقر على القائمة الكاملة، ثم انقر على تعديل المخزَن.
  3. ضمن وجهة الحوض، اختَر حزمة السجلّات _Default.

  4. ضمن اختيار السجلات المطلوب تضمينها في المستودع، أضِف سطرًا جديدًا. أدخِل القاعدة التالية إلى فلتر الإدراج الحالي:

    NOT LOG_ID("run.googleapis.com/requests")

  5. لإيقاف التسجيل من موازن التحميل أيضًا، أضِف سطرًا جديدًا وأدخِل القاعدة التالية إلى فلتر التضمين الحالي:

    NOT LOG_ID("requests")

  6. انقر على تعديل مخزَن لتطبيق التغييرات. سيتم الآن استبعاد الطلبات من التسجيل.

  7. تأكَّد من عدم ظهور أي طلبات جديدة في سجلّات Logs Explorer.

تسجيل البيانات في وحدة التحكّم

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

تحديد سجلّات وحدة التحكّم غير المرغوب فيها:

  1. في Google Cloud Platform، افتح مستكشف السجلات.

  2. ابحث عن أي رسائل سجلّ غير مرغوب فيها مصدرها علاماتك. على سبيل المثال:

    قد ترسل العلامة السجلات التالية:

    const logToConsole = require('logToConsole');

logToConsole('Custom message: ' + data.param1);
logToConsole('An important message to keep around!');
data.gtmOnSuccess()

    ابحث عن رسائل السجلّ المناسبة في الحقل textPayload:
    لقطة شاشة من Logs Explorer في "منصة Google Cloud" تعرض نماذج من السجلّات

لإيقاف رسالة سجلّ وحدة التحكّم، اتّبِع الخطوات التالية:

  1. في Google Cloud Platform، افتح Logs Router. تأكَّد من أنّك في المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشروع GCP، تعرض رقم تعريف نموذج حاوية في Tag Manager.
  2. بالنسبة إلى النوع: حزمة Cloud Logging، الاسم: سطر _Default، انقر على القائمة الكاملة، ثم انقر على تعديل المخزَن.
  3. ضمن وجهة الحوض، اختَر حزمة السجلّات _Default.

  4. ضمن اختيار السجلات المطلوب تضمينها في المستودع، أضِف سطرًا جديدًا. أدخِل القاعدة التالية في فلتر الإدراج الحالي:

    NOT textPayload:"Custom message:"

    بالنسبة إلى سجلّات وحدة التحكّم، استبدِل النص Custom message: بسلسلة فرعية من سجلّ وحدة التحكّم الذي تريد إيقافه. للحصول على فلاتر أكثر تفصيلاً، استخدِم لغة طلبات البحث في التسجيل.

  5. انقر على تعديل مخزَن لتطبيق التغييرات. يجب استبعاد الرسالة المطابِقة logToConsole من التسجيل.

  6. تأكَّد من عدم ظهور أي رسائل سجلّ وحدة تحكّم جديدة في مستكشف السجلات.

2. ربط عملية النشر بنطاقك الخاص

إعداد نطاق مخصّص لاستخدام نطاق آخر غير العنوان التلقائي الذي يوفّره Cloud Run

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

بعد إعداد خادم، عليك التأكّد من أنّ أداة "إدارة العلامات من Google" تعرف أنّه يجب استخدام خادمك.

  1. افتح Google Tag Manager.

  2. انقر على حاوية الخادم التي تريد توجيهها إلى خادم وضع العلامات.

  3. افتح إعدادات حاوية الخادم في علامة التبويب المشرف > إعدادات الحاوية.

  4. انقر على إضافة عنوان URL والصِق عنوان URL الخاص بالخادم.

  5. احفظ التغييرات وارجع إلى مساحة عملك.

4. التحقّق من الصحة

بعد إعداد خادم وضع العلامات، تأكَّد من أنّه يعمل على النحو المطلوب.

التحقّق من واجهة المستخدم

في مساحة العمل بحسابك على أداة Google Tag Manager، انقر على الزرّ معاينة. إذا تم تحميل صفحة المعاينة، يعني ذلك أنّه تم إعداد كل شيء بشكل صحيح.

التحقّق من واجهة برمجة التطبيقات

يمكنك أيضًا التأكّد من أنّ الخادم يستجيب لعمليات التحقّق من السلامة باستخدام واجهة برمجة التطبيقات الخاصة به:

  1. انسخ عنوان URL لحاوية الخادم من المشرف > إعدادات الحاوية.
  2. افتح علامة تبويب جديدة في المتصفّح.
  3. الصِق عنوان URL وأضِف /healthy إلى المسار. على سبيل المثال: https://www.example.com/metrics/healthy
  4. إذا كانت خدمتك تعمل، من المفترض أن يظهر النص ok على الصفحة.

إذا كانت طلبات منتج معيّن غير متوفّرة، تأكَّد من أنّه يتم تشغيل حدث. يؤدي الأمر config إلى بدء تشغيل المنتج، ولكن لا يتم عادةً نقل البيانات إلا عند استدعاء event.

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

معاينة عناوين URL متعددة

إذا ربطت عدّة نطاقات بخادم وضع علامات واحد، تأكَّد من إضافة كل عنوان URL إلى إعدادات الحاوية.

إذا قدّمت عناوين URL متعددة، يجب أن تتطابق جميع المسارات (السلسلة التي تلي اسم النطاق).

الأعمال لا يعمل
عنوان URL 1: example.com/abc
عنوان URL 2: example2.com/abc		 عنوان URL 1: example.com/abc
عنوان URL 2: example2.com/def

في حال إضافة عناوين URL متعدّدة، سيظهر رمز بجانب الزر معاينة يتيح لك اختيار عنوان URL الذي تريد معاينته.

تعديل إصدار خادم وضع العلامات

تحتوي تحديثات خادم وضع العلامات الجديدة على إصلاحات للثغرات الأمنية وميزات جديدة. ننصحك بتحديث خادم وضع العلامات على الأقل لكل إصدار رئيسي (مثل الترقية من الإصدار 1.x.x إلى 2.x.x) عندما تُعلمك أداة "إدارة العلامات من Google" بضرورة التحديث.

لتعديل خادم وضع العلامات، عليك نشر نسخة معدَّلة جديدة باستخدام الإعدادات نفسها التي استخدمتها سابقًا.

  1. افتح Cloud Run.
  2. اختَر الخدمة التي تريد تعديلها.
  3. انقر على تعديل ونشر نسخة جديدة.
  4. تأكَّد من ضبط عنوان URL لصورة الحاوية على gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable وانقر على نشر.

للتأكّد من نجاح عملية التعديل، اتّبِع الخطوات التالية:

  1. في حاوية الخادم، انقر على الزر معاينة لبدء جلسة تصحيح أخطاء جديدة وإرسال طلب في علامة تبويب منفصلة.
  2. في "الملخّص"، اختَر علامة التبويب وحدة التحكّم وتأكَّد من عدم ظهور أي رسائل تطلب منك تعديل خادم وضع العلامات.

قد تعرض Tag Manager رسائل تطلب منك تعديل خادم وضع العلامات لمدة تصل إلى يوم واحد بعد تعديل الخادم بنجاح. ومع ذلك، ستعرض صفحة المعاينة رسالة حديثة بشأن إصدار خادم وضع العلامات.