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

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

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

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

قبل البدء

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

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

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

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

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

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

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

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

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

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

للاطّلاع على قائمة العملاء المتاحين:

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

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

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

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

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

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

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

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

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

    • مسارات 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 من خلال خادمي