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

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

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

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

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

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

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

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

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

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

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

في ما يلي بعض الأمثلة على حالات استخدام إضافة 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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