إرسال البيانات إلى إدارة العلامات من جانب الخادم

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

تتناول هذه المقالة كيفية تنفيذ ما يلي:

  • إرسال البيانات من موقع إلكتروني إلى حاوية من جهة الخادم
  • إرسال بيانات إضافية إلى حاوية خادم
  • تلقّي البيانات في حاويتك من جهة الخادم
  • إرسال البيانات من مصادر أخرى غير المواقع الإلكترونية

قبل البدء

يفترض هذا الدليل أنّ لديك ما يلي:

1. إرسال البيانات من موقع إلكتروني إلى حاويتك من جهة الخادم

يمكنك توجيه البيانات من خلال عملية تنفيذ من جهة الخادم باستخدام أداة "إدارة العلامات من Google" أو مقتطف gtag.js. اختَر خيار التنفيذ.

اختَر خيار التنفيذ.

اختياري: إرسال مَعلمات إضافية مع كل حدث

يمكنك إرسال نوعَين إضافيَين من المَعلمات الإضافية: مَعلمات على مستوى الإعداد ومَعلمات على مستوى الحدث. تؤثّر مَعلمات الإعدادات في طريقة عمل "علامة التتبّع من Google"، ولا يمكن ضبطها إلا على مستوى "علامة التتبّع من Google".

تحدّد مَعلمات الأحداث معلومات إضافية عن حدث معيّن ويمكن ضبطها لجميع الأحداث أو أحداث محدّدة أو أحداث page_view.

اختَر خيار التنفيذ.

اقتراحات الإعداد

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

  • بكسل الصورة
  • Fetch API
  • XHR
  • مشغّل الخدمات الذي يتم تشغيله في إطار iframe يتم تحميله من نطاق حاوية الخادم.

للتأكّد من توفّر جميع الطرق، يُرجى التحقّق مما يلي:

سياسة أمان المحتوى (CSP)

التوجيه المحتوى Purpose
img-src [SERVER_CONTAINER_URL] طلبات القياس
connect-src [SERVER_CONTAINER_URL] طلبات القياس
frame-src [SERVER_CONTAINER_URL] تنفيذ مشغّل الخدمات

بالإضافة إلى ذلك، يجب ألا تقيّد X-Frame-Options تحميل إطارات iframe من عنوان URL لحاوية الخادم.

يمكنك الرجوع إلى https://developers.google.com/tag-platform/security/guides/csp للاطّلاع على السياسات المحدّدة لكل منتج.

2. تلقّي البيانات في حاويتك من جهة الخادم

عند إرسال طلب HTTP إلى حاوية خادم، على العميل أن يطالب بهذا الطلب.

للاطّلاع على قائمة بالعملاء المتاحين، اتّبِع الخطوات التالية:

  1. فتح أداة "إدارة العلامات من Google"

  2. افتح حاوية الخادم.

  3. في شريط التنقّل على يمين الصفحة، انقر على العملاء. يتم تثبيت برنامج "إحصاءات Google‏ 4" مسبقًا على حاوية من جهة الخادم تلقائيًا.

  4. انقر على اسم العميل لعرض التفاصيل أو تعديلها.

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

في معظم الحالات، لن يحتاج العميل إلى إجراء أي تعديلات. ومع ذلك، قد تختلف حالة الاستخدام الخاصة بك وقد تحتاج إلى تعديل أحد الإعدادات التالية:

  • الأولوية: تحدّد ترتيب تشغيل البرامج. يتم تنفيذ الأرقام الأعلى أولاً، وسيصبح أول عميل يطابق الطلب الوارد هو العميل النشط لهذا الطلب.

  • معايير التفعيل: تحدّد معايير التفعيل الحالات التي يستجيب فيها البرنامج لطلباتك، وهي:

    • مسارات gtag.js التلقائية لأرقام تعريف معيّنة: استخدِم هذا الإعداد لتفعيل عرض JavaScript gtag.js من خلال عنوان URL لحاوية الخادم. عند تفعيل هذا العرض، سيتم تفعيل هذا البرنامج استجابةً للطلبات المقدَّمة إلى مسارات طلبات gtag.js التلقائية، مثل /gtag/js?id=TAG_ID. انقر على إضافة معرّف قياس لإضافة معرّف واحد أو أكثر لوجهة.

