Android の設定手順

パッケージがインストールされたら、Adobe Campaign Classic で Android アプリの設定を定義できます。

主な手順は次のとおりです。

これで、Android リッチ通知を作成できるようになります。

IMPORTANT
Android Firebase Cloud Messaging(FCM)サービスに対するいくつかの重要な変更は、2024 年にリリースする予定であり、Adobe Campaign の実装に影響を与える場合があります。この変更をサポートするには、Android プッシュメッセージの購読サービス設定を更新する必要がある場合があります。今すぐ確認し、実行できます。詳しくは、こちらの Adobe Campaign v8 テクニカルノートを参照してください。

Android 外部アカウントの設定 configuring-external-account-android

Android の場合、2 種類のコネクタを使用できます。

  • V1 コネクタでは、MTA の子 1 つにつき 1 つのコネクタを使用できます。
  • V2 コネクタでは、スループット向上のために FCM サーバーへの同時接続が可能です。

使用するコネクタを選択するには、次の手順に従います。

  1. 管理/プラットフォーム/外部アカウント ​に移動します。

  2. Android ルーティング ​外部アカウントを選択します。

  3. コネクタ」タブで、「コネクタで使用された JavaScript」フィールドに次のように入力します。

    Android V2 の場合:https://localhost:8080/nms/jsp/androidPushConnectorV2.js

    note note
    NOTE
    または、https://localhost:8080/nms/jsp/androidPushConnector.js に設定することもできますが、コネクタのバージョン 2 を使用することをお勧めします。

  4. Android V2 では、アドビサーバー設定ファイル(serverConf.xml)で次の追加パラメーターを使用できます。

    • maxGCMConnectPerChild:それぞれの子サーバーで開始できる、FCM に対する並列 HTTP リクエストの最大数(デフォルト値は 8)。

Android サービスの設定 configuring-android-service

詳しくは、Android サービスの設定方法(ビデオ)をご覧ください

  1. プロファイルとターゲット/サービスと購読 ​ノードに移動して、「新規」をクリックします。

  2. ラベル」と「内部名」を定義します。

  3. タイプ」フィールドに移動して「モバイルアプリケーション」を選択します。

    note note
    NOTE
    デフォルトの「購読者のアプリケーション(nms:appSubscriptionRcp)」ターゲットマッピングが受信者のテーブルにリンクされています。異なるターゲットマッピングを使用する場合は、新しいターゲットマッピングを作成し、サービスの「ターゲットマッピング」フィールドに入力する必要があります。ターゲットマッピングの作成について詳しくは、この節を参照してください。

  4. 次に、「追加」ボタンをクリックして、アプリケーションタイプを選択します。

  5. Android アプリケーションを作成します。詳しくは、この節を参照してください。

Android モバイルアプリケーションの作成 creating-android-app

サービスの作成後に、Android アプリケーションを作成する必要があります。

  1. 新しく作成したサービスで、「追加」ボタンをクリックしてアプリケーションタイプを選択します。

  2. Android アプリケーションを作成」を選択し、ラベル ​を入力します。

  3. Adobe Campaign と、SDK を使用するアプリケーションコードで同じ​ 統合キー ​が定義されていることを確認します。詳しくは、この節を参照してください。

    note note
    NOTE
    統合キー ​は、文字列値を使用して完全にカスタマイズできますが、SDK で指定されたものと完全に同じにする必要があります。
  4. API バージョン ​として HTTP v1 または HTTP (レガシー)を選択します。 これらの設定について詳しくは、こちらの節を参照してください。

  5. Firebase Cloud Messaging for Android の接続設定 ​フィールドに入力します。

  6. 完了」、「保存」の順にクリックします。これで、Campaign Classic で Android アプリケーションを使用する準備が整いました。

デフォルトでは、Adobe Campaign は​ 購読者のアプリケーション(nms:appSubscriptionRcp) ​テーブルの「ユーザー ID」(@userKey)フィールドにキーを保存します。このキーによって購読情報を受信者にリンクできます。追加データ(複雑な紐付けキーなど)を収集するには、次の設定を適用する必要があります。

API バージョンの設定 select-api-version

IMPORTANT
Android Firebase Cloud Messaging(FCM)サービスに対するいくつかの重要な変更は、2024 年にリリースする予定であり、Adobe Campaign の実装に影響を与える場合があります。Google のサービス向上への継続的な取り組みの一環として、レガシー FCM API は 2024 年 6 月 20 日(PT) ​に廃止されます。詳しくは、こちらの Adobe Campaign v8 テクニカルノートを参照してください。

サービスと新しいモバイルアプリケーションを作成したら、モバイルアプリケーションを設定する必要があります。HTTP(レガシー) API は Google によって非推奨(廃止予定)になっているので、選択しないでください。

HTTP v1 API バージョンを設定するには、次の手順に従います。

  1. モバイルアプリケーション作成ウィザード ​ウィンドウの「API バージョン」ドロップダウンで「HTTPV1」を選択します。

  2. プロジェクトの詳細を抽出するプロジェクトの json ファイルを読み込む…」をクリックして、JSON キーファイルを直接読み込みます。JSON ファイルの抽出方法について詳しくは、このページを参照してください。

    次の詳細を手動で入力することもできます。

    • プロジェクト ID
    • 秘密鍵
    • クライアントメール

  3. 接続をテスト」をクリックして、設定が正しいこと、およびマーケティングサーバーが FCM にアクセスできることを確認します。

    note caution
    CAUTION
    ミッドソーシングデプロイメントの場合、「接続をテスト」ボタンは、MID サーバーが FCM サーバーにアクセスできるかどうかを確認しません。

  4. オプションとして、必要に応じ、アプリケーション変数 ​を使用してプッシュメッセージのコンテンツを強化できます。これらは完全にカスタマイズ可能で、モバイルデバイスに送信されるメッセージペイロードの一部です。

  5. 終了」、「保存」の順にクリックします。これで、Campaign Classic で Android アプリケーションを使用する準備が整いました。

以下に、プッシュ通知をさらにパーソナライズするための FCM ペイロード名を示します。

メッセージタイプ
設定可能なメッセージ要素(FCM ペイロード名)
設定可能なオプション(FCM ペイロード名)
データメッセージ
該当なし
validate_only
通知メッセージ
title、body、android_channel_id、icon、sound、tag、color、click_action、image、ticker、sticky、visibility、notification_priority、notification_count
validate_only

appsubscriptionRcp スキーマの拡張 extend-subscription-schema

詳しくは、appsubscriptionRcp スキーマの拡張方法(ビデオ)をご覧ください

appsubscriptionRcp を拡張して、アプリのパラメーターを Campaign データベースに保存するための新しい追加フィールドを定義する必要があります。これらのフィールドは、例えば、パーソナライゼーションに使用されます。手順は次のとおりです。

  1. 購読者のアプリケーション(nms:appsubscriptionRcp)」スキーマの拡張を作成し、新しいフィールドを定義します。スキーマ拡張について詳しくは、こちらのページを参照してください。

  2. 購読パラメーター」タブでマッピングを定義します。

    note caution
    CAUTION
    購読パラメーター」タブの設定名が、モバイルアプリケーションコードの設定名と同じであることを確認します。この節を参照してください。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1