لمحة عن بيانات الأحداث بلا اتصال بالإنترنت
يمكنك استيراد الأحداث بلا اتصال بالإنترنت من مصادر لا يتوفّر لها اتصال بالإنترنت أو مصادر لا يمكنها بخلاف ذلك إتاحة جمع الأحداث في الوقت الفعلي من خلال حِزم تطوير البرامج (SDK) أو Measurement Protocol. وبعد تحميل الأحداث، تتم معالجتها كما لو تم جمعها من خلال حِزم تطوير البرامج (SDK) التابعة لنا، كما أنها تستخدِم الطابع الزمني الذي تقدِّمه أو الطابع الزمني لعملية التحميل إذا لم تقدِّم الطابع الزمني الخاص بك.
يمكنك استيراد أي حدث يتطابق مع الأحداث التي تجمعها "إحصاءات Google" تلقائيًا أو الأحداث التي ننصح بها للقطاعات المختلفة، أو أي حدث أو معلَمة مخصّصة أو خاصيّة مستخدم تم تنسيقها بشكلٍ سليم. مزيد من المعلومات
تتطلّب إزالة هذه البيانات إما طلب حذف بيانات أو حذف مستخدم.
طريقة استيراد بيانات الأحداث بلا اتصال بالإنترنت
لاستيراد الأحداث بلا اتصال بالإنترنت، عليك إنشاء ملف CSV الذي يتطابق مع مخطط أحداث "إحصاءات Google". اطّلِع على مثال النموذج التالي.
إنشاء السمات المخصّصة
إذا كنت تستورِد قيمًا لسمات غير متاحة بعد في "إحصاءات Google" وكنت تريد الاطّلاع على هذه البيانات في التقارير، يجب إنشاء تلك السمات قبل تحميل بياناتك. مزيد من المعلومات
بعد إنشاء السمات المخصَّصة، تحتاج خدمة "إحصاءات Google" إلى ما يصل إلى 4 ساعات قبل أن تصبح مستعدّة للتعرّف على البيانات التي يتمّ استيرادها. (يمكنك التحقّق من معالجة السمات المخصّصة عن طريق فتح استكشاف والتحقّق من توفّرها في أداة اختيار السمات).
إنشاء ملف CSV
يمكنك إنشاء ملف CSV ببيانات الأحداث باستخدام النموذج أدناه كدليل إرشادي لك.
تحميل البيانات
تم توضيح إجراء التحميل العام في لمحة عن استيراد البيانات.
عند إنشاء مصدر البيانات، اختَر بيانات الأحداث بلا اتصال بالإنترنت.
بالنسبة إلى الأحداث بلا إنترنت، يتم ربط الحقول المستورَدة بحقول "إحصاءات Google" تلقائيًا.
بعد تحميل بياناتك، يمكن أن تستغرق خدمة "إحصاءات Google" ما يصل إلى 24 ساعة لتوفير هذه البيانات في التقارير وقسم "شرائح الجمهور" و"الاستكشافات".
لا يؤدّي حذف مصدر بيانات من خدمة تحميل البيانات إلى حذف البيانات المحمَّلة. وإذا لزم الأمر، وكما هو الحال مع كل طرق جمع البيانات الأخرى، قد تحتاج إلى متابعة طلب حذف البيانات من أجل إزالة البيانات المحمَّلة من خلال "استيراد البيانات".
تفاصيل مصدر البيانات
وسيلة الإيضاح
| النطاق | الحدث |
|---|---|
| حقول مطلوبة |
[one of] client_id أو app_instance_id [one of] tag_id أو firebase_app_id (tag_id and client_id) أو (firebase_app_id وapp_instance_id) event_name |
| البيانات المستورَدة |
يجوز لك تحميل أي بيانات حدث أو مَعلَمة أو سلعة أو خاصيّة مستخدم باستخدام تنسيقات العناوين التالية:
|
| ملاحظات | لا يجوز لك تحميل معلومات تحديد الهوية الشخصية أو ربطها باستيراد الأحداث بلا اتصال بالإنترنت. مزيد من المعلومات |
النموذج
في ما يلي مثال لنموذج بتنسيق CSV لبيانات الأحداث. إذا كنت تريد إنشاء ملفات التحميل يدويًا، استخدِم هذا المثال كدليل.
| measurement_id | client_id | user_id | timestamp_micros | ad_personalization | ad_user_data | event_name | event_param.page_location | event_param.page_referrer | event_param.page_title | event_param.screen_resolution | user_property.color_score | event_param.foo | item1.item_id | item1.item_name | item1.category | item1.item_list_id | item1.item_list_name | item1.index | item1.quantity | item1.price | item2.item_id | item2.item_name | item2.quantity | item2.price | event_param.transaction_id | event_param.value | event_param.tax | event_param.shipping | event_param.currency |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488000000000 | تمّ منح الموافقة | تمّ الرفض | page_view | /home | referrer.com | الصفحة الرئيسية | 1600x900 | أزرق | 1-2 | |||||||||||||||||
| G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488060000000 | تمّ الرفض | تمّ الرفض | page_view | /video_detail | أداة مشاهدة الفيديو | 1600x900 | أزرق | 1-4 | ||||||||||||||||||
| G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488120000000 | تمّ الرفض | تمّ منح الموافقة | video_play | /video_detail | أداة مشاهدة الفيديو | 1600x900 | أزرق | |||||||||||||||||||
| G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574400000000 | تمّ الرفض | تمّ منح الموافقة | page_view | /home | referrer.com | الصفحة الرئيسية | 2560x1440 | أخضر | 2-2 | |||||||||||||||||
| G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574460000000 | تمّ الرفض | تمّ منح الموافقة | page_view | /product_detail | تفاصيل المنتج | 2560x1440 | أخضر | 2-16 | ||||||||||||||||||
| G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574520000000 | تمّ منح الموافقة | تمّ منح الموافقة | page_view | /product_detail | تفاصيل المنتج | 2560x1440 | أخضر | |||||||||||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609574520000000 | تمّ منح الموافقة | تمّ منح الموافقة | page_view | /camp_lp_1 | referrer.com | تخفيضات موسم الصيف | 2560x1440 | أزرق | 3-1 | |||||||||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660801000000 | تمّ منح الموافقة | تمّ الرفض | view_item_list | /camp_lp_1 | تخفيضات موسم الصيف | 2560x1440 | أزرق | 123abc | red_shoe | حذاء | list_123 | colorful_shoes | 1 | 1 | 234bcd | blue_shoe | 1 | 30.00 | ||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660860000000 | تمّ منح الموافقة | تمّ منح الموافقة | select_item | /camp_lp_1 | تخفيضات موسم الصيف | 2560x1440 | أزرق | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660870000000 | تمّ منح الموافقة | تمّ منح الموافقة | page_view | /product_detail | تفاصيل المنتج | 2560x1440 | أزرق | 3-5 | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660930000000 | تمّ الرفض | تمّ منح الموافقة | view_item | /product_detail | تفاصيل المنتج | 2560x1440 | أزرق | 3-17 | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660950000000 | تمّ الرفض | تمّ الرفض | add_to_cart | /product_detail | تفاصيل المنتج | 2560x1440 | أزرق | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660970000000 | تمّ منح الموافقة | تمّ الرفض | begin_checkout | /product_detail | تفاصيل المنتج | 2560x1440 | أزرق | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660975000000 | تمّ منح الموافقة | تمّ الرفض | page_view | /purchase_confirmation | تهانينا | 2560x1440 | أزرق | 3-21 | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
| G-67890ABCDE | 121212.3434 | 1000003 | 1609660980000000 | تمّ منح الموافقة | تمّ الرفض | purchase | /purchase_confirmation | تهانينا | 2560x1440 | أرجواني | 3-21 | 234bcd | blue_shoe | حذاء | list_123 | colorful_shoes | 2 | 1 | 30.00 | t12345 | 37.49 | 2.50 | 4.99 | الدولار الأمريكي |
الحدود القصوى المسموح بها
سيتم رفض الأحداث والمعلَمات وخصائص المستخدمين التي تستخدِم أسماء محجوزة.
سيتم رفض معلَمات Item-event (مثل item_list_name) بدون قيم. ويُسمَح بمعلَمات Item-event لمجموعة فرعية مقترَحة من الأحداث (مثل، التجارة الإلكترونية والوظائف والسفر).
يجب أن تتّبع أسماء الأحداث والمعلَمات القواعد التالية:
- يمكن أن تحتوي الأحداث على 25 معلَمة كحدٍ أقصى.
- يمكن أن تحتوي الأحداث على 25 خاصيّة مستخدم بحدٍ أقصى.
- يجب أن تحتوي أسماء خصائص المستخدمين على 24 حرفًا أو أقل.
- يجب أن تحتوي قيم خصائص المستخدمين على 36 حرفًا أو أقل.
- يجب أن تحتوي أسماء الأحداث على 40 حرفًا أو أقل، وأن تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، ويجب أن تبدأ بحرف أبجدي.
- يجب أن تحتوي أسماء المعلَمات (بما في ذلك معلَمات السلع) على 40 حرفًا أو أقل، وأن تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، ويجب أن تبدأ بحرف أبجدي.
- يجب أن تحتوي قيم المعلَمات (بما في ذلك قيم معلَمات السلع) على 100 حرف أو أقل.