如何将移动应用程序从 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。

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应用程序的过程。 您的SDK v4移动应用程序将不会与具有​ Configured Property status ​的Adobe Experience Platform SDK移动应用程序合并。
迁移后不会更改的内容
使用迁移的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 ​将继续工作,发送的数据不会丢失。
应用程序将绑定到标记​ Mobile Property。 它将作为新创建的移动应用程序处理。
迁移中使用的原始Adobe Experience Platform SDK应用程序将不会作为单独的应用程序存在。 只有迁移的SDK v4应用程序可用。

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

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

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

  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版本收集的新订阅者将在迁移的应用程序中可用。

为了区分这两种不同类型的订阅者,例如,在扩展自定义资源​ Subscriptions to an application (appSubscriptionRcp) ​时可以添加​ Text ​类型的新自定义字段,例如sdkversionappVersion。 有关如何扩展自定义资源的更多信息,请参阅此页面
然后,您需要配置关联的标记​ 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 ConfigureMobile 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 ​下拉菜单下正确存储和显示。

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