如何将移动应用程序从 SDK v4 迁移到 Adobe Experience Platform SDK sdkv4-migration
截至2021年8月31日,已终止对Adobe Experience Platform Mobile版本4 SDK的支持。 如果您仍在使用此旧版SDK,则必须在2024年6月底之前使用Adobe Experience Platform SDK 更新您的实施。 请参阅本文以了解如何迁移到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
在迁移之前,您应该考虑以下建议:
- 迁移过程不可逆。
- 您不应同时运行多个应用程序的迁移。 您还应确保同一应用程序的迁移不会同时由多个窗口触发。
- 在迁移之前,请确保为您分配了要迁移的移动应用程序以及用于迁移的Adobe Experience Platform应用程序的 Organizational unit。
- 迁移后,该应用程序将变为Adobe Experience Platform SDK应用程序。 其更改将链接到其相应的标记 Mobile Property。
-
在数据收集UI中创建新的 Mobile property。 有关此内容的更多信息,请参阅文档。
-
在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版本收集的新订阅者将在迁移的应用程序中可用。
为了区分这两种不同类型的订阅者,例如,在扩展自定义资源 Subscriptions to an application (appSubscriptionRcp) 时可以添加 Text 类型的新自定义字段,例如sdkversion
或appVersion
。 有关如何扩展自定义资源的更多信息,请参阅此页面。
然后,您需要配置关联的标记 Mobile property 以在“收集PII”调用中发送此自定义字段值,并相应地更改您的移动应用程序配置。
常见问题解答 faq
问:在SDK v4移动应用程序中,“将移动应用程序迁移到Adobe Experience Platform SDK”选项卡不可见。 tab-not-visible
答:从高级菜单 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应用程序。 Adobe Experience Platform应用程序的 Property Status 应设置为 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应用程序中的订阅者和其他数据将丢失。 为避免任何数据丢失,只有具有 Ready to Configure Property Status 的Adobe Experience Platform SDK应用程序才有资格迁移。
问:迁移后,我可以在何处找到以前的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 ALL的管理员将有权管理这两个移动设备应用程序,并将负责迁移。
问:如果SDK v4移动应用程序组织单位设置为A,Adobe Experience Platform SDK应用程序设置为B(组织单位A的同级)。 如何迁移移动应用程序? aep-org-unit
答:Adobe Experience Platform SDK应用程序是同级 Organizational unit 的资源,因此移动应用程序对 Organizational unit A的用户不可见。Organizational unit ALL的管理员可以使用移动应用程序,但我们不建议这些管理员迁移移动应用程序。
在这种情况下,您应将移动应用程序移到同一 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 下拉菜单下正确存储和显示。