Adobe empfiehlt die Verwendung des SPA-Editors für Projekte, für die ein frameworkbasiertes clientseitiges 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. Darüber hinaus wird in diesem Abschnitt beschrieben, wie Sie die Funktion Deep-Linking für Push-Benachrichtigungen konfigurieren.
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 einen Push-Vorgang von weniger als einer Sekunde 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 von Benachrichtigungen und Geräten 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 (den Push Notification Service (APNS) von Apple 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 iOS- und Android-Mobilgeräte.
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:
Gehen Sie zur Apple-Seite hier , um sich mit dem Apple Push Notification Service vertraut zu machen.
Um APNS zu verwenden, benötigen Sie eine Certificate-Datei (eine .cer-Datei), einen Push-Schlüssel Private Key (eine .p12-Datei) und ein Private Key Password von Apple. Anweisungen dazu finden Sie hier.
Google ersetzt GCM durch einen ähnlichen Dienst namens Firebase Cloud Messaging (FCM). Klicken Sie für weitere Informationen zu FCM hier.
Gehen Sie zur Google-Seite hier , um sich mit Google Cloud Messaging für Android vertraut zu machen.
Führen Sie die Schritte hier zu Erstellen Sie ein Google API-Projekt, Aktivieren Sie den GCM-Dienst und Erhalten Sie einen API-Schlüssel. Sie benötigen den API-Schlüssel, um Push-Benachrichtigungen an Android-Geräte zu senden. Zeichnen Sie auch Ihre Projektnummer auf, die manchmal auch als GCM Sender Id bezeichnet wird.
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 ** Pushwooshs-Konfigurationen ermöglichen den Versand von Push-Benachrichtigungen von AEM Bildschirmen aus.
Mit der Konfiguration von Adobe Mobile Services können Sie Push-Benachrichtigungen in 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 einen Link zur Erstellung eines neuen AWS-Kontos finden Sie hier. Sie erhalten ein kostenloses Konto für ein Jahr.
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 aus (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 Platform-Anwendungen 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=" 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 dem iOS Developer Program beitreten. 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 der App), müssen Sie zunächst das Telefon in den "Entwicklermodus"stellen. Weitere Informationen dazu finden Sie unter Aktivieren der Entwickleroptionen auf dem Gerät .
Vor der Erstellung und Bereitstellung auf Ihrem konfigurierten Mobilgerät müssen Sie die Benachrichtigungseinstellungen für den gewünschten Messaging-Dienst konfigurieren.
Hinweis: Siehe auch unsere Anweisungen 🔗 hier 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. Aktuelle Mac-/PC-Hardware und Emulatoren unterstützen dies nicht.
PhoneGap Builder ist ein von PhoneGap angebotener Dienst, mit dem Ihre App auf ihren Servern erstellt und direkt auf Ihr Gerät heruntergeladen werden kann. Weitere Informationen zum Einrichten und Verwenden von PhoneGap Build finden Sie in der PhoneGap Build-Dokumentation .
Mit der PhoneGap-Befehlszeilenschnittstelle (CLI) können Sie eine umfangreiche Reihe von PhoneGap-Befehlen in Ihrer Befehlszeile verwenden, um Ihre App zu erstellen, zu debuggen und bereitzustellen. Informationen zum Einrichten und Verwenden der PhoneGap-CLI finden Sie in der PhoneGap-Entwicklerdokumentation .
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 iOS- und Android-Push-Benachrichtigungen 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 von AWS- und Pushwoosh-AEM-Benachrichtigungen bereitgestellten 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 einen Push-Vorgang von weniger als einer Sekunde 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 auf die Bearbeitung oben rechts in der Kachel Cloud Services verwalten .
Wählen Sie die Pushwoosh-Verbindung aus. Klicken Sie auf Weiter.
Geben Sie die Details der Eigenschaften ein und klicken Sie auf Submit.
Wenn Sie Ihre Konfiguration übermitteln, wird im Dashboard die Kachel Push-Benachrichtigungen angezeigt.
Sobald die Kachel Push-Benachrichtigungen in Ihrem Dashboard angezeigt wird, verwenden Sie den Assistenten "Benachrichtigung erstellen", um den Inhalt hinzuzufügen:
Klicken Sie auf das Symbol zum Hinzufügen oben rechts in der Kachel Push-Benachrichtigungen , um den Assistenten für Benachrichtigungserstellung erstellen zu öffnen.
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 in den Benachrichtigungsassistenten erstellen ein und klicken Sie auf Erstellen.
Öffnen Sie die Details, indem Sie auf die von Ihnen erstellte Push-Benachrichtigung in der Kachel Push-Benachrichtigungen klicken.
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, finden Sie weitere Informationen unter AEM Mobile Content Personalization.