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

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

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

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

قبل البدء

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

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

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

يُرجى اختيار خيار التنفيذ.

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

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

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

يُرجى تحديد خيار التنفيذ المطلوب.

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. في Key Path، أدخِل اسم المَعلمة.
  5. أدخِل اسمًا للمتغيّر ثمّ انقر على حفظ.

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

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

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

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

لجعل تطبيق 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. في إعدادات العميل، اختَر نوع العميل لنظام قياس الأداء من Google.
  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. في إعدادات العميل، اختَر نوع العميل لنظام قياس الأداء من Google.
  3. اضبط مسار التفعيل على مسار نقطة نهاية الخادم.
  4. احفظ إعدادات العميل وانشر الحاوية.

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

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

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