‫[GA4] ייבוא של אירועים שמתרחשים אופליין

מידע על נתונים של אירועים שמתרחשים אופליין

אתם יכולים לייבא נתונים של אירועים שמתרחשים אופליין ממקורות שאין להם חיבור לאינטרנט או ממקורות שלא ניתן לאסוף מהם נתוני אירועים בזמן אמת דרך ערכות ה-SDK או Measurement Protocol. אחרי שאתם מעלים אירועים, המערכת מעבדת אותם כאילו נאספו דרך ערכות SDK ומשתמשת בחותמת הזמן שסיפקתם. אם לא תספקו חותמת זמן, המערכת תשתמש בחותמת הזמן של ההעלאה.

אתם יכולים לייבא אירועים שזהים לאירועים שהנתונים שלהם נאספים ב-Analytics באופן אוטומטי או לאירועים המומלצים לענפים שונים, או כל אירוע, פרמטר או מאפיין משתמש שהותאמו אישית והפורמט שלהם תקין. מידע נוסף

כדי להסיר את הנתונים, צריך לשלוח בקשה למחיקת נתונים או למחיקת משתמש.

הסבר על ייבוא נתונים של אירועים שמתרחשים אופליין

כדי לייבא נתונים של אירועים שמתרחשים אופליין, יוצרים קובץ CSV שתואם לסכימת האירועים ב-Analytics. בהמשך מופיעות תבניות לדוגמה, ואתם יכולים לעיין בהן כבר עכשיו.

יצירת המאפיינים המותאמים אישית

אם אתם מייבאים ערכים של מאפיינים שעדיין לא קיימים ב-Analytics ואתם רוצים לראות את הנתונים האלה בדוחות, תצטרכו ליצור את המאפיינים האלה לפני שתעלו את הנתונים. מידע נוסף

אחרי שיוצרים מאפיינים מותאמים אישית, ייקח למערכת Analytics עד 4 שעות לזהות את הנתונים שאתם מייבאים (כדי לוודא שהמאפיינים המותאמים אישית מעובדים, צריך לפתוח ניתוח ולבדוק אם המאפיינים זמינים בבורר המאפיינים).

יצירת קובץ CSV

אפשר ליצור קובץ CSV של נתוני האירועים בעזרת התבנית שלמטה.

העלאת נתונים

תהליך ההעלאה הכללי מפורט במאמר בנושא מידע על ייבוא נתונים.

כשיוצרים את מקור הנתונים, צריך לבחור באפשרות נתוני אירועים אופליין.

כשמדובר באירועים שמתרחשים אופליין, השדות שמיובאים ממופים באופן אוטומטי לשדות של Analytics.

יעברו 24 שעות מהרגע שתעלו את הנתונים ועד שהם יופיעו בדוחות, בקהלים ובניתוחים ב-Analytics.

אם תמחקו מקור נתונים משירות העלאת הנתונים, הנתונים שהועלו לא יימחקו. כמו בכל שיטות האיסוף האחרות, יכול להיות שתצטרכו ליצור בקשה למחיקת הנתונים שייבאתם.

הערה: בחלק מהמקרים אפשר לערוך את שמות השדות, בהתאם לסוג ההעלאה או למקור ייבוא הנתונים.

פרטי מקור הנתונים

מקרא

