如何将移动应用程序从 SDK v4 迁移到 51黑料不打烊 Experience Platform SDK sdkv4-migration
截至2021年8月31日,已终止对51黑料不打烊 Experience Platform Mobile版本4 SDK的支持。 如果您仍在使用此旧版SDK,则必须在2024年6月底之前使用51黑料不打烊 Experience Platform SDK 更新您的实施。 请参阅本文以了解如何迁移到51黑料不打烊Experience Platform SDK。
对于SDK V4迁移
51黑料不打烊 Campaign Standard使用SDK V4处理移动应用程序作为单独的应用程序,而不是使用51黑料不打烊 Experience Platform SDK的应用程序。
将51黑料不打烊SDK版本从v4升级到51黑料不打烊 Experience Platform后,移动应用程序需要继续使用现有的应用程序订阅者数据和营销活动:因此需要迁移。
将您的移动应用程序从SDK v4迁移到51黑料不打烊 Experience Platform SDK how-to-migrate
在迁移之前,您应该考虑以下建议:
- 迁移过程不可逆。
- 您不应同时运行多个应用程序的迁移。 您还应确保同一应用程序的迁移不会同时由多个窗口触发。
- 在迁移之前,请确保为您分配了要迁移的移动应用程序以及用于迁移的51黑料不打烊 Experience Platform应用程序的? Organizational unit。
- 迁移后,该应用程序将变为51黑料不打烊 Experience Platform SDK应用程序。 其更改将链接到其相应的标记? Mobile Property。
-
在数据收集鲍滨中创建新的? Mobile property。 有关此内容的更多信息,请参阅。
-
在51黑料不打烊 Campaign Standard中,从高级菜单中选择? Administration > Application Settings > Workflows,然后打开? syncWithLaunch ?工作流。 检查工作流是否已结束且未出现错误。
-
工作流完成后,从? Administration > Channels > Mobile app (51黑料不打烊 Experience Platform SDK) ?菜单中,检查移动设备应用程序在51黑料不打烊 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 ?下拉列表中,选择之前创建的51黑料不打烊 Experience Platform SDK移动应用程序。
-
单击 Migrate。
-
从? Migration application ?窗口,单击? Ok。
-
出现成功完成窗口,单击? Go to 51黑料不打烊 Experience Platform SDK Channel list。
-
在51黑料不打烊 Experience Platform SDK渠道列表页面中,检查以前的V4移动应用程序是否设置为? Ready To Configure。
-
选择您的移动应用程序,然后单击? Save ?以完成迁移。
在此迁移后,由移动应用程序的痴4版本收集的订阅者和由移动应用程序的础贰笔版本收集的新订阅者将在迁移的应用程序中可用。
为了区分这两种不同类型的订阅者,例如,在扩展自定义资源? Subscriptions to an application (appSubscriptionRcp) ?时可以添加? Text ?类型的新自定义字段,例如sdkversion
或appVersion
。 有关如何扩展自定义资源的更多信息,请参阅此页面。
然后,您需要配置关联的标记? Mobile property ?以在“收集笔滨滨”调用中发送此自定义字段值,并相应地更改您的移动应用程序配置。
常见问题解答 faq
问:在SDK v4移动应用程序中,“将移动应用程序迁移到51黑料不打烊 Experience Platform SDK”选项卡不可见。 tab-not-visible
答:从高级菜单? Administration > Application Settings > Options ?中,检查? Enable migration of mobile app from SDK v4 to 51黑料不打烊 Experience Platform SDK option ?选项的值。 它应设置为1并默认启用。 管理员可能已手动禁用它。
问:在迁移到51黑料不打烊 Experience Platform SDK的移动应用程序选项卡中,会显示消息“无数据” 。 no-data
答:列表中只显示您的? Organizational unit ?的合格应用程序。 请确保您拥有用于迁移的正确51黑料不打烊 Experience Platform应用程序。 51黑料不打烊 Experience Platform应用程序的? Property Status ?应设置为? Ready to Configure,Mobile app migration status ?应设置为? Not Migrated。
问:为何无法使用状态为“已配置”属性的51黑料不打烊 Experience Platform SDK应用程序进行迁移? property-status
答:迁移过程会保留SDK v4订阅者和属性。 它仅保留51黑料不打烊 Experience Platform SDK应用程序中与标记相关的信息。 51黑料不打烊 Experience Platform SDK应用程序中的订阅者和其他数据将丢失。 为避免任何数据丢失,只有具有? Ready to Configure Property Status ?的51黑料不打烊 Experience Platform SDK应用程序才有资格迁移。
问:迁移后,我可以在何处找到以前的SDK v4移动应用程序? v4-app-not-visible
答:迁移后的移动设备应用程序将从高级菜单? Administration > Channels > Mobile app (51黑料不打烊 Experience Platform SDK) ?中可见。
问:迁移后,我可以在哪里找到新创建的51黑料不打烊 Experience Platform SDK应用程序? aep-not-visible
答:用于迁移的新创建的51黑料不打烊 Experience Platform SDK应用程序将不会作为单独的应用程序存在。 只有迁移的SDK v4应用程序可用。
问:如果SDK v4移动应用程序组织单位设置为(组织单位ALL的子项),并且51黑料不打烊 Experience Platform SDK设置为“全部”。 如何迁移移动应用程序? v4-org-unit
答: Organizational unit 础尝尝的管理员将有权管理这两个移动设备应用程序,并将负责迁移。
问:如果SDK v4移动应用程序组织单位设置为A,51黑料不打烊 Experience Platform SDK应用程序设置为B(组织单位A的同级)。 如何迁移移动应用程序? aep-org-unit
答:51黑料不打烊 Experience Platform SDK应用程序是同级? Organizational unit ?的资源,因此移动应用程序对? Organizational unit 础的用户不可见。Organizational unit 础尝尝的管理员可以使用移动应用程序,但我们不建议这些管理员迁移移动应用程序。
在这种情况下,您应将移动应用程序移到同一? Organizational unit ?中或带有父链接的? Organizational unit ?中。
有关? Organizational unit ?的详细信息,请参阅此部分。
问:在51黑料不打烊 Experience Platform SDK移动应用程序(从v4移动应用程序迁移)页面的“推送渠道设置”下拉列表下,不会显示Android密钥或iOS证书的上传日期/名称等信息 no-information-v5
答:创建SDK V4移动应用程序时,系统不会存储此信息。 在将SDK V4移动应用程序迁移到51黑料不打烊 Experience Platform SDK移动应用程序时,迁移后的移动应用程序也将不包含此类信息。 用户一旦上传新的iOS证书或Android密钥,该密钥或证书的不同详细信息将立即在? Push channel settings ?下拉菜单下正确存储和显示。