プッシュ通知チャネルを設定 push-notification-configuration
Adobe Campaign でプッシュ通知を送信するには、このページで詳しく説明するように、まず環境とアプリを設定する必要があります。Adobe Campaign では、プッシュ通知を送信するチャネルはモバイルアプリチャネルです。
Adobe Campaign でプッシュ通知の送信を開始する前に、モバイルアプリと Adobe Experience Platform のタグで、設定と統合が行われていることを確認する必要があります。Adobe Experience Platform Mobile SDK は、Android および iOS 互換の SDK を介して、モバイル用のクライアントサイド統合 API を提供します。
アプリを Adobe Experience Platform Mobile SDK で設定するには、次の手順に従います。
- 前提条件を確認します。
- Adobe Experience Platform データ収集でモバイルタグプロパティを設定します。
- このページを参照して、Adobe Experience Platform Mobile SDK を取得します。
- (オプション)このページを参照して、ログとライフサイクル指標を有効にします。
- (オプション)Adobe Experience Platform Assurance をアプリに追加して、実装を検証します。Adobe Experience Platform Assurance 拡張機能を実装する方法について詳しくは、このページを参照してください。
- このページを参照して、Adobe Campaign で iOS および Android モバイルサービスを設定します。
- モバイルプロパティに Adobe Campaign 拡張機能をインストールして設定します。
- Adobe Experience Platform Mobile SDK ドキュメントに従って、アプリで Adobe Experience Platform Mobile SDK を設定します。
前提条件 before-starting
権限の設定 setup-permissions
モバイルアプリケーションを作成する前に、まず、Adobe Experience Platform でタグに対する正しいユーザー権限があるか、割り当てられていることを確認する必要があります。Adobe Experience Platform のタグに対するユーザー権限は、Adobe Admin Console を通じてユーザーに割り当てられます。詳しくは、タグのドキュメントを参照してください。
プロパティ および 会社 の権限を割り当てるには、次の手順に従います。
-
Admin Console にアクセスします。
-
「製品」タブから、Adobe Experience Platform データ収集 カードを選択します。
-
既存の 製品プロファイル を選択するか、「新規プロファイル」ボタンで新しい製品プロファイルを作成します。新しい 新規プロファイル を作成する方法については、Admin Console のドキュメントを参照してください。
-
「権限」タブから、「プロパティ権限」を選択します。
-
「すべて追加」をクリックします。これにより、次の権限が製品プロファイルに追加されます。
- 承認
- 開発
- プロパティの編集
- 環境の管理
- 拡張機能の管理
- 公開
これらの権限は、Adobe Campaign 拡張機能をインストールして公開し、Adobe Experience Platform Mobile SDK でアプリのプロパティを公開するために必要です。
-
次に、 左側のメニューで「会社の権限」を選択します。
-
次の権限を追加します。
- アプリ設定の管理
- プロパティの管理
これらの権限は、モバイルアプリ開発者が Adobe Experience Platform データ収集 でプッシュ資格情報を設定するために必要です。
-
「保存」をクリックします。
この 製品プロファイル をユーザーに割り当てるには、次の手順に従います。
-
Admin Console にアクセスします。
-
「製品」タブから、Adobe Experience Platform データ収集 カードを選択します。
-
以前に設定した 製品プロファイル を選択します。
-
「ユーザー」タブから、「ユーザーを追加」をクリックします。
-
ユーザー名またはメールアドレスを入力して、ユーザーを選択します。次に、「保存」をクリックします。
note note NOTE ユーザーが以前に Admin Console で作成されていない場合は、 ユーザーの追加に関するドキュメントを参照してください。
アプリの設定 configure-app
技術的な設定では、アプリ開発者とビジネス管理者の緊密な共同作業が必要です。Adobe Campaign でプッシュ通知の送信を開始する前に、Adobe Experience Platform Data Collection で設定を定義し、モバイルアプリを Adobe Experience Platform Mobile SDK と統合する必要があります。
以下のリンクに記載されている実装手順に従います。
- Apple iOS の場合:アプリを APN に登録する方法については、Apple のドキュメントを参照してください。
- Google Android の場合:Android で Firebase Cloud Messaging クライアントアプリを設定する方法については、Google のドキュメントを参照してください。
Adobe Experience Platform データ収集でのモバイルタグプロパティの設定 launch-property
モバイルプロパティを設定すると、モバイルアプリ開発者またはマーケターがモバイル SDK を設定できます。通常、管理するモバイルアプリケーションごとにモバイルプロパティを作成します。モバイルプロパティを作成および設定する方法については、Adobe Experience Platform Mobile SDK ドキュメントを参照してください。
Adobe Experience Platform Data Collection タグについて詳しくは、Adobe Experience Platform ドキュメントを参照してください。
作成したら、新しいタグプロパティを開き、ライブラリを作成します。手順は次のとおりです。
- 左側のナビゲーションで 公開フロー を参照し、「ライブラリを追加」を選択します。
- ライブラリの名前を入力し、環境を選択します。
- 「変更されたリソースをすべて追加」、「開発用に保存およびビルド」を順に選択します。
- 最後に、「作業ライブラリを選択」ボタンから、このライブラリを作業ライブラリとして設定します。
Campaign でのモバイルサービスの設定 push-service
モバイル アプリを Adobe Experience Platform Data Collection に設定したら、Adobe Campaign からプッシュ通知を送信できるように 2 つのサービス(iOS デバイス用に 1 つ、Android デバイス用に 1 つ)を作成する必要があります。
プッシュ通知は、専用のサービスを通じてアプリのユーザーに送信されます。ユーザーはアプリをインストールすると、このサービスにサブスクライブします。Adobe Campaign は、このサービスを利用して、アプリのサブスクライバーのみをターゲットにします。このサービスでは、iOS デバイスと Android デバイスで送信するために、iOS アプリと Android アプリを追加する必要があります。
プッシュ通知を送信するサービスを作成するには、次の手順に従います。
-
プロファイルとターゲット/サービスとサブスクリプション タブを参照し、「作成」をクリックします。
{width="800"}
-
ラベル と 内部名 を入力し、モバイルアプリケーション タイプを選択します。
note note NOTE デフォルトの「購読者のアプリケーション(nms:appSubscriptionRcp)」ターゲットマッピングが受信者のテーブルにリンクされています。異なるターゲットマッピングを使用する場合は、新しいターゲットマッピングを作成し、サービスの「ターゲットマッピング」フィールドに入力する必要があります。ターゲットマッピングについて詳しくは、このページを参照してください。 -
次に、右側にある「追加」アイコンを使用して、このサービスを使用するモバイルアプリケーションを定義します。
iOS デバイス用のアプリを作成するには、次の手順に従います。
-
「iOS アプリケーションを作成」を選択し、「次へ」をクリックします。
{width="600"}
-
「ラベル」フィールドに、アプリの名前を入力します。
-
(オプション)アプリケーション変数 を使用してプッシュメッセージのコンテンツを強化できます。これらは完全にカスタマイズ可能で、モバイルデバイスに送信されるメッセージペイロードの一部です。
次の例では、mediaURl 変数と mediaExt 変数を追加し、リッチなプッシュ通知を作成してさらに通知内に表示する画像をアプリケーションに提供します。
{width="600"}
-
「サブスクリプションパラメーター」タブを参照すると、サブスクライバーのアプリケーション(nms:appsubscriptionRcp) スキーマの拡張によりマッピングを定義できます。
-
「サウンド」タブを参照して、再生するサウンドを定義します。「追加」をクリックし、「内部名」フィールドに、アプリケーションに埋め込まれたファイル名またはシステムサウンドの名前を入力します。
-
「次へ」をクリックし、開発アプリケーションの設定をおこないます。
-
統合キーは、各アプリケーションに固有です。これにより、モバイルアプリケーションが Adobe Campaign にリンクされます。
Adobe Campaign と、アプリケーションコード(SDK 経由)で同じ 統合キー が定義されていることを確認します。
詳しくは、Developer のドキュメントを参照してください
note note NOTE 統合キー は、文字列値を使用して完全にカスタマイズできますが、SDK で指定されたものと完全に同じにする必要があります。 アプリケーションの開発バージョン(サンドボックス)と実稼動バージョンに同じ証明書を使用することはできません。 -
「アプリケーションアイコン」フィールドからアイコンを選択して、サービス内のモバイルアプリケーションをパーソナライズします。
-
「認証モード」を選択します。次の 2 つのモードを使用できます。
-
(推奨)トークンベースの認証:APN 接続設定の キー ID、チーム ID、バンドル ID を入力し、「秘密鍵を入力…」をクリックして p8 証明書を選択します。トークンベースの認証 について詳しくは、Apple のドキュメントを参照してください。
-
証明書ベースの認証:「証明書を入力…」をクリックし、p12 キーを選択して、モバイルアプリケーション開発者から提供されたパスワードを入力します。この証明書には有効期限があり、毎年更新する必要があります。ユーザーへのサービスの中断を回避するには、期限が切れる前に証明書を更新します。証明書は 1 年間有効です。APN との通信を続行するには、証明書を更新する必要があります。
-
-
「接続をテスト」ボタンを使用して、設定を検証します。
-
「次へ」をクリックして本番アプリケーションの設定をおこない、上記と同じ手順に従います。
-
「終了」をクリックします。
これで、Campaign で iOS アプリケーションを使用する準備が整いました。
Android デバイス用のアプリを作成するには、次の手順に従います。
-
「Android アプリケーションを作成」を選択し、「次へ」をクリックします。
{width="600"}
-
「ラベル」フィールドに、アプリの名前を入力します。
-
統合キーは、各アプリケーションに固有です。これにより、モバイルアプリケーションが Adobe Campaign にリンクされます。
Adobe Campaign と、アプリケーションコード(SDK 経由)で同じ 統合キー が定義されていることを確認します。
詳しくは、Developer のドキュメントを参照してください
note note NOTE 統合キー は、文字列値を使用して完全にカスタマイズできますが、SDK で指定されたものと完全に同じにする必要があります。 -
「アプリケーションアイコン」フィールドからアイコンを選択して、サービス内のモバイルアプリケーションをパーソナライズします。
-
API バージョン ドロップダウンリストで「HTTP v1」を選択します。
-
「プロジェクトの詳細を抽出するプロジェクトの json ファイルを読み込む…」リンクをクリックして、JSON キーファイルを読み込みます。JSON ファイルの抽出方法について詳しくは、Google Firebase ドキュメントを参照してください。
次の詳細を手動で入力することもできます。
- プロジェクト ID
- 秘密鍵
- クライアントメール
-
「接続をテスト」ボタンを使用して、設定を検証します。
note caution CAUTION 「接続をテスト」ボタンは、MID サーバーが FCM サーバーにアクセスできるかどうかを確認しません。 -
(オプション)必要に応じて、アプリケーション変数 を使用してプッシュメッセージのコンテンツを強化できます。これらは完全にカスタマイズ可能で、モバイルデバイスに送信されるメッセージペイロードの一部です。
-
「終了」、「保存」の順にクリックします。これで、Campaign で Android アプリケーションを使用する準備が整いました。
以下に、プッシュ通知をさらにパーソナライズするための FCM ペイロード名を示します。
table 0-row-3 1-row-3 2-row-3 1-align-center 2-align-center 3-align-center 5-align-center 6-align-center 7-align-center 9-align-center 10-align-center 11-align-center | ||
---|---|---|
メッセージタイプ | 設定可能なメッセージ要素(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 |
モバイルプロパティでの Adobe Campaign 拡張機能の設定 configure-extension
Adobe Experience Platform Mobile SDK の Adobe Campaign Classic 拡張機能 は、モバイルアプリのプッシュ通知を強化し、ユーザーのプッシュトークンの収集と、Adobe Experience Platform サービスとのインタラクション測定の管理を行うのに役立ちます。
この拡張機能は、Campaign Classic v7 と Campaign v8 の両方に適用され、お使いの環境に事前にインストールされており、設定する必要があります。モバイルタグプロパティの拡張機能を設定するには、次の手順に従います。
- 以前に作成したタグプロパティを開きます。
- 左側のナビゲーションから、拡張機能 を参照し、「カタログ」タブを開きます。検索フィールドを使用して、Adobe Campaign Classic 拡張機能を検索します。
- Campaign Classic カードから、「インストール」ボタンをクリックします。
- Adobe Experience Platform Mobile SDK ドキュメントを参照して、設定を入力します。
これで、Adobe Experience Platform Mobile SDK ドキュメントを参照して、アプリにキャンペーンを追加できるようになりました。