プッシュ通知 push-notifications

NOTE
Adobeは、単一ページアプリケーションのフレームワークベースのクライアントサイドレンダリング(React など)を必要とするプロジェクトでは、SPA Editor を使用することをお勧めします。 詳細情報

重要な通知を使用して、Adobe Experience Manager(AEM) モバイルアプリのユーザーに即座にアラートを送信できることは、モバイルアプリとそのマーケティングキャンペーンの価値にとって重要です。 ここでは、アプリがプッシュ通知を受け取るために必要な手順を説明します。 また、AEM Mobileから携帯電話にインストールされたアプリにプッシュを設定して送信する方法についても説明します。 また、この節では、 ディープリンク 機能をプッシュ通知に追加します。

NOTE
プッシュ通知は保証された配信ではありません。お知らせに似ています。 誰もがそれを受け取るように最善を尽くしていますが、保証された配信メカニズムではありません。 また、プッシュの配信時間は、1 秒未満から 30 分まで様々です。

AEMでプッシュ通知を使用するには、いくつかの異なるテクノロジーが必要です。 まず、プッシュ通知サービスプロバイダーを使用して、通知とデバイスを管理する必要があります (AEMでは、まだこれをおこなっていません )。 AEMでは、次の 2 つのプロバイダーが標準で設定されています。 Amazon Simple Notification Service (または SNS)、および Pushwoosh. 次に、特定のモバイル OS のプッシュテクノロジーは、適切なサービス (iOSデバイス用はAppleのプッシュ通知サービス (APNS)、Android™デバイス用はGoogle Cloud Messaging(GCM)) を経由する必要があります。 AEMは、これらのプラットフォーム固有のサービスと直接通信しませんが、AEMから、これらのサービスがプッシュを実行するための通知と共に、一部の関連する設定情報を提供する必要があります。

(以下で説明するように)インストールおよび設定が完了すると、次のように機能します。

  1. プッシュ通知がAEMで作成され、サービスプロバイダー (Amazon SNS または Pushwoosh) に送信されます。
  2. サービスプロバイダーがこれを受け取り、コアプロバイダー(APNS または GCM)に送信します。
  3. コアプロバイダーは通知をそのプッシュに登録されているすべてのデバイスにプッシュします。 各デバイスでは、携帯電話データネットワークまたは WiFi (デバイスで使用可能な方)を使用します。
  4. 通知は、登録されたアプリが実行されていない場合に、デバイスに表示されます。 ユーザーが通知をタップすると、アプリが起動し、アプリ内で通知が表示されます。 アプリケーションが既に実行されている場合は、アプリ内通知のみが表示されます。

このリリースのAEMでは、iOSと Android™のモバイルデバイスがサポートされます。

概要と手順 overview-and-procedure

AEM Mobileアプリでプッシュ通知を使用するには、次の大まかな手順を実行する必要があります。

通常、Experience Manager開発者は次の操作を行います。

  1. AppleおよびGoogleメッセージングサービスへの登録
  2. プッシュメッセージサービスへの登録と設定
  3. アプリにプッシュサポートを追加する
  4. テスト用に電話を準備する

Experience Manager管理者は次の操作を行います。

  1. AEMアプリでのプッシュの設定
  2. アプリのビルドとデプロイ
  3. プッシュ通知の送信
  4. ディープリンクの設定 (オプション)

手順 1:AppleおよびGoogleのメッセージングサービスに登録する step-register-with-apple-and-google-messaging-services

Appleプッシュ通知サービス (APNS) の使用 using-the-apple-push-notification-service-apns

Appleページに移動します。 ここ Apple Push Notification Service に慣れるためのツールです。

APNs を使用するには、 証明書 ファイル(.cer ファイル)、プッシュ 秘密鍵 (.p12 ファイル)、および 秘密鍵のパスワード Appleから その方法に関する説明は、 ここ.

Google Cloud Messaging(GCM) サービスの使用 using-the-google-cloud-messaging-gcm-service

