إرسال أحداث Measurement Protocol إلى "إحصاءات Google"

يوضّح هذا الدليل كيفية إرسال أحداث بروتوكول القياس في "إحصاءات 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 حرف أو أقل.
  • يمكن أن تحتوي مَعلمات العناصر على 10 مَعلمات مخصّصة كحدٍ أقصى.
  • يجب أن يكون نص المشاركة أقل من 130 كيلوبايت.
  • تتوفّر عملية تحديد المصدر على مستوى الحدث من أحداث Measurement Protocol لمدة تصل إلى 63 يومًا بعد آخر حدث وضع علامات على الإنترنت لتصدير الإحالات الناجحة إلى "الإعلانات" وعمليّات دمج الوسائط الأخرى، حتى إذا كانت فترة الإحالة الناجحة لحدث الإحالة الناجحة أطول من 63 يومًا. في المقابل، إنّ نموذج تحديد المصدر على مستوى الحدث لوضع العلامات على الأحداث على الإنترنت متاح طوال فترة الإحالة الناجحة بالكامل.
  • لأغراض تجديد النشاط التسويقي، يمكنك الانضمام إلى أحداث Measurement Protocol بمدة عدد الأيام التالية بعد آخر حدث على الإنترنت، وذلك باستخدام ملف تعريف ارتباط أو رقم تعريف جهاز مرتبطَين:
    • مصدر البيانات من موقع إلكتروني: 30 يومًا
    • مصدر بيانات التطبيق: 42 يومًا
  • إنّ أحداث Measurement Protocol المُرسَلة إلى "إحصاءات Google 4" لا تُعبِّئ شرائح جمهور البحث في "إعلانات Google" لمستخدمي التطبيقات.