ข้ามไปที่เนื้อหา

ตาราง BigQuery

ภาพรวม

คุณสามารถตรวจสอบประเภทของชุดข้อมูลและตารางที่สามารถค้นหาได้หลังจากได้รับสิทธิ์การเข้าถึง BigQuery รวมถึงวัตถุประสงค์และคอลัมน์หลักของแต่ละตาราง

สำหรับวิธีขอสิทธิ์การเข้าถึง BigQuery และวิธีเชื่อมต่อกับ BigQuery โปรดดูที่ การตั้งค่า BigQuery

ชุดข้อมูล คำอธิบาย
habq-storage.analytics_N_live ข้อมูลของสภาพแวดล้อม Production สามารถค้นหาได้หากขอสิทธิ์ในสภาพแวดล้อม Production
habq-storage.analytics_N_sandbox ข้อมูลของสภาพแวดล้อม Sandbox สามารถค้นหาได้หากขอสิทธิ์ในสภาพแวดล้อม Sandbox
Note

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

รายการตาราง

ตารางแบ่งออกเป็นตารางเหตุการณ์และตารางบริการตามวัตถุประสงค์

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

ตารางเหตุการณ์

ตาราง คำอธิบาย
t_raw_event_log (แหล่งข้อมูลเมตริก) ตารางต้นฉบับที่จัดเก็บบันทึกเหตุการณ์ทั้งหมดไว้ด้วยกัน
t_raw_event_log_rescue ตารางกักกันที่เก็บบันทึกที่ละเมิดกฎการส่งและไม่สามารถจัดเก็บใน t_raw_event_log ไว้ตามเดิม
t_aggregation_index (แหล่งข้อมูลเมตริก) ผลการรวมข้อมูลขั้นสุดท้ายสำหรับให้บริการเมตริกสะสมแยกต่างหาก

ตารางบริการ

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

ตาราง คำอธิบาย
t_aggregation_login_master ตารางรวมข้อมูลระดับกลางสำหรับสร้าง t_aggregation_index บันทึกวันที่ที่พบผู้ใช้ (userId) ที่เข้าสู่ระบบเป็นครั้งแรก (ใช้รวมข้อมูลผู้ใช้สะสม)
t_aggregation_terms_master ตารางรวมข้อมูลระดับกลางสำหรับสร้าง t_aggregation_index บันทึกวันที่ที่พบอุปกรณ์ (deviceId) ที่ยอมรับข้อกำหนดเป็นครั้งแรก (ใช้รวมข้อมูลการติดตั้งสะสม)
t_aggregation_buyer_master ตารางรวมข้อมูลระดับกลางสำหรับสร้าง t_aggregation_index บันทึกวันที่ที่พบผู้ใช้ (userId) ที่ชำระเงินเป็นครั้งแรก (ใช้รวมข้อมูลผู้ซื้อสะสม)
t_aggregation_prerelease_revenue ตารางที่คำนวณรายได้ที่เกิดขึ้นก่อนวันเปิดตัวอย่างเป็นทางการของเกมไว้ล่วงหน้าตามวันที่และเงื่อนไข (มีข้อมูลเฉพาะเมื่อมีรายได้ก่อนเปิดตัว)
tmp_aggregation_stg_* ตารางชั่วคราวที่มีอยู่เฉพาะระหว่างการรวมข้อมูล (ถูกลบโดยอัตโนมัติ 1 วันหลังจากสร้าง)
system_custom_event_user_state ตารางรวมข้อมูลระดับกลางสำหรับสะท้อนข้อมูลใน t_raw_event_log จัดเก็บเวลาและแอตทริบิวต์ของการเกิดขึ้นครั้งแรกและครั้งล่าสุดสำหรับแต่ละผู้ใช้และเหตุการณ์
system_derived_event_* ตารางการประมวลผลภายในที่บันทึกความคืบหน้าของงานสร้างเหตุการณ์ที่ได้มา
meta_event รายการเหตุการณ์ที่คุณมี
meta_event_dimension คำจำกัดความของแอตทริบิวต์สำหรับแต่ละเหตุการณ์ (ชื่อแอตทริบิวต์ ชนิดข้อมูล แหล่งที่มา)
meta_event_dimension_value ค่าที่รวบรวมได้จริงสำหรับแอตทริบิวต์ (รายการค่าสำหรับชนิดสตริง ช่วงค่าต่ำสุด-สูงสุดสำหรับชนิดตัวเลขและเวลา)
meta_event_latest_date วันที่ของข้อมูลล่าสุดสำหรับแต่ละเหตุการณ์
system_attribute_raw รายการแอตทริบิวต์ต้นฉบับที่ใช้สร้าง meta_event_dimension_value แอตทริบิวต์และค่าทั้งหมดใน JSON attributes ยกเว้น hiveAttributes ที่ไปป์ไลน์สร้างขึ้น พร้อมจำนวนครั้งที่รวบรวมแต่ละค่า และเวลาที่รวบรวมครั้งแรกและครั้งล่าสุด
segment_* / snapshot_* ผลลัพธ์ของเซกเมนต์และสแนปช็อตที่สร้างในคอนโซล (รูปแบบ {type}_{number}_{datetime}_{random} สร้างตารางใหม่ทุกครั้ง)

