Adjust 迁移指南

从其他移动监测合作伙伴迁移到 Adjust 其实非常简单轻松！迁移每一步都有 Adjust 支持和引导，还有各类资源供您参考。

An infographic showing the steps you follow when you migrate to Adjust from another MMP.

请按照本指南中的说明，完成下列迁移步骤：

请注意:
如果您的套餐中包含专属支持服务，您还会收到许多研讨和培训材料，主题涵盖 SDK 集成、UA 设置、数据导出/BI、Datascape/数据分析和 iOS 推广活动设置等。

1. 在 Adjust 中设置您的应用

导入历史数据前，您需要现在 AppView 中设置应用。所有历史数据都会基于您的 Adjust 应用识别码​ 进行导入。

  1. 请按照应用设置指南中的说明进行操作。
  2. 应用设置完成后，请复制您的 应用识别码​ 。

2. 集成并测试 Adjust SDK

警告:
Adjust 完成数据导入前请不要将应用提交到应用商店。否则 Adjust 会将已有用户记为新用户。

帮助中心的开发者板块中提供详细文档。针对 Adjust SDK 集成设置应用时，请确保将 SDK 设置为 sandbox 模式并将日志设置为 verbose，尽可能获取最多的信息。若有任何关于 SDK 集成的问题，请联系您的 Adjust 代表，或发送邮件至 support@adjust.com。

为了让测试过程更简单，Adjust 为客户提供测试控制台和设备 API。您可以使用这些工具来分析 SDK 发送至 Adjust 服务器的数据。

3. 导出您的历史数据

在 AppView 中设置好应用后，您就可以创建一个包含历史数据的导入文件了。从您之前的移动监测合作伙伴或您的商业智能系统中导出信息并按以下要求进行格式化。

文件格式

您的文件必须为 CSV (逗号分隔值) 文件且：

  • UTF-8 编码。
  • 以逗号分隔
  • 以双引号 (") 限定。

文件名称

CSV 文件名中必须包含 小写​ 的如下信息：

  1. 第一步中保存的应用识别码。
  2. 目标操作系统的名称 (例如ios 或 android)。
  3. 文件中包含的设备 ID 类型。

您必须针对 每种​ 设备 ID 类型提供一个文件。

<app_token>_<os_name>_<device_id_type>.csv

设备 ID 类型

以下设备 ID 类型可用：

iOS​ :

  • IDFA
  • idfv

针对 Google Play 商店​ 的 安卓​ 设备：

  • gps_adid
  • android_id

针对 Amazon 应用商店​ 的 安卓​ 设备：

  • fire_adid
  • android_id

示例

此示例展示了包含以下属性的数据应该使用的文件名：

  1. 与 Adjust 应用识别码​ 为 abc123的应用相关。
  2. 安卓​ 设备。
  3. 通过 gps_adid 设备 ID 类型识别。
abc123_android_gps_adid.csv

字段

重要提示:
CSV 文件中的所有双引号 ( ") 都必须转义。为此请将被引用字段放置在另一组双引号内，例如 ""High spenders""。

您的 CSV 文件必须按下列顺序包含下列字段：

字段必要或可选示例值注意事项
device_id必要参数B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8连字符可选。可接受 device_id 类型：
  • android_id (case-insensitive)
  • external_device_id (case-sensitive)
  • gps_adid (Google 广告 ID，不区分大小写)
  • fire_adid (case-insensitive)
  • idfa (case-insensitive)
  • idfv (case-insensitive)
created_at可选1586391845Unix 安装时间戳为整数且精确至秒。如果导入文件中的该字段未被填充，那么字段值就会自动被填充为导入时间戳。
network必要参数已导入的设备为了避免与正在运行中的 Adjust 数据集混淆，已导入的数据应当保存在单独的渠道中。要进一步了解如何构建此信息，请查看 渠道映射表 。
campaign可选IronSource
adgroup可选ironsource_ios_us
creative可选Ad Group 1

如果您没有可以用来填充一个或多个可选字段的信息，请插入空白字段。每一行都应该包含与标头中数量相同的字段。

渠道映射

应用首次打开时，Adjust 就会立刻跟踪安装。请注意：在集成 Adjust SDK 后，如果现有用户打开应用，那么该应用打开也会被计为安装，Adjust 会记录下 "安装" 日期。也就是说，如果您在导入文件中使用了实际渠道名称，那么可能会看到对应渠道新安装量激增，但其中会包含现有用户的 "安装" 事件。

要避免这一问题，请创建一个名为 "Imported devices" (导入设备) 的临时渠道，并将历史数据导入至该临时渠道。这样就能分隔历史数据和实时 Adjust 数据，避免现有用户的应用打开被计为安装，从而精准掌握每个渠道的表现。要保持数据精细度，请按照下列方式映射每个渠道字段：

之前系统值Adjust 导入 CSV 值注意事项
—network请将该值硬编码为 "Imported devices" (导入设备)。
渠道名称campaign
推广活动名称adgroup
广告组名称creative

使用这种架构，您可以将现有的推广活动数据深入细分为三个子层。

示例

下方为带有标题行和值的模板，请您参考：

device_id,created_at,network,campaign,adgroup,creative
<device_id>,<created_at>,Imported Devices,<network>,<campaign>,<adgroup>

使用之前系统中的值填充 <device_id>、 <created_at>、 <network>、 <campaign>及 <adgroup> 。例如：

device_id,created_at,network,campaign,adgroup,creative
B1CDA5FE-BEBA-48ED-AD0F-27AE62BF82D8,1586391845,Imported Devices,ironsource,ironsource_ios_us,Ad Group 1

4. 将数据导入 Adjust

完成数据导出，并验证文件确实符合上述要求后，请将文件上传到安全的位置，然后发送给您的 Adjust 代表。Adjust 技术团队会导入您的 CSV 文件并检查数据，确保一切正常。导入完成后，Adjust 代表会主动与您联系。

请注意:
导入的用户不会自动出现在 Datascape 报告中。只有您已发布包含 Adjust SDK 的更新 后 且这些用户开启会话时才会出现。

5. 发布应用

开发者确认已集成 Adjust SDK，且 Adjust 代表已确认数据导入完成后，您就可以向应用商店提交应用新版本了。请检查应用统计数据，确保现有用户和新安装监测和记录正常开展。

6. 设置推广活动

按照推广活动设置指南中的说明设置与渠道合作伙伴和自归因渠道合作开展的推广活动。如果在设置推广活动时需要帮助，请向 Adjust 代表提供您的合作伙伴列表。

如果您的套餐中包含专属支持服务，那么您的 Adjust 代表会为您组织研讨会，带您了解：

  • 您可以记录的推广活动类型
  • 您可接收的信息级别
  • 如何创建推广活动链接
  • Adjust 的归因方法
  • 如何设置 iOS 14+ 推广活动

该讨论会结束后，您可以联系渠道合作伙伴实施推广活动配置。

7. 更新推广活动链接

请注意:
务必在集成 Adjust SDK 的应用版本在应用商店上线后，再开始进行渠道测试。

完成推广活动配置后，请将 Adjust 推广活动链接发送给您的渠道合作伙伴，方便后者测试新链接并更新其设置。

8. 探索全新 Adjust suite 的其他功能

好的！现在，您可以开始使用全新 Adjust suite 了。欢迎查看帮助中心，参阅下列指南及更多：

如果您需要进一步的建议或解释，请联系您的客户经理或发送邮件至 support@adjust.com。