Adobeは、単一ページアプリケーションのフレームワークベースのクライアントサイドレンダリング(React など)を必要とするプロジェクトでは、SPA Editor を使用することをお勧めします。 詳細情報を参照してください。
重要な通知を使用して、AEM Mobileアプリのユーザーに即座に警告できることは、モバイルアプリとそのマーケティングキャンペーンの価値にとって重要です。 ここでは、アプリがプッシュ通知を受信できるようにする必要がある手順と、AEM Mobileから携帯電話にインストールされたアプリにプッシュを設定して送信する方法について説明します。 また、この節では、 ディープリンク 機能をプッシュ通知に追加します。
プッシュ通知は、配信を保証しません。お知らせに似ています。 誰もが確実に受け取れるように最善を尽くしていますが、保証された配信メカニズムではありません。 また、プッシュの配信時間は、1 秒未満から 30 分まで様々です。
AEMでプッシュ通知を使用するには、いくつかの異なるテクノロジーが必要です。 まず、プッシュ通知サービスプロバイダーを使用して、通知とデバイスを管理する必要があります (AEMでは、まだこれをおこなっていません )。 AEMでは、次の 2 つのプロバイダーが標準で設定されています。 Amazon Simple Notification Service (または SNS)、 Pushwoosh. 次に、特定のモバイル OS のプッシュテクノロジーは、適切なサービス (Appleのプッシュ通知サービス (APNS)、iOSデバイス用 ) を経由する必要があります。Android デバイス用のGoogle Cloud Messaging(または GCM)と AEMは、これらのプラットフォーム固有のサービスと直接通信しませんが、これらのサービスがプッシュを実行するには、AEMで関連する設定情報を通知と共に提供する必要があります。
(以下で説明するように)インストールおよび設定が完了すると、次のように機能します。
このリリースのAEMでは、iOSと Android のモバイルデバイスがサポートされます。
AEM Mobileアプリでプッシュ通知を使用するには、次の大まかな手順を実行する必要があります。
通常、Experience Manager開発者は次の操作を行います。
Experience Manager管理者は次の操作を行います。
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 キーの取得. 次が必要です: API キー をクリックして、Android デバイスにプッシュ通知を送信します。 また、 プロジェクト番号(別名) GCM Sender Id.
次の手順は、GCM API キーを作成する別の方法を示しています。
com.adobe.cq.mobile.weretail.outdoorsapp
. (うまくいかない場合は、「test.test」を使用して再度お試しください。)サーバー API キーを記録します。 この値は、プッシュプロバイダーのサイトに入力されます。
AEMは、プッシュ通知に次の 3 つのサービスのいずれかを使用するように設定されています。
Amazon SNS および Pushwoosh 設定を使用すると、AEM screens 内からプッシュを送信できます。
AdobeMobile Services 設定を使用すると、Adobe Analyticsアカウントを使用して、AdobeMobile Services 内からプッシュ通知を設定および送信できます(ただし、AMS プッシュ通知を有効にするには、この設定でアプリを構築する必要があります)。
Amazon SNS に関する情報と、新しいAWSアカウントを作成するためのリンクが含まれています ここ. 1 年間無料のアカウントを受け取ることができます。
Amazon SNS を使用しない場合は、これらの手順をスキップできます。
プッシュ通知用にAmazon SNS を設定するには、次の手順に従います。
Amazon SNS に登録
アクセスキーと ID を作成
アクセスキーは、複数のアプリで使用できます。
「AWS Sandbox」アカウントを使用する組織の場合の手順は非常に似ており、以下で概要を説明します。
トピックの作成
開発、テスト、デモなど、様々なシナリオ用に複数のトピックを作成できます。 残りの SNS 構成は同じままにすることができます。 別のトピックでアプリを構築します。そのトピックに送信されたプッシュ通知は、そのトピックで作成されたアプリでのみ受信されます。
Platform アプリケーションの作成
「アプリケーション」をクリックし、「Platform アプリケーションを作成」をクリックします。 名前を選択し、プラットフォーム (iOSの場合は APNS、Android の場合は GCM) を選択します。 プラットフォームに応じて、他のフィールドに入力する必要があります。
サポートするプラットフォームごとに、上記の手順を 1 回繰り返します。 iOSと Android の両方にプッシュできるようにするには、2 つの Platform アプリケーションを作成する必要があります。
ID プールの作成
アクセスを設定
{ "バージョン":"2012-10-17" "ステートメント": [ { "アクション": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "効果":「許可」 "リソース": [ "*" ] } ] }
|
Pushwoosh を使用しない場合は、この手順をスキップできます。
Pushwoosh を使用するには:
Pushwoosh への登録
API アクセストークンの作成
新しいアプリを作成
2 つ目のアプリが同じアプリ ID (および他の関連する値)を持つAEMで設定されている場合:API アクセストークンおよび GCM ID)、AEMの 2 番目のアプリを介して送信されたプッシュ通知は、そのアプリ ID を持つ他のアプリに送信されます。
notificationsConfig という 2 つのコンテンツノード(app-config で 1 つ、app-config-dev で 1 つ)を作成します。
<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://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"/>
コンテンツ同期ハンドラーは、これらのノードを探し、見つからない場合は pge-notifications-config.json ファイルを書き出しません。
次の手順に従って、プッシュ通知クライアントライブラリをアプリに追加する必要があります。
CRXDE Lite:
プッシュ通知が削除された、または使用されなかった場合、アプリのスペースを考慮し、コンソールのエラーメッセージを避けるために、アプリからこれらの clientlibs を削除します。
プッシュ通知の場合、エミュレーターはプッシュ通知を受信できないので、実際のデバイスでテストする必要があります。
iOSの場合は、Mac OS コンピューターを使用し、 iOS Developer Program. 一部の企業には、すべての開発者が利用できる企業ライセンスがあります。
XCode 8.1 では、プッシュ通知を使用する前に、プロジェクトの「機能」タブに移動し、「プッシュ通知」切り替えをオンにする必要があります。
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 分まで様々です。
ディープリンクとは プッシュ通知のコンテキストでは、アプリを開く、または(開いている場合は)アプリ内の指定した場所に導くことを許可する手段です。
仕組み プッシュ通知の作成者は、オプションでボタンラベルを追加します ( つまり、「見せてくれ!」) 通知に追加し、視覚的なパスブラウザーを使用して、通知内でリンクするページを選択します。 送信時には、通常どおりプッシュが発生しますが、アプリ内メッセージでは、「OK」ボタンが「却下」ボタンに置き換えられ、新しいボタン(「私を表示」)が指定されます。 」も表示されます。 新しいボタンをクリックすると、アプリ内の指定されたページに移動します。 「却下」をクリックすると、メッセージが閉じられます。
アプリが開いていない場合は、シェードが通常どおり表示されます。 日陰で通知に対してアクションを実行すると、アプリが開き、プッシュ通知で設定した内容に基づいて、ユーザーにディープリンクボタンが表示されます。
通知を作成し、オプションのディープリンク用のボタンテキストとリンクパスを追加します。
ダッシュボードのプッシュ通知タイルにアクセスするには、次の手順に従います。
「 Cloud Services タイル。
を選択します。 Pushwoosh 接続. 「次へ」をクリックします。
プロパティの詳細を入力し、「 送信.
設定を送信すると、 プッシュ通知 タイルがダッシュボードに表示されます。
一度 プッシュ通知 ダッシュボードにタイルが表示される場合は、通知を作成ウィザードを使用してコンテンツを追加します。
の右上隅にある追加記号をクリックします。 プッシュ通知 タイルを使用して開きます。 通知の作成ウィザード.
リンクパスの参照アイコンをクリックすると、アプリのコンテンツ構造が表示されます。
パスを選択したら、チェックアイコンをクリックします。
リンクボタンのテキストは 20 文字に制限されています。
エンドユーザーがアプリケーションの最新バージョンを持っておらず、リンクされたパスを使用できない場合は、ディープリンクのアクションを確認すると、ユーザーはアプリのメインページに移動します。
次を入力します。 テキストの詳細 内 通知の作成ウィザード をクリックし、 作成.
詳細を開くには、 プッシュ通知 タイル。
プロパティの編集、通知の送信、または通知の削除をおこなうことができます。
追加情報:
6.4 リリース以降は、Pushwoosh とAmazon SNS はサポートされなくなり、パッケージ共有からアドオンとして利用できるようになります。
アプリのプッシュ通知の詳細を理解したら、 AEM Mobile Content Personalization.