[GA4] BigQuery Export 架構

本文將說明 Google Analytics 4 資源資料和 Google Analytics for Firebase 資料匯出至 BigQuery 時所使用的格式和架構。

資料集

針對每一個連至 BigQuery 的 Google Analytics 4 資源和 Firebase 專案，系統會分別在 BigQuery 專案中加入一個名為「analytics_<property_id>」的資料集。資源 ID 是指 Analytics 資源 ID，可在 Google Analytics 4 資源的資源設定以及 Firebase 的應用程式數據分析設定中找到。每個已啟用 BigQuery 匯出功能的 Google Analytics 4 資源和應用程式，都會將自身資料匯出至該單一資料集。

表格

如果啟用「每日匯出」選項，每個資料集內每天都會建立一個名為 events_YYYYMMDD 的資料表。

若啟用「串流匯出」選項，系統會建立名稱格式為 events_intraday_YYYYMMDD 的資料表，系統一整天都會記錄事件，因此這個資料表會持續填入資料。events_YYYYMMDD 完成後，這份資料表會在每天結束時刪除。

並非觸發事件的所有裝置都會在事件觸發當天傳送資料至 Analytics。為了反映這段延遲時間，Analytics 會更新每日資料表 (events_YYYYMMDD)，加入事件觸發日期後三天內的事件。不論是否延後收到事件，事件都會有正確的時間戳記。系統不會記錄在這三天過後才收到的事件。

如果您使用的是 BigQuery 沙箱，系統不會匯入任何當天事件，且需要遵循其他限制。

如要匯入當天資料，請從沙箱升級。

欄

在 events_YYYYMMDD 資料表中，每個資料欄都代表不同事件的專用參數。部分參數是安插在 RECORDS 的巢狀結構中，有些 RECORDS (例如 items 和 event_params) 則可以多個並存。這些表格欄的說明如下。

全部展開全部收合

event

欄位名稱	資料類型	說明
您可根據 event 欄位中的資訊明確識別事件。
batch_event_index	INTEGER	以數字代表事件在批次中的先後順序，決定依據是事件在裝置上的發生順序。
batch_ordering_id	INTEGER	這個欄位中的數字會單調遞增：每次有網頁送出網路要求，數字就會變大。
batch_page_id	INTEGER	這是指派給網頁的序號；使用者在互動過程中每多瀏覽 1 個網頁，序號會隨之加 1。
event_date	STRING	記錄到事件的日期 (以應用程式的註冊時區為準，格式為 YYYYMMDD)。
event_timestamp	INTEGER	在用戶端記錄到事件的時間 (以微秒為單位，採用世界標準時間)。
event_previous_timestamp	INTEGER	上一次在用戶端記錄到事件的時間 (以微秒為單位，採用世界標準時間)。
event_name	STRING	事件的名稱。
event_value_in_usd	FLOAT	事件「value」參數的幣別換算價值 (以美元計)。
event_bundle_sequence_id	INTEGER	上傳了這些事件的軟體包的序列 ID。
event_server_timestamp_offset	INTEGER	收集時間與上傳時間的時間戳記差距 (以微秒為單位)。

event_params RECORD

欄位名稱	資料類型	說明
event_params RECORD 可儲存廣告活動層級和內容比對事件參數，以及任何使用者定義的事件參數。每個與事件相關聯的鍵都有 event_params RECORD。每次導入時，event_params RECORD 中儲存的參數組合均不同。如要查看導入作業的事件參數完整清單，請查詢事件參數清單。
event_params.key	STRING	事件參數的名稱。
event_params.value	RECORD	包含事件參數值的記錄。
event_params.value.string_value	STRING	如果事件參數以字串 (例如網址或廣告活動名稱) 表示，這個欄位就會填入該參數。
event_params.value.int_value	INTEGER	如果事件參數以整數表示，這個欄位就會填入該參數。
event_params.value.double_value	FLOAT	如果事件參數以雙精度浮點值表示，這個欄位就會填入該參數。
event_params.value.float_value	FLOAT	如果事件參數以浮點值表示，這個欄位就會填入該參數。目前未使用這個欄位。

