Einbetten einer REACT-Anwendung mit dem AEM SPA Editor und Integration mit AEM Screens Analytics embedding-a-react-application-using-the-aem-spa-editor-and-integrating-with-aem-screens-analytics
Sie können eine interaktive Einzelseitenanwendung mit REACT (oder Angular) einbetten. Verwenden Sie dazu den AEM SPA-Editor, der von Geschäftsexperten in AEM konfiguriert wird. Sie können auch lernen, wie Sie Ihre interaktive Anwendung mit Offline-Adobe Analytics integrieren.
Verwenden des AEM SPA Editors using-the-aem-spa-editor
Gehen Sie wie folgt vor, um den AEM SPA Editor zu verwenden:
-
Klonen Sie die AEM SPA Editor-Repo unter https://github.com/adobe/aem-spa-project-archetype.
note note NOTE Dieser Archetyp erstellt ein Adobe Experience Manager-Projekt mit minimalen Umfang als Ausgangspunkt für Ihre eigenen SPA-Projekte. Die Eigenschaften, die bei Verwendung dieses Archetyps angegeben werden müssen, ermöglichen es Ihnen, alle Teile dieses Projekts beliebig zu benennen. -
Gehen Sie wie folgt vor, um ein AEM Archetypprojekt SPA Editor zu erstellen:
code language-none mvn clean install archetype:update-local-catalog mvn archetype:crawl mvn archetype:generate \ -DarchetypeCatalog=internal \ -DarchetypeGroupId=com.adobe.cq.spa.archetypes \ -DarchetypeArtifactId=aem-spa-project-archetype \ -DarchetypeVersion=1.0.3-SNAPSHOT \
note note NOTE Diese Dokumentation verwendet die GroupId as com.adobe.aem.screens und ArtifactId as Meine SPA (Standardeinstellung). Sie können nach Bedarf Ihre eigenen Parameter auswählen. -
Nachdem das Projekt erstellt wurde, verwenden Sie entweder eine IDE oder einen Editor Ihrer Wahl und importieren Sie das generierte Maven-Projekt.
-
Stellen Sie in Ihrer lokalen AEM-Instanz mit dem Befehl mvn clean install -PautoInstallPackage bereit.
Bearbeiten von Inhalten in der REACT-App editing-content-in-the-react-app
Bearbeiten von Inhalten in der REACT-App:
- Navigieren Sie zu
https://localhost:4502/editor.html/content/mysamplespa/en/home.html
(ersetzen Sie ggf. den Hostnamen, Port und Projektnamen). - Sie sollten den Text bearbeiten können, der in der Anwendung „Hello World“ angezeigt wird.
Hinzufügen der interaktiven REACT-App zu AEM Screens adding-the-interactive-react-app-to-aem-screens
Gehen Sie wie folgt vor, um die interaktive REACT-App zu AEM Screens hinzuzufügen:
-
Erstellen Sie ein AEM Screens-Projekt. Siehe Erstellen und Verwalten von Projekten für weitere Details.
-
Erstellen Sie eine Anwendungskanal (vorzugsweise) (oder 1x1-Vorlage oder Mehrzonen-Kanal) im Kanäle Ordner Ihres AEM Screens-Projekts.
note note NOTE Sequenzkanäle für diesen Anwendungsfall nicht empfohlen werden, da sie von Natur aus mit einer Diashow-Logik im Konflikt mit der interaktiven Natur des Erlebnisses stehen.
Siehe Erstellen und Verwalten von Kanälen für weitere Details. -
Bearbeiten Sie einen beliebigen Sequenzkanal und ziehen Sie eine eingebettete Seitenkomponente per Drag-and-Drop.
Siehe Hinzufügen von Komponenten zu Kanälen für weitere Details.
note note NOTE Stellen Sie sicher, dass Sie beim Zuweisen des Kanals zur Anzeige das Benutzerinteraktionsereignis hinzufügen. -
Klicks Bearbeiten in der Aktionsleiste, damit Sie die Eigenschaften des Kanals bearbeiten können.
-
Ziehen Sie die Eingebettete Seite Komponente verwenden oder die vorhandene Komponente in einem Anwendungskanal wiederverwenden und auf die Startseite unter der Anwendung mysamplespa klicken, z. B. /content/mysamplespa/en/home.
-
Weisen Sie den Kanal einer Anzeige zu.
note note NOTE Stellen Sie sicher, dass Sie beim Zuweisen des Kanals zur Anzeige das Benutzerinteraktionsereignis hinzufügen. -
Registrieren Sie einen Player für dieses Projekt, und weisen Sie ihn der Anzeige zu. Jetzt sollte Ihre interaktive Anwendung in AEM Screens ausgeführt werden.
Siehe Geräteregistrierung für weitere Informationen zur Registrierung eines Geräts.
Integrieren der SPA mit Adobe Analytics mit Offline-Funktionen über AEM Screens integrating-the-spa-with-adobe-analytics-with-offline-capability-through-aem-screens
Gehen Sie wie folgt vor, um die SPA mit Adobe Analytics mit Offline-Funktionen über AEM Screens zu integrieren:
-
Konfigurieren Sie Adobe Analytics in AEM Screens.
Siehe Konfigurieren von Adobe Analytics mit AEM Screens Weitere Informationen zum Ausführen der Sequenzierung in Adobe Analytics mit AEM Screens und zum Senden benutzerdefinierter Ereignisse mit Offline-Adobe Analytics.
-
Bearbeiten Sie Ihre React-App in der IDE/dem Editor Ihrer Wahl (insbesondere die Textkomponente oder eine andere Komponente, die Sie zum Ausgeben von Ereignissen verwenden möchten).
-
Fügen Sie beim Klick- oder anderen Ereignis, das Sie für Ihre Komponente erfassen möchten, die Analyseinformationen mit dem Standarddatenmodell hinzu.
Siehe Konfigurieren von Adobe Analytics mit AEM Screens für weitere Details.
-
Rufen Sie die AEM Screens Analytics-API auf, damit Sie das Ereignis offline speichern und in Bursts an Adobe Analytics senden können.
Beispiel:
code language-none handleClick() { if ((window.parent) && (window.parent.CQ) && (window.parent.CQ.screens) && (window.parent.CQ.screens.analytics)) { var analyticsEvent = {}; analyticsEvent['event.type'] = 'play'; // Type of event analyticsEvent['event.coll_dts'] = new Date().toISOString(); // Start of collecting the event analyticsEvent['event.dts_start'] = new Date().toISOString(); // Event start analyticsEvent['content.type'] = 'Washing machine'; // Mime Type or product category analyticsEvent['content.action'] = 'Path to the washing machine asset in AEM'; // Path in AEM to relevant asset analyticsEvent['trn.product'] = 'Washing machine Model number'; // Product being explored analyticsEvent['trn.amount'] = 1000; // Product pricing or other numeric value or weight analyticsEvent['event.dts_end'] = new Date().toISOString(); // Event end analyticsEvent['event.count'] = 100; // Numeric value that may count a number of clicks or keystrokes or wait time in seconds for example analyticsEvent['event.value'] = 'My favorite analytics event'; analyticsEvent['trn.quantity'] = 10; // Quantity of product selection analyticsEvent['event.subtype'] = 'end'; // Event subtype if applicable window.parent.CQ.screens.analytics.sendTrackingEvent(analyticsEvent); } }
note note NOTE Die Player-Firmware fügt den gesendeten benutzerspezifischen Analysedaten automatisch weitere Details zum Player und seiner Laufzeitumgebung hinzu. Daher müssen Sie möglicherweise Details zu Betriebssystemen und Geräten auf niedriger Ebene erfassen, sofern dies nicht erforderlich ist. Konzentrieren Sie sich auf die Geschäftsanalysedaten.