Adobe empfiehlt die Verwendung des SPA-Editors für Projekte, für die ein frameworkbasiertes Client-seitiges Rendering für einzelne Seiten (z. B. React) erforderlich ist. Weitere Informationen
Die Möglichkeit, Ihre AEM Mobile-App-Benutzer sofort mit wichtigen Benachrichtigungen zu benachrichtigen, ist für den Wert einer App und ihrer Marketingkampagnen von entscheidender Bedeutung. In unserem Beispiel werden die Schritte beschrieben, die unternommen werden müssen, damit Ihre App Push-Benachrichtigungen empfangen kann, sowie die Konfiguration und der Versand von Push-Benachrichtigungen von AEM Mobile an die am Telefon installierte App. Außerdem wird in diesem Abschnitt beschrieben, wie Sie die Deep-Linking -Funktion für Ihre Push-Benachrichtigungen verwenden.
Push-Benachrichtigungen werden nicht garantiert. sie sind eher wie Ankündigungen. Es wird alles daran gesetzt, sicherzustellen, dass jeder sie erhält, aber sie kein garantierter Bereitstellungsmechanismus sind. Außerdem kann die Bereitstellungszeit für eine Push-Benachrichtigung zwischen weniger als einer Sekunde und bis zu einer halben Stunde variieren.
Die Verwendung von Push-Benachrichtigungen mit AEM erfordert einige verschiedene Technologien. Zunächst muss ein Push-Benachrichtigungs-Dienstleister zur Verwaltung der Benachrichtigungen und Geräte verwendet werden (AEM tut dies noch nicht). Zwei Anbieter sind standardmäßig mit AEM konfiguriert: Amazon Simple Notification Service (oder SNS) und Pushwoosh. Zweitens muss die Push-Technologie für das jeweilige mobile Betriebssystem den entsprechenden Dienst (Apple Push Notification Service (APNS) für iOS-Geräte) durchlaufen. und Google Cloud Messaging (oder GCM) für Android-Geräte. Obwohl AEM nicht direkt mit diesen plattformspezifischen Diensten kommuniziert, müssen einige zugehörige Konfigurationsinformationen von AEM zusammen mit den Benachrichtigungen bereitgestellt werden, damit diese Dienste den Push-Vorgang ausführen können.
Nach der Installation und Konfiguration (wie unten beschrieben) funktioniert dies wie folgt:
Diese Version von AEM unterstützt Mobilgeräte mit iOS und Android.
Um Push-Benachrichtigungen in einer AEM Mobile-App zu verwenden, müssen die folgenden allgemeinen Schritte ausgeführt werden.
Normalerweise führt ein AEM-Entwickler Folgendes durch:
Ein AEM Administrator wird Folgendes tun:
Navigieren Sie zur Apple-Seite here , um sich mit dem Push-Benachrichtigungsdienst von Apple vertraut zu machen.
Für die Verwendung von APNS benötigen Sie eine Zertifikat Datei (eine .cer-Datei), eine Push-Datei Privater Schlüssel (eine .p12-Datei) und Passwort für privaten Schlüssel aus Apple. Anweisungen dazu finden Sie here.
Google ersetzt GCM durch einen ähnlichen Dienst namens Firebase Cloud Messaging (FCM). Weitere Informationen zu FCM finden Sie unter here.
Navigieren Sie zur Google-Seite here , um sich mit Google Cloud Messaging für Android vertraut zu machen.
Führen Sie die folgenden Schritte aus here nach Erstellen eines Google-API-Projekts, Aktivieren des GCM-Dienstes und Abrufen eines API-Schlüssels. Sie benötigen die API-Schlüssel , um Push-Benachrichtigungen an Android-Geräte zu senden. Zeichnen Sie außerdem Ihre Projektnummer, was manchmal auch als GCM Sender Id.
Die folgenden Schritte zeigen eine andere Methode zum Erstellen von GCM-API-Schlüsseln:
com.adobe.cq.mobile.weretail.outdoorsapp
. (Wenn dies nicht funktioniert, versuchen Sie es erneut mit "test.test".)Notieren Sie sich den Server-API-Schlüssel. Dieser Wert wird auf der Site Ihres Push-Providers eingegeben.
AEM ist für die Verwendung eines der drei Dienste für Push-Benachrichtigungen konfiguriert:
Amazon SNS und Pushwoosh -Konfigurationen ermöglichen es Ihnen, Push-Benachrichtigungen von AEM Bildschirmen aus zu senden.
Adobe Mobile Services Mit der -Konfiguration können Sie Push-Benachrichtigungen von Adobe Mobile Services mithilfe eines Adobe Analytics-Kontos konfigurieren und senden (die App muss jedoch mit dieser Konfiguration erstellt werden, um AMS-Push-Benachrichtigungen zu aktivieren).
Informationen zu Amazon SNS und einem Link zum Erstellen eines neuen AWS-Kontos finden Sie unter here. Sie können ein kostenloses Konto für ein Jahr erhalten.
Wenn Sie Amazon SNS nicht verwenden möchten, können Sie diese Schritte überspringen.
Führen Sie die folgenden Schritte aus, um Amazon SNS für Push-Benachrichtigungen einzurichten:
Bei Amazon SNS registrieren
Zugriffsschlüssel und -kennung erstellen
Ein Zugriffsschlüssel kann für mehrere Apps verwendet werden.
Für Organisationen, die ein "AWS Sandbox"-Konto verwenden, sind die Schritte sehr ähnlich und werden hier beschrieben:
Thema erstellen
Sie können mehrere Themen für verschiedene Szenarien wie Entwicklung, Test, Demo usw. erstellen. Der Rest der SNS-Konfiguration kann unverändert bleiben. Erstellen Sie die App mit dem anderen Thema. Push-Benachrichtigungen, die an dieses Thema gesendet werden, werden nur von der mit diesem Thema erstellten App empfangen.
Erstellen von Platform-Anwendungen
Klicken Sie auf Anwendungen und dann auf Platform Application erstellen. Wählen Sie einen Namen und eine Plattform (APNS für iOS, GCM für Android). Je nach Plattform müssen andere Felder ausgefüllt werden:
Wiederholen Sie den obigen Schritt einmal für jede Plattform, die Sie unterstützen. Um sowohl an iOS als auch an Android pushen zu können, müssen zwei Plattformanwendungen erstellt werden.
Erstellen eines Identitäts-Pools
Zugriff konfigurieren
{ "Version": "10.10.2012", "Aussage": [ { "Aktion": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effekt": "Allow", "Ressource": [ "*" ] } ] }
|
Wenn Sie Pushwoosh nicht verwenden möchten, können Sie diesen Schritt überspringen.
So verwenden Sie Pushwoosh:
Registrieren bei Pushwoosh
API-Zugriffstoken erstellen
Neue App erstellen
Wenn eine zweite App in AEM mit derselben App-ID (und anderen zugehörigen Werten) konfiguriert ist: API-Zugriffstoken und GCM-ID) werden alle Push-Benachrichtigungen, die über die zweite App am AEM gesendet werden, an jede andere App mit dieser App-ID gesendet.
Erstellen Sie zwei Inhaltsknoten (einen in app-config und einen in app-config-dev) namens notificationsConfig:
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfigMit diesen Eigenschaften (.content.xml files) :
<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"/>
Der Content Sync-Handler sucht nach diesen Knoten, und wenn sie nicht vorhanden sind, schreibt er nicht die Datei "page-notifications-config.json".
Die Client-Bibliotheken der Push-Benachrichtigung müssen der App hinzugefügt werden, indem Sie die folgenden Schritte ausführen:
In CRXDE Lite:
Wenn Push-Benachrichtigungen aus Platzgründen in der App entfernt oder nicht verwendet werden und um Konsolenfehlermeldungen zu vermeiden, entfernen Sie diese Clientlibs aus Ihrer App.
Für Push-Benachrichtigungen müssen Sie auf einem eigentlichen Gerät testen, da Emulatoren keine Push-Benachrichtigungen empfangen können.
Für iOS müssen Sie einen Mac OS-Computer verwenden und der iOS Developer Program. Einige Unternehmen verfügen über Unternehmenslizenzen, die für alle Entwickler verfügbar sein können.
In XCode 8.1 müssen Sie vor der Verwendung von Push-Benachrichtigungen in Ihrem Projekt zur Registerkarte Funktionen wechseln und den Umschalter Push-Benachrichtigungen aktivieren aktivieren.
So installieren Sie die App über CLI auf einem Android-Telefon (siehe unten): Schritt 6: Erstellen und Bereitstellen des Programms), müssen Sie zunächst das Telefon in den "Entwicklermodus"stellen. Siehe Aktivieren der Entwickleroptionen auf dem Gerät für weitere Informationen.
Vor der Erstellung und Bereitstellung auf Ihrem konfigurierten Mobilgerät müssen Sie die Benachrichtigungseinstellungen für den Messaging-Dienst konfigurieren, den Sie verwenden möchten.
Hinweis: Lesen Sie auch unsere Anweisungen here zum Erstellen von PhoneGap-Anwendungen.
Es gibt zwei Möglichkeiten, Ihre App mit PhoneGap zu erstellen und bereitzustellen.
Hinweis: Für Push-Benachrichtigungstests reichen Emulatoren nicht aus, da Push-Benachrichtigungen ein bestimmtes Protokoll zwischen dem Push-Provider (Apple oder Google) und dem Gerät verwenden. Die aktuelle Mac-/PC-Hardware und -Emulatoren unterstützen dies nicht.
PhoneGap Build ist ein von PhoneGap angebotener Dienst, mit dem Sie Ihre App auf ihren Servern erstellen und direkt auf Ihr Gerät herunterladen können. Siehe Abschnitt Dokumentation zu PhoneGap Build , um zu erfahren, wie Sie PhoneGap Build einrichten und verwenden.
PhoneGap-Befehlszeilenschnittstelle (CLI) ermöglicht Ihnen die Verwendung einer Vielzahl von PhoneGap-Befehlen in Ihrer Befehlszeile zum Erstellen, Debuggen und Bereitstellen Ihrer App. Siehe Abschnitt Dokumentation für PhoneGap-Entwickler , um zu erfahren, wie Sie PhoneGap CLI einrichten und verwenden.
Gehen Sie wie folgt vor, um eine neue Benachrichtigung zu erstellen und zu senden.
Neue Benachrichtigung erstellen
Benachrichtigung senden
Umgang mit den Ergebnissen
Wenn der Push-Benachrichtigungsdienst (Amazon SNS oder Pushwoosh) die Sendeanforderung erhält, sie als gültig bestätigt und erfolgreich an die nativen Provider (APNS und GCM) sendet, wird das Dialogfeld "Senden"ohne Nachricht geschlossen. In der Benachrichtigungsliste wird der Status dieser Benachrichtigung als Gesendet angezeigt.
Wenn der Push-Versand fehlschlägt, wird im Dialogfeld eine Meldung angezeigt, die das Problem angibt. In der Benachrichtigungsliste wird der Status dieser Benachrichtigung als Fehler aufgeführt. Wenn das Problem behoben wurde, kann die Benachrichtigung erneut gesendet werden. Im Falle eines Fehlers sollten zusätzliche Fehlerinformationen im Serverfehlerprotokoll angezeigt werden.
Beachten Sie, dass es einige Plattformunterschiede zwischen Push-Benachrichtigungen in iOS und Android gibt. Dazu gehören:
Bei AMS-Push-Benachrichtigungen müssen Benachrichtigungen erstellt und vom AMS-Server gesendet werden. AMS bietet zusätzliche Push-Benachrichtigungsfunktionen, die über die Funktionen AEM Benachrichtigungen mit AWS und Pushwoosh hinausgehen.
Push-Benachrichtigungen werden nicht garantiert. sie sind eher wie Ankündigungen. Es wird versucht sicherzustellen, dass jeder es hört, aber es sich nicht um einen garantierten Bereitstellungsmechanismus handelt. Außerdem kann die Bereitstellungszeit für eine Push-Benachrichtigung zwischen weniger als einer Sekunde und bis zu einer halben Stunde variieren.
Was ist Deep Linking? Im Kontext einer Push-Benachrichtigung ist dies eine Möglichkeit, das Öffnen oder Weiterleiten einer App an eine angegebene Position innerhalb der App zu ermöglichen (sofern diese geöffnet ist).
Wie funktioniert es? Der Autor einer Push-Benachrichtigung fügt optional eine Schaltflächenbeschriftung hinzu (d. h. "Zeig mir!") in die Benachrichtigung ein und wählt über einen visuellen Pfad-Browser die Seite aus, die in der Benachrichtigung verknüpft werden soll. Beim Senden erfolgt der Push-Vorgang wie gewohnt. In der In-App-Nachricht wird die Schaltfläche OK durch die Schaltfläche "Beenden"ersetzt und die neue Schaltfläche angegeben ("Anzeigen!") angezeigt. Wenn Sie auf die neue Schaltfläche klicken, wird die App zur angegebenen Seite innerhalb der App weitergeleitet. Wenn Sie auf Beenden klicken, wird die Nachricht einfach verworfen.
Wenn die App nicht geöffnet ist, wird die Schattierung normal angezeigt. Wenn Sie die Benachrichtigung im Schatten bearbeiten, wird die App geöffnet und dem Benutzer dann die Deep-Link-Schaltflächen entsprechend der Konfiguration in der Push-Benachrichtigung angezeigt.
Erstellen Sie die Benachrichtigung, fügen Sie einen Schaltflächentext und einen Link-Pfad für den optionalen Deep-Link hinzu:
.Gehen Sie wie folgt vor, um auf die Kachel Push-Benachrichtigung in Ihrem Dashboard zuzugreifen.
Klicken Sie oben rechts im Cloud Services verwalten Kachel.
Wählen Sie die Pushwoosh-Verbindung. Klicken Sie auf Weiter.
Geben Sie die Details der Eigenschaften ein und klicken Sie auf Einsenden.
Wenn Sie Ihre Konfiguration übermitteln, wird die Push-Benachrichtigungen wird im Dashboard angezeigt.
Einmal Push-Benachrichtigungen in Ihrem Dashboard angezeigt werden, verwenden Sie den Assistenten zur Erstellung von Benachrichtigungen, um den Inhalt hinzuzufügen:
Klicken Sie oben rechts im Push-Benachrichtigungen -Kachel zum Öffnen Benachrichtigungsassistent erstellen.
Durch Klicken auf das Symbol "Durchsuchen"im Link-Pfad wird dem Benutzer die Inhaltsstruktur der App angezeigt.
Nachdem Sie den Pfad ausgewählt haben, klicken Sie auf das Häkchensymbol.
Der Text der Link-Schaltfläche ist auf 20 Zeichen begrenzt.
Wenn der Endbenutzer nicht über die neueste Version der Anwendung verfügt und der verknüpfte Pfad nicht verfügbar ist, führt die Bestätigung der Deep-Link-Aktion dazu, dass der Benutzer zur Hauptseite der App gelangt.
Geben Sie die Textdetails im Benachrichtigungsassistent erstellen und klicken Sie auf Erstellen.
Öffnen Sie die Details, indem Sie auf die von Ihnen erstellte Push-Benachrichtigung im Push-Benachrichtigungen Kachel.
Sie können Eigenschaften bearbeiten, Benachrichtigungen senden oder die Benachrichtigung löschen.
Zusätzliche Informationen:
Pushwoosh und Amazon SNS werden nach Version 6.4 nicht mehr unterstützt und sind als Add-On über Package Share verfügbar.
Sobald Sie die Details zu Push-Benachrichtigungen für Ihre App kennen, lesen Sie AEM Mobile Content Personalization.