如何将移动应用程序从 SDK v4 迁移到 Adobe Experience Platform SDK

重要

迁移过程是不可逆的。

在开始将SDK V4移动应用程序迁移到Adobe Experience Platform SDK之前,请仔细阅读此文档。

关于SDK V4迁移

Adobe Campaign Standard使用SDK V4处理移动应用程序,将其作为与使用Adobe Experience Platform SDK的应用程序分开处理。
将AdobeSDK版本从v4升级到Adobe Experience Platform后,移动设备应用程序需要继续使用现有应用程序订阅者数据和营销活动:因此需要迁移。

注意

本页记录了如何将SDK v4移动应用程序迁移到新创建的Adobe Experience Platform SDK应用程序。 您的SDK v4移动应用程序不会与Adobe Experience Platform SDK移动应用程序 Configured Property status.

迁移后不会更改的内容
对使用迁移的SDK V4应用程序的现有投放和营销活动没有影响。
移动应用程序的名称将保持不变。
将保留iOS和Android的平台凭据。
应用程序的所有订阅者及其数据都将保留。
现有的SDK v4移动应用程序将继续向Adobe Campaign Standard发送数据(PII数据、订阅者和令牌信息)。
Organizational unit 移动应用程序的数量将保持不变。
迁移后将发生哪些更改
移动应用程序将在 Administration > Channels > Mobile app (Adobe Experience Platform SDK). 在迁移之前,它在 Administration > Channels > Mobile app (SDK V4).
Collect PII Endpoint 应用程序的更改。 年长 Collect PII Endpoint 将继续工作,发送的数据将不会丢失。
应用程序将绑定到Adobe Experience Platform Launch Mobile Property. 它将作为新创建的移动应用程序进行处理。
迁移中使用的原始Adobe Experience Platform SDK应用程序将不作为单独的应用程序存在。 只有迁移的SDK v4应用程序才可用。

将您的移动应用程序从SDK v4迁移到Adobe Experience Platform SDK

在迁移之前,您应考虑以下建议:

  • 迁移过程是不可逆的。
  • 您不应同时运行多个应用程序的迁移。 您还应确保同一应用程序的迁移不会同时被多个窗口触发。
  • 在迁移之前,请确保为您分配了 Organizational unit 要迁移的移动应用程序,以及要用于迁移的Adobe Experience Platform应用程序。
  • 迁移后,应用程序将成为Adobe Experience Platform SDK应用程序。 其更改将链接到其相应的Launch Mobile Property.
  1. 新建 Mobile property 在Adobe Experience Platform Launch。 有关此内容的详细信息,请参阅 Adobe Experience Platform Launch文档.

  2. 在Adobe Campaign Standard中,从高级菜单中,选择 Administration > Application Settings > Workflows 打开 syncWithLaunch 工作流。 检查工作流是否已结束且没有错误。

  3. 工作流完成后,从 Administration > Channels > Mobile app (Adobe Experience Platform SDK) ,检查移动应用程序是否在Adobe Campaign Standard中可用,以及是否在 Ready to Configure 状态。

  4. Administration > Channels > Mobile app (SDK V4),选择要迁移的SDK V4应用程序。

  5. 选择 Mobile application migration to AEP SDK 选项卡。

  6. Select AEP SDK mobile application to merge current application with 下拉列表,选择之前创建的Adobe Experience Platform SDK移动应用程序。

  7. 单击 Migrate

  8. Migration application 窗口,单击 Ok.

  9. 出现成功完成窗口,单击 Go to Adobe Experience Platform SDK Channel list.

  10. 从Adobe Experience Platform SDK渠道列表页面中,检查您之前的V4移动应用程序是否设置为 Ready To Configure.

  11. 选择您的移动应用程序并单击 Save 以完成迁移。

进行此迁移后,由V4版本的移动设备应用程序收集的订阅者以及由AEP版本的移动设备应用程序收集的新订阅者,将会在迁移的应用程序中可用。

要区分两种不同类型的订阅者,可以添加新的自定义字段: Text 扩展自定义资源时键入 Subscriptions to an application (appSubscriptionRcp) as sdkversionappVersion 例如。 有关如何扩展自定义资源的更多信息,请参阅此 页面.
然后,您将需要配置关联的Launch Mobile property 要在Collect PII调用中发送此自定义字段值,请相应地更改移动应用程序配置。

常见问题解答

问:在SDK v4移动应用程序中,将移动应用程序迁移到Adobe Experience Platform SDK选项卡时不可见。

答:从高级菜单 Administration > Application Settings > Options,请检查 Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option 选项。 该参数应设置为1,并默认启用。 管理员可能已手动禁用它。

问:从将移动应用程序迁移到Adobe Experience Platform SDK选项卡中,会显示消息无数据。

答:仅适用于 Organizational unit 中。 请确保您具有正确的Adobe Experience Platform迁移应用程序。 的 Property Status 的Adobe Experience Platform应用程序应设置为 Ready to ConfigureMobile app migration status 设置为 Not Migrated.

问:为何无法使用已配置资产状态的Adobe Experience Platform SDK应用程序进行迁移?

答:迁移过程会保留SDK v4订阅者和属性。 它只会从Adobe Experience Platform SDK应用程序中保留与Launch相关的信息。 来自Adobe Experience Platform SDK应用程序的订阅者和其他数据将丢失。 为避免任何数据丢失,请仅将Adobe Experience Platform SDK应用程序与 Ready to Configure Property Status 符合迁移条件。

问:迁移后,我在哪里可以找到之前的SDK v4移动应用程序?

答:迁移后的移动设备应用程序将从高级菜单中可见 Administration > Channels > Mobile app (Adobe Experience Platform SDK).

问:迁移后,在哪里可以找到新创建的Adobe Experience Platform SDK应用程序?

答:新创建的用于迁移的Adobe Experience Platform SDK应用程序将不作为单独的应用程序存在。 只有迁移的SDK v4应用程序才可用。

问:如果SDK v4移动应用程序组织单位设置为A(组织单位ALL的子代),而Adobe Experience Platform SDK设置为ALL。 如何迁移移动应用程序?

答:的管理员 Organizational unit 所有人员都将有权管理移动应用程序,并负责迁移。

问:如果SDK v4移动设备应用程序组织单位设置为A,而Adobe Experience Platform SDK应用程序设置为B(组织单位A的同级)。 如何迁移移动应用程序?

答:Adobe Experience Platform SDK应用程序是同级应用程序的资产 Organizational unit,则移动应用程序的用户将不可见 Organizational unit A.移动设备应用程序将可供 Organizational unit 但我们不建议这些管理员迁移移动应用程序。
在这种情况下,您应将移动应用程序移动到同一 Organizational unitOrganizational unit 具有父链接。
有关 Organizational unit,请参阅 部分.

问:从您的Adobe Experience Platform SDK移动应用程序(从v4移动应用程序迁移)页面的推送渠道设置下拉列表下,不会显示Android密钥或iOS证书的上传日期/名称等信息

答:创建SDK V4移动应用程序后,系统不会存储此信息。 将SDK V4移动应用程序迁移到Adobe Experience Platform SDK移动应用程序时,迁移的移动应用程序也将没有此类信息。 用户一旦上传新的iOS证书或Android密钥,则该密钥或证书的不同详细信息将会存储并正确显示在 Push channel settings 下拉菜单。

在此页面上