Importazione dei dati di esempio in Adobe Experience Platform

Scopri come impostare un ambiente sandbox di Experience Platform con alcuni dati di esempio. Utilizzando una raccolta postman, puoi creare gruppi di campi, schemi, set di dati e quindi importare dati di esempio in Experience Platform.

Caso di utilizzo di dati di esempio

Gli utenti aziendali di Experience Platform devono spesso seguire una serie di passaggi che includono l’identificazione dei gruppi di campi, la creazione di schemi, la preparazione dei dati, la creazione di set di dati e quindi l’acquisizione dei dati prima di esplorare alcune delle funzionalità offerte da Experience Platform. In questa esercitazione, puoi trovare un modo semplice per automatizzare alcuni dei passaggi e ottenere dati in Platform il prima possibile.

Questa esercitazione si concentra su un brand fittizio al dettaglio denominato Luma. Luma gestisce negozi fisici in diversi paesi e ha una presenza online con un sito web e app mobili. Investono in Adobe Experience Platform per combinare i dati di acquisto fedeltà, CRM, web e offline in profili cliente in tempo reale e attivare questi profili per portare il loro marketing al livello successivo. Sono presenti dati di esempio generati per Luma e nella sezione successiva puoi esplorare come importare i dati in Experience Platform.

Per completare questa esercitazione, puoi utilizzare l' Interfaccia utente dell'applicazione Postman oppure la riga di comando Collection Runner for Postman (Newman)

Prerequisiti

  • Hai eseguito l’autenticazione e hai accesso alle API di Experience Platform. In caso contrario, puoi configurarlo rapidamente seguendo questa esercitazione.
  • Accesso all’ambiente sandbox di Experience Platform.

Utilizzo di Postman

Importa la raccolta Postman e imposta le variabili di ambiente

Prima di procedere, assicurati di aver scaricato l’applicazione Postman e di avere accesso alle API di Experience Platform. Per questa esercitazione, utilizzeremo un ambiente sandbox. Fornisce un ambiente isolato in cui puoi provare le funzionalità senza mescolare risorse e dati con l’ambiente di produzione. Cominciamo.

NOTA

