Adobe empfiehlt die Verwendung des SPA-Editors für Projekte, die ein Framework-basiertes clientseitiges Rendering von Einzelseiten-Apps erfordern (z. B. React). Weitere Informationen
Die Möglichkeit, Ihre Adobe Experience Manager-Nutzer (AEM) mit wichtigen Benachrichtigungen sofort zu benachrichtigen, ist für den Wert einer App und ihrer Marketingkampagnen von entscheidender Bedeutung. Hier werden die Schritte beschrieben, die ausgeführt werden müssen, damit Ihre App Push-Benachrichtigungen erhalten kann. Außerdem erfahren Sie, wie Sie Push-Benachrichtigungen von AEM Mobile an die am Telefon installierte App konfigurieren und senden. In diesem Abschnitt wird außerdem beschrieben, wie Sie die Deep-Linking -Funktion für Ihre Push-Benachrichtigungen verwenden.
Push-Benachrichtigungen werden nicht garantiert, sondern ähneln eher Mitteilungen. Es wird alles daran gesetzt, sicherzustellen, dass jeder sie erhält, aber nicht der garantierte Bereitstellungsmechanismus ist. 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 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 Mobilbetriebssystem den entsprechenden Dienst durchlaufen: Apple Push Notification Service (APNS) für iOS-Geräte 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 die Push-Benachrichtigung 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 Experience Manager-Entwickler Folgendes aus:
Ein Experience Manager-Administrator führt Folgendes aus:
Navigieren Sie zur Apple-Seite here , um sich mit dem Apple Push Notification Service vertraut zu machen.
Um APNs zu verwenden, 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 hierzu finden Sie unter 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 nach Erstellen eines Google-API-Projekts, Aktivieren des GCM-Dienstes, und API-Schlüssel abrufen. 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 den Versand von Push-Benachrichtigungen in AEM Bildschirmen.
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 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 ähnlich und hier beschrieben:
Thema erstellen
Sie können mehrere Themen für verschiedene Szenarien wie Entwicklung, Test und Demo 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. Andere Felder müssen ausgefüllt werden:
Wiederholen Sie den obigen Schritt 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": "2012-10-17", "Aussage": [ { "Aktion": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Effect": "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
App erstellen
Wenn eine zweite App in AEM mit derselben App-ID konfiguriert ist (und andere zugehörige Werte: 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://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"/>
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:
Unter 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.
Bei Push-Benachrichtigungen müssen Sie auf einem eigentlichen Gerät testen, da Emulatoren keine Push-Benachrichtigungen empfangen können.
Verwenden Sie für iOS einen macOS-Computer und schließen Sie die 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 die 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 gewünschten Messaging-Dienst konfigurieren.
Hinweis: Siehe 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 PhoneGap Build-Dokumentation unter https://build.phonegap.com/
, 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. Weitere Informationen finden Sie in der PhoneGap-Entwicklerdokumentation (https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface
), um zu erfahren, wie Sie PhoneGap CLI einrichten und verwenden.
Gehen Sie wie folgt vor, um eine Benachrichtigung zu erstellen und zu senden.
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. Wenn ein Fehler auftritt, 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, sondern ähneln eher Mitteilungen. 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. "Anzeigen!"). 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 Verwerfen klicken, wird die Nachricht ausgeschlossen.
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 werden die Deep-Link-Schaltflächen je nach Konfiguration 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 Service verwalten Kachel.
Wählen Sie die Push-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 die Push-Benachrichtigungen in Ihrem Dashboard angezeigt werden, verwenden Sie den Assistenten zur Erstellung von Benachrichtigungen, um den Inhalt hinzuzufügen:
Klicken Sie auf das Symbol zum Hinzufügen oben rechts im Push-Benachrichtigungen -Kachel zum Öffnen der 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 Erstellen.
Öffnen Sie die Details, indem Sie auf die Push-Benachrichtigung klicken, die Sie über das 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.