حالات الاستخدام لمنصّة Measurement Protocol

يتيح لك بروتوكول Measurement Protocol من "إحصاءات Google" إرسال بيانات متوفّرة بلا إنترنت إلى مصدر بيانات الموقع الإلكتروني أو التطبيق، بالإضافة إلى البيانات التي تجمعها حاليًا باستخدام وضع العلامات أو حزمة تطوير البرامج (SDK) لمنصة Firebase.

يوضّح هذا الدليل حالات الاستخدام الشائعة لبروتوكول Measurement Protocol في "إحصاءات Google" ومتطلباتها.

ملخّص المتطلبات

يوفر هذا الجدول مرجعًا سريعًا حول المتطلبات لكل حالة استخدام. يُرجى مراعاة أفضل الممارسات التالية:

  1. يتم ضبط القيمة التلقائية لـ timestamp_micros في الأحداث وخاصيّات المستخدمين على وقت الطلب. عند إرسال تغيير تم في الماضي على حدث أو خاصيّة مستخدم، تجاهل الطابع الزمني كما هو موضّح في دليل إرسال الأحداث ودليل خصائص المستخدمين.

  2. لكي تكون تقارير "الوقت الفعلي" ومقاييس التفاعل دقيقة، ضمِّن مَعلمة خاصة بالحدث engagement_time_msec مع ضبطها على المدة المنقضية منذ الحدث السابق بالملّي ثانية.

حالة الاستخدام معرّف الجلسة شرط وقت الطلب متطلبات timestamp_micros
تعيين User-ID للأحداث مطلوب <= نهاية الجلسة وبداية يوم العمل >= بداية الجلسة <= ونهاية الجلسة
تحديد مصدر الجلسة مطلوب <= بداية الجلسة + 24 ساعة >= بداية الجلسة <= ونهاية الجلسة
استيراد الأحداث إلى المنصات الإعلانية غير مطلوب <= يوم آخر جلسة + 63 يومًا ‫>= وقت الطلب ناقص 72 ساعة و <= وقت الطلب
إرسال الأحداث أو خاصيّات المستخدمين لإنشاء شرائح الجمهور غير مطلوب الموقع الإلكتروني: <= وقت آخر حدث على الإنترنت + 30 يومًا
التطبيق: <= وقت آخر حدث على الإنترنت + 42 يومًا		 ‫>= وقت الطلب ناقص 72 ساعة و <= وقت الطلب

تعيين User-ID للأحداث

استخدِم Measurement Protocol لتزويد الأحداث على الإنترنت أو بلا إنترنت بمعرّف المستخدم.

في ما يلي بعض الأمثلة على حالات الاستخدام التي تتطلّب إضافة User-ID إلى حدث:

  1. لا يتضمّن قياسك على الإنترنت المعلومات اللازمة للبحث عن User-ID للأحداث على الإنترنت، ولكن لديك مسار معالجة أحداث يمكنه الربط بين جلسة على الإنترنت وUser-ID.

    في هذا السيناريو، أنت تستخدم Measurement Protocol لتزويد الأحداث على الإنترنت برقم تعريف User-ID.

  2. ليس لديك رقم تعريف المستخدِم للأحداث التي ترسلها باستخدام Measurement Protocol، ولكنّك تريد ربط هذه الأحداث برقم تعريف المستخدِم إذا سجّل المستخدِم الدخول على الإنترنت خلال الجلسة.

    في هذا السيناريو، أنت تستخدم أحداثًا على الإنترنت لتزويد أحداث Measurement Protocol برقم تعريف المستخدم.

في ما يلي متطلبات إضافة User-ID إلى حدث:

  • أدرِج session_id في قائمة مَعلمات الحدث.
  • أرسِل أحداث Measurement Protocol في يوم العمل نفسه الذي تم فيه إجراء الجلسة على الإنترنت.
  • في حال تجاهل timestamp_micros، اضبطه على طابع زمني بين وقتَي بدء الجلسة على الإنترنت وانتهائها.
  • إذا كان هدفك هو تقديم User-ID للأحداث على الإنترنت، اضبط user_id في الطلب.
  • إذا كان هدفك هو أن يتضمّن كلّ حدث Measurement Protocol معرّف المستخدم من الجلسة المقابلة على الإنترنت، لن تحتاج إلى ضبط user_id.

