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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• أدرِج session_id في قائمة مَعلمات الحدث.
• أرسِل أحداث Measurement Protocol في يوم العمل نفسه الذي حدثت فيه الجلسة على الإنترنت.
• في حال إلغاء القيمة timestamp_micros، اضبطها على طابع زمني بين وقت بدء الجلسة على الإنترنت ووقت انتهائها.
• إذا كان هدفك هو تقديم رقم تعريف المستخدِم للأحداث على الإنترنت، اضبط 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 آذار (مارس).

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

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

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