NOTE
Googleは、GCM を Firebase Cloud Messaging(FCM) と呼ばれる類似のサービスに置き換えています。 FCM の詳細については、 ここ.

Googleページに移動します。 ここ Google Cloud Messaging for Android™に慣れる

次の手順に従います。 から Google API プロジェクトの作成, GCM サービスの有効化、および API キーの取得. 必要なのは API キー をクリックして、Android™デバイスにプッシュ通知を送信します。 また、 プロジェクト番号(別名) GCM Sender Id.

次の手順は、GCM API キーを作成する別の方法を示しています。

  1. google にログインし、 Google Developer ページ.
  2. リストからアプリを選択します(または作成します)。
  3. 「Android™パッケージ名」で、アプリ ID( ) を入力します。 com.adobe.cq.mobile.weretail.outdoorsapp. (うまくいかない場合は、「test.test」を使用して再度お試しください)。
  4. クリック 続行:サービスの選択と設定を行います
  5. Cloud Messaging を選択し、 Google Cloud Messaging を有効にする.
  6. 新しいサーバー API キーと(新規または既存の) Sender ID が表示されます。
NOTE
サーバー API キーを記録します。 この値は、プッシュプロバイダーのサイトに入力されます。

手順 2:プッシュメッセージサービスの登録と設定 step-register-and-configure-a-push-messaging-service

AEMは、プッシュ通知に次の 3 つのサービスのいずれかを使用するように設定されています。

  • Amazon SNS
  • Pushwoosh
  • Adobe Mobile Services

Amazon SNS および Pushwoosh 設定を使用すると、AEM screens 内からプッシュを送信できます。

AdobeMobile Services 設定を使用すると、Adobe Analyticsアカウントを使用して、AdobeMobile Services 内からプッシュ通知を設定および送信できます(ただし、AMS プッシュ通知を有効にするには、この設定でアプリを構築する必要があります)。

Amazon SNS メッセージサービスの使用 using-the-amazon-sns-messaging-service

NOTE
Amazon SNS に関する情報と、AWSアカウントを作成するためのリンクが含まれています ここ. 1 年間無料のアカウントを受け取ることができます。

Amazon SNS を使用しない場合は、これらの手順をスキップできます。

