プッシュ通知 push-notifications
- ヘッドレスコンテンツを視覚的に編集するユニバーサルエディター。
- ヘッドレスコンテンツをフォームベースで編集するコンテンツフラグメントエディター。
重要な通知をAdobe Experience Manager(AEM)モバイルアプリのユーザーにすばやく通知できるようにすることは、モバイルアプリとそのマーケティングキャンペーンの価値にとって非常に重要です。 ここでは、アプリがプッシュ通知を受信できるようにするために実行する必要がある手順について説明します。 また、AEM Mobileからスマートフォンにインストールされたアプリにプッシュを設定して送信する方法についても説明します。 また、この節では、プッシュ通知に ディープリンク 機能を設定する方法についても説明します。
AEMでプッシュ通知を使用するには、いくつかのテクノロジーが必要です。 まず、プッシュ通知サービスプロバイダーを使用して、通知とデバイスを管理する必要があります(AEMはまだこれを行っていません)。 2つのプロバイダーが、AEMでAmazon Simple Notification Service (またはSNS)とPushwooshをすぐに使用できるように設定されています。 次に、特定のモバイル OSのプッシュ通知テクノロジーは、適切なサービス(iOS デバイスの場合はAppleのプッシュ通知サービス(またはAPNS)、Android デバイスの場合はGoogle Cloud Messaging (またはGCM)™を経由する必要があります。 AEMは、これらのプラットフォーム固有のサービスと直接コミュニケーションすることはできませんが、プッシュを実行するためにこれらのサービスの通知と共に、AEMから関連する設定情報の一部を提供する必要があります。
インストールして設定すると(以下で説明するように)、次のように動作します。
- プッシュ通知がAEMで作成され、サービスプロバイダー(Amazon SNSまたはPushwoosh)に送信されます。
- サービスプロバイダーはそれを受信し、コアプロバイダー(APNSまたはGCM)に送信します。
- コアプロバイダーは、そのプッシュに登録されているすべてのデバイスに通知をプッシュします。 各デバイスでは、デバイス上で利用可能なセルラーデータネットワークまたはWiFiを使用します。
- 登録されているアプリが実行されていない場合、通知がデバイスに表示されます。 ユーザーが通知をタップすると、アプリが起動し、アプリ内に通知が表示されます。 アプリケーションが既に実行されている場合は、アプリ内通知のみが表示されます。
このリリースのAEMは、iOSとAndroid™のモバイルデバイスをサポートしています。
概要と手順 overview-and-procedure
AEM Mobile アプリでプッシュ通知を使用するには、次の大まかな手順を実行する必要があります。
通常、Experience Manager開発者は次の操作を行います。
- AppleおよびGoogle メッセージングサービスへの登録
- プッシュメッセージングサービスに登録して設定する
- アプリにプッシュサポートを追加する
- テスト用の電話の準備
Experience Manager Administratorは次の操作を行います。
- AEM アプリでのプッシュの設定
- アプリのビルドとデプロイ
- プッシュ通知を送信
- ディープリンクの設定(オプション)
手順1:AppleおよびGoogle メッセージングサービスへの登録 step-register-with-apple-and-google-messaging-services
Apple プッシュ通知サービス(APNS)の使用 using-the-apple-push-notification-service-apns
Apple ページ ここに移動して、Apple プッシュ通知サービスに慣れましょう。
APNを使用するには、Appleから証明書 ファイル(.cer ファイル)、プッシュ 秘密鍵 (.p12 ファイル)、および 秘密鍵パスワード が必要です。 その方法に関する手順については、こちらを参照してください。
Google Cloud Messaging (GCM)サービスの使用 using-the-google-cloud-messaging-gcm-service
Google ページ こちらに移動して、Android™向けGoogle Cloud Messagingに関する情報を入手してください。
次の手順からGoogle API プロジェクトの作成、GCM サービスの有効化、API キーの取得。 Android™ デバイスにプッシュ通知を送信するには、API キーが必要です。 また、プロジェクト番号を記録します。これは GCM送信者ID とも呼ばれます。
次の手順では、GCM API キーを作成する別の方法を示します。
- Googleにログインし、Google開発者向けページ に移動します。
- リストからアプリを選択します(またはアプリを作成します)。
- Android™ パッケージ名の下に、アプリ ID (
com.adobe.cq.mobile.weretail.outdoorsapp)を入力します。 (それが機能しない場合は、「test.test」でもう一度試してください)。 - 「続行してサービスを選択して設定する」をクリックします
- 「Cloud Messaging」を選択し、「Google Cloud Messagingを有効にする」をクリックします。
- 新しいサーバーAPI キーと(新規または既存の)送信者IDが表示されます。
手順2:プッシュメッセージングサービスの登録と設定 step-register-and-configure-a-push-messaging-service
AEMでは、プッシュ通知に3つのサービスのいずれかを使用するように設定されています。
- Amazon SNS
- Pushwoosh
- Adobe Mobile Services
Amazon SNSおよび Pushwoosh 設定を使用すると、AEM画面内からプッシュを送信できます。
Adobe Mobile Services設定では、Adobe Analytics アカウントを使用してAdobe Mobile Services内からプッシュ通知を設定および送信できます(ただし、AMS プッシュ通知を有効にするには、この設定を使用してアプリを構築する必要があります)。
Amazon SNS メッセージングサービスの使用 using-the-amazon-sns-messaging-service
Amazon SNSを使用しない場合は、これらの手順をスキップできます。
プッシュ通知用にAmazon SNSを設定するには、次の手順に従います。
-
Amazon SNSに登録
- アカウント IDを記録します。 形式は、スペースやダッシュのない12桁の数字、つまり「123456789012」にする必要があります。
- 後の手順(ID プールの作成)では、いずれかの手順が必要なので、「us-east」または「eu」リージョンであることを確認してください。
- 登録後、管理コンソールにログインし、SNS (プッシュ通知サービス)を選択します。 表示された場合は、「開始」をクリックします。
-
アクセスキーとIDを作成
- 画面の右上にあるログイン名をクリックし、メニューから「セキュリティ認証情報」を選択します。
- 「アクセスキー」をクリックし、下のスペースで「新しいアクセスキーを作成」をクリックします。
- 「アクセスキーを表示」をクリックし、表示されているアクセスキーIDとシークレットアクセスキーをコピーして保存します。 キーをダウンロードするオプションを選択すると、同じ値を含むcsv ファイルが取得されます。
- その他のセキュリティ関連の証明書、およびその他の証明書は、このページで管理できます。
note NOTE アクセスキーは複数のアプリケーションに使用できます。 「AWS サンドボックス」アカウントを使用する組織の場合は、次の手順に従い、手順を説明します。
- 画面の右上にあるログイン名をクリックし、メニューから「My Security Credentials」を選択します。
- アクションの左側のリストで「ユーザー」をクリックし、ユーザー名を選択します。
- 「セキュリティ認証情報」タブをクリックします。
- ここから、キーが表示され、新しいキーを作成します。 後で使用するためにキーを保存します。
-
トピックの作成
- 「トピックを作成」をクリックし、トピック名を選択します。 トピック ARN、トピック所有者、地域、表示名など、すべてのフィールドを記録します。
- その他のトピックアクション > トピックポリシーの編集をクリックします。 これらのユーザーがこのトピックを購読することを許可するで、全員を選択します。
- 「ポリシーを更新」をクリックします。
note NOTE 開発、テスト、デモなど、様々なシナリオ用に複数のトピックを作成できます。 残りのSNS設定は同じままにできます。 別のトピックでアプリを構築します。そのトピックに送信されたプッシュ通知は、そのトピックで構築されたアプリによってのみ受信されます。 -
プラットフォームアプリケーションの作成
-
「アプリケーション」をクリックし、「プラットフォームアプリケーションを作成」をクリックします。 名前を選び、プラットフォーム(iOSのAPNS、AndroidのGCM™)を選びます。 ワークフローをカスタマイズできます。 その他のフィールドに入力する必要があります:
- APNSの場合は、P12 ファイル、パスワード、証明書、秘密鍵をすべて入力する必要があります。 これらは、上記の手順 Apple プッシュ通知サービス(APNS)の使用 で取得する必要があります。
- GCMの場合は、API キーを入力する必要があります。 これは、上記の手順 Google Cloud Messaging (GCM) サービスの使用 で取得する必要があります。
-
サポートしている各プラットフォームについて、上記の手順を1回繰り返します。 IOSとAndroid™の両方にプッシュするには、2つのPlatform アプリケーションを作成する必要があります。
-
-
ID プールの作成
- Cognitoを使用して、未認証ユーザーの基本データを保存するID プールを作成します。 注意:現在、Amazon Cognitoでサポートされているのは、「us-east」および「eu」リージョンのみです。
- 名前を付け、「未認証IDへのアクセスを有効にする」チェックボックスをオンにします。
- 次のページ(「Cognito IDにはリソースへのアクセスが必要です」)で、「許可」をクリックします。
- ページの右上にある「ID プールを編集」 リンクをクリックします。 ID プール IDが表示されます。 このテキストを後で使用するために保存します。
- 同じページで、「未認証の役割」の横にあるドロップダウンを選択し、Cognito_< プール名>UnauthRoleが選択されていることを確認します。 変更を保存します。
-
アクセスの設定
- Identity and Access Management (IAM)にログインします。
- 「役割」を選択します。
- 前の手順で作成したCognito_<yourIdentityPoolName>Unauth_Roleという役割をクリックします。 表示された「Role ARN」を記録します。
- まだ開いていない場合は、「インラインポリシー」を開きます。 oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123のような名前のポリシーが表示されます。
- 「ポリシーを編集」をクリックします。 ポリシードキュメントの内容を、次のJSONのスニペットに置き換えます。
table 0-row-1 html-authored no-header {
"Version": "2012-10-17",
"ステートメント": [
{
"Action": [
"mobileanalytics:PutEvents",
"cognito-sync:*",
"SNS:CreatePlatformEndpoint",
「SNS:Subscribe」
],
"Effect": "Allow",
「リソース」 : [
"*"
]
}
]
}
- 「ポリシーを適用」をクリックします。
Pushwoosh メッセージングサービスの使用 using-the-pushwoosh-messaging-service
Pushwooshを使用しない場合は、この手順をスキップできます。
Pushwooshを使用するには:
-
Pushwooshに登録
- pushwoosh.comに移動し、アカウントを作成します。
-
API アクセストークンの作成
- Pushwoosh サイトで、API アクセス メニュー項目に移動して、API アクセストークンを生成します。 このトークンを安全に記録します。
-
アプリを作成
- Android™ サポートの場合は、GCM API キーを指定する必要があります。
- アプリを設定する際は、フレームワークとしてCordovaを選択します。
- IOS サポートの場合は、証明書ファイル(.cer)、プッシュ証明書(.p12)および秘密鍵パスワードを指定する必要があります。これらは、AppleのAPNS サイトから取得する必要があります。 「Framework」で「Cordova」を選択します。
- Pushwooshは、そのアプリのアプリ IDを「XXXXX-XXXXXXX」の形式で生成します。各Xは16進数値(0 ~ F)です。
手順3:アプリにプッシュサポートを追加する step-add-push-support-to-the-app
ContentSync設定の追加 add-contentsync-configuration
notificationsConfigと呼ばれる2つのコンテンツノード(app-configとapp-config-devの1つ)を作成します。
- /content/
<your app>/shell/jcr:content/page-app/app-config-dev/notificationsConfig - /content/
<your app>/shell/jcr:content/page-app/app-config/notificationsConfig
次のプロパティ(.content.xml ファイル)を使用します。
<jcr:root xmlns:jcr=" https://experienceleague.adobe.com/en/tools/aem-api-documentation/spec/jcr/1.0/index.html" xmlns:nt=" https://experienceleague.adobe.com/en/tools/aem-api-documentation/spec/jcr/1.0/index.html"
jcr:primaryType=“nt:unstructured”
excludeProperties=“[appAPIAccessToken]”
path=“…/…/…/…”
targetRootDirectory=“www”
type=“notificationsconfig”/>
クライアントライブラリの追加 add-client-libraries
プッシュ通知クライアントライブラリは、次の手順に従ってアプリに追加する必要があります。
CRXDE Liteで:
- /etc/designs/phonegap/< アプリ名>/clientlibsall.に移動します
- プロパティパネルで「埋め込み」セクションをダブルクリックします。
- 表示されるダイアログボックスで、+ ボタンをクリックしてクライアントライブラリを追加します。
- 新しいテキストフィールドに「cq.mobile.push」を追加し、「OK」をクリックします。
- 「cq.mobile.push.amazon」という名前をもう1つ追加し、「OK」をクリックします。
- 変更を保存します。
手順4:テスト用に携帯電話を準備する step-prepare-a-phone-for-testing
IOS ios
IOSの場合は、macOS コンピューターを使用し、iOS Developer Programに参加します。 一部の企業では、すべての開発者が利用できる法人向けライセンスを保有しています。
XCode 8.1では、プッシュ通知を使用する前に、プロジェクトの「機能」タブに移動し、プッシュ通知トグルをオンにする必要があります。
Android™ android
CLIを使用してAndroid™携帯電話にアプリをインストールするには(以下を参照:手順6 - アプリをビルドしてデプロイ)、まず携帯電話を「デベロッパーモード」にする必要があります。 この方法について詳しくは、 オンデバイス開発者オプションの有効化を参照してください。
手順5:AEM アプリケーションでのプッシュの設定 step-configure-push-on-aem-apps
設定したモバイルデバイスを構築してデプロイする前に、使用するメッセージングサービスの通知設定を設定する必要があります。
- プッシュ通知に適した認証グループを作成します。
- AEMに適切なユーザーとしてログインし、「アプリ」タブをクリックします。
- アプリをクリックします。
- クラウドサービスの管理タイルを見つけて、鉛筆をクリックして、クラウド設定を変更します。
- 通知の設定として、「Amazon SNS Connection」、「Pushwoosh Connection」または「Adobe Mobile Services」を選択します。
- プロバイダープロパティを入力し、「送信」をクリックして保存し、「完了」をクリックします。 AMSがある場合を除き、この段階ではリモートで検証されません。
- これで、クラウドサービスの管理タイルに入力した設定が表示されます。
手順6:アプリのビルドとデプロイ step-build-and-deploy-the-app
メモ: PhoneGap アプリケーションのビルドに関する手順ここを参照してください。
PhoneGapを使用してアプリを構築およびデプロイするには、2つの方法があります。
注: プッシュ通知テストでは、プッシュ通知はプッシュプロバイダー(AppleまたはGoogle)とデバイスの間で異なるプロトコルを使用するため、エミュレーターでは十分ではありません。 現在のMac/PC ハードウェアおよびエミュレータでは、この機能はサポートされていません。
-
PhoneGap Buildは、PhoneGapが提供するサービスで、ユーザー向けにアプリをサーバー上に構築し、デバイスに直接ダウンロードできます。 PhoneGap Buildの設定と使用方法については、
https://build.phonegap.com/のPhoneGap Build ドキュメントを参照してください。 -
PhoneGap コマンドライン インターフェイス (CLI)を使用すると、コマンドラインで豊富なPhoneGap コマンドを使用して、アプリをビルド、デバッグ、デプロイできます。 PhoneGap CLIのセットアップと使用方法については、PhoneGap開発者ドキュメント (
https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface)を参照してください。
手順7:プッシュ通知の送信 step-send-a-push-notification
通知を作成して送信するには、次の手順に従います。
-
通知の作成
- AEM Mobile アプリのダッシュボードで、プッシュ通知タイルを見つけます。
- 右上のメニューで「作成」を選択します。 このボタンは、クラウド設定が最初に設定されるまで使用できません。
- 通知の作成ウィザードで、タイトルとメッセージを入力し、「作成」ボタンをクリックします。 通知をすぐに送信するか、後で送信する準備ができました。 編集でき、メッセージやタイトルを変更して保存できます。
-
通知を送信
- アプリダッシュボードで、プッシュ通知タイルを見つけます。
- 通知を選択するか、右下の詳細ボタン(。 . .)、通知のリストを表示します。 このリストは、通知を送信する準備ができているか、すでに送信されているか、送信中にエラーが発生したかどうかも示します。
- 1つの通知のチェックボックスを選択し(のみ)、リストの上にある「通知を送信」ボタンをクリックします。 表示されるダイアログで通知を「キャンセル」または「送信」するチャンスが1つあります。
-
結果の処理
-
プッシュ通知サービス(Amazon SNSまたはPushwoosh)が送信リクエストを受け取り、有効であることを確認し、ネイティブプロバイダー(APNSおよびGCM)に正常に送信すると、送信ダイアログボックスがメッセージなしで閉じます。 通知リストでは、その通知のステータスが「送信済み」と表示されます。
-
プッシュ送信が失敗した場合、ダイアログボックスに問題を示すメッセージが表示されます。 通知リストでは、その通知のステータスが「エラー」と表示されますが、問題が修正された場合は、通知を再度送信できます。 エラーが発生した場合は、サーバーのエラーログに追加のエラー情報が表示されます。
-
IOSとAndroid™のプッシュ通知には、プラットフォームの違いがいくつかあります。 その中には、
- CLIを使用してビルドすると、Android™にデプロイされた後にアプリが開始されます。 IOSでは、手動で起動する必要があります。 プッシュ登録ステップは起動時に発生するため、Android™ アプリケーションはプッシュ通知をすぐに受け取ることができますが(既に開始および登録されているため)、iOS アプリケーションは受け取ることができません。
- Android™では、「OK」ボタンのテキストはすべての大文字(およびアプリ内通知に追加されたその他のボタン)ですが、iOSではそうではありません。
-
AMS プッシュ通知の場合、通知を作成してAMS サーバーから送信する必要があります。 AMSでは、AWSおよびPushwooshを使用したAEMの通知の機能に加えて、プッシュ通知機能も提供されています。
プッシュ通知によるディープリンクの設定 configuring-deep-linking-with-push-notifications
ディープリンクとは? プッシュ通知のコンテキストでは、アプリを開いたり、アプリ内の指定された場所に(開いている場合)誘導したりできるようにするための手段です。
どのように機能しますか? プッシュ通知の作成者は、オプションでボタンラベルを追加します(つまり、「Show me!」)。 ビジュアルパスブラウザーを使用して、通知にリンクするページを選択します。 送信すると、プッシュは通常どおりに行われますが、アプリ内メッセージでは、「OK」ボタンは「閉じる」ボタンに置き換えられ、新しいボタンは指定されます(「Show me!」) も表示されます。 新しいボタンをクリックすると、アプリはアプリ内の指定されたページに移動します。 「閉じる」をクリックすると、メッセージが削除されます。
アプリが開いていない場合、シェードは通常どおり表示されます。 日陰の通知に対してアクションを実行すると、アプリが開き、プッシュ通知で設定された内容に基づいてディープリンクボタンがユーザーに表示されます。
通知を作成し、オプションのディープリンク用のボタンテキストとリンクパスを追加します。
-
クラウドサービスの管理 タイルの右上隅にある編集をクリックします。
-
プッシュウーシュ接続を選択します。 「次へ」をクリックします。
-
プロパティの詳細を入力し、送信をクリックします。
設定を送信すると、プッシュ通知 タイルがダッシュボードに表示されます。
通知を作成ウィザード create-notification-wizard
ダッシュボードに「プッシュ通知」タイルが表示されたら、通知の作成ウィザードを使用してコンテンツを追加します。
-
プッシュ通知 タイルの右上隅にある追加記号をクリックして、通知の作成ウィザードを開きます。
-
リンクパスの参照アイコンをクリックすると、アプリのコンテンツ構造がユーザーに表示されます。
パスを選択したら、チェックアイコンをクリックします。
note NOTE リンクボタンのテキストは20文字に制限されています。 エンドユーザーが最新バージョンのアプリケーションを使用しておらず、リンクされたパスが使用できない場合は、ディープリンクのアクションを確認すると、ユーザーはアプリのメインページに移動します。 -
通知の作成ウィザードで テキストの詳細 を入力し、作成をクリックします。
プッシュ通知 タイルから作成したプッシュ通知をクリックして、詳細を開きます。
プロパティを編集したり、通知を送信したり、通知を削除したりできます。
次の手順 the-next-steps
アプリのプッシュ通知の詳細を理解したら、AEM Mobile Content Personalizationを参照してください。