Incorporare un’applicazione REACT utilizzando l’editor SPA dell’AEM e Integrare con AEM Screens Analytics embedding-a-react-application-using-the-aem-spa-editor-and-integrating-with-aem-screens-analytics

Puoi incorporare un’applicazione interattiva a pagina singola utilizzando REACT (o Angular). A tale scopo, utilizza l’editor SPA dell’AEM configurato dai professionisti del settore AEM. Scopri anche come integrare l’applicazione interattiva con Adobe Analytics offline.

Utilizzo dell’Editor SPA dell’AEM using-the-aem-spa-editor

Per utilizzare l’Editor SPA dell’AEM, segui la procedura riportata di seguito:

  1. Clona l'archivio dell'editor SPA AEM all'indirizzo https://github.com/adobe/aem-spa-project-archetype.

    note note
    NOTE
    Questo archetipo crea un progetto Adobe Experience Manager minimo come punto di partenza per i tuoi progetti SPA. Le proprietà che devono essere fornite quando si utilizza questo archetipo consentono di denominare come desiderato tutte le parti del progetto.
  2. Per creare un progetto dell’archetipo dell’editor SPA dell’AEM, segui le istruzioni riportate di seguito:

    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 questa documentazione viene utilizzato GroupId come com.adobe.aem.screens e ArtifactId come My Sample SPA (valori predefiniti). Puoi scegliere il tuo, se necessario.
  3. Dopo la creazione del progetto, utilizza un IDE o un editor a tua scelta e importa il progetto Maven generato.

  4. Distribuisci nell'istanza AEM locale utilizzando il comando mvn clean install -PautoInstallPackage.

Modifica di contenuti nell’app REACT editing-content-in-the-react-app

Per modificare i contenuti nell’app REACT:

  1. Passa a https://localhost:4502/editor.html/content/mysamplespa/en/home.html (sostituisci il nome host, la porta e il nome del progetto come applicabile).
  2. Possibilità di modificare il testo visualizzato nell'applicazione Hello World.

Aggiunta dell’app REACT interattiva ad AEM Screens adding-the-interactive-react-app-to-aem-screens

Per aggiungere l’app REACT interattiva ad AEM Screens, segui i passaggi seguenti:

  1. Crea un progetto AEM Screens. Per ulteriori dettagli, vedere Creazione e gestione di progetti.

  2. Crea un Canale applicazione (preferibilmente) (o un modello 1x1 o un canale multizona) nella cartella Canali del progetto AEM Screens.

    note note
    NOTE
    I canali della sequenza sono sconsigliati per questo caso d'uso perché hanno una logica di presentazione intrinseca in conflitto con la natura interattiva dell'esperienza.
    Per ulteriori dettagli, vedere Creazione e gestione dei canali.
  3. Modifica un canale di sequenza e trascina e rilascia un componente di pagina incorporato.

    Per ulteriori dettagli, vedere Aggiunta di componenti a un canale.

    note note
    NOTE
    Assicurati di aggiungere l’evento di interazione dell’utente quando assegni il canale alla visualizzazione.
  4. Fai clic su Modifica nella barra delle azioni per modificare le proprietà del canale.

    schermata_shot_2019-02-15at100555am

  5. Trascina e rilascia il componente Pagina incorporata o riutilizza il componente esistente in un canale dell'applicazione, quindi fai clic sulla home page sotto l'applicazione mysamplespa, ad esempio /content/mysamplespa/en/home.

    schermata_shot_2019-02-15at101104am

  6. Assegna il canale a una visualizzazione.

    note note
    NOTE
    Assicurati di aggiungere l’evento di interazione dell’utente quando assegni il canale alla visualizzazione.
  7. Registra un lettore per questo progetto e assegnalo al display. Ora puoi vedere la tua applicazione interattiva in esecuzione su AEM Screens.

    Per ulteriori informazioni sulla registrazione di un dispositivo, vedere Registrazione dispositivo.

Integrazione dell’SPA con Adobe Analytics con funzionalità offline tramite AEM Screens integrating-the-spa-with-adobe-analytics-with-offline-capability-through-aem-screens

Segui i passaggi seguenti per integrare l’SPA con Adobe Analytics con funzionalità offline tramite AEM Screens:

  1. Configurare Adobe Analytics in AEM Screens.

    Consulta Configurazione di Adobe Analytics con AEM Screens per ulteriori informazioni su come eseguire la sequenza in Adobe Analytics con AEM Screens e inviare eventi personalizzati utilizzando offline Adobe Analytics.

  2. Modifica l’app React nell’IDE/editor che preferisci (in particolare il componente testo o un altro componente da cui vuoi iniziare a emettere eventi).

  3. Aggiungi le informazioni di analisi utilizzando il modello dati standard all’evento di clic o all’altro evento che desideri acquisire per il componente.

    Per ulteriori dettagli, vedere Configurazione di Adobe Analytics con AEM Screens.

  4. Chiama l’API di AEM Screens Analytics in modo da poter salvare l’evento offline e inviarlo in modalità Burst ad Adobe Analytics.

    Ad esempio:

    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
    Il firmware del lettore aggiunge automaticamente ulteriori dettagli sul lettore e sul relativo ambiente di runtime ai dati di analisi personalizzati inviati. Di conseguenza, potrebbe essere necessario acquisire i dettagli relativi al sistema operativo/dispositivo di basso livello, se non necessario. Concentrati sui dati di analisi aziendale.
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053