プッシュ通知用にAmazon SNS を設定するには、次の手順に従います。

  1. Amazon SNS に登録

    1. アカウント ID を記録します。 形式は 12 桁で、スペースやダッシュは使用できません ( つまり、「123456789012」)。
    2. 後の手順(ID プールの作成)では、これらのいずれかが必要なので、「us-east」または「eu」地域にいることを確認します。
    3. 登録後、管理コンソールにログインし、「 」を選択します。 SNS (プッシュ通知サービス)。 「使ってみる」をクリックします(表示された場合)。
  2. アクセスキーと ID を作成

    1. 画面の右上にあるログイン名をクリックし、メニューから「セキュリティ認証情報」を選択します。
    2. 「アクセスキー」をクリックし、下のスペースで、 新しいアクセスキーを作成.
    3. クリック アクセスキーを表示 ​をクリックし、表示されたアクセスキー ID と秘密アクセスキーをコピーして保存します。 キーをダウンロードするオプションを選択すると、同じ値を含む csv ファイルが取得されます。
    4. このページでは、他のセキュリティ関連の証明書などを管理できます。
    note note
    NOTE
    アクセスキーは、複数のアプリで使用できます。

    「AWS Sandbox」アカウントを使用する組織の場合は、手順は似ており、概要は次のとおりです。

    1. 画面の右上にあるログイン名をクリックし、メニューから [My Security Credentials] を選択します。
    2. アクションの左側のリストで「ユーザー」をクリックし、ユーザー名を選択します。
    3. 「セキュリティ資格情報」タブをクリックします。
    4. ここから、キーが表示され、新しいキーが作成されます。 後で使用するためにキーを保存します。
  3. トピックの作成

    1. クリック トピックを作成 をクリックし、トピック名を選択します。 トピック ARN、トピック所有者、地域、表示名など、すべてのフィールドを記録します。
    2. クリック その他のトピックアクション > トピックポリシーの編集. の下 これらのユーザーに対し、このトピックの購読を許可します ​を選択します。 みんな。
    3. クリック ポリシーを更新.
    note note
    NOTE
    開発、テスト、デモなど、様々なシナリオ用に複数のトピックを作成できます。 残りの SNS 構成は同じままにすることができます。 別のトピックでアプリをビルドします。そのトピックに送信されるプッシュ通知は、そのトピックでビルドされたアプリでのみ受信されます。
  4. Platform アプリケーションの作成

    1. 「アプリケーション」をクリックし、「Platform アプリケーションを作成」をクリックします。 名前を選択し、プラットフォーム (iOSの場合は APNS、Android™の場合は GCM) を選択します。 プラットフォームに応じて。 その他のフィールドは、次の場所に入力する必要があります。

      1. APNS の場合、P12 ファイル、パスワード、証明書、秘密鍵をすべて入力する必要があります。 これらは、手順で取得されたはずです Appleプッシュ通知サービス (APNS) の使用 上記の
      2. GCM の場合、API キーを入力する必要があります。 これは、手順で取得されたはずです。 Google Cloud Messaging(GCM) サービスの使用 上記の
    2. サポートするプラットフォームごとに、上記の手順を 1 回繰り返します。 iOSと Android™の両方にプッシュできるようにするには、2 つの Platform アプリケーションを作成する必要があります。

  5. ID プールの作成

    1. 用途 コグニト :未認証ユーザーの基本データを格納するアイデンティティ・プールを作成します。 現在、Amazon Cognito では「us-east」および「eu」地域のみがサポートされています。
    2. 名前を指定し、「未認証 ID へのアクセスを有効にする」チェックボックスをオンにします。
    3. 次のページ (Cognito ID は、リソースへのアクセスを必要とします") [ 許可 ] をクリックします。
    4. ページの右上にある、「ID プールを編集». ID プール ID が表示されます。 後で使用するために、このテキストを保存します。
    5. 同じページで、「Unauthenticated role」の横のドロップダウンを選択し、Cognito_<pool name="">UNAUTHrole が選択されています。 変更を保存します。
  6. アクセスの設定

    1. にログインします。 ID とアクセスの管理 (IAM)。
    2. 「ロール」を選択します。
    3. 前の手順で作成した Cognito_<youridentitypoolname>Unauth_Role。 表示された「役割 ARN」を記録します。
    4. 「インラインポリシー」を開く(まだ開いていない場合)。 ここに、oneClick_Cognito_のような名前のポリシーが表示されます。<youridentitypoolname>Unauth_Role_1234567890123.
    5. 「ポリシーを編集」をクリックします。 ポリシードキュメントのコンテンツを JSON の次のスニペットに置き換えます。
    table 0-row-1 html-authored no-header

    {

    "Version": "2012-10-17",

    "ステートメント": [

    {

    "アクション": [

    "mobileanalytics:PutEvents",

    "cognito-sync:*",

    "SNS:CreatePlatformEndpoint",

    "SNS:Subscribe"

    ],

    "Effect": "Allow",

    "Resource": [

    "*"

    ]

    }

    ]

    }

    1. クリック ポリシーを適用.

Pushwoosh メッセージングサービスの使用 using-the-pushwoosh-messaging-service

Pushwoosh を使用しない場合は、この手順をスキップできます。

Pushwoosh を使用するには:

  1. Pushwoosh への登録

    1. pushwoosh.comに移動し、アカウントを作成します。
  2. API アクセストークンの作成

    1. Pushwoosh サイトで、 API アクセスメニュー項目に移動して、API アクセストークンを生成します。 このトークンを安全に記録します。
  3. アプリの作成

    1. Android™をサポートする場合は、GCM API キーを提供する必要があります。
    2. アプリを設定する際に、フレームワークとして Cordova を選択します。
    3. iOSをサポートするには、証明書ファイル (.cer)、プッシュ証明書 (.p12) および秘密鍵のパスワードを指定する必要があります。これらは、Appleの APNS サイトから取得している必要があります。 「Framework」で、「Cordova」を選択します。
    4. Pushwoosh は、「XXXXX-XXXX」形式でそのアプリのアプリ ID を生成します。各 X は 16 進数値 (0 ~ F) です。
NOTE
2 つ目のアプリが同じアプリ ID( および関連する他の値(API アクセストークン、GCM ID)を持つAEMで設定されている場合、AEMの 2 つ目のアプリを介して送信されるプッシュ通知は、そのアプリ ID を持つ他のアプリに送信されます。

手順 3:アプリにプッシュサポートを追加する step-add-push-support-to-the-app

コンテンツ同期設定を追加 add-contentsync-configuration

notificationsConfig という 2 つのコンテンツノード(app-config で 1 つ、app-config-dev で 1 つ)を作成します。

  • /content/<your app>/shell/jcr:content/pge-app/app-config-dev/notificationsConfig
  • /content/<your app>/shell/jcr:content/pge-app/app-config/notificationsConfig

次のプロパティ(.content.xml ファイル)を使用する場合:
<jcr:root xmlns:jcr=" <span id=" translate="no" />https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" xmlns:nt=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" jcr:primaryType="nt:unstructured" excludeProperties="[appAPIAccessToken]" path="…/…/…/…"
🔗targetRootDirectory="www" type="notificationsconfig"/>

NOTE
コンテンツ同期ハンドラーは、これらのノードを探し、見つからない場合は pge-notifications-config.json ファイルを書き出しません。

クライアントライブラリを追加 add-client-libraries

次の手順に従って、プッシュ通知クライアントライブラリをアプリに追加する必要があります。

CRXDE Lite内:

  1. に移動します。 /etc/designs/phonegap/<app name="">/clientlibsall.
  2. プロパティペインの「埋め込み」セクションをダブルクリックします。
  3. 表示されるダイアログボックスで、「+」ボタンをクリックしてクライアントライブラリを追加します。
  4. 新しいテキストフィールドに「cq.mobile.push」を追加し、「OK」をクリックします。
  5. cq.mobile.push.amazon という名前のもう 1 つを追加し、「OK」をクリックします。
  6. 変更を保存します。
NOTE
プッシュ通知が削除された、または使用されなかった場合、アプリのスペースを考慮し、コンソールのエラーメッセージを避けるために、アプリからこれらの clientlibs を削除します。

手順 4:テスト用に電話を準備する step-prepare-a-phone-for-testing

NOTE
プッシュ通知の場合、エミュレーターはプッシュ通知を受信できないので、実際のデバイスでテストする必要があります。

IOS ios

iOSの場合は、macOSコンピューターを使用して、 iOS Developer Program. 一部の企業には、すべての開発者が利用できる企業ライセンスがあります。

XCode 8.1 では、プッシュ通知を使用する前に、プロジェクトの「機能」タブに移動し、「プッシュ通知」切り替えをオンにする必要があります。

Android™ android

CLI を使用して Android™電話にアプリをインストールするには(以下を参照) 手順 6 — アプリケーションをビルドしてデプロイする) の場合、最初に電話を「開発者モード」にする必要があります。 詳しくは、 オンデバイス開発者向けオプションの有効化 を参照してください。

手順 5:AEMアプリでのプッシュの設定 step-configure-push-on-aem-apps

ビルドして設定したモバイルデバイスにデプロイする前に、使用すると決定したメッセージングサービスの通知設定を指定する必要があります。

  1. プッシュ通知用の適切な認証グループを作成します。
  2. 適切なユーザーとしてAEMにログインし、「アプリ」タブをクリックします。
  3. アプリをクリックします。
  4. Cloud Serviceを管理タイルを探し、鉛筆アイコンをクリックして、クラウド設定を変更します。
  5. 通知設定として、「 Amazon SNS 接続」、「 Pushwoosh 接続」または「AdobeMobile Services 」を選択します。
  6. プロバイダーのプロパティを入力し、「送信」をクリックして保存し、「完了」をクリックします。 AMS がある場合を除き、この段階ではリモートで検証されません。
  7. これで、設定を管理タイルに入力した設定がCloud Serviceされます。

手順 6:アプリケーションをビルドしデプロイする step-build-and-deploy-the-app

注意: 手順を参照してください ここ PhoneGap アプリケーションの構築時に

PhoneGap を使用してアプリを構築してデプロイするには、2 つの方法があります。

注意: プッシュ通知のテストでは、エミュレーターで十分ではありません。プッシュ通知では、プッシュプロバイダー (AppleまたはGoogle) とデバイスの間で異なるプロトコルが使用されるからです。 現在のMac/PC ハードウェアおよびエミュレーターでは、この機能はサポートされていません。

  1. PhoneGap Build は、PhoneGap が提供するサービスで、アプリをサーバー上で構築し、直接デバイスにダウンロードできます。 詳しくは、PhoneGap Buildドキュメント ( https://build.phonegap.com/ を参照して、PhoneGap Buildを設定および使用する方法を確認してください。

  2. PhoneGap コマンドラインインターフェイス (CLI) コマンドラインで豊富な PhoneGap コマンドセットを使用して、アプリのビルド、デバッグ、デプロイをおこなうことができます。 PhoneGap 開発者向けドキュメント (https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface) を参照して、PhoneGap CLI を設定して使用する方法を確認してください。

手順 7:プッシュ通知の送信 step-send-a-push-notification

通知を作成して送信するには、次の手順に従います。

  1. 通知の作成

    • AEM Mobileアプリのダッシュボードで、プッシュ通知タイルを見つけます。
    • 右上のメニューで、「作成」を選択します。 このボタンは、クラウド設定が最初に設定されるまで使用できません。
    • 通知を作成ウィザードで、タイトルとメッセージを入力し、「作成」ボタンをクリックします。 これで、通知をすぐに送信するか、後で送信する準備が整いました。 メッセージやタイトルは、編集したり、変更や保存をおこなうことができます。
  2. 通知を送信

    • アプリダッシュボードで、プッシュ通知タイルを見つけます。
    • 通知を選択するか、右下の「詳細」ボタン ( . ) をクリックします。) をクリックして、通知のリストを表示します。 このリストは、通知の送信準備ができたか、既に送信されたか、送信中にエラーが発生したかを示します。
    • 1 つの通知用のチェックボックスを選択し(のみ)、リストの上の「通知を送信」ボタンをクリックします。 表示されるダイアログで、「キャンセル」または「送信」の通知を実行できます。
  3. 結果の処理

    • プッシュ通知サービス (Amazon SNS または Pushwoosh) が送信要求を受け取り、有効であることを確認し、ネイティブプロバイダー(APNS および GCM)に正常に送信した場合、送信ダイアログボックスはメッセージなしで閉じます。 通知リストには、その通知のステータスが「送信済み」と表示されます。

    • プッシュ送信が失敗した場合、ダイアログボックスに問題を示すメッセージが表示されます。 通知リストには、その通知のステータスが「エラー」と表示されますが、問題が修正された場合は、通知を再度送信できます。 エラーが発生した場合は、サーバーエラーログに追加のエラー情報が表示されます。

    • iOSと Android™のプッシュ通知には、プラットフォームにいくつかの違いがあることに注意してください。 その中には、

      • CLI でビルドすると、Android™にデプロイされた後にアプリが起動します。 iOSでは、手動で開始する必要があります。 プッシュ登録手順は起動時に発生するので、Android™アプリは(既に起動および登録されているので)すぐにプッシュ通知を受け取ることができますが、iOSアプリは受け取ることができません。
      • Android™では、「 OK 」ボタンのテキストはすべて大文字です(およびアプリ内通知に追加される他のボタンです)。iOSでは大文字ではありません。

AMS プッシュ通知の場合、通知は AMS サーバーから構成および送信される必要があります。 AMS には、AWSおよび Pushwoosh でAEM通知で提供される機能以外にも、追加のプッシュ通知機能が用意されています。

NOTE
プッシュ通知は保証された配信ではありません。お知らせに似ています。 誰もがそれを聞いているかを確かめるために最善の努力が行われていますが、保証された配信メカニズムではありません。 また、プッシュの配信時間は、1 秒未満から 30 分まで様々です。

プッシュ通知でのディープリンクの設定 configuring-deep-linking-with-push-notifications

ディープリンクとは プッシュ通知のコンテキストでは、アプリを開く、または(開いている場合は)アプリ内の指定した場所に導くことを許可する手段です。

どのように機能しますか? プッシュ通知の作成者は、オプションでボタンラベル(「表示」)を追加します。 通知に追加し、視覚的なパスブラウザーを使用して、通知内でリンクするページを選択します。 送信時には、通常どおりプッシュが発生しますが、アプリ内メッセージでは、「OK」ボタンが「却下」ボタンに置き換えられ、新しいボタン(「私を表示」)が指定されます。 」も表示されます。 新しいボタンをクリックすると、アプリはアプリ内の指定されたページに移動します。 「閉じる」をクリックすると、メッセージが表示されます。

アプリが開いていない場合は、シェードが通常どおり表示されます。 日陰で通知に対してアクションを実行すると、アプリが開き、プッシュ通知で設定した内容に基づいて、ユーザーにディープリンクボタンが表示されます。

通知を作成し、オプションのディープリンク用のボタンテキストとリンクパスを追加します。

CAUTION
ダッシュボードのプッシュ通知タイルにアクセスするには、次の手順に従います。
  1. の右上隅にある編集をクリックします。 Cloud Service タイル。

    chlimage_1-108

  2. を選択します。 Pushwoosh 接続. 「次へ」をクリックします。

    chlimage_1-109

  3. プロパティの詳細を入力し、「 送信.

    chlimage_1-110

    設定を送信すると、 プッシュ通知 タイルがダッシュボードに表示されます。

    chlimage_1-111

通知を作成ウィザード create-notification-wizard

1 回 プッシュ通知 ダッシュボードにタイルが表示される場合は、通知を作成ウィザードを使用してコンテンツを追加します。

  1. の右上隅にある追加記号をクリックします。 プッシュ通知 タイルを使用して開きます。 通知の作成ウィザード.

    chlimage_1-112

  2. リンクパスの参照アイコンをクリックすると、アプリのコンテンツ構造が表示されます。

    パスを選択したら、チェックアイコンをクリックします。

    chlimage_1-113

    note note
    NOTE
    リンクボタンのテキストは 20 文字に制限されています。
    エンドユーザーがアプリケーションの最新バージョンを持っておらず、リンクされたパスが使用できない場合、ディープリンクのアクションを確認すると、ユーザーはアプリのメインページに移動します。
  3. 次を入力します。 テキストの詳細 (内) 通知の作成ウィザード をクリックします。 作成.

    chlimage_1-114

    詳細を開くには、 プッシュ通知 タイル。

    プロパティの編集、通知の送信、または通知の削除をおこなうことができます。

    chlimage_1-115

NOTE
追加情報:
6.4 リリース以降は、Pushwoosh とAmazon SNS はサポートされなくなり、パッケージ共有からアドオンとして利用できるようになります。

次の手順 the-next-steps

アプリのプッシュ通知の詳細を理解したら、 AEM Mobile Content Personalization.

recommendation-more-help
2eeeb575-8007-40cc-a72d-206fbc4ddd4b