应用中对接的 AppsFlyer SDK 是应用与 AppsFlyer 平台之间的连接。从而实现应用激活、应用打开、应用内事件等数据的上报。

如需对接 AppsFlyer SDK：

1. 将 AppsFlyer SDK 接入相关应用。
   在应用中对接 AppsFlyer SDK。
   参阅 Android 和 iOS SDK 对接指南。
2. 使用 AppsFlyer 的事件定义，映射需要记录的应用内事件。
   您可以通过 SDK 或 S2S 完成此操作。您可以通过 SDK 或 S2S 完成此操作。

3. 移除其它归因平台的 SDK。
   您可以立即移除其他服务商的 SDK，完全切换至 AppsFlyer；也可以在过渡期间同时运行两个 SDK 数周。下表详细介绍了这两种方案。
    

   操作	发布新版应用后的情况	成效提升
   删除其它归因工具的 SDK（推荐）	只有 AppsFlyer 会记录新安装和更新应用的用户。对于尚未更新应用的用户，原服务商仍会显示其产生的事件。	快速过渡。 无重复归因。
   在过渡期间保留其它归因工具的 SDK	AppsFlyer 和原服务商都会对新安装进行归因并上报事件。之后再移除原服务商的 SDK。	可以进行数据验证。可以验证数据，即对比 AppsFlyer 与原服务商的数据。 可能发生重复归因，导致广告平台重复扣费（见下方示例）。具体请参见下文示例。 工作量更大。

4. 完成所有其他迁移任务后，请将对接 AppsFlyer SDK 的新版应用发布到应用商店。此后，新用户将由 AppsFlyer 进行归因。 
   注意：
   • 请确保在 App Store、Google Play 和其他第三方商店中上线更新后的应用。
   • 安卓应用可能会有非官方的 APK 下载渠道（请使用您的应用包名进行搜索，检查是否存在这种情况）。 您的 Android 应用可能已被上传至一些非官方 APK 网站，即使您对此并不知情（您可以在网上搜索应用的包名，检查是否存在此类情况）。这些网站通常需要一段时间才能更新至最新版本，因此仍可能为您带来自然量用户，而这些用户安装的可能是尚未对接 AppsFlyer SDK 的旧版本应用。
   • 应用商店中的应用更新可能需要几天才能全部完成。在此期间安装应用的用户，仍可能使用旧版本。

设备迁移是指将现有用户的设备 ID（IDFA、IDFV、GAID、CUID）列表上传到 AppsFlyer。请务必先完成这个流程，然后再上线带有 AppsFlyer SDK 的新版本应用。设备迁移是指将现有用户的设备 ID 列表（IDFA、IDFV、GAID、CUID）上传至 AppsFlyer 的过程。

设备迁移可以解决现有应用用户的相关数据问题。这些用户之前已经下载应用，并由原归因服务商进行归因。

设备迁移完毕后，AppsFlyer 中呈现的数据如下：

• 安装数据：与重新安装类似，已迁移的设备没有安装数据记录。 AppsFlyer 中不会呈现已迁移设备的激活。
• 应用内事件和会话数据：如果采用非归因迁移方式，相关数据会记录并显示为自然量；如果采用归因迁移方式，则会归因至相应的媒体渠道和广告系列。
• 再营销：再归因和再互动数据会正常显示。
• 活跃数据：正常显示。
• 留存和同期群数据：已迁移的设备没有安装记录。因此不会关联到任何同期群，也不会显示在留存和同期群报告中。 

请按照以下步骤迁移设备： 

1. 确定需要迁移的用户范围。您可以迁移所有现有用户，但这可能导致 AppsFlyer 无法准确获取再归因数据；也可以只迁移近期安装应用的用户，但这可能导致部分安装时间较早的用户被重复扣费。我们建议的迁移范围是当前再归因窗口期内的活跃用户。举例来说，如果相关应用的再归因窗口期为 90 天，则推荐的迁移范围是在过去 90 天内打开过该应用的用户。
2. ［可选］通知营销人员或用户获取（UA）经理，暂停现有广告系列，包括 SRN、非 SRN 广告平台和自有媒体广告系列，直至设备迁移完成。如果决定不暂停广告系列，请在对接 AppsFlyer SDK 的新版应用发布至应用商店后，尽快迁移原服务商中剩余的设备 ID。
3. 根据所选用户范围，按照归因迁移或非归因迁移对应的文件结构准备 CSV 文件。请参阅 CSV 示例
4. 将您准备好的 CSV 文件发给 AppsFlyer 客户成功经理（CSM）。
   您的 CSM 将负责把设备 ID 迁移至 AppsFlyer。 

对于通过这种方法迁移到 AppsFlyer 的设备，AppsFlyer 会按照之前的归因工具所上报的媒体渠道以及相关广告平台的数据保留政策，记录并呈现其应用内事件和应用打开（sessions）数据，

用于归因设备迁移的 CSV 文件结构

CSV 文件规则：

