単一ページアプリケーションフレームワークを基にしたクライアント側レンダリング(React など)が必要なプロジェクトでは、SPA エディターを使用することをお勧めします。詳細情報を参照してください。
重要な通知を AEM Mobile アプリユーザーに即座に警告できることは、モバイルアプリとそのマーケティングキャンペーンの価値にとって重要です。ここでは、アプリがプッシュ通知を受信できるようにするために必要な手順と、AEM Mobileから携帯電話にインストールされたアプリにプッシュを設定して送信する方法について説明します。 また、プッシュ通知にディープリンク機能を設定する方法についても説明します。
プッシュ通知は保証型配信ではありません。むしろお知らせに近いものです。全ユーザーがプッシュ通知を受信するように最大限の努力が払われていますが、保証型配信メカニズムではありません。また、プッシュを配信する時間は、1秒未満から最大30分までと異なる場合があります。
AEM でプッシュ通知を使用するには、さまざまなテクノロジーがいくつか必要になります。まず、プッシュ通知サービスプロバイダーを使用して、通知とデバイスを管理する必要があります(AEMでは、まだおこなっていません)。 AEMでは、次の2つのプロバイダーが標準で設定されます。Amazon Simple Notification Service(またはSNS)とPushwoosh。 次に、指定したモバイル OS 向けのプッシュテクノロジーは、適切なサービスである Apple のプッシュ通知サービス(APNS。iOS デバイス用)、Google Cloud Messaging(GCM。Android デバイス用)を経由する必要があります。AEMは、これらのプラットフォーム固有のサービスと直接通信しませんが、これらのサービスがプッシュを実行するには、AEMが通知と共に一部の関連設定情報を提供する必要があります。
インストールおよび設定(下記)が完了すると、次のように機能します。
AEM のこのリリースでは、iOS と Android のモバイルデバイスをサポートしています。
AEM Mobile アプリでプッシュ通知を使用するには、次のおおまかな手順を実行する必要があります。
通常、AEM開発者は次の操作をおこないます。
AEM管理者は次の操作を実行します。
Appleのページここに移動して、Appleプッシュ通知サービスに慣れてください。
APNSを使用するには、Appleの証明書ファイル(.cerファイル)、プッシュ秘密鍵(.p12ファイル)、秘密鍵のパスワードが必要です。 その方法に関する説明は、ここにあります。
Google は、GCM を Firebase Cloud Messaging(FCM)という類似のサービスに置き換えます。FCM について詳しくは、こちらを参照してください。
Googleページhereに移動して、Android向けのGoogle Cloud Messagingに慣れてください。
ここからGoogle APIプロジェクトを作成する、GCMサービスを有効にする、APIキーを取得する手順に従う必要があります。 Android デバイスにプッシュ通知を送信するには、API キーが必要になります。また、プロジェクト番号を記録します。この番号は、GCM送信者IDとも呼ばれます。
以下に、GCM API キーを作成する別の方法を示します。
com.adobe.cq.mobile.weretail.outdoorsapp
. (うまくいかない場合は、「test.test」を再試行してください)。サーバー API キーを記録します。この値は、プッシュプロバイダーのサイトで入力します。
AEM は、プッシュ通知に 3 つのサービスのうちいずれかを使用するように設定されています。
Amazon SNS および Pushwoosh の設定を使用すると、AEM 画面内からプッシュ通知を送信できます。
Adobe Mobile Services ** の設定を使用すると、Adobe Analytics アカウントを使用して Adobe Mobile Services 内からプッシュ通知を設定および送信できます(ただし、AMS プッシュ通知を有効にするには、この設定をおこなってアプリをビルドする必要があります)。
Amazon SNSに関する情報と、新しいAWSアカウントを作成するためのリンクは、こちらを参照し てください。1 年間無料のアカウントを入手できます。
Amazon SNS を使用しない場合には、この手順をスキップできます。
次の手順に従って、プッシュ通知用に Amazon SNS を設定します。
Amazon SNS への登録
アクセスキーおよび ID の作成
アクセスキーは、複数のアプリで使用できます。
「AWS サンドボックス」アカウントを使用する組織でも、同様に以下の手順に従います。
トピックの作成
開発、テスト、デモなどの、様々なシナリオに合わせて複数のトピックを作成できます。残りのSNS構成は同じままにできます。 別のトピックでアプリを構築します。そのトピックに送信されるプッシュ通知は、そのトピックで作成されたアプリでのみ受信されます。
プラットフォームアプリケーションの作成
Applications/Create Platform Application をクリックします。名前を選択し、プラットフォーム(iOS の場合は APNS、Android の場合は GCM)を選択します。プラットフォームに応じて、他のフィールドにも入力する必要があります。
サポート対象のプラットフォームごとに 1 回、上述の手順を繰り返します。iOS と Android の両方にプッシュできるようにするには、2 つのプラットフォームアプリケーションを作成する必要があります。
ID プールの作成
アクセスの設定
{ "Version":"2012-10-17" "Statement": [ { "動作": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ] "Effect":「許可」 "リソース": [ "*" ] } ] }
|
Pushwoosh を使用しない場合には、この手順をスキップできます。
Pushwoosh を使用するには:
Pushwoosh への登録
API アクセストークンの作成
新しいアプリを作成
2つ目のアプリが同じアプリID(およびその他の関連値)を持つAEMで設定されている場合:APIアクセストークンおよびGCM ID)、AEM上の2番目のアプリを介して送信されたプッシュ通知は、そのアプリIDを持つ他のアプリに送信されます。
notificationsConfig という 2 つのコンテンツノードを(1 つは app-config に、もう 1 つは app-config-dev に)作成します。
<your app>
/shell/jcr:content/pge-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/pge-app/app-config/notificationsConfig次のプロパティ(.content.xmlファイル)を使用する場合:
<jcr:root xmlns:jcr=" https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0"
jcr:primaryType="nt:unstructured"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>
コンテンツ同期ハンドラーは、これらのノードを検索し、ノードがなければ pge-notifications-config.json ファイルを書き出しません。
次の手順に従って、プッシュ通知クライアントライブラリをアプリに追加する必要があります。
CRXDE Lite で以下の手順に従います。
アプリのスペースの都合で、プッシュ通知を削除したか、使用していない場合は、コンソールのエラーメッセージを避けるために、これらのクライアントライブラリをアプリから削除します。
プッシュ通知の場合、エミュレーターはプッシュ通知を受信できないので、実際のデバイスでテストする必要があります。
iOSの場合は、Mac OSコンピュータを使用し、iOS Developer Programに参加する必要があります。 一部の企業は、すべての開発者が利用できる企業ライセンスを持っています。
XCode 8.1 では、プッシュ通知を使用する前に、プロジェクトの「Capabilities」タブに移動し、「Push Notifications」のトグルをオンに切り替える必要があります。
CLIを使用してAndroidスマートフォンにアプリをインストールするには(以下を参照)手順6 — アプリをビルドしてデプロイする)、まず電話を「開発者モード」にする必要があります。 この方法について詳しくは、デバイス上の開発者向けオプションの有効化を参照してください。
ビルドして設定済みのモバイルデバイスにデプロイする前に、使用するメッセージングサービス用に通知設定をおこなう必要があります。
注意: PhoneGapアプリケーションの構築に関するアドビの 🔗 指示も参照してください。
PhoneGap を使用してアプリをビルドしてデプロイするには、2 つの方法があります。
注意: プッシュ通知のテストの場合、エミュレーターでは十分ではありません。プッシュ通知は、プッシュプロバイダー(AppleまたはGoogle)とデバイスの間で異なるプロトコルを使用するからです。現在の Mac/PC ハードウェアおよびエミュレーターは、これをサポートしていません。
PhoneGap Build は、PhoneGapが提供するサービスで、サーバー上でアプリを構築し、デバイスに直接ダウンロードできます。PhoneGap Buildの設定方法と使用方法については、PhoneGap Buildのドキュメントを参照してください。
PhoneGapコマンドラインインターフェイス (CLI)を使用すると、コマンドラインで豊富なPhoneGapコマンドセットを使用して、アプリを構築、デバッグ、デプロイできます。PhoneGap CLIの設定および使用方法については、PhoneGap開発者向けドキュメントを参照してください。
新規通知を作成して送信するには、次の手順に従います。
新規通知の作成
通知の送信
結果の処理
プッシュ通知サービス(Amazon SNS または Pushwoosh)が送信要求を受信し、要求が有効であることを確認してネイティブのプロバイダー(APNS および GCM)に正常に送信した場合には、送信ダイアログがメッセージなしで閉じます。通知リストには、その通知のステータスが「送信済み」と表示されます。
プッシュ送信が失敗した場合、ダイアログには問題の発生を示すメッセージが表示されます。通知リストには、その通知のステータスが「エラー」と表示されますが、問題が修正された場合は、通知を再度送信できます。 エラーが発生した場合は、追加のエラー情報がサーバーエラーログに表示されます。
iOS と Android のプッシュ通知には、プラットフォームの違いがいくつかあります。その中には
AMS プッシュ通知では、AMS サーバーから通知を作成し、送信する必要があります。AMSは、AWSおよびPushwooshを使用したAEM通知で提供される機能以外にも、追加のプッシュ通知機能を提供します。
プッシュ通知は保証型配信ではありません。むしろお知らせに近いものです。全ユーザーがプッシュ通知を受信するように最大限の努力が払われていますが、保証型配信メカニズムではありません。また、プッシュを配信する時間は、1秒未満から最大30分までと異なる場合があります。
ディープリンクとはプッシュ通知のコンテキストでは、アプリを開く、またはアプリ内の指定した場所に(開いている場合に)誘導することを許可する手段です。
では、これはどのように機能するでしょうか。プッシュ通知の作成者は、視覚的なパスブラウザーを利用して、オプションで通知にボタンラベル(「Show me!」など)を追加したり、通知内にリンクを記載するページを選択したりできます。送信すると、プッシュが通常どおりに発生しますが、アプリ内メッセージでは「OK」ボタンが「解除」ボタンに置き換えられ、指定した新しいボタン(「Show me!」)も表示される点が異なります。新しいボタンをクリックすると、アプリがアプリ内の指定されたページに移動します。 「解除」をクリックすると、単にメッセージが消去されます。
アプリが開かれていない場合は、シェードが通常どおりに表示されます。日陰で通知に対してアクションを実行すると、アプリが開き、プッシュ通知で設定した内容に基づいてユーザーにディープリンクボタンが表示されます。
通知を作成し、オプションのディープリンクのボタンテキストおよびリンクパスを追加します。
ダッシュボードのプッシュ通知タイルにアクセスするには、以下の手順に従います。
クラウドサービスを管理タイルの右上隅の編集アイコンをクリックします。
「Pushwoosh 接続」を選択します。「次へ」をクリックします。
プロパティの詳細を入力して、「送信」をクリックします。
設定を送信すると、ダッシュボードにプッシュ通知タイルが表示されます。
ダッシュボードにプッシュ通知タイルが表示されたら、通知を作成ウィザードを使用してコンテンツを追加します。
プッシュ通知タイルの右上隅にある追加記号をクリックし、通知を作成ウィザードを表示します。
リンクパス内の参照アイコンをクリックすると、ユーザーにアプリのコンテンツ構造が表示されます。
パスを選択したら、チェックアイコンをクリックします。
リンクボタンのテキストは20文字に制限されています。
エンドユーザーがアプリケーションの最新バージョンを持たず、リンクされたパスを使用できない場合、ディープリンクのアクションを確認すると、ユーザーはアプリのメインページに移動します。
通知を作成ウィザードの「テキスト詳細」に入力し、「作成」をクリックします。
プッシュ通知タイルから、作成したプッシュ通知をクリックして、詳細を表示します。
プロパティの編集、通知の送信、通知の削除をおこなえます。
追加情報:
PushwooshおよびAmazon SNSは、6.4リリース以降はサポートされなくなり、パッケージ共有のアドオンとして使用できるようになります。
アプリのプッシュ通知の詳細を理解したら、AEM Mobile Content Personalizationを参照してください。