[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 ที่มีอยู่จากสคีมาการส่งออกเก่าไปยังสคีมาใหม่
  1. ลงชื่อเข้าใช้หน้าคอนโซล Cloud Platform >: จัดการทรัพยากร
  2. เปิดโปรเจ็กต์ที่มีข้อมูลที่ต้องการย้ายแล้วคลิกเปิดใช้งาน Google Cloud Shell ที่ด้านบนของหน้า
  3. เมื่อเปิด Shell แล้ว ให้คัดลอกสคริปต์ด้านล่างไปยังไฟล์ชื่อ migration_script.sql ดังนี้
    1. ออกคำสั่ง cat > migration_script.sql
    2. คัดลอกสคริปต์ด้านล่างและวางลงใน Shell
    3. กด 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
      
  4. เปิด Shell ใหม่และคัดลอกสคริปต์ Bash ด้านล่างไปยังไฟล์ชื่อ migration.sh ดังนี้
    1. ออกคำสั่ง cat > migration.sh
    2. คัดลอกสคริปต์ด้านล่างและวางลงใน Shell
    3. กด 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
    
    # สิ้นสุดสคริปต์
    
    
  5. เปิด 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) ที่เหตุการณ์นี้บันทึกไคลเอ็นต์ก่อนหน้านี้

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

เราจะปรับปรุงได้อย่างไร
ค้นหา
ล้างการค้นหา
ปิดการค้นหา
แอป Google
เมนูหลัก