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

截至2021年8月31日,已终止对Adobe Experience Platform Mobile版本4 SDK的支持。 如果您仍在使用此旧版SDK,则必须使用Adobe Experience Platform SDK更新您的实施 2024年6月底之前. 请参阅本文以了解如何迁移到AdobeExperience Platform SDK。

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

关于SDK V4迁移

Adobe Campaign Standard使用SDK V4处理移动应用程序作为单独的应用程序,而不是使用Adobe Experience Platform SDK的应用程序。

将AdobeSDK版本从v4升级到Adobe Experience Platform后,移动应用程序需要继续使用现有的应用程序订阅者数据和营销活动:因此需要迁移。

NOTE
本页记录了SDK v4移动应用程序迁移到新创建的Adobe Experience Platform SDK应用程序的过程。 Adobe Experience Platform您的SDK v4移动应用程序不会与具有的 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 应用程序的URL将发生更改。 较早 Collect PII Endpoint 将继续工作,发送的数据不会丢失。
应用程序将绑定到标记 Mobile Property. 它将作为新创建的移动应用程序处理。
迁移中使用的原始Adobe Experience Platform SDK应用程序将不会作为单独的应用程序存在。 只有迁移的SDK v4应用程序可用。

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

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

  • 迁移过程不可逆。
  • 您不应同时运行多个应用程序的迁移。 您还应确保同一应用程序的迁移不会同时由多个窗口触发。
  • 在迁移之前,请确保已为您分配 Organizational unit 要迁移的移动应用程序以及用于迁移的Adobe Experience Platform应用程序的ID。
  • 迁移后,该应用程序将变为Adobe Experience Platform SDK应用程序。 其更改将链接到其相应的标记 Mobile Property.
  1. 新建 Mobile property 在数据收集UI中。 有关详情,请参阅 文档.

  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) 作为 sdkversionappVersion 例如。 有关如何扩展自定义资源的更多信息,请参阅此 页面.
然后,您需要配置关联的标记 Mobile property 在收集PII调用中发送此自定义字段值,并相应地更改您的移动应用程序配置。

常见问题解答 faq

问:在SDK v4移动应用程序中,“将移动应用程序迁移到Adobe Experience Platform SDK”选项卡不可见。 tab-not-visible

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

问:在迁移到Adobe Experience Platform SDK的移动应用程序选项卡中,会显示消息“无数据” 。 no-data

答:只有符合条件的申请,您才可以 Organizational unit 将显示在列表中。 请确保您拥有用于迁移的正确Adobe Experience Platform应用程序。 此 Property Status Adobe Experience Platform的URL应设置为 Ready to ConfigureMobile app migration status 设置为 Not Migrated.

问:为何无法使用状态为“已配置”属性的Adobe Experience Platform SDK应用程序进行迁移? property-status

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

问:迁移后,我可以在何处找到以前的SDK v4移动应用程序? v4-app-not-visible

答:迁移后的移动应用程序将显示在高级菜单中 Administration > Channels > Mobile app (Adobe Experience Platform SDK).

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

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

问:如果SDK v4移动应用程序组织单位设置为(组织单位ALL的子项),并且Adobe Experience Platform SDK设置为“全部”。 如何迁移移动应用程序? v4-org-unit

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

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

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

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

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

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff