DocumentazioneAEMGuida di AEM Screens

Configurazione di ContextHub in AEM Screens configuring-contexthub-in-aem-screens

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Intermedio
  • Sviluppatore

In questa sezione viene posto l’accento sulla creazione e la gestione delle modifiche alle risorse basate sui dati tramite un archivio dati.

Termini chiave key-terms

Prima di entrare nei dettagli della creazione e della gestione dei canali basati sull’inventario nel progetto AEM Screens, scopri alcuni dei termini chiave dei diversi scenari.

Marchio - Descrizione del progetto di alto livello.

Area - Il nome del progetto AEM Screens, ad esempio Digital Ad Signage

Attività - Definisce le regole di categoria, ad esempio Basate su inventario, Meteo o Basate sulla disponibilità del reparto.

Pubblico - Definisce la regola.

Segmento: versione di una risorsa da riprodurre per la regola specificata. Ad esempio, se la temperatura è inferiore a 50 gradi Fahrenheit, sullo schermo viene visualizzata l’immagine di una bevanda calda, altrimenti di una bevanda fredda.

Il diagramma seguente fornisce una rappresentazione visiva del modo in cui le configurazioni di ContextHub coincidono con attività, pubblico e canali.

schermata_shot_2019-05-29at53729pm

Precondizioni preconditions

Prima di iniziare a configurare le configurazioni ContextHub per un progetto AEM Screens, imposta i fogli Google (a scopo dimostrativo).

IMPORTANT
Nell’esempio seguente, i fogli di Google vengono utilizzati come database di esempio dal quale vengono recuperati i valori, a scopo puramente didattico. L’Adobe non prevede l’utilizzo di Google Sheets per ambienti di produzione.
Per ulteriori informazioni, consulta Ottenere la chiave API nella documentazione di Google.

Passaggio 1: configurazione di un archivio dati step-setting-up-a-data-store

È possibile impostare l'archivio dati come evento di I/O locale o come evento di database locale.

L’esempio seguente, relativo ai trigger di dati a livello di risorsa, mostra un evento di database locale. L’evento configura un archivio dati, ad esempio un foglio Excel, che consente di utilizzare le configurazioni ContextHub e il percorso dei segmenti per il canale AEM Screens.

Dopo aver configurato correttamente il foglio google, come illustrato nell'esempio seguente:

immagine

La convalida seguente è quella visualizzata quando si controlla la connessione immettendo i due valori *google sheet ID* e *API key* nel formato seguente:

https://sheets.googleapis.com/v4/spreadsheets/<your sheet id>/values/Sheet1?key=<your API key>

immagine

NOTE
L’esempio specifico seguente mostra i fogli di Google come archivio dati che attiva una modifica della risorsa se il valore è maggiore di 100 o minore di 50.

