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

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

اختر النظام الأساسي الذي تريد مشاهدته في هذا الدليل:

Firebase gtag.js

تنسيق الطلب

لا يتوافق 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 حدث محجوز name، يؤدي إنشاء 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. إحصاءات:

ملاحظة: لمزيد من المعلومات عن حدود ميزات الإصدار 360، يُرجى الاطّلاع على إحصاءات Google. 360.

• يمكن أن تحتوي الطلبات على 25 حدثًا كحدّ أقصى.
• يمكن أن تحتوي الأحداث على 25 معلَمة كحدٍ أقصى.
• يمكن أن تحتوي الأحداث على 25 خاصيّة مستخدم بحدٍ أقصى.
• يجب أن تحتوي أسماء خصائص المستخدمين على 24 حرفًا أو أقل.
• يجب أن تحتوي قيم خصائص المستخدمين على 36 حرفًا أو أقل.
• يجب أن تحتوي أسماء الأحداث على 40 حرفًا أو أقل، ويمكن أن تحتوي على أحرف أبجدية رقمية فقط. والشرطات السفلية، ويجب أن تبدأ بحرف أبجدي.
• يجب أن يكون عدد أحرف أسماء المعلَمات، بما في ذلك معلَمات السلع، 40 حرفًا أو أقل ويمكن أن يحتوي فقط على أحرف أبجدية رقمية وشرطات سفلية، ويجب أن يبدأ بحرف أبجدي.
• يجب أن تحتوي قيم المعلَمات، بما في ذلك قيم معلَمات السلع، على 100 حرف أقل بالنسبة إلى المواقع العادية على "إحصاءات Google 4"، و500 حرف عدد أقلّ لأحد مواقع "إحصاءات Google 360".
• يمكن أن تحتوي مَعلمات العناصر على 10 مَعلمات مخصَّصة بحدٍ أقصى.
• يجب أن يكون حجم نص المشاركة أقل من 130 كيلوبايت.
• تتوفّر إمكانية تحديد المصدر على مستوى الحدث من أحداث Measurement Protocol لما يصل إلى 63 يومًا بعد آخر حدث لوضع العلامات على الإنترنت لتصدير الإحالات الناجحة إلى عمليات دمج الإعلانات والوسائط الأخرى، حتى في حال كانت فترة الإحالة الناجحة حدث الإحالة الناجحة أكبر من 63 يومًا. في المقابل، على مستوى الحدث يتوافق تحديد المصدر لوضع العلامات على الأحداث على الإنترنت مع الإحالة الناجحة بالكامل. نافذة.
• لأغراض تجديد النشاط التسويقي، يمكنك الانضمام إلى أحداث Measurement Protocol حتى عدد الأيام التالي بعد آخر حدث على الإنترنت مع معرّف الجهاز أو ملف تعريف الارتباط المرتبطَين
  • مصدر بيانات من موقع إلكتروني: 30 يومًا
  • مصدر بيانات التطبيق: 42 يومًا
• لا تتم تعبئة أحداث App Measurement Protocol المُرسَلة إلى "إحصاءات Google 4" شرائح جمهور البحث في "إعلانات Google" لمستخدمي التطبيقات