• CSV 文件中可以包含多个应用的用户设备。
• 不得在多行中重复使用相同的设备 ID 与应用 ID 组合。如果出现重复，AppsFlyer 会取用最后一次出现的数据。
• 必须包含所有列标题：app_id、platform、device_id、id_type、install_time、media_source、integrated_partner、campaign、campaign_id。注意：字段顺序很重要，必须保持不变。
• 同一设备可以同时填写 IDFV 和 IDFA，但必须分别放在不同的行中。除 device_id 外，这些行中的其他字段都必须相同。
• 每行必须包含 9 个字段，每个字段之间以逗号区隔。
• 将非必填字段留空（空值）
• 文件最多可以包含 500 万行。
• 如果您有多个文件，请确保各文件的名称之间没有重复。
• 必须使用 UTF-8 对数据进行编码。
• 【可选】可以使用 ZIP 或 GZIP 来压缩文件。
   

查看 CSV 文件范例

采用此方式迁移至 AppsFlyer 的设备会被记录为自然量用户，但不会显示在相关界面中。这些设备上的应用内事件和应用打开（sessions）也会被记录为自然量，并显示在面板中。

用于非归因设备迁移的 CSV 文件结构

操作	D. Columns	使用场景	示例
1	App ID + IDFA/GAID	如果您所有的安卓用户都有 GAID。 如果您的用户仅使用 iOS
2	App ID + Device ID + Device ID type	如果您的部分安卓用户只有 IMEI 或 Android ID，而没有 GAID（如第三方应用商店、4.4.2 以下的安卓版本）。 Android ID 必须为十六进制格式。 注意： ID 类型列必须使用以下准确的字符串：advertiserId（也支持 amazon_aid）、idfa、idfv、android_id、imei。 如果您使用的是 android_id 或 imei，但后续 AppsFlyer 接收到了规格更高的标识符，就会将其记录为新的转化归因。 android_id 和 imei 默认不会由 AppsFlyer SDK 收集。如果使用其中任一标识符，请确保在SDK 对接过程中收集相应字段。

CSV 文件规则：

• CSV 文件中可以包含多个应用的用户设备。
• 每行针对每个应用只能包含一个设备 ID。
• 文件中的列标题必须设置为特定的字段并以指定的顺序排列，具体方式有以下两种可选：
  • 选项 1：app_id、device_id
  • 选项 2：app_id、device_id、id_type
• App ID 应为小写
• Android 标识符应为小写
• IDFA/IDFV 应为大写
• 最多可包含 2500 万行

查看 CSV 文件范例

当 MMP（移动衡量合作伙伴）向 SRN 发出请求，查询具体设备的互动信息时，SRN 会回复认领结果。如果两个 MMP（例如 AppsFlyer 和其他归因服务商）同时向同一个 SRN 查询同一次设备安装，您可能会因此被重复扣费。

如需迁移 SRN 广告系列：

• 在 AppsFlyer 中启用并配置相关 SRN。

广告平台的归因链接会记录用户与广告的互动情况，之后如果用户激活了相关应用，AppsFlyer 就能将该激活归因到对应的广告互动。

如需迁移非 SRN 广告平台的广告系列：

1. 在 AppsFlyer 中启用相关广告平台。
2. 为每个广告平台生成 AppsFlyer 归因链接。
3. 将各个广告系列中的现有追踪链接替换为 AppsFlyer 的归因链接。 

自有媒体是指您在以下场景中使用的归因链接：

• 内容分享
• 网页到应用程序
• 邮件
• 短信
• 社交媒体发布
• 博客
• 社区帖子（Quora 等）
• 等场景

对于这些广告系列，AppsFlyer 使用 OneLink 链接。 OneLink 链接会根据用户的设备类型让用户跳转到对应的应用商店、网址/落地页，或直接调起应用。

如需将现有自有媒体链接替换为 AppsFlyer OneLink 链接：

• 请联系您的 CSM，让其协助您根据当前使用的流量入口和工具将自有媒体链接转换成 OneLink 链接。

对于 SKAdNetwork（SKAN）归因，只能由一个 SDK 更新转化值。否则，SKAN 数据将失去意义。因此，完成迁移后，请确保只有 AppsFlyer SDK 更新 SKAN 转化值。

了解如何在 AppsFlyer 中设置 SKAN 转化值。

迁移之前，您的系统会根据与当前服务商约定的报告结构、字段和参数，存储归因数据。为了确保 AppsFlyer 能够正确生成报告，您必须将现有报告结构、字段和参数调整并映射为 AppsFlyer 对应的结构、字段和参数。

调整/映射报告结构的方法如下：

• 请与您的客户成功经理联系，便于将您的报告数据结构从 Adjust，Branch / Tune 或 Kochava 快速调整/迁移到 AppsFlyer。

AppsFlyer 支持通过多种方式获取原始报告数据和汇总报告数据。请全面了解这些方法，然后选择最适合自己的方式系统化地完成数据对接设置。

您可以通过以下方式获取数据：

• 面板
• 导出报告
• Push API
• Pull API
• Data Locker