[GA4] นําเข้าเหตุการณ์ออฟไลน์

เกี่ยวกับข้อมูลเหตุการณ์ออฟไลน์

คุณสามารถนําเข้าเหตุการณ์ออฟไลน์จากแหล่งที่มาที่ไม่มีการเชื่อมต่ออินเทอร์เน็ต หรือไม่รองรับการเก็บรวบรวมเหตุการณ์แบบเรียลไทม์ผ่าน SDK หรือ Measurement Protocol เมื่ออัปโหลดเหตุการณ์แล้ว ระบบจะประมวลผลข้อมูลด้วยวิธีเดียวกันกับการเก็บรวบรวมผ่าน SDK และใช้การประทับเวลาที่คุณระบุ หรือการประทับเวลาของการอัปโหลดในกรณีที่คุณไม่ได้ระบุเอง

นอกจากนี้คุณยังสามารถนำเข้าเหตุการณ์ซึ่งตรงกับเหตุการณ์ที่ Analytics รวบรวมโดยอัตโนมัติ หรือเหตุการณ์ที่เราแนะนำสำหรับธุรกิจประเภทต่างๆ รวมไปถึงเหตุการณ์ พารามิเตอร์ หรือพร็อพเพอร์ตี้ผู้ใช้ที่กำหนดเองซึ่งจัดรูปแบบอย่างถูกต้องได้ ดูข้อมูลเพิ่มเติม

หากต้องการนําข้อมูลนี้ออก คุณจะต้องส่งคําขอลบข้อมูลหรือทำการลบผู้ใช้

วิธีการทํางานของการนําเข้าข้อมูลเหตุการณ์ออฟไลน์

หากต้องการนําเข้าเหตุการณ์ออฟไลน์ คุณจะต้องสร้างไฟล์ CSV ที่ตรงกับสคีมาของเหตุการณ์ Analytics ดูตัวอย่างเทมเพลตด้านล่าง

สร้างมิติข้อมูลที่กําหนดเอง

หากคุณกําลังนําเข้าค่าสําหรับมิติข้อมูลที่ยังไม่มีอยู่ใน Analytics และต้องการดูข้อมูลนั้นในรายงาน คุณจะต้องสร้างมิติข้อมูลเหล่านั้นก่อนที่จะอัปโหลดข้อมูล ดูข้อมูลเพิ่มเติม

เมื่อสร้างมิติข้อมูลที่กําหนดเองแล้ว Analytics ต้องการเวลาสูงสุดไม่เกิน 4 ชั่วโมงก่อนที่จะพร้อมจดจําข้อมูลที่คุณนําเข้า (คุณตรวจสอบได้ว่ามิติข้อมูลที่กําหนดเองได้รับการประมวลผลหรือไม่โดยการเปิดการสํารวจ แล้วตรวจสอบเพื่อดูว่ามีมิติข้อมูลหรือไม่ในเครื่องมือเลือกมิติข้อมูล)

สร้างไฟล์ CSV

สร้างไฟล์ CSV ของข้อมูลเหตุการณ์โดยใช้เทมเพลตด้านล่างเป็นแนวทาง

อัปโหลดข้อมูล

โปรดดูขั้นตอนการอัปโหลดทั่วไปในหัวข้อเกี่ยวกับการนำเข้าข้อมูล

เมื่อสร้างแหล่งข้อมูล ให้เลือกข้อมูลเหตุการณ์ออฟไลน์

สําหรับเหตุการณ์ออฟไลน์ ระบบจะจับคู่ฟิลด์ที่นําเข้ากับฟิลด์ Analytics โดยอัตโนมัติ

หลังจากที่อัปโหลดข้อมูลแล้ว ระบบอาจใช้เวลาสูงสุด 24 ชั่วโมงเพื่อให้ Analytics แสดงข้อมูลในรายงาน กลุ่มเป้าหมาย และการสํารวจ

การลบแหล่งข้อมูลจากบริการอัปโหลดข้อมูลจะไม่ลบข้อมูลที่อัปโหลด และหากใช้ร่วมกับวิธีการรวบรวมข้อมูลอื่นๆ ทั้งหมด คุณอาจต้องลบคําขอลบข้อมูลเพื่อนําข้อมูลที่อัปโหลดผ่านการนำเข้าข้อมูลออกด้วย หากจําเป็น

รายละเอียดแหล่งข้อมูล

คำอธิบาย