item_params RECORD

欄位名稱	資料類型	說明
item_params RECORD 可儲存一般的項目參數，以及任何使用者定義的項目參數。每次導入作業期間，item_params RECORD 中儲存的參數組合均不同。
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	如果項目參數以雙精度浮點值表示，就會填入這個欄位。
item_params.value.float_value	FLOAT	如果項目參數以浮點值表示，就會填入這個欄位。

user

欄位名稱	資料類型	說明
您可根據 user 欄位中的資訊，明確識別出與事件相關聯的使用者。
is_active_user	BOOLEAN	使用者在當日任一時間點處於活躍 (True) 或不活躍 (False) 狀態只包含在每日表格 (`events_YYYYMMDD)`) 中。
user_id	STRING	指派給使用者的專屬 ID。
user_pseudo_id	STRING	使用者的匿名 ID (例如應用程式執行個體 ID)。使用者初次開啟應用程式或造訪網站時，系統會指派給使用者的專屬 ID。
user_first_touch_timestamp	INTEGER	使用者初次開啟應用程式或造訪網站的時間 (以微秒為單位)。

privacy_info 欄位

欄位名稱	資料類型	說明
您啟用同意聲明模式後，系統會根據使用者同意聲明狀態判斷該在 privacy_info 欄位填入哪些資訊。
privacy_info.ads_storage	STRING	是否對使用者啟用了廣告指定目標功能。可能的值：「Yes」、「No」、「Unset」
privacy_info.analytics_storage	STRING	是否對使用者啟用了 Analytics 儲存空間。可能的值：「Yes」、「No」、「Unset」
privacy_info.uses_transient_token	STRING	網站使用者是否拒絕 Analytics 儲存空間，且開發人員是否根據伺服器資料中的暫時性權杖，在沒有 Cookie 的情況下啟用評估功能。可能的值：「Yes」、「No」、「Unset」

user_properties RECORD

欄位名稱	資料類型	說明
user_properties RECORD 包含您設定的任何使用者屬性，每個與使用者相關聯的鍵都有這個 RECORD。
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	上次設定使用者屬性的時間 (以微秒為單位)。

user_ltv RECORD

欄位名稱	資料類型	說明
user_ltv RECORD 包含使用者的生命週期價值資訊；當日資料表中的這個 RECORD 不會填入任何資料。
user_ltv.revenue	FLOAT	使用者的生命週期價值 (收益)；系統不會在當日資料表的這個欄位填入資料。
user_ltv.currency	STRING	使用者的生命週期價值 (貨幣)；系統不會在當日資料表的這個欄位填入資料。

device

欄位名稱	資料類型	說明
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 (供應商識別碼，收集不到廣告識別碼時才擷取這項資訊)。
device.advertising_id	STRING	廣告 ID/廣告識別碼。
device.language	STRING	作業系統語言。
device.time_zone_offset_seconds	INTEGER	與 GMT 的時差 (以秒為單位)。
device.is_limited_ad_tracking	BOOLEAN	裝置的「限制廣告追蹤」設定。在 iOS14 以上版本中，如果 IDFA 的值不是零，就會傳回 false。
device.web_info.browser	STRING	使用者瀏覽內容時所用的瀏覽器。
device.web_info.browser_version	STRING	使用者瀏覽內容時所用的瀏覽器版本。
device.web_info.hostname	STRING	與記錄事件相關聯的主機名稱。

geo

欄位名稱	資料類型	說明
您可根據 geo RECORD 中的資訊，瞭解事件是在哪個地理位置發生。
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

欄位名稱	資料類型	說明
app_info RECORD 包含啟動事件的應用程式相關資訊。
app_info.id	STRING	應用程式套件名稱或軟體包 ID。
app_info.firebase_app_id	STRING	與應用程式相關聯的 Firebase 應用程式 ID。
app_info.install_source	STRING	使用者透過哪個商店安裝了應用程式。
app_info.version	STRING	應用程式的 versionName (Android) 或簡短版軟體包版本。

