プッシュ通知チャネルの変更 push-upgrade

Campaign を使用すると、AndroidとiOSのデバイスでプッシュ通知を送信できます。 これを実行するには、Campaign を特定の購読サービスに依存させます。2024 年に Android Firebase Cloud Messaging(FCM)サービスに対するいくつかの重要な変更をリリースします。このリリースは、Adobe Campaign の実装に影響を与える場合があります。この変更をサポートするには、Android プッシュメッセージの購読サービス設定を更新する必要がある場合があります。

さらに、アドビでは、証明書ベースの接続ではなく、より安全で拡張性の高いトークンベースの APN への接続に移行することを強くお勧めします。

サービスが中断されないようにするには、Adobe Campaignに登録されているモバイルアプリケーションをアップグレードして、FCM (Android)および APN (iOS)の最新の認証メカニズムを組み込む必要があります。

Adobe Campaign Standardでモバイルアプリケーション証明書を設定する方法について詳しく説明します

Google Android Firebase Cloud Messaging(FCM)サービス fcm-push-upgrade

変更点 fcm-changes

Google のサービス向上への継続的な取り組みの一環として、レガシー FCM API は 2024年6月20日(PT) ​に廃止されます。Firebase Cloud Messaging HTTP プロトコルについて詳しくは、Google Firebase ドキュメントを参照してください。

24.1 リリース以降、Adobe Campaign Standardでは、Android プッシュ通知メッセージを送信する HTTP v1 API をサポートしています。

影響の有無 fcm-impact

既にAdobe Campaign Standardを使用してプッシュ通知を送信している場合は、を更新する必要があります。

サービスの中断を避けるには、最新の API への移行が必須となります。

更新方法 fcm-transition-procedure

前提条件 fcm-transition-prerequisites

  • HTTP v1 API モードのサポートが 24.1 リリースで追加されました。 環境が古いバージョンで実行されている場合、この変更の前提条件は、環境を 最新のCampaign Standardリリースにアップグレードすることです。

  • モバイルアプリケーションを HTTP v1 に移行するには、Android Firebase Admin SDK サービスのアカウント JSON ファイルが必要です。このファイルを取得する方法について詳しくは、Google Firebase ドキュメントを参照してください。

  • このレガシーバージョンの SDK をまだ使用している場合は、Adobe Experience Platform SDK を使用して実装を更新する必要があります。 Adobe Experience Plaform SDK に移行する方法については、 この記事を参照してください。

  • 次の手順を実行する前に、Adobe Experience Platform Data Collection Mobile に モバイルアプリ設定 権限があることを確認してください。 詳細情報

トランジション手順 fcm-transition-steps

環境を HTTP v1 に移行するには、次の手順に従います。

  1. Administration/Channels/Mobile app (AEP SDK) を参照します。

  2. 証明書の更新を必要とする特定のモバイルアプリケーションを選択します。

  3. Update app credentials」チェックボックスをオンにします。

  4. Android プロジェクトの build.gradle ファイルからアプリ ID (Android パッケージ名)を指定します。 例:com.android.test.testApp。 ステージング環境と実稼動環境では必ず異なる ID を使用してください。

  5. Android秘密鍵の JSON キーファイルをアップロードします。

  6. 保存」ボタンをクリックします。

NOTE
これらの変更が適用されると、Android デバイスへの新しいプッシュ通知配信はすべて HTTP v1 API を使用します。 再試行中、処理中、使用中の既存のプッシュ配信では、HTTP(レガシー)API を引き続き使用します。

Apple iOS プッシュ通知サービス(APNs) apns-push-upgrade

変更点 ios-changes

Apple の推奨に従って、ステートレス認証トークンを使用して Apple プッシュ通知サービス(APNs)との通信を保護する必要があります。

トークンベースの認証では、APNs と通信するためのステートレスな方法を提供します。ステートレス通信は、APNs が証明書やプロバイダーサーバーに関連するその他の情報を検索する必要がないので、証明書ベースの通信より高速です。トークンベースの認証を使用することには他にも次のようなメリットがあります。

  • 複数のプロバイダーサーバーから同じトークンを使用できます。

  • 1 つのトークンを使用して、会社のすべてのアプリに関する通知を配布できます。

