Adobeは、単一ページアプリケーションのフレームワークベースのクライアントサイドレンダリング(React など)を必要とするプロジェクトでは、SPA Editor を使用することをお勧めします。 詳細情報。
重要な通知を使用して、Adobe Experience Manager(AEM) モバイルアプリのユーザーに即座にアラートを送信できることは、モバイルアプリとそのマーケティングキャンペーンの価値にとって重要です。 ここでは、アプリがプッシュ通知を受け取るために必要な手順を説明します。 また、AEM Mobileから携帯電話にインストールされたアプリにプッシュを設定して送信する方法についても説明します。 また、この節では、 ディープリンク 機能をプッシュ通知に追加します。
プッシュ通知は保証された配信ではありません。お知らせに似ています。 誰もがそれを受け取るように最善を尽くしていますが、保証された配信メカニズムではありません。 また、プッシュの配信時間は、1 秒未満から 30 分まで様々です。
AEMでプッシュ通知を使用するには、いくつかの異なるテクノロジーが必要です。 まず、プッシュ通知サービスプロバイダーを使用して、通知とデバイスを管理する必要があります (AEMでは、まだこれをおこなっていません )。 AEMでは、次の 2 つのプロバイダーが標準で設定されています。 Amazon Simple Notification Service (または SNS)、および Pushwoosh. 次に、特定のモバイル OS のプッシュテクノロジーは、適切なサービス (iOSデバイス用はAppleのプッシュ通知サービス (APNS)、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 プールの作成
アクセスを設定
{ "Version": "2012-10-17", "ステートメント": [ { "アクション": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effect": "Allow", "リソース": [ "*" ] } ] }
|
Pushwoosh を使用しない場合は、この手順をスキップできます。
Pushwoosh を使用するには:
Pushwoosh への登録
API アクセストークンの作成
アプリの作成
2 つ目のアプリが同じアプリ ID( および関連する他の値(API アクセストークン、GCM ID)を持つAEMで設定されている場合、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の場合は、macOSコンピューターを使用して、 iOS Developer Program. 一部の企業には、すべての開発者が利用できる企業ライセンスがあります。
XCode 8.1 では、プッシュ通知を使用する前に、プロジェクトの「機能」タブに移動し、「プッシュ通知」切り替えをオンにする必要があります。
CLI を使用して Android™電話にアプリをインストールするには(以下を参照) 手順 6 — アプリケーションをビルドしてデプロイする) の場合、最初に電話を「開発者モード」にする必要があります。 詳しくは、 オンデバイス開発者向けオプションの有効化 を参照してください。
ビルドして設定したモバイルデバイスにデプロイする前に、使用すると決定したメッセージングサービスの通知設定を指定する必要があります。
注意: 手順を参照してください ここ PhoneGap アプリケーションの構築時に
PhoneGap を使用してアプリを構築してデプロイするには、2 つの方法があります。
注意: プッシュ通知のテストでは、エミュレーターで十分ではありません。プッシュ通知では、プッシュプロバイダー (AppleまたはGoogle) とデバイスの間で異なるプロトコルが使用されるからです。 現在のMac/PC ハードウェアおよびエミュレーターでは、この機能はサポートされていません。
PhoneGap Build は、PhoneGap が提供するサービスで、アプリをサーバー上で構築し、直接デバイスにダウンロードできます。 詳しくは、PhoneGap Buildドキュメント ( https://build.phonegap.com/
を参照して、PhoneGap Buildを設定および使用する方法を確認してください。
PhoneGap コマンドラインインターフェイス (CLI) コマンドラインで豊富な PhoneGap コマンドセットを使用して、アプリのビルド、デバッグ、デプロイをおこなうことができます。 PhoneGap 開発者向けドキュメント (https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface
) を参照して、PhoneGap CLI を設定して使用する方法を確認してください。
通知を作成して送信するには、次の手順に従います。
通知の作成
通知を送信
結果の処理
プッシュ通知サービス (Amazon SNS または Pushwoosh) が送信要求を受け取り、有効であることを確認し、ネイティブプロバイダー(APNS および GCM)に正常に送信した場合、送信ダイアログボックスはメッセージなしで閉じます。 通知リストには、その通知のステータスが「送信済み」と表示されます。
プッシュ送信が失敗した場合、ダイアログボックスに問題を示すメッセージが表示されます。 通知リストには、その通知のステータスが「エラー」と表示されますが、問題が修正された場合は、通知を再度送信できます。 エラーが発生した場合は、サーバーエラーログに追加のエラー情報が表示されます。
iOSと Android™のプッシュ通知には、プラットフォームにいくつかの違いがあることに注意してください。 その中には、
AMS プッシュ通知の場合、通知は AMS サーバーから構成および送信される必要があります。 AMS には、AWSおよび Pushwoosh でAEM通知で提供される機能以外にも、追加のプッシュ通知機能が用意されています。
プッシュ通知は保証された配信ではありません。お知らせに似ています。 誰もがそれを聞いているかを確かめるために最善の努力が行われていますが、保証された配信メカニズムではありません。 また、プッシュの配信時間は、1 秒未満から 30 分まで様々です。
ディープリンクとは プッシュ通知のコンテキストでは、アプリを開く、または(開いている場合は)アプリ内の指定した場所に導くことを許可する手段です。
どのように機能しますか? プッシュ通知の作成者は、オプションでボタンラベル(「表示」)を追加します。 通知に追加し、視覚的なパスブラウザーを使用して、通知内でリンクするページを選択します。 送信時には、通常どおりプッシュが発生しますが、アプリ内メッセージでは、「OK」ボタンが「却下」ボタンに置き換えられ、新しいボタン(「私を表示」)が指定されます。 」も表示されます。 新しいボタンをクリックすると、アプリはアプリ内の指定されたページに移動します。 「閉じる」をクリックすると、メッセージが表示されます。
アプリが開いていない場合は、シェードが通常どおり表示されます。 日陰で通知に対してアクションを実行すると、アプリが開き、プッシュ通知で設定した内容に基づいて、ユーザーにディープリンクボタンが表示されます。
通知を作成し、オプションのディープリンク用のボタンテキストとリンクパスを追加します。
ダッシュボードのプッシュ通知タイルにアクセスするには、次の手順に従います。
の右上隅にある編集をクリックします。 Cloud Service タイル。
を選択します。 Pushwoosh 接続. 「次へ」をクリックします。
プロパティの詳細を入力し、「 送信.
設定を送信すると、 プッシュ通知 タイルがダッシュボードに表示されます。
1 回 プッシュ通知 ダッシュボードにタイルが表示される場合は、通知を作成ウィザードを使用してコンテンツを追加します。
の右上隅にある追加記号をクリックします。 プッシュ通知 タイルを使用して開きます。 通知の作成ウィザード.
リンクパスの参照アイコンをクリックすると、アプリのコンテンツ構造が表示されます。
パスを選択したら、チェックアイコンをクリックします。
リンクボタンのテキストは 20 文字に制限されています。
エンドユーザーがアプリケーションの最新バージョンを持っておらず、リンクされたパスを使用できない場合は、ディープリンクのアクションを確認すると、ユーザーはアプリのメインページに移動します。
次を入力します。 テキストの詳細 (内) 通知の作成ウィザード をクリックします。 作成.
詳細を開くには、 プッシュ通知 タイル。
プロパティの編集、通知の送信、または通知の削除をおこなうことができます。
追加情報:
6.4 リリース以降は、Pushwoosh とAmazon SNS はサポートされなくなり、パッケージ共有からアドオンとして利用できるようになります。
アプリのプッシュ通知の詳細を理解したら、 AEM Mobile Content Personalization.