collected_traffic_source

欄位名稱	資料類型	說明
collected_traffic_source RECORD 包含透過網頁的第一個事件收集到的流量來源資料。
manual_campaign_id	STRING	透過事件收集到的手動廣告活動 ID (utm_id)。
manual_campaign_name	STRING	透過事件收集到的手動廣告活動名稱 (utm_campaign)。
manual_source	STRING	連同事件收集到的手動廣告活動來源 (utm_source)，當中除了 Urchin 流量監視器 (UTM) 值，也包含參照連結網址參數的剖析參數。
manual_medium	STRING	連同事件收集到的手動廣告活動媒介 (utm_medium)，當中除了 Urchin 流量監視器 (UTM) 值，也包含參照連結網址參數的剖析參數。
manual_term	STRING	透過事件收集到的手動廣告活動關鍵字/字詞 (utm_term)。
manual_content	STRING	連同事件收集到的其他手動廣告活動中繼資料 (utm_content)。
manual_creative_format	STRING	連同事件收集到的手動廣告活動廣告素材格式 (utm_creative_format)。
manual_marketing_tactic	STRING	連同事件收集到的手動廣告活動行銷策略 (utm_marketing_tactic)。
manual_source_platform	STRING	連同事件收集到的手動廣告活動來源平台 (utm_source_platform)。
gclid	STRING	透過事件收集到的 Google 點擊 ID。
dclid	STRING	連同事件收集到的 DoubleClick 點擊 ID (Display & Video 360 和 Campaign Manager 360 的都有)。
srsltid	STRING	連同事件收集到的 Google Merchant Center ID。

session_traffic_source_last_click

