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

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

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

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

  1. يجب أن يكون لديك حساب على GCP. إذا لم يكن لديك حساب، أنشئ حسابًا جديدًا على 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 بسلسلة إعدادات الحاوية من أداة "إدارة العلامات من Google". قد يكون هذا الحقل مملوءًا إذا اتّبعت خيارات سطر الأوامر لتوفير خادم المعاينة ووضع العلامات.
  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، تعرض نموذجًا لمعرّف حاوية في أداة "إدارة العلامات من Google".
  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:
    لقطة شاشة من "مستكشف السجلات" في GCP تعرض نماذج سجلات

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

  1. في Google Cloud Platform، افتح Logs Router. تأكَّد من أنّك في المشروع الذي يتطابق مع رقم تعريف الحاوية:
    لقطة شاشة لأداة اختيار مشاريع GCP، تعرض نموذجًا لمعرّف حاوية في أداة "إدارة العلامات من Google".
  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"، انقر على الزرّ معاينة. إذا تم تحميل صفحة المعاينة، يعني ذلك أنّه تم إعداد كل شيء بشكل صحيح.

معاينة عناوين 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. في "الملخّص"، اختَر علامة التبويب وحدة التحكّم وتأكَّد من عدم ظهور أي رسائل تطلب منك تعديل خادم وضع العلامات.

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