Passaggio 2: configurazione dell’archivio step-setting-store-configurations

  1. Accesso a ContextHub

    Passa all’istanza AEM e fai clic sull’icona Strumenti nella barra laterale a sinistra. Fai clic su Sites > ContextHub, come illustrato nella figura seguente.

    immagine

  2. Creazione di una configurazione archivio ContextHub

    1. Passa al contenitore di configurazione con titolo schermate.

    2. Fai clic su Crea > Crea contenitore configurazione e immetti il titolo come ContextHubDemo.

      immagine

    3. Passa a ContextHubDemo > Crea Configurazione ContentHub e fai clic su Salva.

      note note
      NOTE
      Dopo aver fatto clic su Salva, sei nella schermata Configurazione ContextHub.

    4. Dalla schermata Configurazione ContextHub, fai clic su Crea > Configurazione archivio ContentHub

    immagine

    note caution
    CAUTION
    Come parte del Feature Pack 4 per AEM 6.5 o del Feature Pack 8 per AEM 6.4, i clienti devono aggiornare /conf/screens/settings/cloudsettings a sling:Folder.
    Effettua le seguenti operazioni:
    1. Passare a CRXDE Lite e quindi a /conf/screens/settings/cloudsettings.
    2. Verifica se cloudsettings jcr:primaryType si trova in sling:Folder. Se jcr:primaryType non è in sling:folder, procedere con i passaggi successivi.
    3. Fare clic con il pulsante destro del mouse su /conf/screens/settings, creare un nodo con name come cloudsettings1 e Type come sling:Folder e salvare le modifiche.
    4. Sposta tutti i nodi in /conf/screens/settings/cloudsettings in cloudsettings1.
    5. Elimina cloudsettings e salva.
    6. Rinomina cloudsettings1 in cloudsettings e salva.
    7. Osservare che /conf/screens/settings/cloudsettings ha jcr:primaryType come sling:Folder.
    Segui questi passaggi in Author e Publish prima o dopo l’aggiornamento.

    1. Immetti il Titolo come Fogli Google, Nome archivio come googlesheets e Tipo archivio come contexthub.generic-jsonp e fai clic su Avanti.

      note caution
      CAUTION
      Se si utilizza Adobe Experience Manager (AEM) 6.4, immettere Titolo configurazione come googlesheets e Tipo archivio come contexthub.generic-jsonp.

      immagine

    2. Immetti la configurazione JSON specifica. Ad esempio, puoi utilizzare il seguente codice JSON a scopo dimostrativo e fare clic su Salva. Nella configurazione ContextHub è presente la configurazione dell'archivio con titolo Fogli Google.

      note important
      IMPORTANT
      Assicurarsi di sostituire il codice con *<Sheet ID>* e *<API Key>* recuperati durante la configurazione dei fogli di Google.
      code language-none 
       {
  "service": {
  "host": "sheets.googleapis.com",
  "port": 80,
  "path": "/v4/spreadsheets/<your google sheets id>/values/Sheet1",
  "jsonp": false,
  "secure": true,
  "params": {
  "key": "<your Google API key>"
 }
},
"pollInterval": 10000
}
      note note
      NOTE
      Nel codice di esempio precedente, pollInterval definisce la frequenza di aggiornamento dei valori (in millisecondi).
      Sostituisci il codice con *<Sheet ID>* e *<API Key>* recuperati durante la configurazione dei fogli di Google.
      note caution
      CAUTION
      Se crei i fogli Google per memorizzare le configurazioni al di fuori della cartella globale (ad esempio, nella tua cartella di progetto), il targeting non funziona come previsto.

  3. Impostazione della segmentazione dell'archivio

    1. Passa a Configurazione archivio ContentHub e crea un'altra configurazione archivio nel contenitore di configurazione AEM Screens e imposta Titolo come segmentation-contexthub, Nome archivio come segmentation e Tipo archivio come aem.segmentation.

      immagine

    2. Fai clic su Avanti e quindi su Salva.

      note note
      NOTE
      Ignora il processo di definizione del codice JSON e lascialo vuoto.

Passaggio 3: Impostazione dei segmenti in Audience setting-up-audience

  1. Creazione di segmenti in tipi di pubblico

    1. Passa dall'istanza AEM a Personalization > Tipi di pubblico > Schermi.

    2. Fai clic su Crea > Crea segmento ContextHub. Viene visualizzata la finestra di dialogo Nuovo segmento ContextHub.

    3. Immetti Titolo come **Higherthan50** e fai clic su Crea. Allo stesso modo, crea un altro segmento con titolo **Lowerthan50**.

      immagine

    4. Fai clic sul segmento **Higherthan50** e fai clic su Proprietà nella barra delle azioni.

      immagine

    5. Fai clic sulla scheda Personalization dalle Proprietà segmento. Imposta Percorso ContextHub su /conf/screens/settings/cloudsettings/ContextHubDemo/contexthub configurations e Percorso segmenti su /conf/screens/settings/wcm/segments e fai clic su Salva, come illustrato nella figura seguente.

    immagine

    1. Analogamente, impostare Percorso ContextHub e Percorso segmenti anche per il segmento **Lowerthan50**.

Passaggio 4: configurazione di marchio e area setting-brand-area

Segui i passaggi seguenti per creare un marchio nelle attività e nelle aree sotto il marchio:

  1. Creazione di un marchio nelle attività

    1. Passa dall'istanza AEM a Personalization > Attività.

    2. Fai clic su Crea > Crea marchio.

    3. Fare clic su Marchio dalla procedura guidata Crea pagina e fare clic su Avanti.

    4. Immetti Titolo come ScreensBrand e fai clic su Crea. Il brand viene ora creato come mostrato di seguito.

      immagine

      note caution
      CAUTION
      Problema noto:
      Per aggiungere un’area, rimuovi l’elemento principale dall’URL, ad esempio
      http://localhost:4502/libs/cq/personalization/touch-ui/content/v2/activities.html/content/campaigns/screensbrand/master.

  2. Creazione di un'area nel tuo marchio

    Per creare un’area nel brand, segui i passaggi seguenti:

    1. Fare clic su Crea e quindi su Crea area.

      immagine

    2. Fare clic su Area dalla procedura guidata Crea pagina e fare clic su Avanti.

    3. Immetti Titolo come ValoreSchermi e fai clic su Crea.
      Nel tuo marchio viene creata un’area.