欄位名稱	資料類型	說明
session_traffic_source_last_click RECORD 中，包含促成最終點擊的 Google Ads/手動廣告活動工作階段流量來源的資料 (如果有的話)。
session_traffic_source_last_click. manual_campaign.campaign_id	STRING	獲得最終點擊的手動廣告活動的 ID。
session_traffic_source_last_click. manual_campaign.campaign_name	STRING	獲得最終點擊的手動廣告活動的名稱。
session_traffic_source_last_click. manual_campaign.medium	STRING	獲得最終點擊的手動廣告活動的媒介 (例如付費搜尋、自然搜尋和電子郵件)。
session_traffic_source_last_click. manual_campaign.term	STRING	獲得最終點擊的手動廣告活動的觸發關鍵字/搜尋字詞。
session_traffic_source_last_click. manual_campaign.content	STRING	獲得最終點擊的手動廣告活動的其他中繼資料。
session_traffic_source_last_click. manual_campaign.source_platform	STRING	放送獲得最終點擊的手動廣告活動的平台 (例如搜尋引擎、社群媒體)。
session_traffic_source_last_click. manual_campaign.source	STRING	獲得最終點擊的手動廣告活動的平台內特定來源。
session_traffic_source_last_click. manual_campaign.creative_format	STRING	獲得最終點擊的手動廣告活動所用的廣告素材格式。
session_traffic_source_last_click. manual_campaign.marketing_tactic	STRING	獲得最終點擊的手動廣告活動所用的行銷策略。
session_traffic_source_last_click. google_ads_campaign.customer_id	STRING	與 Google Ads 帳戶相關聯的客戶 ID。
session_traffic_source_last_click. google_ads_campaign.account_name	STRING	Google Ads 帳戶名稱。
session_traffic_source_last_click. google_ads_campaign.campaign_id	STRING	Google Ads 廣告活動 ID。
session_traffic_source_last_click. google_ads_campaign.campaign_name	STRING	Google Ads 廣告活動名稱。
session_traffic_source_last_click. google_ads_campaign.ad_group_id	STRING	Google Ads 廣告活動中的廣告群組 ID。
session_traffic_source_last_click. google_ads_campaign.ad_group_name	STRING	Google Ads 廣告活動中的廣告群組名稱。
session_traffic_source_last_click. cross_channel_campaign.campaign_name	STRING	獲得最終點擊的跨管道廣告活動名稱
session_traffic_source_last_click. cross_channel_campaign.campaign_id	STRING	獲得最終點擊的跨管道廣告活動 ID
session_traffic_source_last_click. cross_channel_campaign.source_platform	STRING	獲得最終點擊的跨管道廣告活動名稱
session_traffic_source_last_click. cross_channel_campaign.source	STRING	獲得最終點擊的跨管道廣告活動的平台內特定來源。
session_traffic_source_last_click. cross_channel_campaign.medium	STRING	獲得最終點擊的跨管道廣告活動媒介
session_traffic_source_last_click. sa360_campaign.campaign_name	STRING	獲得最終點擊的 SA360 廣告活動名稱。
session_traffic_source_last_click. sa360_campaign.source	STRING	獲得最終點擊的 SA360 廣告活動的平台內特定來源。
session_traffic_source_last_click. sa360_campaign.medium	STRING	獲得最終點擊的 SA360 廣告活動媒介
session_traffic_source_last_click. sa360_campaign.ad_group_id	STRING	SA360 廣告活動中的廣告群組 ID
session_traffic_source_last_click. sa360_campaign.ad_group_name	STRING	SA360 廣告活動中的廣告群組名稱
session_traffic_source_last_click. sa360_campaign.campaign_id	STRING	獲得最終點擊的 SA360 廣告活動的 ID
session_traffic_source_last_click. sa360_campaign.creative_format	STRING	獲得最終點擊的 SA360 廣告活動的廣告素材格式
session_traffic_source_last_click. sa360_campaign.engine_account_name	STRING	SA360 引擎帳戶名稱
session_traffic_source_last_click. sa360_campaign.engine_account_type	STRING	包含 SA360 廣告活動的引擎帳戶類型
session_traffic_source_last_click. sa360_campaign.manager_account_name	STRING	SA360 管理員帳戶名稱
session_traffic_source_last_click. dv360_campaign.advertiser_id	STRING	DV360 廣告主 ID
session_traffic_source_last_click. dv360_campaign.advertiser_name	STRING	DV360 廣告主名稱
session_traffic_source_last_click. dv360_campaign.campaign_id	STRING	獲得最終點擊的 DV360 廣告活動 ID
session_traffic_source_last_click. dv360_campaign.campaign_name	STRING	獲得最終點擊的 DV360 廣告活動名稱
session_traffic_source_last_click. dv360_campaign.creative_id	STRING	獲得最終點擊的 DV360 廣告活動的廣告素材 ID
session_traffic_source_last_click. dv360_campaign.creative_format	STRING	獲得最終點擊的 DV360 廣告活動的廣告素材格式
session_traffic_source_last_click. dv360_campaign.creative_name	STRING	獲得最終點擊的 DV360 廣告活動的廣告素材名稱
session_traffic_source_last_click. dv360_campaign.marketing_tactic	STRING	獲得最終點擊的 DV360 廣告活動的行銷策略
session_traffic_source_last_click. dv360_campaign.exchange_id	STRING	獲得最終點擊的 DV360 廣告活動的廣告交易平台 ID
session_traffic_source_last_click. dv360_campaign.exchange_name	STRING	獲得最終點擊的 DV360 廣告活動的廣告交易平台名稱
session_traffic_source_last_click. dv360_campaign.insertion_order_id	STRING	獲得最終點擊的 DV360 廣告活動中的廣告訂單 ID
session_traffic_source_last_click. dv360_campaign.insertion_order_name	STRING	獲得最終點擊的 DV360 廣告活動中的廣告訂單名稱
session_traffic_source_last_click. dv360_campaign.line_item_id	STRING	獲得最終點擊的 DV360 廣告活動中的委刊項 ID
session_traffic_source_last_click. dv360_campaign.line_item_name	STRING	獲得最終點擊的 DV360 廣告活動中的委刊項名稱
session_traffic_source_last_click. dv360_campaign.partner_id	STRING	DV360 合作夥伴 ID
session_traffic_source_last_click. dv360_campaign.partner_name	STRING	DV360 合作夥伴名稱
session_traffic_source_last_click. dv360_campaign.source	STRING	獲得最終點擊的 DV360 廣告活動的平台內特定來源
session_traffic_source_last_click. dv360_campaign.medium	STRING	獲得最終點擊的 DV360 廣告活動媒介
session_traffic_source_last_click. cm360_campaign.account_id	STRING	CM360 帳戶 ID
session_traffic_source_last_click. cm360_campaign.account_name	STRING	CM360 帳戶名稱
session_traffic_source_last_click. cm360_campaign.advertiser_id	STRING	CM360 廣告主 ID
session_traffic_source_last_click. cm360_campaign.advertiser_name	STRING	CM360 廣告主名稱
session_traffic_source_last_click. cm360_campaign.campaign_id	STRING	獲得最終點擊的 CM360 廣告活動 ID
session_traffic_source_last_click. cm360_campaign.campaign_name	STRING	獲得最終點擊的 CM360 廣告活動名稱
session_traffic_source_last_click. cm360_campaign.creative_id	STRING	獲得最終點擊的 CM360 廣告活動的廣告素材 ID
session_traffic_source_last_click. cm360_campaign.creative_format	STRING	獲得最終點擊的 CM360 廣告活動的廣告素材格式
session_traffic_source_last_click. cm360_campaign.creative_name	STRING	獲得最終點擊的 CM360 廣告活動的廣告素材名稱
session_traffic_source_last_click. cm360_campaign.creative_type	STRING	獲得最終點擊的 CM360 廣告活動的廣告素材類型
session_traffic_source_last_click. cm360_campaign.creative_type_id	STRING	獲得最終點擊的 CM360 廣告活動的廣告素材類型 ID
session_traffic_source_last_click. cm360_campaign.creative_version	STRING	獲得最終點擊的 CM360 廣告活動的廣告素材版本
session_traffic_source_last_click. cm360_campaign.placement_id	STRING	獲得最終點擊的 CM360 廣告活動的刊登位置 ID
session_traffic_source_last_click.cm360 _campaign.placement_cost_structure	STRING	獲得最終點擊的 CM360 廣告活動的刊登位置計費方式
session_traffic_source_last_click. cm360_campaign.placement_name	STRING	獲得最終點擊的 CM360 廣告活動的刊登位置名稱
session_traffic_source_last_click. cm360_campaign.rendering_id	STRING	獲得最終點擊的 CM360 廣告活動的顯示 ID
session_traffic_source_last_click. cm360_campaign.site_id	STRING	獲得最終點擊的 CM360 廣告活動的網站 ID
session_traffic_source_last_click. cm360_campaign.site_name	STRING	獲得最終點擊的 CM360 廣告活動的網站名稱
session_traffic_source_last_click. cm360_campaign.source	STRING	獲得最終點擊的 CM360 廣告活動的特定來源
session_traffic_source_last_click. cm360_campaign.medium	STRING	獲得最終點擊的 CM360 廣告活動媒介