اختياري: تلقّي بيانات إضافية في أداة "إدارة العلامات من Google" من جهة الخادم

في حال إرسال مَعلمات إضافية، عليك إعداد برنامج إحصاءات Google‏ 4 في حاوية الخادم لتحليل المَعلمات الإضافية وإنشاء بيانات الأحداث منها.

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

لاستخدام مَعلمات إضافية في علامات أخرى، اتّبِع الخطوات التالية:

  1. في حاوية الخادم، انقر على المتغيّرات في شريط التنقّل الأيمن.
  2. أنشئ متغيّرًا جديدًا يحدّده المستخدِم.
  3. في إعدادات المتغيّر، اختَر نوع المتغيّر بيانات الحدث.
  4. في مسار المفتاح، أدخِل اسم المَعلمة.
  5. أدخِل اسمًا للمتغيّر، ثمّ انقر على حفظ.

يمكنك الآن استخدام مَعلمة الحدث في أي علامة أخرى ضمن حاوية الخادم.

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

يمكن استخدام Measurement Protocol من "إحصاءات Google" لتفعيل إمكانية وضع العلامات من جهة الخادم من مصادر مثل تطبيقات الأجهزة الجوّالة والتطبيقات التي تعمل من خادم إلى خادم. يتيح لك هذا الخيار إرسال الأحداث إلى حاويتك بتنسيق Measurement Protocol. ترسل الحاوية هذه الأحداث إلى "إحصاءات Google" باستخدام الآلية نفسها المستخدَمة في جميع أحداث SGTM الأخرى.

لا يتيح هذا الخيار استخدام جميع ميزات نقطة نهاية Measurement Protocol، مثل استخلاص المعلومات الجغرافية ومعلومات الجهاز من أحداث وضع العلامات.

تطبيقات الأجهزة الجوّالة

لإعداد تطبيق Android أو iOS لإرسال البيانات إلى حاوية الخادم، عليك إنشاء علامة صورة مخصّصة وضبطها لاستخدام Measurement Protocol باتّباع الخطوات التالية:

  1. في حاوية الأجهزة الجوّالة (Android أو iOS)، انقر على العلامات > جديد.
  2. في إعدادات العلامة، اختَر نوع العلامة صورة مخصّصة.
  3. اضبط قيمة عنوان URL للصورة على صورة بكسل في حاوية الخادم على المسار في عميل Measurement Protocol الذي حدّدته سابقًا. ألحِق أيّ مَعلمات Measurement Protocol مطلوبة بنهاية عنوان URL الخاص بالبكسل:
    https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. ألغِ اختيار تفعيل تنظيم ذاكرة التخزين المؤقت.
  5. احفظ العلامة وانشر الحاوية.
  6. في حاوية "الخادم"، انقر على العملاء > جديد.
  7. في إعدادات العميل، اختَر نوع عميل Measurement Protocol.
  8. اضبط مسار التفعيل على مسار نقطة نهاية جمع البيانات في تطبيقك.
  9. احفظ إعدادات العميل وانشر حاوية من جهة الخادم.

التطبيقات من خادم إلى خادم

لإرسال بيانات بروتوكول القياس إلى حاوية الخادم، استبدِل اسم المضيف www.google-analytics.com باسم نطاق حاوية الخادم. على سبيل المثال:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

لتلقّي زيارات Measurement Protocol، اضبط عملية تثبيت Tag Manager من جهة الخادم باستخدام عميل Measurement Protocol:

  1. في حاوية "الخادم"، انقر على العملاء > جديد.
  2. في إعدادات العميل، اختَر نوع عميل Measurement Protocol.
  3. اضبط مسار التفعيل على مسار نقطة نهاية الخادم.
  4. احفظ إعدادات العميل وانشر الحاوية.

الخطوات التالية

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

تحميل نصوص Google البرمجية من خلال الخادم