تحديد مصدر الجلسة

تظهر أحداث Measurement Protocol التي تستوفي متطلبات معيّنة في التقارير مع سمات الجلسة نفسها (مثل المعلومات الجغرافية والمصدر والوسيط والحملة) كما هو الحال مع الأحداث على الإنترنت من الجلسة نفسها.

في ما يلي متطلبات تحديد مصدر الجلسات:

  • أدرِج session_id في قائمة مَعلمات الحدث.

  • يجب إرسال الطلب في غضون 24 ساعة من بدء الجلسة على الإنترنت.

    على سبيل المثال، إذا بدأت الجلسة في الساعة 11:15 صباحًا يوم الاثنين في المنطقة الزمنية لموقعك، أرسِل الطلب قبل الساعة 11:15 صباحًا يوم الثلاثاء.

  • في حال تجاهل timestamp_micros، اضبطه على طابع زمني بين وقتَي بدء الجلسة على الإنترنت وانتهائها.

استيراد الأحداث إلى المنصات الإعلانية

تتضمّن "إحصاءات Google" الأحداث التي تُرسلها باستخدام Measurement Protocol في عمليات التصدير إلى المنتجات الإعلانية المرتبطة، مثل "إعلانات Google" أو "مدير الحملة 360".

في ما يلي بعض السيناريوهات الشائعة التي يكون فيها ذلك مفيدًا:

  • لديك أحداث غير إلكترونية تريد تضمينها في تحديد مصدر الإحالات الناجحة وإعداد التقارير في الإعلانات.
  • لديك أحداث إضافية في نظام غير متاح لوضع العلامات أو حزمة تطوير البرامج (SDK) لمنصة Firebase، ولكنّك تريد تضمين هذه الأحداث في المنتجات المرتبطة.

في ما يلي متطلبات استيراد الأحداث إلى المنصات الإعلانية:

  • أرسِل الطلب في موعد لا يتجاوز 63 يومًا بعد آخر حدث على الإنترنت، حتى إذا كان وقت اكتمال تحديد المصدر للحدث الرئيسي يزيد عن 63 يومًا. يجب أن يصل الحدث أيضًا خلال وقت اكتمال تحديد المصدر للحدث الرئيسي. تعرَّف على كيفية ضبط إعدادات وقت اكتمال تحديد المصدر.

    على سبيل المثال، إذا وقع آخر حدث على الإنترنت client_id أو app_instance_id في 1 آذار (مارس)، أرسِل حدث Measurement Protocol في موعد لا يتجاوز 3 أيار (مايو).

  • في حال تجاهل timestamp_micros، اضبطه على طابع زمني ضمن آخر 72 ساعة.

إرسال الأحداث أو خاصيّات المستخدمين لإنشاء شرائح الجمهور

يتم تضمين الأحداث وخصائص المستخدِمين المُرسَلة باستخدام Measurement Protocol في تقييم شروط شرائح الجمهور إذا استوفيت بعض المتطلبات.

في ما يلي متطلبات إرسال الأحداث أو خصائص المستخدمين لإنشاء شرائح الجمهور:

  • أرسِل الطلب إلى مصدر بيانات من موقع إلكتروني في غضون 30 يومًا على الأكثر من تاريخ آخر حدث على الإنترنت لنفس client_id.

    على سبيل المثال، إذا حدث آخر حدث على الإنترنت client_id في 1 آذار (مارس)، أرسِل حدث Measurement Protocol في موعد أقصاه 31 آذار (مارس).

  • أرسِل الطلب إلى مصدر بيانات التطبيق في غضون 42 يومًا كحد أقصى من تاريخ آخر حدث على الإنترنت لنفس app_instance_id.

    على سبيل المثال، إذا كان آخر حدث على الإنترنت app_instance_id قد وقع في 1 آذار (مارس)، أرسِل حدث Measurement Protocol في موعد أقصاه 12 نيسان (أبريل).

  • في حال تجاهل timestamp_micros، اضبطه على طابع زمني ضمن آخر 72 ساعة.