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.
- الجمع من خلال علامة الموقع الشاملة
يتم شرح كلّ منهما بالتفصيل أدناه
الجمع من خلال علامة الموقع الشاملة
يمكنك استرداد client_id من خلال موقعك الإلكتروني باستخدام :
gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
Do something with clientID)
}
في ما يلي المزيد من الروابط حسب البنية الأساسية
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 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