SDK v4 からAdobe Experience Platform SDK にモバイルアプリケーションを移行する方法 sdkv4-migration
Adobe Experience Platform Mobile version 4 SDK のサポートは 2021 年 8 月 31 日(PT)をもって終了しました。 引き続きこのレガシーバージョンの SDK を使用する場合は、2024 年 6 月末までに、Adobe Experience Platform SDK で実装を更新する必要があります。 Adobe Experience Platform SDK に移行する方法については、この記事を参照してください。
SDK V4 の移行について
Adobe Campaign Standardは、Adobe Experience Platform SDK を使用するアプリケーションとは別のアプリケーションとして、SDK V4 を使用するモバイルアプリケーションを処理します。
Adobe SDK バージョンを 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 バージョンで収集された新しいサブスクライバーは、移行されたアプリケーションで使用できます。
2 つの異なるタイプのサブスクライバーを区別するには、カスタムリソースフィールドを拡張する際に、Text タイプの新しいカスタムフ Subscriptions to an application (appSubscriptionRcp) ールドを、例えば sdkversion
や appVersion
のように追加できます。 カスタムリソースの拡張方法について詳しくは、この ページを参照してください。
次に、関連するタグ 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: 「モバイルアプリケーションの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 に設定する必要があります。
Q:設定済みプロパティのステータスを持つ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 アプリケーションのみが移行の対象となります。
Q:移行後、以前の SDK v4 モバイルアプリケーションはどこにありますか? v4-app-not-visible
回答:移行後のモバイルアプリケーションが、詳細メニュー Administration/Channels/Mobile app (Adobe Experience Platform SDK) に表示されます。
Q:移行後、新しく作成したAdobe Experience Platform SDK アプリケーションはどこで見つけられますか? aep-not-visible
回答:移行に使用される、新しく作成されたAdobe Experience Platform SDK アプリケーションは、個別のアプリケーションとしては存在しません。 移行された SDK v4 アプリケーションのみ使用できます。
Q:SDK v4 モバイルアプリケーションの組織単位が A (組織単位 ALL の子)に設定されていて、Adobe Experience Platform SDK が ALL に設定されている場合。 モバイルアプリケーションを移行するにはどうすればよいですか? v4-org-unit
A:Organizational unit の管理者は、モバイルアプリケーションの両方を管理する権限を持ち、移行を担当します。
Q: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 ドロップダウンに正しく表示されます。