如何將您的行動應用程式從 SDK v4 移轉至 Adobe Experience Platform SDK

重要

遷移過程是不可逆的。

開始將SDK V4行動應用程式移轉至Adobe Experience PlatformSDK之前,請仔細閱讀檔案。

關於SDK V4移轉

Adobe Campaign Standard使用SDK V4處理行動應用程式,與使用Adobe Experience PlatformSDK的應用程式分開處理。
將AdobeSDK版本從v4升級至Adobe Experience Platform後,行動應用程式需要繼續使用現有的應用程式訂閱者資料和促銷活動:因此需要移轉。

注意

本頁記錄SDK v4行動應用程式移轉至新建立的Adobe Experience PlatformSDK應用程式。 您的SDK v4行動應用程式不會與具有​Configured Property status​的Adobe Experience PlatformSDK行動應用程式合併。

移轉後不會變更的項目
使用移轉的SDK V4應用程式,將不會對現有的傳送和促銷活動造成任何影響。
行動應用程式的名稱將維持不變。
iOS和Android的平台認證將會保留。
應用程式的所有訂閱者及其資料將會保留。
現有的SDK v4行動應用程式將繼續傳送資料(PII資料、訂閱者與Token資訊)至Adobe Campaign Standard。
行動應用程式的​Organizational unit​將維持不變。
移轉後會有哪些改變
行動應用程式將可在​Administration > Channels > Mobile app (Adobe Experience Platform SDK)​中使用。 在移轉之前,它可在​Administration > Channels > Mobile app (SDK V4)​中使用。
應用程式的​Collect PII Endpoint​將會變更。 舊版​Collect PII Endpoint​將繼續運作,傳送的資料不會遺失。
應用程式將系結至Adobe Experience Platform Launch Mobile Property。 它會處理為新建立的行動應用程式。
移轉中使用的原始Adobe Experience PlatformSDK應用程式將不會以個別應用程式的形式存在。 只有已移轉的SDK v4應用程式才可用。

將您的行動應用程式從SDK v4移轉至Adobe Experience PlatformSDK

在移轉之前,您應考量下列建議:

  • 遷移過程是不可逆的。
  • 您不應同時執行多個應用程式的移轉。 您也應確保同一應用程式的移轉不會同時由多個視窗觸發。
  • 在移轉之前,請確定您已獲得要移轉的行動應用程式的​Organizational unit,以及您要移轉的Adobe Experience Platform應用程式的。
  • 移轉後,應用程式將會變成Adobe Experience PlatformSDK應用程式。 其更改將連結至其相應的啟動​Mobile Property
  1. 在Adobe Experience Platform Launch建立新的​Mobile property。 有關詳細資訊,請參閱Adobe Experience Platform Launch文檔

  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 PlatformSDK行動應用程式。

  7. 按一下 Migrate

  8. 在​Migration application​窗口中,按一下​Ok

  9. 出現成功完成窗口,按一下​Go to Adobe Experience Platform SDK Channel list

  10. 從Adobe Experience PlatformSDK頻道清單頁面,檢查您先前的V4行動應用程式是否設為​Ready To Configure

  11. 選擇您的行動應用程式,然後按一下​Save​以完成移轉。

此移轉後,由V4版行動應用程式收集的訂閱者和由AEP版行動應用程式收集的新訂閱者,將可在移轉的應用程式中使用。

要區分兩種不同的訂閱者類型,例如,將自訂資源​Subscriptions to an application (appSubscriptionRcp)​擴展為sdkversionappVersion時,可以添加​Text​類型的新自訂欄位。 有關如何擴展自定義資源的詳細資訊,請參閱此
然後,您需要設定相關的啟動​Mobile property,以傳送Collect PII呼叫中的此自訂欄位值,並據以變更行動應用程式設定。

常見問答集

問:在SDK v4行動應用程式中,無法看到移動應用程式移轉至Adobe Experience PlatformSDK標籤。

答:從高級菜單​Administration > Application Settings > Options​中,檢查​Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option​選項的值。 它應設為1,並依預設啟用。 管理員可能已手動禁用它。

問:從「行動應用程式」移轉至「Adobe Experience PlatformSDK」索引標籤,訊息會顯示「無資料」。

答:清單中只會顯示您​Organizational unit​的合格應用程式。 請確定您有正確的Adobe Experience Platform應用程式進行移轉。 您的Adobe Experience Platform應用程式的​Property Status​應設定為​Ready to Configure , Mobile app migration status​應設定為​Not Migrated

問:為什麼不能使用具有「已設定屬性狀態」的Adobe Experience PlatformSDK應用程式進行移轉?

答:移轉程式會保留SDK v4訂閱者和屬性。 它只會保留Adobe Experience PlatformSDK應用程式的Launch相關資訊。 來自Adobe Experience PlatformSDK應用程式的訂閱者和其他資料將會遺失。 為避免資料遺失,只有​Ready to Configure Property Status​的Adobe Experience PlatformSDK應用程式才符合移轉的資格。

問:在移轉後,我可以在哪裡找到我先前的SDK v4行動應用程式?

答:移轉後的行動應用程式將可從進階功能表​Administration > Channels > Mobile app (Adobe Experience Platform SDK)​中看到。

問:在移轉後,我可以在哪裡找到我新建立的Adobe Experience PlatformSDK應用程式?

答:用於移轉的新建Adobe Experience PlatformSDK應用程式將不會以個別應用程式的形式存在。 只有已移轉的SDK v4應用程式才可用。

問:如果SDK v4行動應用程式組織單位設為A(組織單位ALL的子系),而Adobe Experience PlatformSDK則設為ALL。 如何移轉行動應用程式?

答:Organizational unit ALL的管理員將擁有管理行動應用程式的權限,並負責移轉。

問:如果SDK v4行動應用程式組織單位設為A,而Adobe Experience PlatformSDK應用程式則設為B(組織單位A的同級)。 如何移轉行動應用程式?

答:Adobe Experience PlatformSDK應用程式是同級​Organizational unit​的資產,而行動應用程式對​Organizational unit A的使用者將看不到。Organizational unit ALL的管理員可使用行動應用程式,但我們不建議這些管理員移轉行動應用程式。
在這種情況下,您應將行動應用程式移至相同的​Organizational unit​或具有父連結的​Organizational unit​中。
有關​Organizational unit​的更多資訊,請參閱部分

問:從您的Adobe Experience PlatformSDK行動應用程式(從v4行動應用程式移轉)頁面,在「推播頻道設定」下拉式清單下,不會顯示Android金鑰或iOS憑證的上傳日期/名稱等資訊

答:當建立SDK V4行動應用程式時,系統不會儲存此資訊。 將SDK V4行動應用程式移轉至Adobe Experience PlatformSDK行動應用程式時,您移轉的行動應用程式也不會有此類資訊。 當使用者上傳新的iOS憑證或Android金鑰時,就會儲存和正確顯示金鑰或憑證的不同詳細資訊至​Push channel settings​下拉式清單。

本頁內容