Passaggio 5: Creazione dei segmenti in un’attività step-setting-up-audience-segmentation

Dopo aver configurato un archivio dati e definito l’attività (marchio e area), segui i passaggi riportati di seguito per creare segmenti nell’attività.

  1. Creazione di segmenti nelle attività

    1. Passa dall'istanza AEM a Personalization > Attività > ScreensBrand >ScreensValue.

    2. Fai clic su Crea > Crea attività. Viene aperta la Configurazione guidata attività.

    3. Immetti il Titolo come ValueCheck50 e Nome come valuecheck50. Fai clic sul motore di targeting come ContextHub (AEM) dal menu a discesa e fai clic su Avanti.

      immagine

    4. Fare clic su Aggiungi esperienza dalla procedura guidata **Configure Activity**.

    5. Da Tipi di pubblico, fai clic su **Higherthan50**, quindi su Aggiungi esperienza e immetti Titolo come **higherthan50** Nome come **higherthan50**. Fare clic su Ok.

    6. Da Tipi di pubblico, fai clic su **Lowerthan50**, quindi su Aggiungi esperienza e immetti Titolo come **lowerthan50** Nome come **lowerthan50**. Fare clic su Ok.

    immagine

    1. Fai clic su Avanti e quindi su Salva. L'attività **ValueCheck50** è stata creata e configurata.

      immagine

Passaggio 5: modificare i segmenti in Audiences editing-audience-segmentation

  1. Modifica dei segmenti

    1. Passa dall'istanza AEM a Personalization > Tipi di pubblico > Schermi.

    2. Fai clic sul segmento **Higherthan50** e fai clic su Modifica nella barra delle azioni.

    3. Trascina e rilascia il componente Comparison: Property - Value nell'editor.

    4. Fare clic sull'icona chiave inglese per aprire la finestra di dialogo Confronto di una proprietà con il valore.

    5. Fare clic su googlesheets/value/1/0 dal menu a discesa in Nome proprietà.

      note note
      NOTE
      I fogli di Google Analytics/value/1/0 fanno riferimento alla riga 2 e alla colonna compilate in google fogli nella figura seguente:

      immagine

    6. Fare clic su Operatore come maggiore di dal menu a discesa.

    7. Immetti Valore come 70.

      note note
      NOTE
      L’AEM convalida i dati dal foglio Google mostrando il segmento in verde.

      immagine

    Analogamente, modificare i valori della proprietà in **Lowerthan50**.

    1. Trascina e rilascia il componente Comparison: Property - Value nell'editor.

    2. Fai clic sull’icona a forma di chiave inglese.

    3. Nella finestra di dialogo Confronto di una proprietà con valore, fare clic su googlesheets/value/1/0 dall'elenco a discesa in Nome proprietà.

    4. Fare clic su Operatore come minore di dal menu a discesa.

    5. Immetti Valore come 50.

Abilitazione del targeting nei canali step-enabling-targeting-in-channels

Segui i passaggi seguenti per abilitare il targeting nei tuoi canali.

  1. Passa a uno dei canali di AEM Screens. Nei passaggi seguenti viene illustrato come abilitare il targeting utilizzando DataDrivenChannel creato in un canale AEM Screens.

  2. Fai clic sul canale TargetChannel e fai clic su Proprietà nella barra delle azioni.

    immagine

  3. Fai clic sulla scheda Personalization per configurare le configurazioni di ContextHub.

    1. Impostare Percorso ContextHub su /conf/screens/settings/wcm/segments e Percorso segmenti su /conf/screens/settings/wcm/segments.

    2. Imposta brand su ScreensBrand dal menu a discesa e Imposta riferimento area su ScreensValue.

    3. Fai clic su Salva e chiudi.

      note note
      NOTE
      Utilizza ContextHub e il percorso Segmenti, dove hai inizialmente salvato le configurazioni e i segmenti ContextHub.

      immagine

    4. Passa al canale TargetChannel e fai clic su Modifica nella barra delle azioni.

      note note
      NOTE
      Se hai impostato tutto correttamente, puoi visualizzare l'opzione Targeting nell'elenco a discesa dall'editor, come illustrato nella figura seguente.

      immagine

Ulteriori informazioni: casi di utilizzo di esempio learn-more-example-use-cases

Dopo aver configurato ContextHub per il progetto AEM Screens, puoi seguire i diversi casi d’uso per comprendere in che modo le risorse attivate dai dati svolgono un ruolo fondamentale in diversi settori:

  1. Attivazione con targeting inventario vendita al dettaglio
  2. Attivazione temperatura centro di viaggio
  3. Attivazione prenotazione ospitalità
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053