إرسال أحداث الويب إلى "إحصاءات Google 4" باستخدام Measurement Protocol

1. مقدمة

تاريخ آخر تعديل: 2019-04-30

ما ستنشئه

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

ما ستتعلمه

• خطوات إرسال الطلب الأول عبر Measurement Protocol
• فهم المعلَمات اللازمة لإرسال الطلب
• إرسال طلب تجريبي والتحقق من صلاحيته
• إنشاء نص برمجي نموذجي في Python لإجراء المكالمة

المتطلبات

• موقع إلكتروني أو صفحة ويب
• أي بيئة تطوير متكاملة لإجراء تغييرات
• حساب "إحصاءات Google‏ 4"
• اختياري: بيئة تطوير Python (أو Colab)

2. جمع الحقول الإلزامية

إنشاء سرّ واجهة برمجة التطبيقات في "إحصاءات Google‏ 4"

انتقِل إلى "إحصاءات Google‏ 4" وأنشِئ مفتاحًا سرّيًا جديدًا لواجهة برمجة التطبيقات من خلال الانتقال إلى المشرف > مصادر البيانات > اختيار مصدر بياناتك > Measurement Protocol > إنشاء.

يمكنك تقديم أي اسم مستعار، وسيتم عرض قيمة المفتاح السرّي التي يمكنك استخدامها في مكالمتك

جمع client_id

يمكنك استخدام أيّ من الطرق أدناه لجمع client_id.

1. الجمع من خلال علامة الموقع الشاملة

يتم توضيح كلّ منهما بالتفصيل أدناه

الجمع من خلال علامة الموقع الشاملة

يمكنك استرداد client_id من خلال موقعك الإلكتروني باستخدام :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

في ما يلي المزيد من الروابط حسب البنية الأساسية التي تستخدمها

• gtag.js(‘get')

3- إنشاء المكالمة

يمكنك إنشاء نموذج لطلب باستخدام أداة إنشاء الأحداث في "إحصاءات Google‏ 4". (يتطلّب ذلك تسجيل الدخول وتفعيل ملفّات تعريف الارتباط). احرص على ضبط زر التبديل على "gtag.js"

يجب ملء الحقول التالية

• api_secret - تم إنشاؤه سابقًا في "إحصاءات Google‏ 4"
• ‫measurement_id: للحصول على هذا المعرّف، يمكنك الانتقال إلى "المشرف" > "مصادر البيانات" > اختيار مصدر البيانات . يجب أن يظهر على النحو التالي

• client_id: سبق أن استرجعت هذه القيمة
• ‫user_id ليس حقلًا إلزاميًا. يمكنك ترك هذا الحقل فارغًا في الوقت الحالي
• الفئة: غيِّر هذه القيمة إلى "مخصّص" من القائمة المنسدلة، وأدخِل أي اسم حدث من اختيارك (لا تستخدِم أي حدث مجمَّع تلقائيًا). نستخدم هنا "test_from_codelab"

يمكنك أيضًا اختيار تقديم مَعلمات الأحداث و/أو خصائص المستخدِمين من خلال النقر على الأزرار أدناه

بعد ملء كل المعلومات، من المفترض أن يظهر لك ما يلي، مع زر "تأكيد الحدث"

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

يمكنك الآن النقر على الزر، وسيؤدي ذلك إلى إرسال حدث تجريبي إلى "إحصاءات Google‏ 4".

4. التحقّق من صحة الأحداث في "إحصاءات Google‏ 4"

بعد إرسال الحدث، يمكنك الانتقال إلى حسابك على "إحصاءات Google‏ 4" والتحقّق من تقرير "الوقت الفعلي". من المفترض أن يظهر لك الحدث

قد يستغرق ظهور الأحداث في علامة التبويب الخاصة بإعداد تقارير الأحداث الفعلية حوالي 24 ساعة من ظهورها في "العرض في الوقت الفعلي"، لذا لا داعي للقلق إذا لم تظهر في تقارير الأحداث العادية على الفور.

5- إنشاء نص برمجي بلغة Python

بعد أن جرّبت ذلك، يمكنك فحص طلب البيانات من واجهة برمجة التطبيقات وحِزمة بيانات الحدث لإنشاء بنية مشابهة في Python (أو أي لغة تختارها) يمكنها إجراء هذا الطلب. يمكنك بعد ذلك جدولة هذا التقرير بمعدّل التكرار الذي تريده وتفعيله. في هذا الجزء، يمكنك استخدام أي بيئة تطوير متكاملة (IDE) من اختيارك تتوافق مع Python أو استخدام ورقة ملاحظات Colab التي لا تتطلب أي تثبيت على جهازك.

بالرجوع إلى "أداة إنشاء الأحداث" في "إحصاءات Google‏ 4"، ستلاحظ أنّ نقطة النهاية هي كما يلي

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

كانت حمولة الحدث كما يلي

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

يمكنك ترجمة ذلك إلى Python باستخدام ما يلي

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

بعد تنفيذ ذلك بالقيم الصحيحة، من المفترض أن يظهر الحدث بشكل مشابه في الوقت الفعلي في "إحصاءات Google‏ 4".

6. تهانينا

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

لقد تعلّمت

• كيفية جمع المتغيّرات المناسبة لإجراء طلبات إلى "منصّة Google للتسويق"
• كيفية إرسال أحداث تجريبية والتحقّق من صحتها
• كيفية إنشاء برنامج نصي لإرسال طلبات MP

المستندات المرجعية

• مرجع Measurement Protocol
• منصة Measurement Protocol في "إحصاءات Google‏ 4" - أداة إنشاء الأحداث
• نظرة عامة على Measurement Protocol