إرسال أحداث الويب إلى "إحصاءات 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 > إنشاء

8dee89e850ae90bb.pngd0be19d8112435a2.pngde5a80a1445d3a14.png

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

جمع client_id

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

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

يتم شرح كلّ منهما بالتفصيل أدناه

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

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

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

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

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

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

b904d2a053eb7817.png

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

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

d362992ff592c675.png

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

cf580a708bb0a8a2.png

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

da59bb982f6f906a.png

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

31f720d550906298.png

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

1d63d1e067c46294.png

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

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

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

7b9e9a0f74b64757.png

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

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

بعد أن جرّبت ذلك، يمكنك فحص طلب البيانات من واجهة برمجة التطبيقات وحِزمة بيانات الحدث لإنشاء بنية مشابهة في Python (أو أي لغة من اختيارك) يمكنها تنفيذ هذا الطلب. يمكنك بعد ذلك جدولة هذا التقرير بمعدّل التكرار الذي تريده وتفعيله. في هذا الجزء، يمكنك استخدام أي بيئة تطوير متكاملة (IDE) من اختيارك تتوافق مع Python أو استخدام ورقة ملاحظات Colab من Google 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" واستيراد هذه الأحداث كإحالات ناجحة.

لقد تعلّمت

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

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