Android の設定手順
パッケージがインストールされたら、Adobe Campaign Classic で Android アプリの設定を定義できます。
主な手順は次のとおりです。
これで、Android リッチ通知を作成できるようになります。
Android 外部アカウントの設定 configuring-external-account-android
Android の場合、2 種類のコネクタを使用できます。
- V1 コネクタでは、MTA の子 1 つにつき 1 つのコネクタを使用できます。
- V2 コネクタでは、スループット向上のために FCM サーバーへの同時接続が可能です。
使用するコネクタを選択するには、次の手順に従います。
-
管理／プラットフォーム／外部アカウント に移動します。
-
Android ルーティング 外部アカウントを選択します。
-
「コネクタ」タブで、「コネクタで使用された JavaScript」フィールドに次のように入力します。
Android V2 の場合：https://localhost:8080/nms/jsp/androidPushConnectorV2.js
note note NOTE または、https://localhost:8080/nms/jsp/androidPushConnector.js に設定することもできますが、コネクタのバージョン 2 を使用することをお勧めします。 
-
Android V2 では、アドビサーバー設定ファイル（serverConf.xml）で次の追加パラメーターを使用できます。
- maxGCMConnectPerChild：それぞれの子サーバーで開始できる、FCM に対する並列 HTTP リクエストの最大数（デフォルト値は 8）。
Android サービスの設定 configuring-android-service
-
プロファイルとターゲット／サービスと購読 ノードに移動して、「新規」をクリックします。
-
「ラベル」と「内部名」を定義します。
-
「タイプ」フィールドに移動して「モバイルアプリケーション」を選択します。
note note NOTE デフォルトの「購読者のアプリケーション（nms:appSubscriptionRcp）」ターゲットマッピングが受信者のテーブルにリンクされています。異なるターゲットマッピングを使用する場合は、新しいターゲットマッピングを作成し、サービスの「ターゲットマッピング」フィールドに入力する必要があります。ターゲットマッピングの作成について詳しくは、この節を参照してください。 
-
次に、「追加」ボタンをクリックして、アプリケーションタイプを選択します。
-
Android アプリケーションを作成します。詳しくは、この節を参照してください。
Android モバイルアプリケーションの作成 creating-android-app
サービスの作成後に、Android アプリケーションを作成する必要があります。
-
新しく作成したサービスで、「追加」ボタンをクリックしてアプリケーションタイプを選択します。
-
「Android アプリケーションを作成」を選択し、ラベル を入力します。
-
Adobe Campaign と、アプリケーションコード（SDK 経由）で同じ 統合キー が定義されていることを確認します。
note note NOTE 統合キー は、文字列値を使用して完全にカスタマイズできますが、SDK で指定されたものと完全に同じにする必要があります。 -
API バージョン として HTTP v1 または HTTP （レガシー）を選択します。 これらの設定について詳しくは、こちらの節を参照してください。
-
Firebase Cloud Messaging for Android の接続設定 フィールドに入力します。
-
「完了」、「保存」の順にクリックします。これで、Campaign Classic で Android アプリケーションを使用する準備が整いました。
デフォルトでは、Adobe Campaign は 購読者のアプリケーション（nms:appSubscriptionRcp） テーブルの「ユーザー ID」（@userKey）フィールドにキーを保存します。このキーによって購読情報を受信者にリンクできます。追加データ（複雑な紐付けキーなど）を収集するには、次の設定を適用する必要があります。
API バージョンの設定 select-api-version
サービスと新しいモバイルアプリケーションを作成したら、モバイルアプリケーションを設定する必要があります。HTTP（レガシー） API は Google によって非推奨（廃止予定）になっているので、選択しないでください。
HTTP v1 API バージョンを設定するには、次の手順に従います。
-
モバイルアプリケーション作成ウィザード ウィンドウの「API バージョン」ドロップダウンで「HTTPV1」を選択します。
-
「プロジェクトの詳細を抽出するプロジェクトの json ファイルを読み込む…」をクリックして、JSON キーファイルを直接読み込みます。JSON ファイルの抽出方法について詳しくは、このページを参照してください。
次の詳細を手動で入力することもできます。
- プロジェクト ID
- 秘密鍵
- クライアントメール
-
「接続をテスト」をクリックして、設定が正しいこと、およびマーケティングサーバーが FCM にアクセスできることを確認します。
note caution CAUTION ミッドソーシングデプロイメントの場合、「接続をテスト」ボタンは、MID サーバーが FCM サーバーにアクセスできるかどうかを確認しません。 
-
オプションとして、必要に応じ、アプリケーション変数 を使用してプッシュメッセージのコンテンツを強化できます。これらは完全にカスタマイズ可能で、モバイルデバイスに送信されるメッセージペイロードの一部です。
-
「終了」、「保存」の順にクリックします。これで、Campaign Classic で Android アプリケーションを使用する準備が整いました。
以下に、プッシュ通知をさらにパーソナライズするための FCM ペイロード名を示します。
appsubscriptionRcp スキーマの拡張 extend-subscription-schema
appsubscriptionRcp を拡張して、アプリのパラメーターを Campaign データベースに保存するための新しい追加フィールドを定義する必要があります。これらのフィールドは、例えば、パーソナライゼーションに使用されます。手順は次のとおりです。
-
「購読者のアプリケーション（nms:appsubscriptionRcp）」スキーマの拡張を作成し、新しいフィールドを定義します。スキーマ拡張について詳しくは、こちらのページを参照してください。
-
「購読パラメーター」タブでマッピングを定義します。
note caution CAUTION 「購読パラメーター」タブの設定名が、モバイルアプリケーションコードの設定名と同じであることを確認します。