يوضّح هذا الدليل كيفية إرسال أحداث مصادر بيانات المواقع الإلكترونية والتطبيقات لبروتوكول قياس "إحصاءات Google" إلى خادم "إحصاءات Google" حتى تتمكّن من عرض أحداث Measurement Protocol في تقارير "إحصاءات Google".
اختر النظام الأساسي الذي تريد مشاهدته في هذا الدليل:
تنسيق الطلب
لا يتوافق Measurement Protocol في "إحصاءات Google 4" إلا مع طلبات HTTP POST.
لإرسال حدث، استخدِم التنسيق التالي:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
يجب تقديم المعلومات التالية في عنوان URL الخاص بالطلب:
api_secret: سر واجهة برمجة التطبيقات الذي تم إنشاؤه في واجهة مستخدم "إحصاءات Google".لإنشاء مفتاح سرّي جديد، انتقِل إلى المشرف > مصادر البيانات > اختيار مصدر بياناتك > Measurement Protocol > إنشاء.
measurement_id: رقم تعريف القياس المرتبط بمصدر بيانات، ويمكنك العثور عليه في واجهة مستخدم "إحصاءات Google" ضمن المشرف > مصادر البيانات > اختيار مصدر البيانات > رقم تعريف القياس.إنّ
measurement_idليس معرّف مصدر البيانات الخاص بك.
راجِع مَعلمات طلب البحث للمرجع الكامل.
يجب تقديم ما يلي في نص الطلب:
client_id: معرّف فريد لعميل ويختلف هذا عنapp_instance_idمن Firebase. استخدِم gtag.js('get').
user_id: اختيارية. معرّف فريد للمستخدِم. لا يمكن أن يحتوي إلا على أحرف utf-8. اطّلِع على User-ID للتحليل من عدّة منصات للحصول على مزيد من المعلومات عن هذا المعرّف.consent: اختيارية. تعرَّف على كيفية ضبط إعدادات الموافقة.events: مصفوفة من عناصر الأحداث. يمكنك تضمين أحداث متعددة في طلب واحد.لعرض نشاط المستخدِم في تقارير مثل الوقت الفعلي، يجب تقديم
engagement_time_msecوsession_idكجزء منparamsلـevent. يجب أن تعكس مَعلمةengagement_time_msecمدة تفاعل الحدث بالمللي ثانية.وفي ما يلي مثال لذلك:
{
"client_id": "123456.7654321",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
في حين أنّ session_start هو اسم
حدث محجوز،
يؤدي إنشاء session_id جديد إلى إنشاء جلسة جديدة بدون الحاجة إلى إرسال
session_start. التعرُّف على كيفية احتساب الجلسات.
تجربة الإيماءة
في ما يلي مثال يمكنك استخدامه لإرسال حدث tutorial_begin إلى
خادم "إحصاءات Google":
const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
client_id: 'XXXXXXXXXX.YYYYYYYYYY',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
القيود
تنطبق القيود التالية على إرسال أحداث Measurement Protocol إلى "إحصاءات Google":
- يمكن أن تحتوي الطلبات على 25 حدثًا كحدّ أقصى.
- يمكن أن تحتوي الأحداث على 25 معلَمة كحدٍ أقصى.
- يمكن أن تحتوي الأحداث على 25 خاصيّة مستخدم بحدٍ أقصى.
- يجب أن تحتوي أسماء خصائص المستخدمين على 24 حرفًا أو أقل.
- يجب أن تحتوي قيم خصائص المستخدمين على 36 حرفًا أو أقل.
- يجب أن تحتوي أسماء الأحداث على 40 حرفًا أو أقل، ولا يمكن أن تحتوي إلا على أحرف أبجدية رقمية وشرطات سفلية، كما يجب أن تبدأ بحرف أبجدي.
- يجب أن تحتوي أسماء المعلَمات، بما في ذلك معلَمات السلع، على 40 حرفًا أو أقل، ولا يمكن أن تحتوي إلا على أحرف أبجدية رقمية وشرطات سفلية، كما يجب أن تبدأ بحرف أبجدي.
- يجب أن تحتوي قيم المعلَمات التي تتضمّن قيم معلَمات السلع على 100 حرف أو أقل بالنسبة إلى المواقع العادية على "إحصاءات Google 4" و500 حرف أو أقل في موقع "إحصاءات Google 360".
- يمكن أن تحتوي مَعلمات العناصر على 10 مَعلمات مخصَّصة بحدٍ أقصى.
- يجب أن يكون حجم نص المشاركة أقل من 130 كيلوبايت.
- تتوفّر إمكانية تحديد المصدر على مستوى الحدث من أحداث Measurement Protocol لمدة تصل إلى 63 يومًا بعد آخر حدث لوضع العلامات على الإنترنت لتصدير الإحالات الناجحة إلى "إعلانات Google" وعمليات دمج الوسائط الأخرى، حتى إذا كانت فترة الإحالة الناجحة لحدث الإحالة الناجحة أكبر من 63 يومًا. في المقابل، تتوفّر عملية تحديد المصدر على مستوى الحدث لوضع علامات على الأحداث على الإنترنت خلال فترة الإحالة الناجحة بأكملها.
- لأغراض تجديد النشاط التسويقي، يمكنك الانضمام إلى أحداث Measurement Protocol تصل إلى
عدد الأيام التالية بعد آخر حدث على الإنترنت مع
ملف تعريف ارتباط أو رقم تعريف جهاز مرتبطَين:
- مصدر بيانات الويب: 30 يومًا
- مصدر بيانات التطبيق: 42 يومًا
- إنّ أحداث Measurement Protocol بشأن التطبيقات المُرسَلة إلى "إحصاءات Google 4" لا تتم تعبئة شرائح جمهور "شبكة البحث" في "إعلانات Google" لمستخدِمي التطبيقات.