中文

Adjust 迁移指南

转为使用 Adjust — 我们的迁移计划帮助您平稳过渡、顺利完成设置,实现无痕的持续跟踪。Adjust 迁移计划留有一个月的过渡期和设置时间。每个迁移步骤花费大约一周时间。如果您想按需求自定义集成时间或加快集成速度,请联系您的 Adjust 销售工程师。

控制面板设置和数据导入

首先,我们会提供有关 Adjust 功能的说明性演示,帮助您在 Adjust 控制面板中进行设置。

您可了解到:

  • 如何设置应用和应用内事件
  • 如何设置原始数据回传或原始数据上传

完成控制面板设置后,您就可以邀请账户用户访问控制面板。 下一步,我们会导入您现有的用户群。 

步骤 1:数据导入

在首次发布带有 Adjust SDK 的应用更新时,最佳的做法是先导入现有的设备信息,以便 Adjust 获得这些设备的记录,避免安装数据发生重复。您可以从之前的移动监测合作伙伴 (MMP) 和 / 或商务智能系统中导出现有数据。

文件格式

Adjust 可接受采用下列格式的逗号分隔值 (CSV) 文件:

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

iOS 和安卓均支持使用下列设备 ID 的导入:

操作系统商店设备 ID 类型
AndroidGoogle Play Storegps_adid
Android亚马逊应用商店android_id
iOSApp Storeidfa
iOSApp Storeidfv

每个文件都应遵循下列命名约定: <app_token><os_name><device_id_type>.csv

请以小写提供应用识别码、操作系统名称和设备 ID 类型值。例如:

sgnadsdg354gfan_android_gps_adid.csv

字段

请注意:
为避免数据重复,针对每个 device_id_type/app_token 组合,Adjust 只会导入首次出现的 device_id。同一文件或任何未来文件中出现的重复值都会被忽略。

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

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

如果您没有可以用来填充一个或多个可选字段的信息,请插入空白字段。每行的字段数量应与标头数量匹配。

请注意:
已导入的用户不会自动显示在您的控制面板报告中;每个已导入的用户只有 (在集成 Adjust SDK 的应用版本中) 触发应用会话后,才会被纳入到您的 Adjust 数据集中。

您的数据导入完成后我们便会立即通知您。

数据导入最佳做法

已导入的设备

为了保护 Adjust 数据集的精确性,我们建议您不要将历史数据导入运行中的渠道。从外部系统导入的设备信息没有相对应的安装事件,因此,如果与 Adjust 生成的数据混合,可能导致不准确或不清晰的数据。要避免出现这个问题,我们建议您使用名为 "Imported Devices" (已导入设备) 的临时渠道,用渠道名称作为推广活动名称,推广活动名称作为广告组名称,广告组名称作为素材名称,如上方的 CSV 所示。

之前系统值Adjust 导入 CSV 值注意事项
network硬编码为 "Imported devices" (已导入设备),或留白供 Adjust 自动填充信息。
渠道名称campaign
推广活动名称adgroup
广告组名称creative

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

示例

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

device_id,created_at,network,campaign,adgroup,creative

<device_id>,<created_at>,Imported Devices,,, Populate <device_id>, <created_at>, <network>, <campaign>, and <adgroup> with values from your previous system. For example:

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

设备 ID

针对每款 iOS 应用,我们推荐您导入 2 个文件,每 iOS device_id 值一个:

  • idfa
  • idfv

针对每款安卓应用,我们推荐您导入带有下列 device_id 值的单一文件:

  • gps_adid

android_id 只代表了 gps_adid 未覆盖的 1-3% 的设备,因此并非必须导入。

隐私

导入文件中会包含敏感信息,因此,我们推荐您将文件上传到安全位置,与您的 Adjust 联系人分享。完成导入后,您的 Adjust 联系人会移除文件。

第二步:SDK 集成和测试

在我们导入您的现有用户群时,您便可以开始集成和测试 Adjust SDK。

请参阅我们的 SDK 发布页面,了解关于 SDK 发布的信息。

在开发者执行开发和测试期间,您将能够在 Adjust 控制面板内看到并审查测试数据。所有 SDK 集成测试均应在将 SDK 环境设置为 Sandbox 模式的情况下展开。

如果您的开发者对 SDK 集成有任何疑问,或希望获得针对集成流程的一对一详细解释,我们可应要求安排讨论会为您说明。

为开展 SDK 测试,我们建议使用 Adjust 设备 API(应用程序编程接口)。

销售工程师确认 SDK 集成成功并完成用户导入后,我们将批准您将已集成 Adjust SDK 的新版应用提交到所需应用商店。

警告:
在数据导入完成前,请勿将应用提交到应用商店,否则您的现有用户群将在 Adjust 中被视为新用户。

第三步:推广活动设置

Adjust 推广活动设置向导可帮助您轻松设置推广活动。如您需要自定义设置支持,只需向我们提供合作伙伴列表,我们便可安排推广活动讨论会,帮助您了解流程。

我们将讨论:

  • 您可以跟踪的推广活动类型
  • 您可接收的信息级别
  • 如何创建跟踪链接
  • 如何启用合作伙伴模块
  • 我们的归因方法

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

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

一旦推广活动启动并开始运行,Adjust 销售工程师会为您确认您的跟踪设置以及报告进行顺利无误。

第四步:分析及优化

在您的应用(已妥善集成 SDK)在应用商店中上线,并且 Adjust 也开始跟踪您的推广活动数据后,我们会安排最终迁移讨论会。

讨论会将涵盖:

  • 如何分析您的数据
  • 如何提取报告
  • 如何接收原始数据
  • 关于制定用户获取策略的建议

上述步骤将赋予您开始充分利用 Adjust 功能,以及跟踪数据所需的全部工具和知识。我们随时乐意为您回答问题或提供建议。请联系您的客户经理,或发送电子邮件至 support@adjust.com 与我们联系。