[GA4] สคีมา BigQuery Export

บทความนี้จะอธิบายรูปแบบและสคีมาของข้อมูลพร็อพเพอร์ตี้ Google Analytics 4 และข้อมูล Google Analytics สําหรับ Firebase ที่ส่งออกไปยัง BigQuery

ชุดข้อมูล

สําหรับพร็อพเพอร์ตี้ Google Analytics 4 แต่ละรายการและโปรเจ็กต์ Firebase แต่ละโปรเจ็กต์ที่ลิงก์กับ BigQuery ระบบจะเพิ่มชุดข้อมูลเดียวที่ชื่อ "analytics_<property_id>" ลงในโปรเจ็กต์ BigQuery รหัสพร็อพเพอร์ตี้หมายถึงรหัสพร็อพเพอร์ตี้ของ Analytics ซึ่งคุณจะดูได้ในการตั้งค่าพร็อพเพอร์ตี้ของพร็อพเพอร์ตี้ Google Analytics 4 และในการตั้งค่าการวิเคราะห์แอปใน Firebase พร็อพเพอร์ตี้ Google Analytics 4 แต่ละรายการและแอปแต่ละแอปที่เปิดใช้การส่งออก BigQuery จะส่งออกข้อมูลไปยังชุดข้อมูลดังกล่าว

ตาราง

ภายในชุดข้อมูลแต่ละชุด ระบบจะสร้างตารางชื่อ events_YYYYMMDD ในแต่ละวันหากมีการเปิดใช้ตัวเลือกการส่งออกรายวัน

หากเปิดใช้ตัวเลือกการส่งออกแบบสตรีม ระบบจะสร้างตารางชื่อ events_intraday_YYYYMMDD ระบบจะป้อนข้อมูลลงในตารางนี้อย่างต่อเนื่องขณะที่มีการบันทึกเหตุการณ์ตลอดทั้งวัน ระบบจะลบตารางนี้เมื่อสิ้นสุดแต่ละวันเมื่อ events_YYYYMMDD สมบูรณ์แล้ว

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

หากคุณใช้แซนด์บ็อกซ์ของ BigQuery จะไม่มีการนำเข้าเหตุการณ์ระหว่างวันและมีข้อจำกัดเพิ่มเติม

หากต้องการให้มีการนำเข้าระหว่างวัน โปรดอัปเกรดไปใช้เวอร์ชันอื่นที่ไม่ใช่แซนด์บ็อกซ์

คอลัมน์

แต่ละคอลัมน์ในตาราง events_YYYYMMDD แสดงถึงพารามิเตอร์เฉพาะเหตุการณ์ โปรดทราบว่าบางพารามิเตอร์จะซ้อนกันภายใน RECORD และ RECORD บางรายการ เช่น items และ event_params สามารถซ้ำกันได้ คอลัมน์ตารางมีคำอธิบายอยู่ด้านล่าง

ขยายทั้งหมด ยุบทั้งหมด

event

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
ช่องเหตุการณ์มีข้อมูลที่ระบุเหตุการณ์ได้อย่างไม่ซ้ำกัน
event_date	STRING	วันที่ที่บันทึกเหตุการณ์ (รูปแบบ YYYYMMDD ในเขตเวลาที่ลงทะเบียนไว้ของแอป)
event_timestamp	INTEGER	เวลา (เป็นไมโครวินาที เวลา UTC) เมื่อบันทึกเหตุการณ์ในไคลเอ็นต์
event_previous_timestamp	INTEGER	เวลา (เป็นไมโครวินาที เวลา UTC) เมื่อบันทึกเหตุการณ์ไว้ก่อนหน้านี้ในไคลเอ็นต์
event_name	STRING	ชื่อเหตุการณ์
event_value_in_usd	FLOAT	ค่าที่แปลงสกุลเงิน (USD) ของพารามิเตอร์ "ค่า" ของเหตุการณ์
event_bundle_sequence_id	INTEGER	รหัสตามลำดับของแพ็กเกจที่มีการอัปโหลดเหตุการณ์เหล่านี้
event_server_timestamp_offset	INTEGER	การชดเชยการประทับเวลาระหว่างเวลาเก็บรวบรวมข้อมูลกับเวลาในการอัปโหลดเป็นไมโครวินาที

RECORD event_params

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD event_params สามารถจัดเก็บพารามิเตอร์เหตุการณ์ตามบริบทและระดับแคมเปญ รวมถึงพารามิเตอร์เหตุการณ์ที่ผู้ใช้กําหนด RECORD event_params ซ้ำกันสําหรับแต่ละคีย์ที่เชื่อมโยงกับเหตุการณ์ ชุดพารามิเตอร์ที่จัดเก็บไว้ใน RECORD event_params เป็นแบบไม่ซ้ำกันสําหรับการติดตั้งใช้งานแต่ละรายการ หากต้องการดูรายการพารามิเตอร์เหตุการณ์ทั้งหมดสําหรับการติดตั้งใช้งาน โปรดค้นหารายการพารามิเตอร์เหตุการณ์
event_params.key	STRING	ชื่อพารามิเตอร์เหตุการณ์
event_params.value	RECORD	ระเบียนที่มีค่าพารามิเตอร์เหตุการณ์
event_params.value.string_value	STRING	หากพารามิเตอร์เหตุการณ์แสดงด้วยสตริง เช่น URL หรือชื่อแคมเปญ ระบบจะป้อนข้อมูลในช่องนี้
event_params.value.int_value	INTEGER	หากพารามิเตอร์เหตุการณ์แสดงด้วยจํานวนเต็ม ระบบจะป้อนข้อมูลในช่องนี้
event_params.value.double_value	FLOAT	หากพารามิเตอร์เหตุการณ์แสดงด้วยค่า Double ระบบจะป้อนข้อมูลในช่องนี้
event_params.value.float_value	FLOAT	หากพารามิเตอร์เหตุการณ์แสดงด้วยค่าทศนิยม ระบบจะป้อนข้อมูลในช่องนี้ ไม่มีการใช้งานช่องนี้อยู่ในขณะนี้