traffic_source

欄位名稱	資料類型	說明
traffic_source RECORD 包含初次招攬到使用者的流量來源相關資訊。當日資料表中的這個 RECORD 不會填入任何資料。注意：如果使用者在安裝後與後續的廣告活動互動，traffic_source 值不會因此更改。
traffic_source.name	STRING	初次招攬到使用者的行銷廣告活動名稱；系統不會在當日資料表的這個欄位填入資料。
traffic_source.medium	STRING	初次招攬到使用者的媒介名稱 (付費搜尋、隨機搜尋或電子郵件等)；系統不會在當日資料表的這個欄位填入資料。
traffic_source.source	STRING	初次招攬到使用者的聯播網名稱；系統不會在當日資料表的這個欄位填入資料。

stream and platform

欄位名稱	資料類型	說明
stream 和 platform 欄位當中，包含串流和應用程式平台的相關資訊。
stream_id	STRING	事件來源的資料串流數字 ID。
platform	STRING	事件來源的資料串流平台 (網站、iOS 或 Android)。

電子商務

欄位名稱	資料類型	說明
這項 ecommerce RECORD 包含已在網站或應用程式上設定的任何電子商務事件相關資訊。
ecommerce.total_item_quantity	INTEGER	此事件中的商品總數，亦即 items.quantity 的總和。
ecommerce.purchase_revenue_in_usd	FLOAT	此事件的購買收益，以採用標準單位的美元表示。系統僅會針對購買事件填入適當值。
ecommerce.purchase_revenue	FLOAT	此事件的購買收益，以採用標準單位的當地幣別表示。系統僅會針對購買事件填入適當值。
ecommerce.refund_value_in_usd	FLOAT	此事件中的退款金額，幣別為美元並以標準貨幣單位表示。系統僅會針對退款事件填入適當值。
ecommerce.refund_value	FLOAT	此事件中的退款金額，以採用標準單位的當地幣別表示。系統僅會針對退款事件填入適當值。
ecommerce.shipping_value_in_usd	FLOAT	此事件中的運費，以採用標準單位的美元表示。
ecommerce.shipping_value	FLOAT	此事件中的運費，以當地幣別標準單位表示。
ecommerce.tax_value_in_usd	FLOAT	此事件中的稅額，以採用標準單位的美元表示。
ecommerce.tax_value	FLOAT	此事件中的稅額。幣別為當地貨幣，並以標準貨幣單位表示。
ecommerce.transaction_id	STRING	電子商務交易的交易 ID。
ecommerce.unique_items	INTEGER	此事件中的不重複商品數量，根據 item_id、item_name 和 item_brand 計算得出。

