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

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

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

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

قبل البدء

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

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

يمكنك توجيه البيانات من خلال عملية تنفيذ من جهة الخادم باستخدام أداة "إدارة العلامات من Google" أو علامة 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". يكون هذا الخيار نشطًا بشكل تلقائي.

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

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

في حال إرسال مَعلمات إضافية، عليك إعداد برنامج إحصاءات 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، يجب ضبط عملية تثبيت أداة "إدارة العلامات من جهة الخادم" باستخدام برنامج Measurement Protocol:

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

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

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

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