SDK v4 からAdobe Experience Platform SDK にモバイルアプリケーションを移行する方法 sdkv4-migration
Adobe Experience Platform Mobile バージョン 4 SDKのサポートは、2021年8月31日(PT)をもって終了しました。 このレガシーバージョンのSDKをまだ使用している場合は、2024年6月末 までにAdobe Experience Platform SDK で実装を更新する必要があります。 Adobe Experience Platform SDKへの移行方法については、この記事を参照してください。
SDK V4への移行について
Adobe Campaign Standardは、SDK V4を使用したモバイルアプリケーションを、Adobe Experience Platform SDKを使用したアプリケーションとは別のアプリケーションとして処理します。
Adobe SDK バージョンをv4からAdobe Experience Platformにアップグレードした後、モバイルアプリケーションでは、既存のアプリケーションのサブスクライバーデータとキャンペーンを引き続き使用する必要があります。したがって、移行が必要になります。
モバイルアプリケーションをSDK v4からAdobe Experience Platform SDKに移行する how-to-migrate
移行する前に、次の推奨事項を考慮する必要があります。
- 移行プロセスは元に戻せません。
- 複数のアプリケーションの移行を同時に実行しないでください。 また、同じアプリケーションの移行が同時に複数のウィンドウによってトリガーされないようにする必要があります。
- 移行前に、移行するモバイルアプリケーションの Organizational unit と、移行用に使用しているAdobe Experience Platform アプリケーションのが割り当てられていることを確認してください。
- 移行後、アプリケーションは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 バージョンのモバイルアプリケーションによって収集された新しいサブスクライバーが、移行後のアプリケーションで利用できるようになります。
2つの異なるタイプのサブスクライバーを区別するには、カスタムリソース Subscriptions to an application (appSubscriptionRcp)をsdkversionまたはappVersionとして拡張する場合に、Text タイプの新しいカスタムフィールドを追加できます(例:)。 カスタムリソースの拡張方法について詳しくは、この ページ を参照してください。
次に、関連付けられたタグ Mobile propertyを設定して、PII呼び出しを収集してこのカスタムフィールド値を送信し、それに応じてモバイルアプリケーション設定を変更する必要があります。
FAQ faq
Q: 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に設定し、デフォルトで有効にする必要があります。 管理者が手動で無効化した可能性があります。
Q: 「Mobile application migration to Adobe Experience Platform SDK」タブで、「No data」というメッセージが表示されます。 no-data
A: リストには、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
A:移行プロセスでは、SDK v4のサブスクライバーと属性が保持されます。 Adobe Experience Platform SDK アプリケーションのタグ関連情報のみが保持されます。 Adobe Experience Platform SDK アプリケーションのサブスクライバーおよびその他のデータは失われます。 データが失われるのを防ぐため、Ready to Configure Property Statusを持つAdobe Experience Platform SDK アプリケーションのみが移行の対象となります。
Q:移行後、以前のSDK v4 モバイルアプリケーションはどこで見つけることができますか? v4-app-not-visible
A:移行後のモバイルアプリケーションは、詳細メニューAdministration > Channels > Mobile app (Adobe Experience Platform SDK)から表示されます。
Q:移行後、新しく作成したAdobe Experience Platform SDK アプリケーションはどこで見つけることができますか? aep-not-visible
A:新しく作成されたAdobe Experience Platform SDK アプリケーションは、別のアプリケーションとして存在しません。 移行されたSDK v4 アプリケーションのみが使用できます。
Q: SDK v4 mobile application Organizational unitがA (Organizational unit ALLの子)に設定され、Adobe Experience Platform SDKがALLに設定されている場合。 モバイルアプリケーションを移行するにはどうすればよいですか? v4-org-unit
回答:Organizational unit ALLの管理者は、両方のモバイルアプリケーションを管理する権限を持ち、移行を担当します。
Q: SDK v4 mobile application Organizational unitがAに設定され、Adobe Experience Platform SDK applicationがB (Organizational unit Aの兄弟)に設定されている場合。 モバイルアプリケーションを移行するにはどうすればよいですか? aep-org-unit
A:兄弟 Organizational unit のアセットであるAdobe Experience Platform SDK アプリケーションは、Organizational unit Aのユーザーには表示されません。モバイルアプリケーションはOrganizational unit ALLの管理者が利用できますが、これらの管理者がモバイルアプリケーションを移行することはお勧めしません。
この場合、モバイルアプリケーションを同じ Organizational unit または親リンクを持つ Organizational unit に移動する必要があります。
Organizational unitの詳細については、この セクション を参照してください。
Q: Adobe Experience Platform SDK モバイルアプリケーション(v4 モバイルアプリケーションから移行)ページの「プッシュチャネル設定」ドロップダウンで、Android キーまたはiOS証明書にアップロードされた日付/名前などの情報が表示されません no-information-v5
A: SDK V4 モバイルアプリケーションの作成時に、この情報は保存されません。 SDK V4 モバイルアプリケーションをAdobe Experience Platform SDK モバイルアプリケーションに移行する場合、移行したモバイルアプリケーションにもこのような情報は含まれません。 ユーザーが新しいiOS証明書またはAndroid キーをアップロードするとすぐに、キーまたは証明書の異なる詳細が保存され、Push channel settings ドロップダウンの下に正しく表示されます。