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

Last update: Tue Mar 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Push

作成対象：

Experienced
Admin

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

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

中断のないサービスを確保するには、Adobe Campaignに登録されているモバイルアプリケーションをアップグレードして、FCM(Android) と APNs(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 で実装を更新する必要があります。で Experience Platform SDK にAdobeする方法を説明します。この記事.
次の項目を確認します。 モバイルアプリ設定 以下の手順を実行する前に、Adobe Experience Platform Data Collection Mobile の権限を設定してください。詳細情報.

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

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

参照先 Administration > Channels > Mobile app (AEP SDK).
証明書の更新を必要とする特定のモバイルアプリケーションを選択します。
次を確認します。 Update app credentials チェックボックス。
Android プロジェクトの build.gradle ファイル。例： com.android.test.testApp. ステージング環境と実稼動環境では異なる ID を必ず使用してください。
Android 秘密鍵 JSON キーファイルをアップロードします。
「保存」ボタンをクリックします。

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 モバイルアプリケーションをトークンベースの認証モードに移行するには、次の手順に従います。

参照先 Administration > Channels > Mobile app (AEP SDK).
証明書の更新を必要とする特定のモバイルアプリケーションを選択します。
次を確認します。 Update app credentials チェックボックス。
次を提供： アプリ ID (iOSバンドル ID)。 Xcode で、iOSバンドル ID（アプリ ID）をアプリのプライマリターゲットで検索できます。
次をアップロード： iOS p8 証明書ファイル.
APNs 接続設定を入力します Key Id および iOS Team Id.
「Save」をクリックします。

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

よくある質問 push-upgrade-faq

ステージング<>実稼働インスタンスに同じ appID を保持できますか？

iOSモバイルアプリケーションの場合、ステージング環境と実稼動環境の両方で、同じアプリ ID(iOSアプリバンドル ID) を使用できます。ただし、Android では、アプリ ID は環境ごとに一意である必要があります。したがって、ステージング環境で作成したアプリ ID に「stage」を追加することをお勧めします

Android アプリのみを移行できますか？

いいえ。Android アプリとiOSアプリの両方を、上記の手順に従って移行する必要があります。

移行後に実行する必要がある検証の種類

すべてのプッシュ関連の使用例に対して機能検証を実行することをお勧めします。

モバイルアプリの保存中に「認証されていません」というエラーが発生した場合は、どうすればよいですか？

これは、Adobe Experience Platform Data Collection に関連する権限の問題のようです。これを解決するには、この記事の前提条件の節で説明されているように、Adobe Admin Consoleに「モバイル」および「モバイルアプリ設定」権限を追加する必要があります。

変更がモバイルアプリコードに必要ですか？

いいえ。必要なのは、Firebase とアプリ開発者アカウントの設定関連の変更のみです。顧客モバイルアプリの変更は必要ありません。

毎年iOS証明書を更新する必要がありますか？

いいえ、この移行後は、毎年iOS証明書を更新する必要はありません。

この移行が行われていない場合はどうなりますか？

Googleからの通知に従って、2024 年 6 月 20 日以降、Android のプッシュメッセージは失敗します。詳細情報。

FCMv1 の移行を完了した後、お客様は FCM に戻すことができますか？

はい、2024 年 6 月 20 日までに FCM に移行できます。この日以降、移行オプションは使用できなくなります。

HTTP v1 API の移行は、SDK V4 モバイルアプリでサポートされていますか？

いいえ。まずモバイルアプリを V5 SDK に移行し、次に上記の移行を進める必要があります。 Googleからの通知に従って、2024 年 6 月からプッシュサービスが失敗し始めるので、優先しておこなう必要があります。

ステージインスタンスでの変更は、実稼動インスタンスに影響を与えますか？

いいえ。ステージングモバイルアプリでの変更が実稼動インスタンスに及ぼす影響はありません。

recommendation-more-help

3ef63344-7f3d-48f9-85ed-02bf569c4fff