รายละเอียดตาราง

ตารางเหตุการณ์

t_raw_event_log

ตารางที่จัดเก็บบันทึกเหตุการณ์ทั้งหมดที่ส่งจากเกม แต่ละแถวแสดงถึง "ใคร (userId) / บนอุปกรณ์ใด (deviceId) / ในเกมใด (appIdGroup) / เมื่อใด (dateTime) / ด้วยแอตทริบิวต์ใด (attributes) / ทำอะไร (eventName)"

สำหรับโครงสร้างคอลัมน์และแอตทริบิวต์โดยละเอียดของ JSON attributes โปรดดูที่ โครงสร้างการจัดเก็บเหตุการณ์

t_raw_event_log_rescue

ตารางกักกันที่เก็บบันทึกที่ไม่สามารถจัดเก็บใน t_raw_event_log ไว้ตามเดิม มีคอลัมน์เดียวกับ t_raw_event_log พร้อมด้วยสตริงต้นฉบับ (rawData) สาเหตุการกักกัน (errorReason) และรายละเอียด (errorStackTrace)

  • จะถูกสร้างขึ้นเฉพาะเมื่อมีบันทึกที่ถูกกักกัน
  • dateTime ถูกจัดเก็บเป็น STRING ไม่ใช่ TIMESTAMP เนื่องจากต้องเก็บค่าที่ไม่ถูกต้องไว้ด้วย
  • หากไม่พบข้อมูลใน t_raw_event_log ให้ตรวจสอบตารางนี้ก่อน

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

t_aggregation_index

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

คอลัมน์ คำอธิบาย ตัวอย่าง
appIdGroup ตัวระบุเกม com.sample.test
dateTime วันที่เป้าหมาย 2026-10-04
periodType ประเภทช่วงเวลา day (วันนั้น), cumulative (สะสมตลอดทั้งช่วงเวลา) day
aggName กลุ่มเมตริก agg_users (การเข้าสู่ระบบ), agg_sales (รายได้), agg_terms (การติดตั้ง) agg_sales
dimKey แกนเงื่อนไข * หมายถึงค่าทั้งหมดของแกนนั้น country=*\|market=*\|serverId=*
attributes JSON ที่จัดเก็บค่าเมตริกจริง (ค่าของแต่ละเมตริกอยู่ภายใต้ measure) measure.au, measure.revenue, measure.pu
checksum ค่าแฮชสำหรับระบุแถว

ค่าเมตริกอยู่ใน JSON attributes ไม่ได้อยู่ในคอลัมน์ ดังนั้นให้ค้นหาด้วย JSON_VALUE

SELECT JSON_VALUE(attributes, '$.measure.revenue') AS revenue
FROM `habq-storage.analytics_N_live.t_aggregation_index`
WHERE aggName = 'agg_sales'
  AND periodType = 'cumulative'
  AND appIdGroup = 'com.sample.test'  -- appIdGroup ที่ใช้งานจริงของคุณ
  AND dimKey = 'country=*|market=*|serverId=*'  -- ยอดรวมทั้งหมด
  AND DATE(dateTime) = '2026-10-04'
Warning

แม้จะเป็นวันที่และเมตริกเดียวกัน ก็จะมีหลายแถวตาม dimKey เช่น "ทั้งหมด" "เกาหลี" และ "เกาหลี × Google Play" สำหรับยอดรวมทั้งหมด ให้ค้นหาเฉพาะแถวเดียวที่ทุกแกนเป็น * การรวมหลายแถวเข้าด้วยกันจะทำให้เกิดการนับซ้ำ

ตารางบริการ

ตารางบริการมีไว้เพื่อการอ้างอิง และคุณไม่จำเป็นต้องค้นหาโดยตรง

t_aggregation_*_master

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

