استيراد أحداث

لمحة عن بيانات الأحداث

يمكنك استيراد الأحداث من مصادر لا يتوفّر لها اتصال بالإنترنت أو مصادر لا يمكنها إتاحة جمع الأحداث في الوقت الفعلي من خلال حِزم تطوير البرامج (SDK) أو Measurement Protocol. وبعد تحميل الأحداث، تتم معالجتها كما لو تم جمعها من خلال حِزم تطوير البرامج (SDK) التابعة لنا، كما أنها تستخدِم الطابع الزمني الذي تقدِّمه أو الطابع الزمني لعملية التحميل إذا لم تقدِّم الطابع الزمني الخاص بك.

يمكنك استيراد أي حدث يتطابق مع الأحداث التي تجمعها "إحصاءات Google" تلقائيًا أو الأحداث التي ننصح بها للقطاعات المختلفة، أو أي حدث أو معلَمة مخصّصة أو خاصيّة مستخدم تم تنسيقها بشكلٍ سليم. مزيد من المعلومات

تتطلّب إزالة هذه البيانات إما طلب حذف بيانات أو حذف مستخدم.

آلية عمل ميزة "استيراد بيانات الأحداث"

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

إنشاء السمات المخصّصة

إذا كنت تستورِد قيمًا لسمات غير متاحة بعد في "إحصاءات Google" وكنت تريد الاطّلاع على هذه البيانات في التقارير، يجب إنشاء تلك السمات قبل تحميل بياناتك. مزيد من المعلومات

بعد إنشاء السمات المخصَّصة، تحتاج خدمة "إحصاءات Google" إلى ما يصل إلى 4 ساعات قبل أن تصبح مستعدّة للتعرّف على البيانات التي يتمّ استيرادها. (يمكنك التحقّق من معالجة السمات المخصّصة عن طريق فتح استكشاف والتحقّق من توفّرها في أداة اختيار السمات).

إنشاء ملف CSV

يمكنك إنشاء ملف CSV ببيانات الأحداث باستخدام النموذج أدناه كدليل إرشادي لك.

تحميل البيانات

تم توضيح إجراء التحميل العام في لمحة عن استيراد البيانات.

عند إنشاء مصدر البيانات، اختَر بيانات الأحداث.

بالنسبة إلى الأحداث، يتم ربط الحقول المستورَدة بحقول "إحصاءات Google" تلقائيًا.

بعد تحميل بياناتك، يمكن أن تستغرق خدمة "إحصاءات Google" ما يصل إلى 24 ساعة لتوفير هذه البيانات في التقارير وقسم "شرائح الجمهور" و"الاستكشافات".

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

ملاحظة: استنادًا إلى نوع عملية التحميل أو مصدر استيراد البيانات، قد يكون من الممكن أو غير الممكن تعديل أسماء الحقول.

تفاصيل مصدر البيانات

التسمية التوضيحية

النطاق	الحدث
حقول مطلوبة	‎[one of] client_id أو app_instance_id ‎[one of] measurement_id أو firebase_app_id (measurement_id وclient_id) أو (firebase_app_id وapp_instance_id) event_name
البيانات المستورَدة	يجوز لك تحميل أي بيانات حدث أو مَعلَمة أو سلعة أو خاصيّة مستخدم باستخدام تنسيقات العناوين التالية: ‫timestamp_micros (اختياري، يجب أن يكون الحدث خلال آخر يومَين تقويميَّين، بالإضافة إلى اليوم الحالي، أو الطابع الزمني لعملية التحميل إذا لم يتم تقديمه) ‫‎user_id (اختياري، ولكن يُنصَح باستخدامه عند توفّره) إشارات الموافقة (اختيارية، ولكن يُنصح باستخدامها بشدّة عند توفّرها. مزيد من المعلومات) ‫event_param.<xxxxx>‎ (استيراد أيّ مَعلمة بأيّ اسم) ‫user_property.<yyyyy>‎ (استيراد أي خاصيّة مستخدم بأي اسم) ‫item<x>.<item_param>‎ (بمعنى آخر، item2.item_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_confirmation		تهانينا!	2560x1440	أرجواني	3-21	234bcd	blue_shoe	حذاء	list_123	colorful_shoes	2	1	30.00					t12345	37.49	2.50	4.99	دولار أمريكي

 

تنزيل نموذج استيراد ملف CSV للأحداث

 

تنزيل نموذج استيراد ملف CSV للأحداث المرتبطة بجذب العملاء المحتمَلين

الحدود

سيتم رفض الأحداث والمعلَمات وخصائص المستخدمين التي تستخدِم أسماء محجوزة.

سيتم رفض معلَمات Item-event (مثل item_list_name) بدون قيم. ويُسمَح بمعلَمات Item-event لمجموعة فرعية مقترَحة من الأحداث (مثل، التجارة الإلكترونية والوظائف والسفر).

يجب أن تتّبع أسماء الأحداث والمعلَمات القواعد التالية:

• يمكن أن تحتوي الأحداث على 25 معلَمة كحدّ أقصى.
• يمكن أن تحتوي الأحداث على 25 خاصيّة مستخدم كحدّ أقصى.
• يجب أن تحتوي أسماء خصائص المستخدمين على 24 حرفًا أو أقل.
• يجب أن تحتوي قيم خصائص المستخدمين على 36 حرفًا أو أقل.
• يجب أن تحتوي أسماء الأحداث على 40 حرفًا أو أقل، وأن تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، ويجب أن تبدأ بحرف أبجدي.
• يجب أن تحتوي أسماء المعلَمات (بما في ذلك معلَمات السلع) على 40 حرفًا أو أقل، وأن تحتوي على أحرف أبجدية رقمية وشرطات سفلية فقط، ويجب أن تبدأ بحرف أبجدي.
• يجب أن تحتوي قيم المَعلمات (بما في ذلك قيم مَعلمات السلع) على 100 حرف أو أقل.

حدود استيراد بيانات الأحداث

يمكنك إنشاء ما يصل إلى 10 مصادر بيانات لبيانات الأحداث.