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

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • معايير التفعيل: تحدّد معايير التفعيل الوقت الذي سيستجيب فيه العميل للطلبات:

    • بالنسبة إلى عملاء UA: مسارات Universal Analytics التلقائية: سيتم تفعيل العميل عندما تتضمّن مسارات الطلبات /collect و/r/collect ومسارات أخرى مشابهة تستخدمها ملفات JavaScript التي ترسل البيانات إلى "إحصاءات Google". يكون هذا الإعداد نشطًا تلقائيًا.

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

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

لجعل تطبيق 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 البرمجية من خلال الخادم