היקף	אירוע
שדות חובה	‫client_id או app_instance_id [אחד מהשניים] ‫measurement_id או firebase_app_id [אחד מהשניים] ‫(measurement_id ו-client_id) או (firebase_app_id ו-app_instance_id) event_name
נתונים מיובאים	אפשר להעלות נתונים של כל אירוע, פרמטר, פריט או מאפיין משתמש. אלה הפורמטים של כותרות העמודות של כל אחד מסוגי הנתונים: ‫timestamp_micros (אופציונלי, צריך להעלות את הנתונים עד 72 שעות אחרי האירוע. אם לא מספקים חותמת זמן, המערכת משתמשת בחותמת הזמן של ההעלאה) ‫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	GRANTED	DENIED	page_view	‎/home	referrer.com	Home page	1600x900	blue	1-2
G-12345ABCDE	1234567890.0987654321	1000001	1609488060000000	DENIED	DENIED	page_view	‎/video_detail		Video viewer	1600x900	blue	1-4
G-12345ABCDE	1234567890.0987654321	1000001	1609488120000000	DENIED	GRANTED	video_play	‎/video_detail		Video viewer	1600x900	blue
G-67890ABCDE	2345678901.9876543210	1000002	1609574400000000	DENIED	GRANTED	page_view	‎/home	referrer.com	Home page	2560x1440	green	2-2
G-67890ABCDE	2345678901.9876543210	1000002	1609574460000000	DENIED	GRANTED	page_view	‎/product_detail		Product detail	2560x1440	green	2-16
G-67890ABCDE	2345678901.9876543210	1000002	1609574520000000	GRANTED	GRANTED	page_view	‎/product_detail		Product detail	2560x1440	green
G-67890ABCDE	121212.3434	1000003	1609574520000000	GRANTED	GRANTED	page_view	‎/camp_lp_1	referrer.com	Summer Sale!‎	2560x1440	blue	3-1
G-67890ABCDE	121212.3434	1000003	1609660801000000	GRANTED	DENIED	view_item_list	‎/camp_lp_1		Summer Sale!‎	2560x1440	blue		123abc	red_shoe	shoe	list_123	colorful_shoes	1	1		234bcd	blue_shoe	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660860000000	GRANTED	GRANTED	select_item	‎/camp_lp_1		Summer Sale!‎	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660870000000	GRANTED	GRANTED	page_view	‎/product_detail		Product detail	2560x1440	blue	3-5	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660930000000	DENIED	GRANTED	view_item	‎/product_detail		Product detail	2560x1440	blue	3-17	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660950000000	DENIED	DENIED	add_to_cart	‎/product_detail		Product detail	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660970000000	GRANTED	DENIED	begin_checkout	‎/product_detail		Product detail	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660975000000	GRANTED	DENIED	page_view	‎/purchase_confirmation		Congratulations!‪	2560x1440	blue	3-21	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660980000000	GRANTED	DENIED	purchase	‎/purchase_confirmation		Congratulations!‪	2560x1440	purple	3-21	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00					t12345	37.49	2.50	4.99	USD

 

הורדת תבנית של קובץ CSV לייבוא אירועים שמתרחשים אופליין

 

הורדת תבנית של קובץ CSV לייבוא אירועים שמתרחשים אופליין מקמפיינים ליצירת לידים

מגבלות

אירועים, פרמטרים ומאפייני משתמשים שכוללים שמות שמורים יידחו.

פרמטרים של אירועי פריטים (למשל item_list_name) שלא יהיו בהם ערכים יידחו. פרמטרים של אירועי פריטים נתמכים בקבוצת משנה מומלצת של אירועים (לדוגמה, מסחר אלקטרוני, משרות, נסיעות).

אלה הכללים ששמות של אירועים ופרמטרים צריכים לעמוד בהם:

• מותר לכלול באירועים עד 25 פרמטרים.
• מותר לכלול באירועים עד 25 מאפייני משתמשים.
• שמות של מאפייני משתמשים צריכים להיות באורך של עד 24 תווים.
• ערכים של מאפייני משתמשים צריכים להיות באורך של עד 36 תווים.
• שמות של אירועים צריכים להיות באורך של עד 40 תווים, יכולים לכלול רק אותיות, מספרים ותווי קו תחתון, וחייבים להתחיל באות.
• שמות של פרמטרים (כולל פרמטרים של פריטים) צריכים להיות באורך של עד 40 תווים, יכולים לכלול רק אותיות, מספרים ותווי קו תחתון, וחייבים להתחיל באות.
• ערכים של פרמטרים (כולל ערכי פרמטרים של פריטים) צריכים להיות באורך של עד 100 תווים.

מגבלות הייבוא של נתוני אירועים שמתרחשים אופליין

אפשר ליצור עד 10 מקורות לנתונים של אירועים שמתרחשים אופליין.