items

欄位名稱	資料類型	說明
items RECORD 內含事件中項目的相關資訊，每個項目都有這個 RECORD。
items.item_id	STRING	商品的 ID。
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	商品價格，以採用標準單位的美元表示。
items.price	FLOAT	商品價格，以當地幣別表示。
items.quantity	INTEGER	商品數量。如未指定數量，則會設為 1。
items.item_revenue_in_usd	FLOAT	此商品的收益，計算方式為 price_in_usd 乘以數量。僅針對購買事件填入適當值，以採用標準單位的美元表示。
items.item_revenue	FLOAT	此商品的收益，計算方式為價格乘以數量。僅針對購買事件填入適當值，以採用標準單位的當地幣別表示。
items.item_refund_in_usd	FLOAT	此商品的退款金額，計算方式為 price_in_usd 乘以數量。僅針對退款事件填入適當值，以採用標準單位的美元表示。
items.item_refund	FLOAT	此商品的退款金額，計算方式為價格乘以數量。僅針對退款事件填入適當值，以採用標準單位的當地幣別表示。
items.coupon	STRING	已套用至此商品的優待券代碼。
items.affiliation	STRING	產品關聯，用來指定供貨公司或實體商店位置。
items.location_id	STRING	與商品相關聯的位置。
items.item_list_id	STRING	使用者在其中看到商品的清單 ID。
items.item_list_name	STRING	使用者在其中看到商品的清單名稱。
Items.item_list_index	STRING	商品在清單中的位置。
items.promotion_id	STRING	產品的促銷 ID。
items.promotion_name	STRING	產品的促銷名稱。
items.creative_name	STRING	促銷地點所使用廣告素材的名稱。
items.creative_slot	STRING	廣告素材版位的名稱。

item_params RECORD

欄位名稱	資料類型	說明
item_params RECORD 會儲存您定義的自訂項目參數。請注意，預先定義的項目參數 (例如 item_id、item_name 等) 未列於此處，而是匯出為明確欄位。每次導入時，item_params RECORD 中儲存的參數組合均不同。如要進一步瞭解電子商務導入作業和 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	如果項目參數以雙精度浮點值表示，就會填入這個欄位。
items.item_params.value.float_value	FLOAT	如果項目參數以浮點值表示，就會填入這個欄位。

發布商 (僅限搶先體驗)

