關於離線事件資料
您可以從沒有網路連線,或是無法透過 SDK 或 Measurement Protocol 支援即時收集事件的來源匯入離線事件。上傳後,系統會將這些事件視為透過我們 SDK 收集的事件進行處理,並使用您提供的時間戳記或上傳的時間戳記 (若您未提供)。
您可以匯入與 Analytics (分析) 自動收集事件相符的事件或我們針對不同產業建議採用的事件,也可以匯入任何自訂事件、參數或格式正確的使用者屬性。瞭解詳情
若要移除這項資料,需要提交刪除資料要求或刪除使用者。
離線事件資料匯入的運作方式
如要匯入離線事件,您必須建立符合 Analytics (分析) 事件結構定義的 CSV 檔案。請參考以下範本。
建立自訂維度
如果要為 Analytics (分析) 中還不存在的維度匯入值,且想在報表中查看這項資料,請先建立這些維度,再上傳資料。瞭解詳情
建立自訂維度後,Analytics (分析) 最久需要 4 個小時才能識別您匯入的資料 (如要確認系統是否已處理自訂維度,請開啟「探索」,並查看維度挑選器中是否有維度)。
建立 CSV 檔案
請參考下方範本建立事件資料的 CSV 檔案。
上傳資料
如要瞭解一般上傳程序,請參閱「關於資料匯入」一文。
建立資料來源時,請選取「離線事件資料」。
如果是離線事件,匯入的欄位會自動對應至 Analytics (分析) 欄位。
上傳資料後,Analytics (分析) 最久可能需要 24 小時的處理時間,才能讓報表、目標對象和探索使用這些資料。
如果從資料上傳服務刪除資料來源,上傳的資料並不會遭到刪除。與所有其他收集方法一樣,您可能需要提出資料刪除要求,才能移除透過「資料匯入」功能上傳的資料。
資料來源詳細資料
圖例
範圍 | 事件 |
---|---|
必填欄位 |
[任一] client_id 或 app_instance_id [任一] tag_id 或 firebase_app_id (tag_id 和 client_id) 或 (firebase_app_id 和 app_instance_id) event_name |
已匯入的資料 |
您可以使用下列標頭格式上傳任何事件、參數、項目或使用者屬性資料:
|
附註 | 您不得上傳個人識別資訊,也不得將其與離線事件匯入建立關聯。瞭解詳情 |
範本
以下是事件資料的 CSV 範本範例。如果您需要手動建立上傳檔案,請參考此範例。
measurement_id | client_id | user_id | timestamp_micros | ad_personalization | ad_user_data | event_name | event_param.page_location | event_param.page_referrer | event_param.page_title | event_param.screen_resolution | user_property.color_score | event_param.foo | item1.item_id | item1.item_name | item1.category | item1.item_list_id | item1.item_list_name | item1.index | item1.quantity | item1.price | item2.item_id | item2.item_name | item2.quantity | item2.price | event_param.transaction_id | event_param.value | event_param.tax | event_param.shipping | event_param.currency |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488000000000 | 授予 | 已遭拒 | page_view | /home | referrer.com | 首頁 | 1600x900 | 藍色 | 1-2 | |||||||||||||||||
G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488060000000 | 已遭拒 | 已遭拒 | page_view | /video_detail | 影片檢視器 | 1600x900 | 藍色 | 1-4 | ||||||||||||||||||
G-12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488120000000 | 已遭拒 | 授予 | video_play | /video_detail | 影片檢視器 | 1600x900 | 藍色 | |||||||||||||||||||
G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574400000000 | 已遭拒 | 授予 | page_view | /home | referrer.com | 首頁 | 2560x1440 | 綠色 | 2-2 | |||||||||||||||||
G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574460000000 | 已遭拒 | 授予 | page_view | /product_detail | 產品詳細資料 | 2560x1440 | 綠色 | 2-16 | ||||||||||||||||||
G-67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574520000000 | 授予 | 授予 | page_view | /product_detail | 產品詳細資料 | 2560x1440 | 綠色 | |||||||||||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609574520000000 | 授予 | 授予 | page_view | /camp_lp_1 | referrer.com | 夏季促銷! | 2560x1440 | 藍色 | 3-1 | |||||||||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660801000000 | 授予 | 已遭拒 | view_item_list | /camp_lp_1 | 夏季促銷! | 2560x1440 | 藍色 | 123abc | red_shoe | 鞋子 | list_123 | colorful_shoes | 1 | 1 | 234bcd | blue_shoe | 1 | 30.00 | ||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660860000000 | 授予 | 授予 | select_item | /camp_lp_1 | 夏季促銷! | 2560x1440 | 藍色 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660870000000 | 授予 | 授予 | page_view | /product_detail | 產品詳細資料 | 2560x1440 | 藍色 | 3-5 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660930000000 | 已遭拒 | 授予 | view_item | /product_detail | 產品詳細資料 | 2560x1440 | 藍色 | 3-17 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660950000000 | 已遭拒 | 已遭拒 | add_to_cart | /product_detail | 產品詳細資料 | 2560x1440 | 藍色 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660970000000 | 授予 | 已遭拒 | begin_checkout | /product_detail | 產品詳細資料 | 2560x1440 | 藍色 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660975000000 | 授予 | 已遭拒 | page_view | /purchase_confirmation | 恭喜! | 2560x1440 | 藍色 | 3-21 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
G-67890ABCDE | 121212.3434 | 1000003 | 1609660980000000 | 授予 | 已遭拒 | purchase | /purchase_confirmation | 恭喜! | 2560x1440 | 紫色 | 3-21 | 234bcd | blue_shoe | 鞋子 | list_123 | colorful_shoes | 2 | 1 | 30.00 | t12345 | 37.49 | 2.50 | 4.99 | USD |
限制
使用預留名稱的事件、參數和使用者屬性都會遭到拒絕。
沒有值的項目事件參數 (例如 item_list_name) 將遭到拒絕。部分建議事件支援項目事件參數 (例如 「電子商務」、「工作機會」、「旅遊」)。
事件和參數名稱都必須遵守下列規則:
- 事件最多只能有 25 個參數。
- 事件最多只能有 25 個使用者屬性。
- 使用者屬性的名稱不能超過 24 個半形字元。
- 使用者屬性的值不能超過 36 個半形字元。
- 事件名稱不能超過 40 個半形字元,只能使用英文字母、數字和底線,且必須以字母為開頭。
- 參數名稱 (包括項目參數) 不能超過 40 個半形字元,只能使用英文字母、數字和底線,且必須以字母為開頭。
- 參數值 (包括項目參數值) 不能超過 100 個半形字元。