アドビは、シングルページアプリケーションフレームワークをベースにしたクライアント側のレンダリング(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 Push Notification Service に慣れるためのツールです。
APNS を使用するには、 証明書 ファイル(.cer ファイル)、プッシュ 秘密鍵 (.p12 ファイル)と 秘密鍵のパスワード Appleから その方法に関する説明は、 ここ.
Google は、GCM を Firebase Cloud Messaging(FCM)という類似のサービスに置き換えます。FCM について詳しくは、こちらを参照してください。
Googleページに移動します。 ここ を参照して、Google Cloud Messaging for Android に慣れてください。
次の手順に従う必要があります ここ から Google API プロジェクトの作成, GCM サービスの有効化、および API キーの取得. Android デバイスにプッシュ通知を送信するには、API キーが必要になります。また、 プロジェクト番号(別名) GCM Sender 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 プールの作成
アクセスの設定
{ "バージョン":"2012-10-17" "Statement": [ { "アクション": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "効果":「許可」 "リソース": [ "*" ] } ] }
|
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=" <span id=" translate="no" />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 開発者向けドキュメント を参照して、PhoneGap CLI を設定して使用する方法を確認してください。
新規通知を作成して送信するには、次の手順に従います。
新規通知の作成
通知の送信
結果の処理
プッシュ通知サービス(Amazon SNS または Pushwoosh)が送信要求を受信し、要求が有効であることを確認してネイティブのプロバイダー(APNS および GCM)に正常に送信した場合には、送信ダイアログがメッセージなしで閉じます。通知リストには、その通知のステータスが「送信済み」と表示されます。
プッシュ送信が失敗した場合、ダイアログには問題の発生を示すメッセージが表示されます。通知リストには、その通知のステータスが「エラー」と表示されますが、問題が修正された場合は、通知を再度送信できます。 エラーが発生した場合は、追加のエラー情報がサーバーエラーログに表示されます。
iOS と Android のプッシュ通知には、プラットフォームの違いがいくつかあります。その中には、
AMS プッシュ通知では、AMS サーバーから通知を作成し、送信する必要があります。AMS には、AWSおよび Pushwoosh でAEM通知で提供される機能以外にも、追加のプッシュ通知機能が用意されています。
プッシュ通知は保証型配信ではありません。むしろお知らせに近いものです。全ユーザーがプッシュ通知を受信するように最大限の努力が払われていますが、保証型配信メカニズムではありません。また、プッシュの配信時間は、1 秒未満から 30 分まで様々です。
ディープリンクとはプッシュ通知のコンテキストでは、アプリを開く、または(開いている場合は)アプリ内の指定した場所に導くことを許可する手段です。
では、これはどのように機能するでしょうか。プッシュ通知の作成者は、視覚的なパスブラウザーを利用して、オプションで通知にボタンラベル(「Show me!」など)を追加したり、通知内にリンクを記載するページを選択したりできます。送信すると、プッシュが通常どおりに発生しますが、アプリ内メッセージでは「OK」ボタンが「解除」ボタンに置き換えられ、指定した新しいボタン(「Show me!」)も表示される点が異なります。新しいボタンをクリックすると、アプリ内の指定されたページに移動します。 「解除」をクリックすると、単にメッセージが消去されます。
アプリが開かれていない場合は、シェードが通常どおりに表示されます。日陰で通知に対してアクションを実行すると、アプリが開き、プッシュ通知で設定した内容に基づいて、ユーザーにディープリンクボタンが表示されます。
通知を作成し、オプションのディープリンクのボタンテキストおよびリンクパスを追加します。
ダッシュボードのプッシュ通知タイルにアクセスするには、以下の手順に従います。
クラウドサービスを管理タイルの右上隅の編集アイコンをクリックします。
「Pushwoosh 接続」を選択します。「次へ」をクリックします。
プロパティの詳細を入力して、「送信」をクリックします。
設定を送信すると、ダッシュボードにプッシュ通知タイルが表示されます。
ダッシュボードにプッシュ通知タイルが表示されたら、通知を作成ウィザードを使用してコンテンツを追加します。
プッシュ通知タイルの右上隅にある追加記号をクリックし、通知を作成ウィザードを表示します。
リンクパス内の参照アイコンをクリックすると、ユーザーにアプリのコンテンツ構造が表示されます。
パスを選択したら、チェックアイコンをクリックします。
リンクボタンのテキストは 20 文字に制限されています。
エンドユーザーがアプリケーションの最新バージョンを持っておらず、リンクされたパスを使用できない場合は、ディープリンクのアクションを確認すると、ユーザーはアプリのメインページに移動します。
通知を作成ウィザードの「テキスト詳細」に入力し、「作成」をクリックします。
プッシュ通知タイルから、作成したプッシュ通知をクリックして、詳細を表示します。
プロパティの編集、通知の送信、通知の削除をおこなえます。
追加情報:
6.4 リリース以降は、Pushwoosh とAmazon SNS はサポートされなくなり、パッケージ共有からアドオンとして利用できるようになります。
アプリのプッシュ通知の詳細を理解したら、 AEM Mobile Content Personalization.