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

1. مقدمة

تاريخ آخر تحديث: 30/04/2019

ما الذي ستنشئه

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

المعلومات التي ستطّلع عليها

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

المتطلبات

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

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

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

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

8dee89e850ae90bb.png

d0be19d8112435a2.png

de5a80a1445d3a14.png

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

جمع client_id

يمكنك استخدام أي من الطرق التالية لجمع customer_id الخاص بك.

  1. يتم جمع البيانات من خلال علامة الموقع الشاملة (gTag)

ويتم شرح كلا هذين النوعين بالتفصيل في ما يلي.

جمع البيانات من خلال علامة الموقع الشاملة (gtag)

يمكنك استرداد 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"
  • القياس_id- للحصول على ذلك، يمكنك الانتقال إلى المشرف > مصادر البيانات > اختر ساحة المشاركات . يجب أن يظهر على النحو التالي

d362992ff592c675.png

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

cf580a708bb0a8a2.png

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

da59bb982f6f906a.png

بعد ملء كل المعلومات، من المفترض أن ترى شيئًا مثل هذا، مع زر لـ "التحقق من صحة الحدث"

31f720d550906298.png

عند الوصول إلى هذا الحدث، انقر على "VALIDATE EVENT". ، يتم تمييز الزر باللون البرتقالي. من المفترض أن يتم عرض الرسالة أدناه، مع تحديد أنّ الحدث صالح، وسيظهر لك زر الآن "SEND to GA". في هذه المرحلة، إذا كان الحدث غير صالح، ستخبرك الأداة بالحقل الدقيق الذي تظهر فيه المشكلة، ويمكنك حلّ المشكلة وإعادة المحاولة.

1d63d1e067c46294.png

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

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

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

7b9e9a0f74b64757.png

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

5- إنشاء نص برمجي في بايثون

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

بالرجوع إلى "أداة إنشاء الأحداث" في "إحصاءات 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"
      }
    }
  ]
}

يمكنك ترجمة هذا إلى بايثون باستخدام شيء كهذا

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" واستيراد هذه الأحداث كإحالات ناجحة.

لقد تعلمتَ

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

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