Android の設定手順

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

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

1. Android 外部アカウントを設定する
2. Android サービスを設定する
3. Campaign でモバイルアプリを作成する
4. 追加データでアプリスキーマを拡張する

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

Android 外部アカウントの設定

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

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

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

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

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

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

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

   メモ

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

   

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

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

Android サービスの設定

Android サービスの設定方法をビデオで説明します

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

   

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

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

   メモ

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

   

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

   

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

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

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

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

   

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

   

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

   メモ

   統合キー​は、文字列値を使用して完全にカスタマイズできますが、SDK で指定されたものと完全に同じにする必要があります。

4. API バージョン​として HTTP v1 または HTTP （レガシー）を選択します。 これらの設定について詳しくは、こちらの節を参照してください。

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

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

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

API バージョンの選択

サービスと新しいモバイルアプリケーションを作成したら、選択した API バージョンに応じてモバイルアプリケーションを設定する必要があります。

• HTTP v1 の設定について詳しくは、この節を参照してください。
• HTTP（レガシー）​の設定について詳しくは、この節を参照してください。

HTTP v1 API の設定

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

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

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

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

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

   

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

   注意

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

   

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

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

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

HTTP（レガシー）API の設定

HTTP（レガシー）API バージョンを設定するには、次の手順に従います。

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

2. モバイルアプリケーションの開発者が提供した​プロジェクトキー​を入力します。

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

   次の例では、title、imageURL および iconURL を追加し、リッチなプッシュ通知を作成してさらに通知内に表示する画像、タイトル、アイコンをアプリケーションに提供します。

   

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

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

appsubscriptionRcp スキーマの拡張

appsubscriptionRcp スキーマの拡張方法をビデオで説明します

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

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

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

   注意

   「購読パラメーター」タブの設定名が、モバイルアプリケーションコードの設定名と同じであることを確認します。この節を参照してください。

Business.Adobe.com リソース