I dati utente contenuti nel file platform-utils-main.zip sono fittizi e devono essere utilizzati solo a scopo dimostrativo.

  1. Scarica il file platform-utils-main.zip , che contiene tutti i file necessari per questa esercitazione.

  2. Dalla cartella dei download, sposta il file platform-utils-main.zip nella posizione desiderata sul computer e decomprimi il file.

  3. Prendi nota della posizione del file decompresso, poiché potrebbe essere necessario in seguito durante la configurazione della variabile di ambiente postman FILE_PATH

    NOTA

    Per ottenere il percorso del file sul Mac, accedi alla cartella platform-utils-main, fai clic con il pulsante destro del mouse sulla cartella e seleziona l'opzione Ottieni informazioni .

    Percorso file Mac

    NOTA

    Per ottenere il percorso del file nelle finestre, fare clic per aprire la posizione della cartella desiderata, quindi fare clic con il pulsante destro del mouse sulla destra del percorso nella barra degli indirizzi. Copiare l'indirizzo per ottenere il percorso del file.

    Percorso file Windows

  4. Avvia Postman e crea una nuova area di lavoro. Copia il valore dei metadati where dal

  5. Per creare una nuova area di lavoro, utilizza il menu a discesa Aree di lavoro a sinistra di Postman. Puoi selezionare un’area di lavoro esistente o crearne una nuova per il progetto.
    Creare un’area di lavoro

  6. Immetti un Nome e un Riepilogo facoltativo per l'area di lavoro e fai clic su Crea area di lavoro. Postman passa alla nuova area di lavoro quando la crei.
    Salva area di lavoro

  7. Ora eseguiamo alcune impostazioni aggiuntive per eseguire le nostre raccolte postman in questo spazio di lavoro. Nell'intestazione di Postman, fai clic sull'icona chiave inglese e seleziona Impostazioni per aprire le impostazioni modali. È inoltre possibile utilizzare la scelta rapida da tastiera (CMD/CTRL + ,) per aprire il modale.

  8. Nella scheda General, aggiorniamo il timeout della richiesta in ms a 5000 ms e attiviamo allow reading file outside this directory

    Impostazioni

    NOTA

    Se i file vengono caricati dall'interno della directory di lavoro, questi verranno eseguiti senza problemi tra i dispositivi se gli stessi file vengono memorizzati sugli altri dispositivi. Tuttavia, se si desidera eseguire i file dall'esterno della directory di lavoro, è necessario attivare un'impostazione per indicare lo stesso intento. Se il FILE_PATH non è lo stesso percorso della directory di lavoro del postman, questa opzione deve essere abilitata.

  9. Chiudi il pannello delle impostazioni.

  10. Seleziona l’opzione ambienti e fai clic sull’opzione di importazione.
    Importazione ambiente

  11. Importiamo il file di ambiente json scaricato, DataInExperiencePlatform.postman_environment, quindi fai clic su Importa

  12. In Postman, seleziona l’ambiente nel menu a discesa in alto a destra e fai clic sull’icona occhio per visualizzare le variabili di ambiente.
    Selezione dell'ambiente

  13. Assicurati che le seguenti variabili di ambiente siano popolate. Per informazioni su come ottenere il valore delle variabili di ambiente, consulta l’ esercitazione Autentica le API di Experience Platform per istruzioni dettagliate.

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY
  14. Aggiorna la variabile FILE_PATH nel percorso della cartella locale in cui hai decompresso il file platform-utils-main.zip. Puoi modificare le variabili aprendo un ambiente da Ambienti a sinistra oppure aprendo l’aspetto rapido dell’ambiente (pulsante occhio) in alto a destra di Postman e facendo clic su Modifica.
    Percorso file

  15. Ora è necessario compilare i valori per le seguenti variabili di ambiente. Per farlo, dobbiamo caricare i file di raccolta nella nostra area di lavoro.

    • JWT_TOKEN
    • ACCESS_TOKEN
  16. Seleziona le raccolte e quindi scegli l’opzione di importazione

    Raccolte

  17. Importa i seguenti file di raccolta in postman

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    Importazione raccolte

  18. Apri la raccolta Authentication, seleziona la richiesta IMS: JWT Generate + Auth via User Token POST e fai clic su SEND per eseguire l’autenticazione e ottenere il token di accesso.

    Importazione raccolte

  19. Esamina le variabili di ambiente e puoi notare che ora i JWT_TOKEN e ACCESS_TOKEN sono popolati.

  20. Apri la raccolta Luma-Loyalty-Data e fai clic su Esegui nella scheda panoramica per avviare un Collection Runner.

    Importazione raccolte

  21. Nella finestra di esecuzione della raccolta, assicurati di selezionare l’ambiente dal menu a discesa, fornire un ritardo di 4000 ms, selezionare l’opzione salva risposte e assicurarsi che l’ordine di esecuzione sia corretto. Fai clic sul pulsante Esegui dati fedeltà Luma

    Importazione raccolte

    NOTA

    L’esecuzione della raccolta Luma-Fedeltà- Datacollecection creerebbe uno schema per contenere i dati fedeltà dei clienti. Lo schema si basa sulla classe Profilo individuale XDM che comprende gruppi di campi personalizzati e tipi di dati. La raccolta crea inoltre un set di dati utilizzando lo schema e carica dati di esempio sulla fidelizzazione dei clienti in Adobe Experience Platform.

    NOTA

    Se una richiesta di raccolta non riesce durante il runner della raccolta postman, interrompi l’esecuzione ed esegui le richieste di raccolta una per una.

  22. Se tutto va bene, tutte le richieste nella raccolta Luma-Loyalty-Data devono passare.

    Risultato fedeltà

  23. Ora accediamo a Adobe Experience Platform UI e passiamo ai set di dati.

  24. Apri il set di dati Luma Loyalty Dataset e nella finestra dell’attività del set di dati puoi visualizzare un’esecuzione batch riuscita con 1000 record acquisiti. Puoi anche fare clic sull’opzione di anteprima del set di dati per verificare i record acquisiti.
    Set di dati fedeltà

  25. Ripeti i passaggi 21 - 23 per eseguire le seguenti raccolte:

    • Luma-CRM-Data.postman_collection.json : esecuzione della raccolta creerebbe uno schema per contenere i dati CRM dei clienti. Lo schema si basa sulla classe Profilo individuale XDM che comprende i gruppi di campi Dettagli demografici, Dettagli contatto personale e Profilo identità Luma. La raccolta crea inoltre un set di dati utilizzando lo schema e carica dati CRM dei clienti di esempio in Adobe Experience Platform.
    • Luma-Product-Catalog.postman_collection.json : l'esecuzione della raccolta creerebbe uno schema che contenga informazioni sul catalogo dei prodotti. Lo schema è basato su una classe personalizzata che include mixin catalogo prodotti, dettagli Commerce e mixin Evento esperienza consumatore. La raccolta crea inoltre un set di dati utilizzando lo schema e carica i dati di prodotto in Adobe Experience Platform.
    • Luma-Offline-Purchase-Events.postman_collection.json: l'esecuzione della raccolta creerebbe uno schema per contenere i dati degli eventi di acquisto offline dei clienti. Lo schema è basato sulla classe ExperienceEvent XDM e comprende gruppi di campi per acquisire informazioni sulla fidelizzazione dei clienti e i relativi eventi di acquisto offline. La raccolta crea inoltre un set di dati utilizzando lo schema e carica i dati degli eventi di acquisto offline in Adobe Experience Platform.