APNs へのトークンベースの接続について詳しくは、Apple 開発者向けドキュメントを参照してください。

Adobe Campaign Standardは、トークンベースの接続と証明書ベースの接続の両方をサポートしています。 実装が証明書ベースの接続に依存している場合、アドビではトークンベースの接続に更新することを強くお勧めします。

影響の有無 ios-impact

現在の実装が APNs への接続に証明書ベースのリクエストに依存している場合、影響を受けます。トークンベースの接続へのトランジションをお勧めします。

更新方法 ios-transition-procedure

前提条件 ios-transition-prerequisites

  • トークンベースの認証 モードのサポートが、24.1 リリースで追加されました。 環境が古いバージョンで実行されている場合、この変更の前提条件は、環境を 最新のCampaign Standardリリースにアップグレードすることです。

  • サーバーが使用するトークンを生成するには、APNs 認証トークン署名キーが必要です。Apple 開発者向けドキュメントで説明するように、Apple 開発者アカウントからこのキーをリクエストします。

トランジション手順 ios-transition-steps

iOS モバイルアプリケーションをトークンベースの認証モードに移行するには、次の手順に従います。

  1. Administration/Channels/Mobile app (AEP SDK) を参照します。

  2. 証明書の更新を必要とする特定のモバイルアプリケーションを選択します。

  3. Update app credentials」チェックボックスをオンにします。

  4. アプリ ID (iOS バンドル ID)を指定します。 iOS バンドル ID (アプリ ID)は、Xcode のアプリのメインターゲットにあります。

  5. iOS p8 証明書ファイル をアップロードします。

  6. APN 接続設定 Key IdiOS Team Id を入力します。

  7. Save」をクリックします。

これで、iOS アプリケーションがトークンベースの認証モードに移行しました。

よくある質問 push-upgrade-faq

ステージと実稼動インスタンスに同じ appID を保持できますか?
iOS モバイルアプリケーションの場合、同じアプリ ID (iOS アプリバンドル ID)をステージング環境と実稼動環境の両方に使用できます。 ただし、Androidでは、アプリ ID は環境ごとに一意である必要があります。 そのため、ステージング環境で作成したアプリ ID に「ステージ」を追加することをお勧めします
Android アプリケーションのみを移行できますか?
いいえ。上記の手順に従って、AndroidとiOSの両方のアプリを移行する必要があります。
移行後にどのような検証を行う必要がありますか?
プッシュ関連のすべてのユースケースに対して機能検証を実施することをお勧めします。
モバイルアプリの保存中に「認証されていません」エラーが発生した場合は、どうすればよいですか?
これは、Adobe Experience Platform Data Collection に関連する権限の問題のようです。 これを解決するには、この記事の前提条件の節で説明しているように、Adobe Admin Consoleで「モバイル」および「モバイルアプリ設定」権限を追加する必要があります。
モバイルアプリコードでは変更が必要ですか?
いいえ、Firebase とアプリ開発者アカウントの設定関連の変更のみが必要です。 顧客モバイルアプリの変更は必須ではありません。
iOS証明書を毎年更新する必要がありますか?
いいえ。この移行の後は、iOS証明書を毎年更新する必要はありません。
この移行が行われない場合はどうなりますか?
Androidのプッシュメッセージは、Googleからの通知に従って、2024 年 6 月 20 日(PT)以降に失敗し始めます。 詳細情報
FCMv1 の移行が完了した後で、お客様は FCM に戻すことはできますか?
はい、2024 年 6 月 20 日(PT)まで FCM に移行できます。 この期限を過ぎると、移行オプションは使用できなくなります。
HTTP v1 API 移行は SDK V4 モバイルアプリでサポートされていますか?
いいえ。お客様はまずモバイルアプリを V5 SDK に移行してから、上記の移行を進める必要があります。 Googleからの通知に従って、プッシュサービスが 2024 年 6 月から失敗し始めるため、これらのユーザーは優先事項としてこれを行う必要があります。
ステージインスタンスでの変更は、実稼動インスタンスに何らかの影響を与えますか?
いいえ。実稼動インスタンスにおけるステージモバイルアプリの変更の影響はありません。
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff