如何将移动应用程序从 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。
关于SDK V4迁移
Adobe Campaign Standard使用SDK V4处理移动应用程序作为单独的应用程序,而不是使用Adobe Experience Platform SDK的应用程序。
将AdobeSDK版本从v4升级到Adobe Experience Platform后,移动应用程序需要继续使用现有的应用程序订阅者数据和营销活动:因此需要迁移。
将您的移动应用程序从SDK v4迁移到Adobe Experience Platform SDK how-to-migrate
在迁移之前,您应该考虑以下建议:
- 迁移过程不可逆。
- 您不应同时运行多个应用程序的迁移。 您还应确保同一应用程序的迁移不会同时由多个窗口触发。
- 在迁移之前,请确保已为您分配 Organizational unit 要迁移的移动应用程序以及用于迁移的Adobe Experience Platform应用程序的ID。
- 迁移后,该应用程序将变为Adobe Experience Platform SDK应用程序。 其更改将链接到其相应的标记 Mobile Property.
-
新建 Mobile property 在数据收集UI中。 有关详情,请参阅 文档.
-
在Adobe Campaign Standard中,从高级菜单中,选择 Administration > Application Settings > Workflows 然后打开 syncWithLaunch 工作流。 检查工作流是否已结束且未出现错误。
-
工作流完成后,从 Administration > Channels > Mobile app (Adobe Experience Platform SDK) 菜单,检查移动设备应用程序在Adobe Campaign Standard中是否可用以及是否位于 Ready to Configure 省/州。
-
在 Administration > Channels > Mobile app (SDK V4) 中,选择要迁移的SDK V4应用程序。
-
选择 Mobile application migration to AEP SDK 选项卡。
-
从 Select AEP SDK mobile application to merge current application with 从下拉列表中,选择之前创建的Adobe Experience Platform SDK移动应用程序。
-
单击 Migrate。
-
从 Migration application 窗口,单击 Ok.
-
成功完成窗口出现,单击 Go to Adobe Experience Platform SDK Channel list.
-
从Adobe Experience Platform SDK渠道列表页面,检查是否将之前的V4移动应用程序设置为 Ready To Configure.
-
选择您的移动应用程序,然后单击 Save 以完成迁移。
在此迁移后,由移动应用程序的V4版本收集的订阅者和由移动应用程序的AEP版本收集的新订阅者将在迁移的应用程序中可用。
要区分这两种不同类型的订阅者,您可以添加新的自定义字段 Text 扩展自定义资源时键入 Subscriptions to an application (appSubscriptionRcp) 作为 sdkversion
或 appVersion
例如。 有关如何扩展自定义资源的更多信息,请参阅此 页面.
然后,您需要配置关联的标记 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 Configure 和 Mobile 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 下拉菜单。