[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 天內所有購買事件的預期收益 (以美元為單位)

這對您有幫助嗎?

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