了解如何将企业现有的安装归因信息导入 Singular 平台。
什么是归因数据导入？
当您从不同的归因提供商切换到 Singular 时，我们会为您提供导入应用程序现有用户群的独特选项。
通过导入，Singular 可以将这些用户标记为现有用户，并保持安装数量的准确性。这有助于但并不能防止在切换到 Singular 时出现 "有机峰值"，同时还能保护您不会因为在相应设备上安装相同应用程序而被重复计费。
请注意，您必须在任何应用程序在 Singular 中获得实时流量之前将历史数据导入您的 Singular 账户。如果您在加载历史数据之前就将应用程序发布到应用程序商店，那么有机安装量将会出现峰值，部分设备的归因来源也会不正确。
Singular 如何识别您的现有用户？
对于安卓设备：
- 需要设备的谷歌广告 ID（GAID） 或 安卓应用程序集 ID（ASID）！
对于 iOS 设备：
- 设备的供应商标识符（IDFV） 是必须 的！
- 设备的广告标识符 (IDFA) 是 可选的 ，但如果您有，则应提供！
重要！没有有效标识符的设备将无法导入。
Singular不会在导入过程中使用自定义用户ID（或任何归属功能），即使您与Singular共享自定义用户ID。
注：如果配置了内部 BI 回传，导入的用户将在网络字段中显示 "导入用户"。
Singular 如何导入数据？
只要数据格式符合以下数据文件规范，Singular 就会导入您提供的数据：
数据文件规范：
- 文件名格式应以文件生成日期（YYYYMMDD）开头，并指定应用程序名称和平台。YYYYMMDD_App-Name_Platform_Import.csv
示例：20170115_SingularDeviceAssist_iOS_Import.csv
- 数据文件应为 Unix 编码的 CSV（逗号分隔）格式。
- 数据文件的格式必须正确无误。
- 每个数据文件的大小必须小于 2GB。对于大型数据集，您可以分割文件。
- 所有数据文件必须包含规范中定义的正确标题行。
- 所有 UUIDv4 标识符（如 IDFA、IDFV、GAID、ASID）长度必须为 36 个字符。
- 必须删除重复的行。
- 不导入无有效设备标识符的行。
- 必须删除所有值的前导空格和尾部空格。
重要！如果数据文件不符合这些要求，将被拒绝，导入将被延迟，直到提供正确的文件。
数据文件布局规范
样本文件
20170115_SingularDeviceAssist_Android_Import.csv
20170115_SingularDeviceAssist_iOS_Import.csv
| 列名 | 必填 | 说明 | 示例值 |
| app_name | Singular 的应用程序页面中显示的应用程序名称 | 我的应用程序 | |
| app_id | 安卓/iOS 应用程序的软件包名称/软件包 ID。 注意： 请勿使用应用程序商店 ID（例如：id1441750662) |
com.singular.app | |
| os | 指定 Android 或 iOS | 安卓或 iOS | |
| idfa | 广告商的 iOS ID：如果 IDFA 和 IDFV 都可用，则应同时提供。 | DFC5A647-9043-4699-B2A5-76F03A97064B | |
| idfv | |
供应商的 iOS ID | 21DB6612-09B3-4ECC-84AC-B353B0AF1334 |
| gaid | 谷歌广告 ID | 8ecd7512-2864-440c-93f3-a3cabe62525b | |
| asid |
|
应用程序集 ID：仅在未提供 GAID 时需要。如果同时提供 GAID 和 ASID，则应同时提供。 | 38400000-8cf0-11bd-b23e-10b96e40000d |
| android_id |
|
Android ID：仅在未提供 GAID 和 ASID 时需要。如果 GAID 和 ASID 都可用，则不应提供 Android ID。 | FC8D449516DE0DFB |
| user_id | 自定义用户 ID | player_1234 | |
| 设备制造商 | 仅适用于亚马逊设备 | 亚马逊 |