Utilizzo di Newman

Prima di seguire i passaggi, assicurati di avere accesso alle API di Experience Platform. Per questa esercitazione, utilizzeremo un ambiente sandbox che fornisce un ambiente isolato in cui puoi provare le funzionalità senza mescolare risorse e dati con l’ambiente di produzione.

Installa NodeJs e Newman

  1. Per eseguire Newman, assicurati di disporre di Node.js >= v10. Installa Node.js tramite gestore di pacchetti.

  2. Esegui il comando node -v per assicurarti che il nodo sia installato.

  3. Il modo più semplice per installare Newman è utilizzare NPM. Se Node.js è installato, è molto probabile che anche NPM sia installato.

  4. Segui i passaggi qui per installare newman per il tuo sistema

  5. Esegui il comando newman -v per assicurarti che sia installato newman.

  6. Scarica il file platform-utils-main.zip , che contiene tutti i file necessari per questa esercitazione.

  7. Dalla cartella dei download, sposta il file platform-utils-main.zip nella posizione desiderata sul computer e decomprimi il file.

  8. Prendi nota della posizione del file decompresso, poiché potrebbe essere necessario in seguito durante la configurazione della variabile di ambiente postman FILE_PATH

  9. Apri la cartella platform-utils-main in una finestra terminale.

  10. Esegui Luma-Loyalty-Data.postman_collection.json per creare gruppi di campi, schema, set di dati e per acquisire dati di fidelizzazione di esempio in Adobe Experience Platform

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
  11. Se tutto va bene, tutte le richieste nella raccolta Luma-Loyalty-Data devono passare.

  12. Ora accediamo a Adobe Experience Platform UI e passiamo ai set di dati.

  13. Apri il set di dati Luma Loyalty Dataset e nella finestra dell’attività del set di dati puoi visualizzare un’esecuzione batch riuscita con 1000 record acquisiti. Puoi anche fare clic sull’opzione di anteprima del set di dati per verificare i record acquisiti.

    Set di dati fedeltà

  14. Ripeti i passaggi 10-13 per eseguire sotto le raccolte:

    • Esegui Luma-CRM-Data.postman_collection.json per creare gruppi di campi, schema, set di dati e per acquisire dati CRM di esempio in Adobe Experience Platform
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Esegui Luma-Product-Catalog.postman_collection.json per creare gruppi di campi, schema, set di dati e per acquisire dati di prodotto di esempio in Adobe Experience Platform
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Esegui Luma-Offline-Purchase-Events.postman_collection.json per creare gruppi di campi, schema, set di dati e per acquisire dati di prodotto di esempio in Adobe Experience Platform
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

Ripristina ambiente Sandbox

Se si reimposta una sandbox non di produzione, vengono eliminate tutte le risorse associate a tale sandbox (schemi, set di dati e così via), mantenendo il nome della sandbox e le relative autorizzazioni. Questa sandbox "pulita" continua a essere disponibile con lo stesso nome per gli utenti che vi hanno accesso.

Segui i passaggi qui per ripristinare un ambiente sandbox.

In questa pagina