欄位名稱	資料類型	說明
發布商 RECORD 包含與廣告顯示 (也就是 AdMob) 相關的發布商整合事件資訊。
publisher	RECORD	來自 AdMob 的發布商資料記錄。
publisher.ad_revenue_in_usd	FLOAT	此事件的預估廣告收益 (以美元表示)。系統僅會針對廣告曝光事件填入資料。
publisher.ad_format	STRING	說明廣告的顯示方式和位置。常見的格式包括「插頁式」、「橫幅」、「獎勵」和「原生進階」。
publisher.ad_source_name	STRING	放送廣告的來源聯播網。常見來源包括「AdMob 聯播網」、「Meta Audience Network」和「中介服務內部廣告」。
publisher.ad_unit_id	STRING	您選擇用來描述這個廣告單元的名稱。「廣告單元」是放置在應用程式中的容器，用來向使用者顯示廣告。

列

單一事件的資料可能包含一或多項 RECORDS，並分別以一或多列表示。例如，如果 page_view 事件包含多個 event_params，會以類似下表的形式呈現。初始資料列包含事件名稱、日期、時間戳記和其他不重複的資料項目。與事件相關聯的每個參數都包含 event_params RECORD。這些重複的 RECORDS 會直接填入初始事件列下方的後續資料列中。

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
			中	參照連結網址
			來源	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，系統會比照舊版架構安排匯出資料的架構。
升級之後，您只能存取重複項目陣列中的項目資料，而且無法再透過標準事件參數取得項目資料。
這項變更是為了支援多產品分析。
因此，對商品/產品資料的參照可能需要調整。

請使用這段指令碼，將現有的 BigQuery 資料集從舊的匯出架構遷移至新架構

登入 Cloud Platform Console > 「管理資源」頁面。
開啟需要遷移資料的專案，然後按一下頁面頂端的「啟用 Google Cloud Shell」。

殼層開啟後，請將下列指令碼複製到名為 migration_script.sql 的檔案：

送出下列指令：cat > migration_script.sql。
複製以下指令碼並貼進殼層。
按下 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

開啟新殼層，並將下列 bash 指令碼複製到名為 migration.sh 的檔案：

送出下列指令：cat > migration.sh。
複製以下指令碼並貼進殼層。
按下 Ctrl+D 鍵來儲存變更並離開。

請修改以下指令碼來納入您的 Analytics 資源 ID、BigQuery 專案 ID、Firebase 應用程式 ID、BigQuery 資料集名稱，以及所需資料的開始和結束日期。

指令碼 (migration.sh)：

# 專案的 Analytics 資源 ID。您可在 Firebase 的 Analytics 設定中找到這個 ID。
PROPERTY_ID=your Analytics property ID

# BigQuery Export 專案。
BQ_PROJECT_ID="您的 BigQuery 專案 ID" (例如 "firebase-public-project")

# 應用程式的 Firebase 應用程式 ID
FIREBASE_APP_ID="您的 Firebase 應用程式 ID" (例如 "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

# 指令碼尾端

開啟新殼層並送出 bash migration.sh 指令

舊的匯出架構

user_dim

欄位名稱	資料類型	說明
user_dim	RECORD	使用者維度記錄。
user_dim.user_id	STRING	透過 setUserId API 設定的 User ID。
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	廣告 ID/廣告識別碼。
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) 或簡短版軟體包版本。
user_dim.app_info.app_instance_id	STRING	這個應用程式執行個體的不重複 ID。
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	上傳了這些事件的軟體包的序列 ID。
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	在用戶端上記錄到這個事件的時間 (以微秒為單位，採用世界標準時間)。
event_dim.previous_timestamp_micros	INTEGER	之前在用戶端上記錄到這個事件的時間 (以微秒為單位，採用世界標準時間)。

這對您有幫助嗎？

我們應如何改進呢？

[GA4] BigQuery Export 架構

資料集

表格

欄

event_params RECORD

item_params RECORD

privacy_info 欄位

user_properties RECORD

user_ltv RECORD

geo

item_params RECORD

列

user_dim

event_dim

這對您有幫助嗎？

還有其他問題嗎？

嘗試以下步驟：