تتيح لك Measurement Protocol في "إحصاءات Google" إرسال البيانات بلا اتصال بالإنترنت إلى مصدر بيانات الموقع الإلكتروني أو التطبيق، وذلك في إضافةً إلى البيانات التي تجمعها حاليًا باستخدام وضع العلامات أو حزمة تطوير البرامج (SDK) لمنصّة Firebase.
يصف هذا الدليل حالات الاستخدام الشائعة لبروتوكول Measurement Protocol في "إحصاءات Google" ومتطلباتها.
ملخّص المتطلبات
يوفّر هذا الجدول مرجعًا سريعًا لمتطلبات كل استخدام. الحالة. يُرجى اتّباع أفضل الممارسات التالية:
يتم ضبط
timestamp_microsللأحداث وخصائص المستخدمين تلقائيًا على الطلب الوقت. عند إرسال تغيير حدث أو خاصيّة مستخدم تم في بعد ذلك، يمكنك إلغاء الطابع الزمني كما هو موضح في دليل إرسال الأحداث دليل خصائص المستخدِمللحصول على تقارير دقيقة في الوقت الفعلي ومقاييس التفاعل، عليك تضمين تم ضبط مَعلمة حدث
engagement_time_msecعلى عدد المللي ثانية التي انقضت منذ الحدث السابق.
| حالة الاستخدام | معرّف الجلسة | متطلبات وقت الطلب | شرط واحد (timestamp_micros) |
|---|---|---|---|
| تعيين User-ID للأحداث | مطلوب | <= نهاية يوم عمل بدء الجلسة | >= بدء جلسة و<= نهاية جلسة |
| تحديد مصدر الجلسات | مطلوب | <= بدء الجلسة + 24 ساعة | >= بدء جلسة و<= نهاية جلسة |
| تصدير الأحداث إلى المنصّات الإعلانية | غير مطلوبة | <= آخر يوم عمل للجلسة + 63 يومًا | <= وقت الطلب |
| إرسال الأحداث أو خصائص المستخدمين للجمهور الإنشاء | غير مطلوبة | الويب: <= آخر وقت للفعالية على الإنترنت + 30 يومًا التطبيق: <= آخر وقت للفعالية على الإنترنت + 42 يومًا |
<= وقت الطلب |
تعيين User-ID للأحداث
استخدِم Measurement Protocol لتزويد الأحداث على الإنترنت أو بلا اتصال بالإنترنت باستخدام User-ID:
في ما يلي بعض الأمثلة على حالات الاستخدام لإضافة User-ID إلى حدث:
يفتقر القياس عبر الإنترنت إلى المعلومات اللازمة للبحث عن ميزة User-ID للفعاليات على الإنترنت، ولكن لديك مسار لمعالجة الأحداث من الربط بين جلسة على الإنترنت وUser-ID.
في هذا السيناريو، أنت تستخدم Measurement Protocol لتوفير على الإنترنت باستخدام User-ID.
ليس لديك User-ID للأحداث التي ترسلها باستخدام Measurement Protocol، ولكنك تريد ربط هذه الأحداث User-ID إذا سجَّل المستخدم دخوله على الإنترنت على مدار الجلسة.
في هذا السيناريو، أنت تستخدم الأحداث عبر الإنترنت لتوفير أحداث Measurement Protocol مع User-ID.
في ما يلي متطلّبات إضافة User-ID إلى أحد الأحداث:
- أدرِج
session_idفي قائمة مَعلمات الحدث. - أرسِل أحداث Measurement Protocol في يوم العمل نفسه مع جلسة عبر الإنترنت.
- في حال إلغاء السمة
timestamp_micros، يجب ضبطها على طابع زمني بين وقت بدء ووقت انتهاء الجلسة عبر الإنترنت. - إذا كان هدفك هو توفير User-ID للفعاليات على الإنترنت، اضبط
user_idفي الطلب. - في حال كان هدفك هو أن يحصل كل حدث Measurement Protocol على User-ID.
من الجلسة المقابلة على الإنترنت، لن تحتاج إلى ضبط
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، يجب ضبطها على طابع زمني أقل من أو يساوي. مع وقت الطلب.
إرسال الأحداث أو خصائص المستخدمين لإنشاء الجمهور
يتم تضمين الأحداث وخصائص المستخدِمين المُرسَلة باستخدام Measurement Protocol في تقييم شروط الجمهور في حال الالتزام ببعض المتطلبات
في ما يلي متطلبات إرسال الأحداث أو خصائص المستخدمين للجمهور الإنشاء:
إرسال الطلب إلى مصدر بيانات من موقع إلكتروني في موعد أقصاه نهاية يوم العمل بعد 30 يومًا من آخر حدث على الإنترنت في "
client_id" نفسهعلى سبيل المثال، إذا وقع آخر حدث على الإنترنت لـ
client_idفي 1 آذار (مارس)، أرسِل حدث Measurement Protocol في موعد لا يتجاوز نهاية يوم عمل في 31 مارس.إرسال الطلب إلى مصدر بيانات التطبيق في موعد أقصاه نهاية يوم العمل بعد 42 يومًا من آخر حدث على الإنترنت في "
app_instance_id" نفسهعلى سبيل المثال، إذا وقع آخر حدث على الإنترنت لـ
app_instance_idفي 1 آذار (مارس)، أرسِل حدث Measurement Protocol في موعد لا يتجاوز نهاية يوم العمل في 12 أبريل.في حال إلغاء السمة
timestamp_micros، يجب ضبطها على طابع زمني أقل من أو يساوي. مع وقت الطلب.