RECORD item_params

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD item_params สามารถจัดเก็บพารามิเตอร์รายการ รวมถึงพารามิเตอร์รายการที่กำหนดโดยผู้ใช้ได้ ชุดพารามิเตอร์ที่จัดเก็บไว้ใน RECORD item_params เป็นแบบไม่ซ้ำกันสำหรับการติดตั้งใช้งานแต่ละรายการ
item_params.key	STRING	ชื่อพารามิเตอร์รายการ
item_params.value	RECORD	ระเบียนที่มีค่าพารามิเตอร์รายการ
item_params.value.string_value	STRING	หากพารามิเตอร์รายการแสดงด้วยสตริง ระบบจะกรอกข้อมูลในช่องนี้
item_params.value.int_value	INTEGER	หากพารามิเตอร์รายการแสดงด้วยจำนวนเต็ม ระบบจะกรอกข้อมูลในช่องนี้
item_params.value.double_value	FLOAT	หากพารามิเตอร์รายการแสดงด้วยค่า Double ระบบจะกรอกข้อมูลในช่องนี้
item_params.value.float_value	FLOAT	หากพารามิเตอร์รายการแสดงด้วยค่าทศนิยม ระบบจะกรอกข้อมูลในช่องนี้

user

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
ช่องผู้ใช้มีข้อมูลที่ระบุตัวผู้ใช้ที่เชื่อมโยงกับเหตุการณ์ได้อย่างไม่ซ้ำกัน
is_active_user	BOOLEAN	ผู้ใช้ใช้งานอยู่ (จริง) หรือไม่ได้ใช้งานอยู่ (เท็จ) ในช่วงหนึ่งๆ ของวันตามปฏิทิน รวมอยู่ในตารางรายวันเท่านั้น (`events_YYYYMMDD)`
user_id	STRING	รหัสที่ไม่ซ้ำกันที่กําหนดให้ผู้ใช้
user_pseudo_id	STRING	รหัสที่ไม่ระบุตัวตน (เช่น รหัสอินสแตนซ์ของแอป) สำหรับผู้ใช้
user_first_touch_timestamp	INTEGER	เวลา (เป็นไมโครวินาที) ที่ผู้ใช้เปิดแอปหรือเข้าชมเว็บไซต์เป็นครั้งแรก

ช่อง privacy_info

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
ช่อง privacy_info มีข้อมูลตามสถานะความยินยอมของผู้ใช้เมื่อเปิดใช้โหมดความยินยอม
privacy_info.ads_storage	STRING	เปิดใช้งานการกําหนดเป้าหมายโฆษณาสำหรับผู้ใช้หรือไม่ ค่าที่เป็นไปได้: ใช่ ไม่ ไม่ได้ตั้งค่า
privacy_info.analytics_storage	STRING	เปิดใช้พื้นที่เก็บข้อมูล Analytics สําหรับผู้ใช้หรือไม่ ค่าที่เป็นไปได้: ใช่ ไม่ ไม่ได้ตั้งค่า
privacy_info.uses_Transient_token	STRING	ผู้ใช้เว็บปฏิเสธพื้นที่เก็บข้อมูล Analytics และนักพัฒนาซอฟต์แวร์เปิดใช้การวัดโดยไม่มีคุกกี้ตามโทเค็นค่าชั่วคราวในข้อมูลเซิร์ฟเวอร์แล้วหรือไม่ ค่าที่เป็นไปได้: ใช่ ไม่ ไม่ได้ตั้งค่า

RECORD user_properties

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD user_properties มีพร็อพเพอร์ตี้ผู้ใช้ที่คุณตั้งค่าไว้ ซึ่งซ้ำกันสำหรับแต่ละคีย์ที่เชื่อมโยงกับผู้ใช้
user_properties.key	STRING	ชื่อของพร็อพเพอร์ตี้ผู้ใช้
user_properties.value	RECORD	ระเบียนสำหรับค่าพร็อพเพอร์ตี้ผู้ใช้
user_properties.value.string_value	STRING	ค่าสตริงของพร็อพเพอร์ตี้ผู้ใช้
user_properties.value.int_value	INTEGER	ค่าจำนวนเต็มของพร็อพเพอร์ตี้ผู้ใช้
user_properties.value.double_value	FLOAT	ค่าทศนิยมของพร็อพเพอร์ตี้ผู้ใช้
user_properties.value.float_value	FLOAT	ปัจจุบันช่องนี้ไม่ได้ใช้งาน
user_properties.value.set_timestamp_micros	INTEGER	เวลา (เป็นไมโครวินาที) ที่ตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ครั้งล่าสุด

RECORD user_ltv

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD user_ltv มีข้อมูลมูลค่าตลอดอายุการใช้งานเกี่ยวกับผู้ใช้ ตารางระหว่างวันจะไม่มีข้อมูลใน RECORD นี้
user_ltv.revenue	FLOAT	มูลค่าตลอดอายุการใช้งาน (รายได้) ของผู้ใช้ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_ltv.currency	STRING	มูลค่าตลอดอายุการใช้งาน (สกุลเงิน) ของผู้ใช้ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้

device

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD อุปกรณ์มีข้อมูลเกี่ยวกับอุปกรณ์ที่สร้างเหตุการณ์
device.category	STRING	หมวดหมู่อุปกรณ์ (โทรศัพท์มือถือ แท็บเล็ต เดสก์ท็อป)
device.mobile_brand_name	STRING	ชื่อแบรนด์อุปกรณ์
device.mobile_model_name	STRING	ชื่อรุ่นอุปกรณ์
device.mobile_marketing_name	STRING	ชื่อทางการตลาดของอุปกรณ์
device.mobile_os_hardware_model	STRING	ข้อมูลรุ่นของอุปกรณ์ที่ดึงมาจากระบบปฏิบัติการโดยตรง
device.operating_system	STRING	ระบบปฏิบัติการของอุปกรณ์
device.operating_system_version	STRING	เวอร์ชันของระบบปฏิบัติการ
device.vendor_id	STRING	IDFV (แสดงเฉพาะเมื่อไม่มีการรวบรวม IDFA)
device.advertising_id	STRING	รหัสโฆษณา/IDFA
device.language	STRING	ภาษาของระบบปฏิบัติการ
device.time_zone_offset_seconds	INTEGER	ค่าออฟเซ็ตจาก GMT เป็นวินาที
device.is_limited_ad_tracking	BOOLEAN	การตั้งค่า "จำกัดการติดตามโฆษณา" ของอุปกรณ์ ใน iOS14+ จะแสดงผลเป็นเท็จ หาก IDFA ไม่ใช่ 0
device.web_info.browser	STRING	เบราว์เซอร์ที่ผู้ใช้ดูเนื้อหา
device.web_info.browser_version	STRING	เวอร์ชันของเบราว์เซอร์ที่ผู้ใช้ดูเนื้อหา
device.web_info.hostname	STRING	ชื่อโฮสต์ที่เชื่อมโยงกับเหตุการณ์ที่บันทึกไว้

geo

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD geo มีข้อมูลเกี่ยวกับสถานที่ตั้งทางภูมิศาสตร์ที่เริ่มต้นเหตุการณ์
geo.continent	STRING	ทวีปตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
geo.sub_continent	STRING	อนุทวีปตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
geo.country	STRING	ประเทศตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
geo.region	STRING	ภูมิภาคตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
geo.metro	STRING	เมืองใหญ่ตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
geo.city	STRING	เมืองตามที่อยู่ IP ที่มีการรายงานเหตุการณ์

app_info

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD app_info มีข้อมูลเกี่ยวกับแอปที่เริ่มต้นเหตุการณ์
app_info.id	STRING	ชื่อแพ็กเกจหรือรหัสชุดของแอป
app_info.firebase_app_id	STRING	รหัสแอป Firebase ที่เชื่อมโยงกับแอป
app_info.install_source	STRING	Store ที่ติดตั้งแอป
app_info.version	STRING	versionName (Android) หรือเวอร์ชัน Bundle แบบย่อของแอป

collected_traffic_source

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD collected_traffic_source มีข้อมูลบันทึกการเข้าชมที่รวบรวมพร้อมกับเหตุการณ์
manual_campaign_id	STRING	รหัสแคมเปญที่กําหนดเอง (utm_id) ที่รวบรวมพร้อมกับเหตุการณ์
manual_campaign_name	STRING	ชื่อแคมเปญที่กําหนดเอง (utm_campaign) ที่รวบรวมพร้อมกับเหตุการณ์
manual_source	STRING	แหล่งที่มาของแคมเปญที่กำหนดเอง (utm_source) ที่รวบรวมพร้อมกับเหตุการณ์ นอกจากนี้ยังมีพารามิเตอร์ที่แยกวิเคราะห์จากพารามิเตอร์การอ้างอิง ไม่ใช่แค่ค่า UTM
manual_medium	STRING	สื่อแคมเปญที่กำหนดเอง (utm_medium) ที่รวบรวมพร้อมกับเหตุการณ์ นอกจากนี้ยังมีพารามิเตอร์ที่แยกวิเคราะห์จากพารามิเตอร์การอ้างอิง ไม่ใช่แค่ค่า UTM
manual_term	STRING	คีย์เวิร์ด/คําของแคมเปญที่กําหนดเอง (utm_term) ที่รวบรวมพร้อมกับเหตุการณ์
manual_content	STRING	ข้อมูลเมตาเกี่ยวกับแคมเปญที่กําหนดเองเพิ่มเติม (utm_content) ที่รวบรวมพร้อมกับเหตุการณ์
gclid	STRING	หมายเลขระบุคลิกของ Google ที่รวบรวมพร้อมกับเหตุการณ์
dclid	STRING	ตัวระบุ Google Marketing Platform (GMP) ที่รวบรวมพร้อมกับเหตุการณ์
srsltid	STRING	ตัวระบุ Google Merchant Center ที่รวบรวมพร้อมกับเหตุการณ์

traffic_source

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD traffic_source มีข้อมูลเกี่ยวกับแหล่งที่มาของการเข้าชมที่ได้ผู้ใช้ก่อน ตารางระหว่างวันจะไม่มีข้อมูลใน RECORD นี้ หมายเหตุ: ค่า traffic_source จะไม่เปลี่ยนแปลงหากผู้ใช้โต้ตอบกับแคมเปญต่อๆ ไปหลังการติดตั้ง
traffic_source.name	STRING	ชื่อแคมเปญการตลาดที่ได้ผู้ใช้ก่อน ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
traffic_source.medium	STRING	ชื่อสื่อ (การค้นหาที่เสียค่าใช้จ่าย การค้นหาทั่วไป อีเมล ฯลฯ) ที่ได้ผู้ใช้ก่อน ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
traffic_source.source	STRING	ชื่อเครือข่ายที่ได้ผู้ใช้ก่อน ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้

stream and platform

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
ช่องสตรีมและแพลตฟอร์มมีข้อมูลเกี่ยวกับแพลตฟอร์มสตรีมและแอป
stream_id	STRING	รหัสตัวเลขของสตรีมข้อมูลที่เกิดเหตุการณ์
platform	STRING	แพลตฟอร์มสตรีมข้อมูล (เว็บ, iOS หรือ Android) ที่เกิดเหตุการณ์

ecommerce

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD ecommerce นี้มีข้อมูลเกี่ยวกับเหตุการณ์อีคอมเมิร์ซที่ตั้งค่าไว้ในเว็บไซต์หรือแอป
ecommerce.total_item_quantity	INTEGER	จํานวนสินค้าทั้งหมดในเหตุการณ์นี้ซึ่งเท่ากับผลรวมของ items.quantity
ecommerce.purchase_revenue_in_usd	FLOAT	รายได้จากการซื้อของเหตุการณ์นี้ซึ่งแสดงเป็น USD ที่มีหน่วยมาตรฐาน ระบุข้อมูลสําหรับเหตุการณ์การซื้อเท่านั้น
ecommerce.purchase_revenue	FLOAT	รายได้จากการซื้อของเหตุการณ์นี้ซึ่งแสดงเป็นสกุลเงินท้องถิ่นที่มีหน่วยมาตรฐาน ระบุข้อมูลสําหรับเหตุการณ์การซื้อเท่านั้น
ecommerce.refund_value_in_usd	FLOAT	จํานวนเงินคืนในเหตุการณ์นี้ซึ่งแสดงเป็น USD ที่มีหน่วยมาตรฐาน ระบุข้อมูลสำหรับเหตุการณ์การคืนเงินเท่านั้น
ecommerce.refund_value	FLOAT	จํานวนเงินคืนในเหตุการณ์นี้ซึ่งแสดงเป็นสกุลเงินท้องถิ่นที่มีหน่วยมาตรฐาน ระบุข้อมูลสำหรับเหตุการณ์การคืนเงินเท่านั้น
ecommerce.shipping_value_in_usd	FLOAT	ค่าจัดส่งในเหตุการณ์นี้ซึ่งแสดงเป็น USD ที่มีหน่วยมาตรฐาน
ecommerce.shipping_value	FLOAT	ค่าจัดส่งในเหตุการณ์นี้ซึ่งแสดงเป็นสกุลเงินท้องถิ่น
ecommerce.tax_value_in_usd	FLOAT	มูลค่าภาษีในเหตุการณ์นี้ซึ่งแสดงเป็นสกุลเงิน USD ที่มีหน่วยมาตรฐาน
ecommerce.tax_value	FLOAT	มูลค่าภาษีในเหตุการณ์นี้ซึ่งแสดงเป็นสกุลเงินท้องถิ่นที่มีหน่วยมาตรฐาน
ecommerce.transaction_id	STRING	รหัสธุรกรรมของธุรกรรมอีคอมเมิร์ซ
ecommerce.unique_items	INTEGER	จำนวนสินค้าที่ไม่ซ้ำกันในเหตุการณ์นี้ อิงตาม item_id, item_name และ item_brand

items

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD สินค้ามีข้อมูลเกี่ยวกับสินค้าที่รวมอยู่ในเหตุการณ์ ซึ่งซ้ำกันสำหรับสินค้าแต่ละรายการ
items.item_id	STRING	รหัสของสินค้า
items.item_name	STRING	ชื่อของสินค้า
items.item_brand	STRING	แบรนด์ของสินค้า
items.item_variant	STRING	รายละเอียดปลีกย่อยของสินค้า
items.item_category	STRING	หมวดหมู่ของสินค้า
items.item_category2	STRING	หมวดหมู่ย่อยของสินค้า
items.item_category3	STRING	หมวดหมู่ย่อยของสินค้า
items.item_category4	STRING	หมวดหมู่ย่อยของสินค้า
items.item_category5	STRING	หมวดหมู่ย่อยของสินค้า
items.price_in_usd	FLOAT	ราคาสินค้าเป็น USD ที่มีหน่วยมาตรฐาน
items.price	FLOAT	ราคาสินค้าเป็นสกุลเงินท้องถิ่น
items.quantity	INTEGER	จํานวนสินค้า กําหนดจํานวนเป็น 1 หากไม่ได้ระบุไว้
items.item_revenue_in_usd	FLOAT	รายได้ของสินค้านี้ โดยคํานวณเป็นจำนวน price_in_usd * ช่องนี้มีไว้สำหรับระบุข้อมูลเหตุการณ์การซื้อเท่านั้น ซึ่งแสดงเป็น USD ที่มีหน่วยมาตรฐาน
items.item_revenue	FLOAT	รายได้ของสินค้านี้โดยคํานวณจากจำนวน price * ช่องนี้มีไว้สำหรับระบุข้อมูลเหตุการณ์การซื้อเท่านั้น ซึ่งแสดงเป็นสกุลเงินท้องถิ่นที่มีหน่วยมาตรฐาน
items.item_refund_in_usd	FLOAT	มูลค่าการคืนเงินของสินค้านี้ โดยคํานวณเป็นจํานวน price_in_usd * ช่องนี้มีไว้สำหรับระบุข้อมูลเหตุการณ์การคืนเงินเท่านั้น ซึ่งแสดงเป็น USD ที่มีหน่วยมาตรฐาน
items.item_refund	FLOAT	มูลค่าการคืนเงินของสินค้านี้ โดยคํานวณจากจำนวน price * ช่องนี้มีไว้สำหรับระบุข้อมูลเหตุการณ์การคืนเงินเท่านั้น ซึ่งแสดงเป็นสกุลเงินท้องถิ่นที่มีหน่วยมาตรฐาน
items.coupon	STRING	รหัสคูปองที่ใช้กับสินค้านี้
items.affiliation	STRING	แอฟฟิลิเอตผลิตภัณฑ์ที่กำหนดบริษัทจัดหาบริการหรือสถานที่ตั้งของหน้าร้านจริง
items.location_id	STRING	สถานที่ที่เชื่อมโยงกับสินค้า
items.item_list_id	STRING	รหัสของรายการที่แสดงสินค้าต่อผู้ใช้
items.item_list_name	STRING	ชื่อของรายการที่แสดงสินค้าต่อผู้ใช้
Items.item_list_index	STRING	ตําแหน่งของสินค้าในรายการ
items.promotion_id	STRING	รหัสของโปรโมชันผลิตภัณฑ์
items.promotion_name	STRING	ชื่อของโปรโมชันผลิตภัณฑ์
items.creative_name	STRING	ชื่อของครีเอทีฟโฆษณาที่ใช้ในสปอตที่โปรโมต
items.creative_slot	STRING	ชื่อของสล็อตครีเอทีฟโฆษณา

RECORD item_params

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
RECORD item_params จะจัดเก็บพารามิเตอร์รายการที่กำหนดเองซึ่งคุณกำหนดไว้ โปรดทราบว่าพารามิเตอร์รายการที่กำหนดไว้ล่วงหน้า เช่น item_id, item_name และอื่นๆ จะไม่รวมอยู่ในนี้ แต่ส่งออกเป็นช่องที่ชัดเจนแทน ชุดพารามิเตอร์ที่จัดเก็บไว้ใน RECORD item_params เป็นแบบไม่ซ้ำกันสําหรับการติดตั้งใช้งานแต่ละรายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานอีคอมเมิร์ซและอาร์เรย์รายการของ Google Analytics 4 ได้ที่ส่วนวัดอีคอมเมิร์ซ
items.item_params.key	STRING	ชื่อพารามิเตอร์รายการ
items.item_params.value	RECORD	ระเบียนที่มีค่าพารามิเตอร์รายการ
items.item_params.value.string_value	STRING	หากพารามิเตอร์รายการแสดงด้วยสตริง ระบบจะกรอกข้อมูลในช่องนี้
items.item_params.value.int_value	INTEGER	หากพารามิเตอร์รายการแสดงด้วยจำนวนเต็ม ระบบจะกรอกข้อมูลในช่องนี้
items.item_params.value.double_value	FLOAT	หากพารามิเตอร์รายการแสดงด้วยค่า Double ระบบจะกรอกข้อมูลในช่องนี้
items.item_params.value.float_value	FLOAT	หากพารามิเตอร์รายการแสดงด้วยค่าทศนิยม ระบบจะกรอกข้อมูลในช่องนี้

แถว

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

event_date	event_timestamp	event_name	event_params.key	event_params_value.string_value
20220222	1643673600483790	page_view	page_location	https://example.com
			page_title	Home
			medium	referral
			source	Google
			page_referrer	https://www.google.com
			<parameters...>	<values...>

ข้อมูลเหตุการณ์นี้จะแสดงดังต่อไปนี้ในอินเทอร์เฟซผู้ใช้ GA4

ข้อควรพิจารณาสำหรับการอัปเดต SDK เป็น Android 17.2.5 (หรือใหม่กว่า) และ/หรือ iOS: 16.20.0 (หรือใหม่กว่า)

คุณควรพิจารณาสิ่งต่อไปนี้ หากคุณใช้ SDK เวอร์ชันก่อนหน้าและวางแผนที่จะอัปเกรดเป็น Android 17.2.5 (หรือใหม่กว่า) และ/หรือ iOS 16.20.0 (หรือใหม่กว่า)

หากต้องการใช้สคีมา BigQuery Export ปัจจุบัน คุณต้องอัปเกรด SDK เป็น Android 17.2.5 (หรือใหม่กว่า) และ/หรือ iOS 16.20.0 (หรือใหม่กว่า) เมื่อใช้ SDK เวอร์ชันก่อนหน้า ข้อมูลที่ส่งออกจะแสดงสคีมาเดิม
หลังจากอัปเกรดเป็นต้นไป คุณจะเข้าถึงข้อมูลสินค้าภายในอาร์เรย์รายการที่ซ้ำกันได้เท่านั้น จะไม่มีข้อมูลสินค้าอยู่ในพารามิเตอร์เหตุการณ์มาตรฐานอีกต่อไป เนื่องจากเป็นข้อมูลที่อยู่ใน SDK เวอร์ชันก่อนหน้านี้
การเปลี่ยนแปลงนี้มีขึ้นเพื่อสนับสนุนการวิเคราะห์ผลิตภัณฑ์หลายรายการ
คุณอาจต้องปรับการอ้างอิงถึงข้อมูลสินค้า/ผลิตภัณฑ์

ใช้สคริปต์นี้เพื่อย้ายชุดข้อมูลของ BigQuery ที่มีอยู่จากสคีมาการส่งออกเก่าไปยังสคีมาใหม่

ลงชื่อเข้าใช้หน้าคอนโซล Cloud Platform >: จัดการทรัพยากร
เปิดโปรเจ็กต์ที่มีข้อมูลที่ต้องการย้ายแล้วคลิกเปิดใช้งาน Google Cloud Shell ที่ด้านบนของหน้า

เมื่อเปิด Shell แล้ว ให้คัดลอกสคริปต์ด้านล่างไปยังไฟล์ชื่อ migration_script.sql ดังนี้

ออกคำสั่ง cat > migration_script.sql
คัดลอกสคริปต์ด้านล่างและวางลงใน Shell
กด Ctrl+D เพื่อบันทึกและออก

สคริปต์ (migration_script.sql) คือ

  SELECT
  @date AS event_date,
  event.timestamp_micros AS event_timestamp,
  event.previous_timestamp_micros AS event_previous_timestamp,
  event.name AS event_name,
  event.value_in_usd  AS event_value_in_usd,
   user_dim.bundle_info.bundle_sequence_id AS event_bundle_sequence_id,
  user_dim.bundle_info.server_timestamp_offset_micros as event_server_timestamp_offset,
  (
  SELECT
    ARRAY_AGG(STRUCT(event_param.key AS key,
        STRUCT(event_param.value.string_value AS string_value,
          event_param.value.int_value AS int_value,
          event_param.value.double_value AS double_value, 
          event_param.value.float_value AS float_value) AS value))
  FROM
    UNNEST(event.params) AS event_param) AS event_params,
  user_dim.first_open_timestamp_micros AS user_first_touch_timestamp,
  user_dim.user_id AS user_id,
  user_dim.app_info.app_instance_id AS user_pseudo_id,
  "" AS stream_id,
  user_dim.app_info.app_platform AS platform,
  STRUCT( user_dim.ltv_info.revenue AS revenue,
    user_dim.ltv_info.currency AS currency ) AS user_ltv,
  STRUCT( user_dim.traffic_source.user_acquired_campaign AS name,
      user_dim.traffic_source.user_acquired_medium AS medium,
      user_dim.traffic_source.user_acquired_source AS source ) AS traffic_source,
  STRUCT( user_dim.geo_info.continent AS continent,
    user_dim.geo_info.country AS country,
    user_dim.geo_info.region AS region,
    user_dim.geo_info.city AS city ) AS geo,
  STRUCT( user_dim.device_info.device_category AS category,
    user_dim.device_info.mobile_brand_name,
    user_dim.device_info.mobile_model_name,
    user_dim.device_info.mobile_marketing_name,
    user_dim.device_info.device_model AS mobile_os_hardware_model,
    @platform AS operating_system,
    user_dim.device_info.platform_version AS operating_system_version,
    user_dim.device_info.device_id AS vendor_id,
    user_dim.device_info.resettable_device_id AS advertising_id,
    user_dim.device_info.user_default_language AS language,
    user_dim.device_info.device_time_zone_offset_seconds AS time_zone_offset_seconds,
    IF(user_dim.device_info.limited_ad_tracking, "Yes", "No") AS is_limited_ad_tracking ) AS device,
  STRUCT( user_dim.app_info.app_id AS id,
    @firebase_app_id  AS firebase_app_id,
    user_dim.app_info.app_version AS version,
    user_dim.app_info.app_store AS install_source ) AS app_info,
  (
  SELECT
    ARRAY_AGG(STRUCT(user_property.key AS key,
        STRUCT(user_property.value.value.string_value AS string_value,
          user_property.value.value.int_value AS int_value,
          user_property.value.value.double_value AS double_value,
          user_property.value.value.float_value AS float_value,
          user_property.value.set_timestamp_usec AS set_timestamp_micros ) AS value))
  FROM
    UNNEST(user_dim.user_properties) AS user_property) AS user_properties
FROM
  `SCRIPT_GENERATED_TABLE_NAME`,
  UNNEST(event_dim) AS event

เปิด Shell ใหม่และคัดลอกสคริปต์ Bash ด้านล่างไปยังไฟล์ชื่อ migration.sh ดังนี้

ออกคำสั่ง cat > migration.sh
คัดลอกสคริปต์ด้านล่างและวางลงใน Shell
กด Ctrl+D เพื่อบันทึกและออก

แก้ไขสคริปต์ต่อไปนี้เพื่อรวมรหัสพร็อพเพอร์ตี้ Analytics, รหัสโครงการ BigQuery, รหัสแอป Firebase, ชื่อชุดข้อมูล BigQuery รวมถึงวันที่เริ่มต้นและวันที่สิ้นสุดของข้อมูลที่คุณต้องการ

สคริปต์ (migration.sh) คือ

# รหัสพร็อพเพอร์ตี้ Analytics สำหรับโปรเจ็กต์ หารหัสนี้ในการตั้งค่า Analytics ใน Firebase
PROPERTY_ID=รหัสพร็อพเพอร์ตี้ Analytics

# โปรเจ็กต์ BigQuery Export
BQ_PROJECT_ID="รหัสโปรเจ็กต์ BigQuery" (เช่น "firebase-public-project")

# รหัสแอป Firebase ของแอป
FIREBASE_APP_ID="รหัสแอป Firebase" (เช่น "1:300830567303:ios:09b1ab1d3ca29bda")

# ชุดข้อมูลที่มีข้อมูลที่จะนำเข้า
BQ_DATASET="ชื่อชุดข้อมูล BigQuery ที่ต้องการนำเข้า" (เช่น "com_firebase_demo_IOS")

# แพลตฟอร์ม
PLATFORM="แพลตฟอร์มของแอป ได้แก่ Android หรือ IOS"

# ช่วงวันที่ที่ต้องการย้ายข้อมูล ใส่ [START_DATE,END_DATE]
START_DATE=20180324
END_DATE=20180327

# หากไม่มั่นใจโปรดอย่าแก้ไขสคริปต์ด้านล่าง
startdate=$(date -d"$START_DATE"  +%Y%m%d) || exit -1
enddate=$(date -d"$END_DATE"  +%Y%m%d) || exit -1

# ทำซ้ำในช่วงวันดังกล่าว
DATE="$startdate"
while [ "$DATE" -le "$enddate" ]; do

        # ตาราง BQ สร้างขึ้นจากพารามิเตอร์ด้านบนนี้
        BQ_TABLE="$BQ_PROJECT_ID.$BQ_DATASET.app_events_$DATE"

        echo "Migrating $BQ_TABLE"

        cat migration_script.sql | sed -e "s/SCRIPT_GENERATED_TABLE_NAME/$BQ_TABLE/g" | bq query \
        --debug_mode \
        --allow_large_results \
        --noflatten_results \
        --use_legacy_sql=False \
        --destination_table analytics_$PROPERTY_ID.events_$DATE \
        --batch \
        --append_table \
        --parameter=firebase_app_id::$FIREBASE_APP_ID \
        --parameter=date::$DATE \
        --parameter=platform::$PLATFORM \
        --project_id=$BQ_PROJECT_ID


        temp=$(date -I -d "$DATE + 1 day")
        DATE=$(date -d "$temp" +%Y%m%d)

done
exit

# สิ้นสุดสคริปต์

เปิด Shell ใหม่และออกคำสั่ง bash migration.sh

สคีมาการส่งออกเดิม

user_dim

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
user_dim	RECORD	ระเบียนของมิติข้อมูลผู้ใช้
user_dim.user_id	STRING	User ID ที่ตั้งค่าผ่าน setUserId API
user_dim.first_open_timestamp_micros	INTEGER	เวลา (เป็นไมโครวินาที) ที่ผู้ใช้เปิดแอปเป็นครั้งแรก
user_dim.user_properties	RECORD	ระเบียนซ้ำของพร็อพเพอร์ตี้ผู้ใช้ที่ตั้งค่าด้วย setUserProperty API
user_dim.user_properties.key	STRING	ชื่อของพร็อพเพอร์ตี้ผู้ใช้
user_dim.user_properties.value	RECORD	ระเบียนของข้อมูลเกี่ยวกับพร็อพเพอร์ตี้ผู้ใช้
user_dim.user_properties.value.value	RECORD	ระเบียนสำหรับค่าพร็อพเพอร์ตี้ผู้ใช้
user_dim.user_properties.value.value.string_value	STRING	ค่าสตริงของพร็อพเพอร์ตี้ผู้ใช้
user_dim.user_properties.value.value.int_value	INTEGER	ค่าจำนวนเต็มของพร็อพเพอร์ตี้ผู้ใช้
user_dim.user_properties.value.value.double_value	FLOAT	ค่าทศนิยมของพร็อพเพอร์ตี้ผู้ใช้
user_dim.user_properties.value.set_timestamp_usec	INTEGER	เวลา (เป็นไมโครวินาที) ที่ตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ครั้งล่าสุด
user_dim.user_properties.value.index	INTEGER	ดัชนี (0-24) ของพร็อพเพอร์ตี้ผู้ใช้
user_dim.device_info	RECORD	ระเบียนของข้อมูลอุปกรณ์
user_dim.device_info.device_category	STRING	หมวดหมู่อุปกรณ์ (โทรศัพท์มือถือ แท็บเล็ต เดสก์ท็อป)
user_dim.device_info.mobile_brand_name	STRING	ชื่อแบรนด์อุปกรณ์
user_dim.device_info.mobile_model_name	STRING	ชื่อรุ่นอุปกรณ์
user_dim.device_info.mobile_marketing_name	STRING	ชื่อทางการตลาดของอุปกรณ์
user_dim.device_info.device_model	STRING	รูปอุปกรณ์
user_dim.device_info.platform_version	STRING	เวอร์ชันของระบบปฏิบัติการ
user_dim.device_info.device_id	STRING	IDFV (แสดงต่อเมื่อไม่มี IDFA)
user_dim.device_info.resettable_device_id	STRING	รหัสโฆษณา/IDFA
user_dim.device_info.user_default_language	STRING	ภาษาของระบบปฏิบัติการ
user_dim.device_info.device_time_zone_offset_seconds	INTEGER	ค่าออฟเซ็ตจาก GMT เป็นวินาที
user_dim.device_info.limited_ad_tracking	BOOLEAN	การตั้งค่า "จำกัดการติดตามโฆษณา" ของอุปกรณ์
user_dim.geo_info	RECORD	ระเบียนสำหรับข้อมูลทางภูมิศาสตร์ของผู้ใช้
user_dim.geo_info.continent	STRING	ทวีปตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
user_dim.geo_info.country	STRING	ประเทศตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
user_dim.geo_info.region	STRING	ภูมิภาคตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
user_dim.geo_info.city	STRING	เมืองตามที่อยู่ IP ที่มีการรายงานเหตุการณ์
user_dim.app_info	RECORD	ระเบียนของข้อมูลในแอป
user_dim.app_info.app_version	STRING	versionName (Android) หรือเวอร์ชัน Bundle แบบย่อของแอป
user_dim.app_info.app_instance_id	STRING	รหัสที่ไม่ซ้ำกันสำหรับอินสแตนซ์นี้ของแอป
user_dim.app_info.app_store	STRING	ร้านที่ติดตั้งแอปนี้
user_dim.app_info.app_platform	STRING	แพลตฟอร์มที่แอปนี้ทำงานอยู่
user_dim.traffic_source	RECORD	ชื่อแหล่งที่มาของการเข้าชมที่ใช้เพื่อให้ได้ผู้ใช้ใหม่ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_dim.traffic_source.user_acquired_campaign	STRING	ชื่อแคมเปญการตลาดที่ได้ผู้ใช้ใหม่ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_dim.traffic_source.user_acquired_medium	STRING	ชื่อของสื่อ (การค้นหาที่เสียค่าใช้จ่าย การค้นหาทั่วไป อีเมล ฯลฯ) ที่ได้ผู้ใช้ใหม่ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_dim.traffic_source.user_acquired_source	STRING	ชื่อเครือข่ายที่ได้ผู้ใช้ใหม่ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_dim.bundle_info	RECORD	ระเบียนของข้อมูลเกี่ยวกับกลุ่มที่มีการอัปโหลดเหตุการณ์เหล่านี้
user_dim.bundle_info.bundle_sequence_id	INTEGER	รหัสตามลำดับของกลุ่มที่มีการอัปโหลดเหตุการณ์เหล่านี้
user_dim.ltv_info	RECORD	ระเบียนของข้อมูลมูลค่าตลอดอายุการใช้งานเกี่ยวกับผู้ใช้นี้ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_dim.ltv_info.revenue	FLOAT	มูลค่าตลอดอายุการใช้งาน (รายได้) ของผู้ใช้รายนี้ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้
user_dim.ltv_info.currency	STRING	มูลค่าตลอดอายุการใช้งาน (สกุลเงิน) ของผู้ใช้รายนี้ ตารางระหว่างวันจะไม่มีข้อมูลในช่องนี้

event_dim

ชื่อช่อง	ประเภทข้อมูล	คำอธิบาย
event_dim	RECORD	ระเบียนซ้ำของข้อมูลเกี่ยวกับเหตุการณ์ในกลุ่มนี้
event_dim.date	STRING	วันที่ที่บันทึกเหตุการณ์ (รูปแบบ YYYYMMDD ในเขตเวลาที่ลงทะเบียนไว้ของแอป)
event_dim.name	STRING	ชื่อเหตุการณ์
event_dim.params	RECORD	ระเบียนซ้ำของพารามิเตอร์ที่เชื่อมโยงกับเหตุการณ์นี้
event_dim.params.key	STRING	คีย์ของพารามิเตอร์เหตุการณ์
event_dim.params.value	RECORD	ระเบียนของค่าพารามิเตอร์เหตุการณ์
event_dim.params.value.string_value	STRING	ค่าสตริงของพารามิเตอร์เหตุการณ์
event_dim.params.value.int_value	INTEGER	ค่าจำนวนเต็มของพารามิเตอร์เหตุการณ์
event_dim.params.value.double_value	FLOAT	ค่าทศนิยมของพารามิเตอร์เหตุการณ์
event_dim.timestamp_micros	INTEGER	เวลา (เป็นไมโครวินาที UTC) ที่เหตุการณ์นี้บันทึกไคลเอ็นต์
event_dim.previous_timestamp_micros	INTEGER	เวลา (เป็นไมโครวินาที UTC) ที่เหตุการณ์นี้บันทึกไคลเอ็นต์ก่อนหน้านี้

ข้อมูลนี้มีประโยชน์ไหม

เราจะปรับปรุงได้อย่างไร

[GA4] สคีมา BigQuery Export

ชุดข้อมูล

ตาราง

คอลัมน์

RECORD event_params

RECORD item_params

ช่อง privacy_info

RECORD user_properties

RECORD user_ltv

geo

RECORD item_params

แถว

user_dim

event_dim

ข้อมูลนี้มีประโยชน์ไหม

หากต้องการความช่วยเหลือเพิ่มเติม

ลองทำตามขั้นตอนต่อไปนี้