Een REACT-toepassing insluiten met de AEM SPA Editor en integreren met AEM Screens Analytics embedding-a-react-application-using-the-aem-spa-editor-and-integrating-with-aem-screens-analytics
U kunt een interactieve toepassing van één pagina insluiten met REACT (of Angular). U doet dit door de AEM SPA redacteur te gebruiken die door bedrijfsberoeps in AEM wordt gevormd. U kunt ook leren hoe u uw interactieve toepassing kunt integreren met offline Adobe Analytics.
De AEM SPA Editor gebruiken using-the-aem-spa-editor
Voer de onderstaande stappen uit om de AEM SPA Editor te gebruiken:
-
De AEM SPA Editor-reactie klonen op https://github.com/adobe/aem-spa-project-archetype.
note note NOTE Dit archetype leidt tot een minimaal project van Adobe Experience Manager als uitgangspunt voor uw eigen SPA projecten. Met de eigenschappen die moeten worden opgegeven bij het gebruik van dit archetype kunt u naar wens alle onderdelen van dit project benoemen. -
Als u een archetype-project voor een AEM SPA editor wilt maken, volgt u de leesmij-instructies:
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 In deze documentatie worden de GroupId als com.adobe.aem.screens en de ArtifactId als Mijn SPA (dit zijn de standaardwaarden). U kunt zo nodig uw eigen keuze maken. -
Zodra het project wordt gecreeerd, of gebruik winde of redacteur van uw keus en voer het geproduceerde Geweven project in.
-
Distribueren naar uw lokale AEM met de opdracht mvn clean install -PautoInstallPackage.
Inhoud bewerken in de REACT-app editing-content-in-the-react-app
De inhoud bewerken in de REACT-app:
- Navigeren naar
https://localhost:4502/editor.html/content/mysamplespa/en/home.html
(vervang de hostnaam, poort en projectnaam, indien van toepassing). - U zou de tekst moeten kunnen uitgeven die in de Hello wereldtoepassing wordt getoond.
De interactieve REACT-app toevoegen aan AEM Screens adding-the-interactive-react-app-to-aem-screens
Voer de onderstaande stappen uit om de interactieve REACT-app aan AEM Screens toe te voegen:
-
Maak een AEM Screens-project. Zie Projecten maken en beheren voor meer informatie .
-
Een Toepassingskanaal (bij voorkeur) (of 1x1-sjabloon of multikanaalskanaal) in het dialoogvenster Kanalen map van uw AEM Screens-project.
note note NOTE Kanalen volgreeks worden afgeraden voor dit gebruiksgeval, omdat deze van nature een diapresentatielogica hebben die conflicteert met de interactieve aard van de ervaring.
Zie Kanalen maken en beheren voor meer informatie . -
Bewerk een willekeurig volgnummer en sleep en zet een ingesloten pagina-component neer.
Zie Componenten toevoegen aan een kanaal voor meer informatie .
note note NOTE Voeg de gebruikersinteractiegebeurtenis toe wanneer u het kanaal toewijst aan de weergave. -
Klikken Bewerken in de actiebalk, zodat u de eigenschappen van het kanaal kunt bewerken.
-
Sleep de Ingesloten pagina of hergebruik de bestaande component in een toepassingskanaal en selecteer bijvoorbeeld de startpagina onder de mysamplespa-toepassing. /content/mysamplespa/nl/home.
-
Wijs het kanaal toe aan een weergave.
note note NOTE Voeg de gebruikersinteractiegebeurtenis toe wanneer u het kanaal toewijst aan de weergave. -
Registreer een speler tegen dit project en wijs het aan de vertoning toe. U moet nu de interactieve toepassing kunnen zien die op AEM Screens wordt uitgevoerd.
Zie Apparaatregistratie voor meer informatie over het registreren van een apparaat.
De SPA integreren met Adobe Analytics met offlinemogelijkheden via AEM Screens integrating-the-spa-with-adobe-analytics-with-offline-capability-through-aem-screens
Volg de onderstaande stappen om de SPA met Adobe Analytics te integreren met offline mogelijkheden via AEM Screens:
-
Adobe Analytics configureren in AEM Screens.
Zie Adobe Analytics configureren met AEM Screens voor meer informatie over het uitvoeren van opeenvolging in Adobe Analytics met AEM Screens en het verzenden van douanegebeurtenissen die off-line Adobe Analytics gebruiken.
-
Bewerk uw reactie-app in de IDE/editor van uw keuze (met name de tekstcomponent of andere component die u wilt gebruiken om gebeurtenissen uit te zenden).
-
Voeg bij de klikgebeurtenis of andere gebeurtenis die u voor uw component wilt vastleggen de analysegegevens toe met behulp van het standaardgegevensmodel.
Zie Adobe Analytics configureren met AEM Screens voor meer informatie .
-
Roep de AEM Screens Analytics API aan, zodat u de gebeurtenis offline kunt opslaan en in bursts naar Adobe Analytics kunt verzenden.
Bijvoorbeeld:
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 De spelerfirmware voegt automatisch meer informatie over de speler en de bijbehorende runtimeomgeving toe aan de aangepaste analysegegevens die u verzendt. Daarom moet u mogelijk, tenzij nodig, details van het besturingssysteem of het apparaat op laag niveau vastleggen. Focus op de bedrijfsanalysegegevens.