إرسال الأحداث

نظرة عامة

يوضّح هذا الدليل طريقة تنسيق الطلبات وإرسالها إلى Measurement Protocol في "إحصاءات Google".

إرسال الأحداث

لإرسال حدث، يمكنك إرسال طلب HTTP POST إلى نقطة النهاية التالية:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>

ملاحظة: لا يتوافق بروتوكول Measurement Protocol في "إحصاءات Google 4" إلا مع POST طلبات.

المعلمات المطلوبة

يتطلب الطلب الصالح مجموعتَين من المعلّمات التي تختلف إذا كنت تستخدم Firebase أو gtag.js:

Firebase gtag.js

1. معلمات عنوان URL

   • api_secret - مطلوبة. API SECRET يتم إنشاؤه في واجهة مستخدم"إحصاءات Google". لإنشاء سر جديد، انتقل إلى:
     المشرف &gt؛ مصادر البيانات &gt؛ اختيار مصدر بياناتك &gt؛ Measurement Protocol &gt؛ إنشاء

   يمكنك الاطّلاع على معلَمات طلب البحث كمرجع كامل.

2. نص JSON

   • user_id: اختياري معرّف فريد للمستخدم. اطّلِع على User-ID للتحليل من عدّة منصات للحصول على مزيد من المعلومات حول هذا المعرّف.

     ملاحظة: يمكن أن تحتوي user_id على أحرف utf-8 فقط.

   • events - مطلوبة. مصفوفة من عناصر الحدث.

   يمكنك الاطّلاع على المرجع JSON POST Body كمرجع كامل.

ملاحظة: لإرسال أكثر من حدث واحد في طلب واحد، يمكنك تضمين أحداث متعددة في إدخال events.

المعلمات المقترحة للتقارير

لكي يتم عرض نشاط المستخدم في التقارير القياسية مثل "الوقت الفعلي"، يجب تقديم engagement_time_msec وsession_id كجزء من params لنطاق event.

مثال:

{
"client_id": "x",
"events": [
  {
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123"
    }
  }
]
}

على الرغم من أن session_start هو اسم حدث محجوز، سيؤدي إنشاء session_id جديد إلى إنشاء جلسة جديدة بشكل فعّال بدون الحاجة إلى إرسال session_start.

ملاحظة: تعرَّف على كيفية حساب الجلسات.

إرسال حدث

Firebase gtag.js

لإرسال حدث tutorial_begin، نفِّذ الطلب التالي:

القيود

• يمكن أن تحتوي الطلبات على 25 حدثًا كحد أقصى.
• يمكن أن تحتوي الأحداث على 25 معلّمة بحدٍ أقصى.
• يمكن أن تحتوي الأحداث على 25 خاصيّة مستخدم بحدٍ أقصى.
• يجب أن يبلغ طول أسماء خصائص المستخدمين 24 حرفًا أو أقل.
• يجب أن تكون قيم خصائص المستخدمين 36 حرفًا أو أقل.
• يجب أن تكون أسماء الأحداث 40 حرفًا أو أقل، وأن تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، ويجب أن تبدأ بحرف أبجدي.
• يجب أن تكون أسماء المعلّمات (بما في ذلك معلّمات السلع) 40 حرفًا أو أقل، وقد تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، ويجب أن تبدأ بحرف أبجدي.
• يجب أن تكون قيم المعلّمات (بما في ذلك قيم معلّمات السلع) 100 حرف أو أقل.
• يمكن أن تحتوي معلّمات السلع على 10 معلّمات مخصّصة بحدٍ أقصى.
• يجب أن يكون حجم نص المشاركة أقل من 130 كيلوبايت.