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

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

  • بكسل الصورة
  • واجهة برمجة تطبيقات Fetch
  • 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. انقر على اسم العميل لعرض التفاصيل أو تعديلها.

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

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

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

  • معايير التفعيل: تحدّد معايير التفعيل متى يستجيب العميل للطلبات:

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

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

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

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

لاستخدام مَعلمات إضافية في علامات أخرى:

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

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

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

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

لا يتيح هذا الخيار جميع ميزات نقطة نهاية 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. احفظ إعدادات العميل وانشر الحاوية من جهة الخادم.

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

لإرسال بيانات Measurement Protocol إلى حاوية الخادم، استبدِل اسم المضيف 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، اضبط عملية تثبيت "إدارة العلامات من Google" من جانب الخادم باستخدام عميل Measurement Protocol:

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

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

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

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