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

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

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

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

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

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

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

تعيين 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 ساعة.