[GA4] BigQuery Export 使用者資料結構定義

設定

設定 BigQuery Export 時,可選擇加入每日匯出使用者資料。

資料表格

匯出使用者資料時,Analytics 會在 BigQuery 專案中建立兩個新表格:

  • 匿名 ID
    • 每個匿名 ID 都包含一個資料列。其中一個欄位有任何變更,使用者資料就會隨之更新。
    • 未同意使用者的資料不會匯出至這個表格。
    • 使用者 ID 不會匯出至這個表格。
    • 上次使用時間戳記會匯出至這個表格。
  • 使用者 ID
    • 每個使用者 ID 都包含一個資料列。其中一個欄位有任何變更,使用者資料就會隨之更新。
    • 如果未同意使用者的資料包含使用者 ID,則該資料可匯出至這個表格。
    • 匿名 ID 不會匯出至這個表格
    • 上次使用時間戳記會匯出至這個表格。

比較使用者資料匯出檔案中的活躍使用者與所有使用者

這個匯出檔案會納入當天資料有變化的所有使用者。舉例來說,如果使用者啟動工作階段,user_ltv.sessions 的生命週期價值也隨之增加,匯出檔案就會納入該使用者。如果使用者當天因不再符合目標對象納入條件 (例如最近 7 天內未購買),而從目標對象中移除,該使用者的資料就會發生變化,匯出檔案將納入使用者。

系統會依據資料是否有變化 (而非僅依據活動) 來納入使用者,因此在特定日期或日期範圍內,匯出檔案中的使用者人數可能會超過「活躍使用者」指標的值 (「活躍使用者」指標在「報表」中會顯示為「使用者」)。

如果您查詢匯出的資料,只是想取得活躍使用者人數,請參考開發人員說明文件中列出的部分查詢範例。

結構定義

以下各節說明 Analytics 匯出至匿名 ID 和使用者 ID 表格的使用者資料 (視上述列舉的差異而定)。

稽核

欄位名稱 資料類型 說明
occurrence_date STRING 觸發記錄變更的日期
last_updated_date STRING 表格中記錄的更新日期

使用者

欄位名稱 資料類型 說明
user_id STRING 報表識別資訊中的 User-ID 命名空間 ID (僅限 User-ID 表格)
pseudo_user_id STRING 匿名化命名空間 ID (僅限匿名 ID 表格)
stream_id INTEGER 資料串流 ID (僅限匿名 ID 表格)

 

使用者資訊

欄位名稱 資料類型 說明
user_info.last_active_timestamp_micros INTEGER 使用者上次活動的日期 (時間戳記以微秒為單位)
user_info.user_first_touch_timestamp_micros INTEGER 使用者的 first_open 或 first_visit 事件日期 (以較早者為準,時間戳記以微秒為單位)
user_info.first_purchase_date STRING 使用者初次購買的日期 (YYYYMMDD)

 

隱私權資訊

欄位名稱 資料類型 說明
privacy_info RECORD 隱私權資訊
privacy_info.is_ads_personalization_allowed STRING

如果使用者符合看到個人化廣告的資格,isAdsPersonalizationAllowed 就會傳回「true」。如果使用者不符合看到個人化廣告的資格,isAdsPersonalizationAllowed 則會傳回「false」。

如果 Google Analytics 目前無法傳回這位使用者是否符合看到個人化廣告的資格,isAdsPersonalizationAllowed 就會傳回「(not set)」;反過來說,isAdsPersonalizationAllowed 傳回「(not set)」,可視為使用者不一定符合看到個人化廣告的資格。如要顯示個人化廣告,您應該將 isAdsPersonalizationAllowed 傳回「(not set)」的使用者,視為 isAdsPersonalizationAllowed 傳回「false」,因為在大多數一般情況下,某些「(not set)」列會納入不符合個人化廣告顯示資格的使用者。

isAdsPersonalizationAllowed 傳回「false」的使用者仍可用於非廣告用途,例如 A/B 測試和資料探索。

privacy_info.is_limited_ad_tracking STRING 裝置的「限制廣告追蹤」設定。可能的值包括:「true」、「false」和「(not set)」。如果 Google Analytics 目前無法傳回這部裝置的「限制廣告追蹤」設定,isLimitedAdTracking 會傳回「(not set)」。

 

目標對象

欄位名稱 資料類型 說明
audiences RECORD 目標對象資訊
audiences.id INTEGER 目標對象 ID
audiences.name STRING 目標對象名稱
audiences.membership_start_timestamp_micros INTEGER 使用者第一次加入目標對象的時間 (時間戳記以微秒為單位)
audiences.membership_expiry_timestamp_micros INTEGER

使用者的目標對象名單效期 (時間戳記以微秒為單位)

當使用者有新的活動而再次符合目標對象條件,再行銷效期就會重設

audience.npa BOOLEAN true 或 false 的判定依據:目標對象定義中有關事件的非個人化廣告設定,以及以使用者為範圍的自訂維度

 

屬性

欄位名稱 資料類型 說明
user_properties RECORD 使用者屬性資訊
user_properties.key STRING 使用者屬性維度名稱
user_properties.value.string_value STRING 使用者屬性維度值
user_properties.value.set_timestamp_micros INTEGER 上次設定維度值的時間 (時間戳記以微秒為單位)
     

 

裝置

欄位名稱 資料類型 說明
device RECORD 裝置資訊
device.operating_system STRING 裝置作業系統
device.category STRING 裝置類別 (行動裝置、平板電腦、桌機)
device.mobile_brand_name STRING 裝置品牌名稱
device.mobile_model_name STRING 裝置型號名稱
device.unified_screen_name STRING 畫面名稱

 

地理區域

欄位名稱 資料類型 說明
geo RECORD 地理位置資訊
geo.city STRING 事件記錄的來源城市
geo.country STRING 事件記錄的來源國家/地區
geo.continent STRING 事件記錄的來源洲別
geo.region STRING 事件記錄的來源區域

 

生命週期

欄位名稱 資料類型 說明
user_ltv RECORD 生命週期資訊
user_ltv.revenue_in_usd DOUBLE 生命週期總收益 (以美元為單位)
user_ltv.sessions INTEGER 生命週期工作階段總數
user_ltv.engagement_time_millis INTEGER 生命週期總參與時間 (以毫秒為單位)
user_ltv.purchases INTEGER 生命週期購買總次數
user_ltv.engaged_sessions INTEGER 生命週期互動工作階段總數
user_ltv.session_duration_micros INTEGER 生命週期總工作階段持續時間 (以毫秒為單位)

 

預測

欄位名稱 資料類型 說明
predictions RECORD 預測資訊
predictions.in_app_purchase_score_7d DOUBLE 最近 28 天處於活躍狀態的使用者,未來 7 天內會有 in_app_purchase 事件的機率
predictions.purchase_score_7d DOUBLE 最近 28 天處於活躍狀態的使用者,未來 7 天內會有 purchase 事件的機率
predictions.churn_score_7d DOUBLE 最近 7 天在您的應用程式/網站上處於活躍狀態的使用者,未來 7 天內將不再活躍的機率
predictions.revenue_28d_in_usd FLOAT 最近 28 天處於活躍狀態的使用者,未來 28 天內所有購買事件的預期收益 (以美元為單位)
這個頁面可能含有使用 AI 技術翻譯的內容,也許會有錯誤。

這對您有幫助嗎?

我們應如何改進呢?
搜尋
清除搜尋內容
關閉搜尋
主選單
12002352643240175752
true
搜尋說明中心
false
true
true
true
true
true
69256
false
false
false
false
false