ขอบเขต	เหตุการณ์
ฟิลด์ที่จำเป็น	[ฟิลด์ใดฟิลด์หนึ่ง] client_id หรือ app_instance_id [ฟิลด์ใดฟิลด์หนึ่ง] tag_id หรือ firebase_app_id (ag_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	อนุญาตแล้ว	ถูกปฏิเสธ	page_view	/home	referrer.com	หน้าแรก	1600x900	blue	1-2
G-12345ABCDE	1234567890.0987654321	1000001	1609488060000000	ถูกปฏิเสธ	ถูกปฏิเสธ	page_view	/video_detail		โปรแกรมดูวิดีโอ	1600x900	blue	1-4
G-12345ABCDE	1234567890.0987654321	1000001	1609488120000000	ถูกปฏิเสธ	อนุญาตแล้ว	video_play	/video_detail		โปรแกรมดูวิดีโอ	1600x900	blue
G-67890ABCDE	2345678901.9876543210	1000002	1609574400000000	ถูกปฏิเสธ	อนุญาตแล้ว	page_view	/home	referrer.com	หน้าแรก	2560x1440	green	2-2
G-67890ABCDE	2345678901.9876543210	1000002	1609574460000000	ถูกปฏิเสธ	อนุญาตแล้ว	page_view	/product_detail		รายละเอียดผลิตภัณฑ์	2560x1440	green	2-16
G-67890ABCDE	2345678901.9876543210	1000002	1609574520000000	อนุญาตแล้ว	อนุญาตแล้ว	page_view	/product_detail		รายละเอียดผลิตภัณฑ์	2560x1440	green
G-67890ABCDE	121212.3434	1000003	1609574520000000	อนุญาตแล้ว	อนุญาตแล้ว	page_view	/camp_lp_1	referrer.com	ลดราคาฤดูร้อน	2560x1440	blue	3-1
G-67890ABCDE	121212.3434	1000003	1609660801000000	อนุญาตแล้ว	ถูกปฏิเสธ	view_item_list	/camp_lp_1		ลดราคาฤดูร้อน	2560x1440	blue		123abc	red_shoe	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	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660870000000	อนุญาตแล้ว	อนุญาตแล้ว	page_view	/product_detail		รายละเอียดผลิตภัณฑ์	2560x1440	blue	3-5	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660930000000	ถูกปฏิเสธ	อนุญาตแล้ว	view_item	/product_detail		รายละเอียดผลิตภัณฑ์	2560x1440	blue	3-17	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660950000000	ถูกปฏิเสธ	ถูกปฏิเสธ	add_to_cart	/product_detail		รายละเอียดผลิตภัณฑ์	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660970000000	อนุญาตแล้ว	ถูกปฏิเสธ	begin_checkout	/product_detail		รายละเอียดผลิตภัณฑ์	2560x1440	blue		234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660975000000	อนุญาตแล้ว	ถูกปฏิเสธ	page_view	/purchase_confirmation		ยินดีด้วย	2560x1440	blue	3-21	234bcd	blue_shoe	shoe	list_123	colorful_shoes	2	1	30.00
G-67890ABCDE	121212.3434	1000003	1609660980000000	อนุญาตแล้ว	ถูกปฏิเสธ	purchase	/purchase_confirmation		ยินดีด้วย	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 สําหรับเหตุการณ์ออฟไลน์

ข้อจำกัด

ระบบจะปฏิเสธเหตุการณ์ พารามิเตอร์ และพร็อพเพอร์ตี้ผู้ใช้ที่มีชื่อที่สงวนไว้

พารามิเตอร์เหตุการณ์ของรายการ (เช่น item_list_name) ที่ไม่ระบุค่าจะถูกปฏิเสธ ระบบจะรองรับพารามิเตอร์เหตุการณ์ของรายการสําหรับชุดย่อยของเหตุการณ์ที่แนะนํา (เช่น อีคอมเมิร์ซ งาน การท่องเที่ยว)

ชื่อของเหตุการณ์และพารามิเตอร์จะต้องเป็นไปตามกฎดังนี้

• เหตุการณ์มีพารามิเตอร์ได้สูงสุด 25 รายการ
• เหตุการณ์มีพร็อพเพอร์ตี้ผู้ใช้ได้สูงสุด 25 รายการ
• ชื่อพร็อพเพอร์ตี้ผู้ใช้ต้องมีความยาวไม่เกิน 24 อักขระ
• ค่าพร็อพเพอร์ตี้ผู้ใช้ต้องมีความยาวไม่เกิน 36 อักขระ
• ชื่อเหตุการณ์ต้องขึ้นต้นด้วยตัวอักษรและมีความยาวไม่เกิน 40 อักขระ ซึ่งจะใช้ได้เพียงตัวอักษร ตัวเลข และขีดล่างเท่านั้น
• ชื่อพารามิเตอร์ (เช่น พารามิเตอร์ของรายการ) ต้องขึ้นต้นด้วยตัวอักษรและมีความยาวไม่เกิน 40 อักขระ ซึ่งจะใช้ได้เพียงตัวอักษร ตัวเลข และขีดล่างเท่านั้น
• ค่าพารามิเตอร์ (เช่น ค่าพารามิเตอร์ของรายการ) ต้องมีความยาวไม่เกิน 100 อักขระ