关于线下事件数据
您可以从无法连接互联网或者因其他原因而无法支持通过 SDK 或 Measurement Protocol 实时收集事件的来源导入线下事件。在您上传事件之后，系统会将其视为通过我们的 SDK 收集的事件来进行处理，并会采用您提供的时间戳或上传操作的时间戳（如果您未提供时间戳）。
您可以导入与 Google Analytics（分析）自动收集的事件或我们针对不同行业推荐采用的事件相符的事件，也可以导入任何自定义事件、参数或格式正确的用户属性。了解详情
若要移除此类数据，需要提交数据删除请求或删除用户。
线下事件数据导入的工作原理
您需要创建与 Google Analytics（分析）事件架构匹配的 CSV 文件，才能导入线下事件。请参阅下文的模板示例。
创建自定义维度
如果您要为 Google Analytics（分析）中尚不存在的维度导入值，并希望在报告中显示这些数据，则需要先创建这些维度，然后再上传数据。了解详情
在您创建自定义维度后，Google Analytics（分析）最长需要 4 小时才能识别您导入的数据。（您可以打开探索并检查维度选择器中是否有相应维度，以验证您创建的自定义维度是否处理完成。）
创建 CSV 文件
可以参考下文中的模板来创建包含事件数据的 CSV 文件。
上传数据
数据导入简介一文中概述了常规上传流程。
创建数据源时，请选择线下事件数据。
对于线下事件，您导入的字段会自动映射到 Google Analytics（分析）字段。
上传数据后，Google 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 | 美元 |
限制
使用预留名称的事件、参数和用户属性将会被拒绝。
不提供值的商品事件参数（例如 item_list_name）将会被拒绝。部分推荐事件（例如，电子商务、求职招聘、旅游）支持使用商品事件参数。
事件和参数名称都需要遵循以下规则：
- 事件最多可以包含 25 个参数。
- 事件最多可以包含 25 个用户属性。
- 用户属性名称不得超过 24 个字符。
- 用户属性值不得超过 36 个字符。
- 事件名称不得超过 40 个字符，只能包含字母数字字符和下划线，并且必须以字母字符开头。
- 参数名称（包括商品参数）不得超过 40 个字符，只能包含字母数字字符和下划线，并且必须以字母字符开头。
- 参数值（包括商品参数值）不得超过 100 个字符。