ตาราง เป้าหมาย เมตริก
t_aggregation_login_master ผู้ใช้ที่เข้าสู่ระบบ (userId) agg_users ผู้ใช้สะสม
t_aggregation_terms_master อุปกรณ์ที่ยอมรับข้อกำหนด (deviceId) agg_terms การติดตั้งสะสม
t_aggregation_buyer_master ผู้ใช้ที่ชำระเงิน (userId) agg_sales ผู้ซื้อสะสม
คอลัมน์ คำอธิบาย
appIdGroup ตัวระบุเกม
userId / deviceId ตัวระบุเป้าหมาย
country, market (serverId) ประเทศและมาร์เก็ตเมื่อพบครั้งแรก (t_aggregation_buyer_master รวมเซิร์ฟเวอร์ด้วย)
firstSeenDate / firstSeenAt วันที่ / เวลาที่พบครั้งแรก
updatedAt เวลาที่อัปเดตแถวล่าสุด
Note

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

system_custom_event_user_state

ตารางรวมข้อมูลระดับกลางสำหรับสะท้อนข้อมูลใน t_raw_event_log จัดเก็บเวลาและแอตทริบิวต์ของการเกิดขึ้นครั้งแรกและครั้งล่าสุดไว้ในแถวเดียวสำหรับแต่ละผู้ใช้และเหตุการณ์

คอลัมน์ คำอธิบาย
userId ตัวระบุผู้ใช้ตามบัญชี
deviceId ตัวระบุผู้ใช้ตามอุปกรณ์
appIdGroup ตัวระบุเกม
eventName ชื่อเหตุการณ์
firstEventTime, firstAttributes เวลาที่เกิดขึ้นครั้งแรกและแอตทริบิวต์ในขณะนั้น
lastEventTime, lastAttributes เวลาที่เกิดขึ้นครั้งล่าสุดและแอตทริบิวต์ในขณะนั้น

meta_event

รายการเหตุการณ์ที่คุณมี แต่ละแถวแสดงถึงหนึ่งเหตุการณ์

คอลัมน์ คำอธิบาย
eventName ชื่อเหตุการณ์
dataSource เส้นทางที่เหตุการณ์เข้ามา (custom_server, custom_sdk ฯลฯ)
tableName ชื่อตารางที่จัดเก็บข้อมูลเหตุการณ์

meta_event_dimension

คำจำกัดความของแอตทริบิวต์สำหรับแต่ละเหตุการณ์ แต่ละแถวแสดงถึงหนึ่งแอตทริบิวต์ของเหตุการณ์

คอลัมน์ คำอธิบาย
eventName ชื่อเหตุการณ์
dimensionName ชื่อแอตทริบิวต์
dataType ชนิดข้อมูลของแอตทริบิวต์
attributeSource พื้นที่ที่จัดเก็บแอตทริบิวต์ (hiveAttributes หรือ eventAttributes)

meta_event_dimension_value

ค่าที่รวบรวมได้จริงสำหรับแอตทริบิวต์ สำหรับชนิดสตริงจะจัดเก็บรายการค่า สำหรับชนิดตัวเลขและเวลาจะจัดเก็บช่วงค่าต่ำสุด-สูงสุด

คอลัมน์ คำอธิบาย
key ชื่อแอตทริบิวต์
value ค่าที่รวบรวมได้ (ค่าต่ำสุดและสูงสุดสำหรับชนิดตัวเลขและเวลา)
dataType ชนิดข้อมูลของแอตทริบิวต์
valueType วิธีการจัดเก็บค่า (รายการค่า หรือช่วงค่าต่ำสุด-สูงสุด)

meta_event_latest_date

วันที่ของข้อมูลล่าสุดสำหรับแต่ละเหตุการณ์

คอลัมน์ คำอธิบาย
lastDataDate วันที่ล่าสุดที่มีข้อมูล
sourceTable ตารางต้นทางที่ใช้ตรวจสอบวันที่

system_attribute_raw

รายการแอตทริบิวต์ต้นฉบับที่ใช้สร้าง meta_event_dimension_value โดยจัดระเบียบแอตทริบิวต์และค่าทั้งหมดใน JSON attributes ยกเว้น hiveAttributes ที่ไปป์ไลน์สร้างขึ้น

คอลัมน์ คำอธิบาย
eventName, appIdGroup เหตุการณ์และเกม
key, value ชื่อแอตทริบิวต์และค่าที่รวบรวมได้
dataType ชนิดข้อมูลของแอตทริบิวต์
valueCount จำนวนครั้งที่รวบรวมค่า
firstTime, lastTime เวลาที่รวบรวมครั้งแรกและครั้งล่าสุด
attributeSource พื้นที่ที่จัดเก็บแอตทริบิวต์ (hiveAttributes หรือ eventAttributes)
dataSource เส้นทางที่เหตุการณ์เข้ามา

ข้อควรระวัง & Tips

  • t_raw_event_log และ t_aggregation_index แบ่งพาร์ติชันรายวันตาม dateTime เพื่อลดค่าใช้จ่ายในการค้นหา ให้ระบุเงื่อนไขวันที่ด้วย

เมนูที่เกี่ยวข้อง