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

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

يوضّح هذا الدليل حالات الاستخدام الشائعة في Google Analytics Measurement Protocol ومتطلباتها.

المصطلح الأساسي: في هذا الدليل، يشير "يوم العمل" إلى يوم العمل الخاص بحدث أو جلسة في المنطقة الزمنية لملكيتك.

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

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

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

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

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

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

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

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

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

   في هذا السيناريو، أنت تستخدم 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.

ملاحظة: لا تتطلّب حالة الاستخدام هذه session_id.

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

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

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

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

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

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

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

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

ملاحظة: لا تتطلّب حالة الاستخدام هذه session_id.

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

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

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

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

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

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