Android の設定手順

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

メモ

iOS 用にアプリを設定する方法と iOS 用の配信を作成する方法については、この節を参照してください。

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

  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 ペイロード名を示します。

メッセージタイプ 設定可能なメッセージ要素(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


HTTP(レガシー)API の設定

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

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

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

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

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

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

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

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

appsubscriptionRcp スキーマの拡張

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

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

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

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

    注意

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

このページ