Preparare i dati da utilizzare in Intelligent Services

Per consentire a Intelligent Services di scoprire informazioni provenienti dai dati degli eventi di marketing, i dati devono essere arricchiti e mantenuti in modo semantico in una struttura standard. Intelligent Services sfrutta gli schemi Experience Data Model (XDM) per ottenere questo risultato. In particolare, tutti i set di dati utilizzati in Intelligent Services devono essere conformi allo schema XDM di Consumer ExperienceEvent (CEE) o utilizzare il connettore Adobe Analytics. Inoltre, Customer AI supporta il connettore Adobe Audience Manager.

Questo documento fornisce indicazioni generali sulla mappatura dei dati degli eventi di marketing da più canali allo schema CEE, delineando informazioni su campi importanti all'interno dello schema per aiutarti a determinare come mappare efficacemente i dati alla struttura. Se prevedi di utilizzare i dati di Adobe Analytics, visualizza la sezione relativa alla preparazione dei dati di Adobe Analytics. Se prevedi di utilizzare i dati di Adobe Audience Manager (solo Customer AI), visualizza la sezione per preparazione dei dati di Adobe Audience Manager.

Requisiti dei dati

Intelligent Services richiedono quantità diverse di dati storici a seconda dell’obiettivo creato. Indipendentemente dal fatto che i dati che prepari per all Intelligent Services devono includere percorsi/eventi cliente sia positivi che negativi. La presenza di eventi negativi e positivi migliora la precisione e l'accuratezza del modello.

Ad esempio, se utilizzi Customer AI per prevedere la propensione all’acquisto di un prodotto, il modello per Customer AI richiede sia esempi di percorsi di acquisto riusciti sia esempi di percorsi di acquisto non riusciti. Questo perché durante la formazione sul modello, Customer AI cerca di capire quali eventi e percorsi portano ad un acquisto. Ciò include anche le azioni dei clienti che non hanno acquistato, ad esempio una persona che ha interrotto il percorso aggiungendo un articolo al carrello. Tuttavia, questi clienti possono mostrare comportamenti simili, Customer AI può fornire informazioni approfondite ed approfondire le principali differenze e fattori che portano a un punteggio di propensione più elevato. Allo stesso modo, Attribution AI richiede sia tipi di eventi che percorsi per visualizzare metriche quali l’efficacia dei punti di contatto, i migliori percorsi di conversione e le suddivisioni per posizione dei punti di contatto.

Per ulteriori esempi e informazioni sui requisiti storici dei dati, visita la sezione sui requisiti storici dei dati Customer AI o Attribution AI nella documentazione di input/output.

Linee guida per l’unione dei dati

È consigliabile unire gli eventi di un utente in un ID comune quando possibile. Ad esempio, puoi avere dati utente con "id1" in 10 eventi. Successivamente, lo stesso utente ha eliminato l'id cookie e viene registrato come "id2" nei successivi 20 eventi. Se sai che l’id1 e l’id2 corrispondono allo stesso utente, la best practice consiste nell’unire tutti e 30 gli eventi con un ID comune.

Se ciò non è possibile, è necessario trattare ogni set di eventi come un utente diverso durante la creazione dei dati di input del modello. Questo garantisce i migliori risultati durante l'addestramento e il punteggio del modello.

Riepilogo del flusso di lavoro

Il processo di preparazione varia a seconda che i dati siano memorizzati in Adobe Experience Platform o esternamente. In questa sezione vengono riepilogati i passaggi necessari, in base a entrambi gli scenari.

Preparazione dei dati esterni

Se i dati sono memorizzati al di fuori dell'Experience Platform, devi mappare i tuoi dati sui campi obbligatori e rilevanti in uno schema ExperienceEvent del consumatore. Questo schema può essere migliorato con gruppi di campi personalizzati per acquisire meglio i dati dei clienti. Una volta mappato, puoi creare un set di dati utilizzando lo schema Consumer ExperienceEvent e acquisendo i dati in Platform. È quindi possibile selezionare il set di dati CEE durante la configurazione di un Intelligent Service.

A seconda del Intelligent Service che si desidera utilizzare, potrebbero essere necessari campi diversi. È consigliabile aggiungere dati a un campo se i dati sono disponibili. Per ulteriori informazioni sui campi obbligatori, visita la guida di input/output Attribution AI o Customer AI .

Preparazione dei dati di Adobe Analytics

Customer AI e Attribution AI supportano i dati di Adobe Analytics in modo nativo. Per utilizzare i dati di Adobe Analytics, segui i passaggi descritti nella documentazione per impostare un connettore di origine di Analytics.

Una volta che il connettore di origine trasmette i dati in Experience Platform, puoi selezionare Adobe Analytics come origine dati seguita da un set di dati durante la configurazione dell’istanza. Durante la configurazione della connessione vengono creati automaticamente tutti i gruppi di campi dello schema richiesti e i singoli campi. Non è necessario ETL (Extract, Transform, Load) dei set di dati nel formato CEE.

IMPORTANTE

Il connettore Adobe Analytics impiega fino a quattro settimane per eseguire il backfill dei dati. Se hai recentemente configurato una connessione, devi verificare che il set di dati abbia la lunghezza minima dei dati richiesti per Cliente o Attribution AI. Controlla le sezioni dei dati storici in Customer AI o Attribution AI e verifica di disporre di dati sufficienti per l'obiettivo di previsione.

Preparazione dei dati Adobe Audience Manager (solo Customer AI)

Customer AI supporta in modo nativo i dati di Adobe Audience Manager. Per utilizzare i dati di Audience Manager, segui i passaggi descritti nella documentazione per impostare un connettore di origine Audience Manager.

Una volta che il connettore di origine trasmette i dati in Experience Platform, puoi selezionare Adobe Audience Manager come origine dati seguita da un set di dati durante la configurazione di Customer AI. Durante la configurazione della connessione vengono creati automaticamente tutti i gruppi di campi dello schema e i singoli campi. Non è necessario ETL (Extract, Transform, Load) dei set di dati nel formato CEE.

IMPORTANTE

Se recentemente hai impostato un connettore, devi verificare che il set di dati abbia la lunghezza minima necessaria per i dati. Controlla la sezione relativa ai dati storici nella documentazione di input/output per Customer AI e verifica di disporre di dati sufficienti per l'obiettivo di previsione.

Experience Platform preparazione dei dati

Se i dati sono già memorizzati in Platform e non lo streaming tramite i connettori sorgente Adobe Analytics o Adobe Audience Manager (solo Customer AI), segui i passaggi seguenti. È comunque consigliabile comprendere lo schema CEE.

  1. Rivedi la struttura dello schema di Consumer ExperienceEvent e determina se i tuoi dati possono essere mappati ai relativi campi.
  2. Contatta Adobe Consulting Services per facilitare la mappatura dei dati sullo schema e l’acquisizione in Intelligent Services oppure segui i passaggi descritti in questa guida se desideri mappare i dati da solo.

Informazioni sullo schema CEE

Lo schema Consumer ExperienceEvent descrive il comportamento di un individuo in relazione agli eventi di marketing digitale (web o mobile) nonché alle attività di e-commerce online o offline. L’utilizzo di questo schema è necessario per Intelligent Services a causa dei relativi campi (colonne) semanticamente ben definiti, evitando nomi sconosciuti che renderebbero i dati meno chiari.

Lo schema CEE, come tutti gli schemi ExperienceEvent XDM, acquisisce lo stato del sistema basato su serie temporali quando si verifica un evento (o un set di eventi), incluso il punto nel tempo e l'identità dell'oggetto coinvolto. Gli eventi di esperienza sono registrazioni di fatti di ciò che è accaduto, e quindi sono immutabili e rappresentano ciò che è accaduto senza aggregazione o interpretazione.

Intelligent Services utilizza diversi campi chiave all’interno di questo schema per generare informazioni dai dati degli eventi di marketing, che possono essere trovati a livello principale ed espansi per mostrare i relativi sottocampi richiesti.

Come tutti gli schemi XDM, il gruppo di campi dello schema CEE è estensibile. In altre parole, è possibile aggiungere campi aggiuntivi al gruppo di campi CEE e, se necessario, includere varianti diverse in più schemi.

Un esempio completo del gruppo di campi si trova nel archivio XDM pubblico. Inoltre, è possibile visualizzare e copiare il seguente file JSON per un esempio di come i dati possono essere strutturati in modo da rispettare lo schema CEE. Per determinare come mappare i dati personalizzati sullo schema, fai riferimento a entrambi gli esempi mentre apprendi i campi chiave descritti nella sezione seguente.

Campi chiave

Ci sono diversi campi chiave all'interno del gruppo di campi CEE che devono essere utilizzati affinché Intelligent Services generi informazioni utili. Questa sezione descrive il caso d’uso e i dati previsti per questi campi e fornisce collegamenti alla documentazione di riferimento per ulteriori esempi.

Campi obbligatori

Sebbene sia vivamente consigliato l’utilizzo di tutti i campi chiave, esistono due campi obbligatori per il funzionamento di Intelligent Services:

Identità principale

Uno dei campi dello schema deve essere impostato come campo di identità principale, che consente a Intelligent Services di collegare ogni istanza di dati relativi a serie temporali a una singola persona.

È necessario determinare il campo migliore da utilizzare come identità principale in base all’origine e alla natura dei dati. Un campo di identità deve includere un namespace di identità che indica il tipo di dati di identità che il campo prevede come valore. Alcuni valori di spazio dei nomi validi includono:

  • "e-mail"
  • "telefono"
  • "mcid" (per Adobe Audience Manager ID)
  • "aaid" (per Adobe Analytics ID)

Se non sei sicuro di quale campo utilizzare come identità principale, contatta Adobe Consulting Services per determinare la soluzione migliore. Se non è impostata un'identità primaria, l'applicazione Intelligent Service utilizza il seguente comportamento predefinito:

Predefinito Attribution AI Customer AI
Colonna identità endUserIDs._experience.aaid.id endUserIDs._experience.mcid.id
Namespace AAID ECID

Per impostare un'identità primaria, passa allo schema dalla scheda Schemi e seleziona il nome dello schema ipertestuale per aprire il Schema Editor.

Passa allo schema

Quindi, accedi al campo che desideri utilizzare come identità principale e selezionalo. Viene visualizzato il menu Proprietà campo per tale campo.

Selezionare il campo

Nel menu Proprietà campo, scorri verso il basso fino a trovare la casella di controllo Identità. Dopo aver selezionato la casella, viene visualizzata l'opzione per impostare l'identità selezionata come Identità principale. Seleziona anche questa casella.

Seleziona casella di controllo

Successivamente, devi fornire un namespace Identity dall’elenco dei namespace predefiniti nel menu a discesa. In questo esempio, lo spazio dei nomi ECID viene selezionato in quanto viene utilizzato un Adobe Audience Manager ID mcid.id. Seleziona Applica per confermare gli aggiornamenti, quindi seleziona Salva nell'angolo in alto a destra per salvare le modifiche allo schema.

Salva le modifiche

xdm:timestamp

Questo campo rappresenta il datetime in cui si è verificato l'evento. Questo valore deve essere fornito come stringa, secondo lo standard ISO 8601.

xdm:channel

NOTA

Questo campo è obbligatorio solo quando si utilizza Attribution AI.

Questo campo rappresenta il canale di marketing correlato all’ExperienceEvent. Il campo include informazioni sul tipo di canale, il tipo di supporto e il tipo di posizione.

Esempio di schema

{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

Per informazioni complete su ciascuno dei campi secondari richiesti per xdm:channel, fai riferimento alla specifica schema del canale esperienza . Per alcuni esempi di mappature, vedi la tabella sotto.

Esempio di mappature dei canali

Nella tabella seguente sono riportati alcuni esempi di canali di marketing mappati allo schema xdm:channel :

Channel @type mediaType mediaAction
Ricerca pagata https://ns.adobe.com/xdm/channel-types/search pagato click
Social - Marketing https://ns.adobe.com/xdm/channel-types/social guadagnato click
Visualizzazione https://ns.adobe.com/xdm/channel-types/display pagato click
E-mail https://ns.adobe.com/xdm/channel-types/email pagato click
Referrer interno https://ns.adobe.com/xdm/channel-types/direct di proprietà click
Visualizza visualizzazione passante https://ns.adobe.com/xdm/channel-types/display pagato impression
Reindirizzamento del codice QR https://ns.adobe.com/xdm/channel-types/direct di proprietà click
Dispositivi mobili https://ns.adobe.com/xdm/channel-types/mobile di proprietà click

Campi consigliati

Il resto dei campi chiave è descritto in questa sezione. Anche se questi campi non sono necessariamente necessari per il funzionamento di Intelligent Services, si consiglia vivamente di utilizzarne il maggior numero possibile per ottenere informazioni più approfondite.

xdm:productListItems

Questo campo è un array di articoli che rappresentano i prodotti selezionati da un cliente, inclusi SKU del prodotto, nome, prezzo e quantità.

Esempio di schema

[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

Per informazioni complete su ciascuno dei campi secondari richiesti per xdm:productListItems, fai riferimento alla specifica schema dei dettagli di e-commerce .

xdm:commerce

Questo campo contiene informazioni specifiche sull'ExperienceEvent per l'e-commerce, tra cui il numero dell'ordine di acquisto e le informazioni sul pagamento.

Esempio di schema

{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

Per informazioni complete su ciascuno dei campi secondari richiesti per xdm:commerce, fai riferimento alla specifica schema dei dettagli di e-commerce .

xdm:web

Questo campo rappresenta i dettagli web relativi all’ExperienceEvent, ad esempio l’interazione, i dettagli della pagina e il referente.

Esempio di schema

{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

Per informazioni complete su ciascuno dei campi secondari richiesti per xdm:productListItems, fai riferimento alla specifica Schema dei dettagli web ExperienceEvent .

xdm:marketing

Questo campo contiene informazioni relative alle attività di marketing attive con il punto di contatto.

Esempio di schema

{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Per informazioni complete su ciascuno dei campi secondari richiesti per xdm:productListItems, fai riferimento alle specifiche sechma di marketing .

Mappatura e acquisizione dei dati

Una volta determinato se i dati degli eventi di marketing possono essere mappati sullo schema CEE, il passaggio successivo consiste nel determinare quali dati inserire in Intelligent Services. Tutti i dati storici utilizzati in Intelligent Services devono rientrare nell’intervallo di tempo minimo di quattro mesi di dati, più il numero di giorni previsti come periodo di lookback.

Dopo aver deciso l’intervallo di dati da inviare, contatta Adobe Consulting Services per facilitare la mappatura dei dati sullo schema e il loro inserimento nel servizio.

Se disponi di una sottoscrizione Adobe Experience Platform e desideri mappare e acquisire i dati da solo, segui i passaggi descritti nella sezione seguente.

Utilizzo di Adobe Experience Platform

NOTA

I passaggi seguenti richiedono un abbonamento ad Experience Platform. Se non hai accesso a Platform, passa alla sezione passaggi successivi .

Questa sezione delinea il flusso di lavoro per la mappatura e l’acquisizione dei dati in Experience Platform da utilizzare in Intelligent Services, compresi i collegamenti alle esercitazioni per passaggi dettagliati.

Creare uno schema e un set di dati CEE

Quando sei pronto a preparare i dati per l’acquisizione, il primo passo è creare un nuovo schema XDM che utilizzi il gruppo di campi CEE. Le seguenti esercitazioni illustrano il processo di creazione di un nuovo schema nell’interfaccia utente o nell’API:

IMPORTANTE

Le esercitazioni di cui sopra seguono un flusso di lavoro generico per la creazione di uno schema. Quando scegli una classe per lo schema, devi utilizzare la classe ExperienceEvent XDM. Una volta selezionata questa classe, è possibile aggiungere il gruppo di campi CEE allo schema.

Dopo aver aggiunto il gruppo di campi CEE allo schema, è possibile aggiungere altri gruppi di campi come necessario per ulteriori campi all’interno dei dati.

Dopo aver creato e salvato lo schema, puoi creare un nuovo set di dati basato su tale schema. Le seguenti esercitazioni illustrano il processo di creazione di un nuovo set di dati nell’interfaccia utente o nell’API:

Dopo la creazione del set di dati, puoi trovarlo nell’interfaccia utente di Platform nell’area di lavoro Set di dati.

Aggiungere campi di identità al set di dati

Se inserisci dati da Adobe Audience Manager, Adobe Analytics o da un’altra origine esterna, puoi impostare un campo schema come campo di identità. Per impostare un campo di schema come campo di identità, visualizza la sezione relativa all’impostazione dei campi di identità nell’esercitazione Interfaccia utente o nell’esercitazione API per la creazione di uno schema.

Se acquisisci dati da un file CSV locale, puoi passare alla sezione successiva relativa alla mappatura e acquisizione di dati.

Mappare e acquisire dati

Dopo aver creato uno schema e un set di dati CEE, puoi iniziare a mappare le tabelle di dati sullo schema e a trasferirli in Platform. Per istruzioni su come eseguire questa operazione nell’interfaccia utente, consulta l’esercitazione su mappatura di un file CSV su uno schema XDM . Puoi usare il seguente file JSON di esempio per testare il processo di acquisizione prima di usare i tuoi dati.

Una volta compilato un set di dati, lo stesso set di dati può essere utilizzato per acquisire file di dati aggiuntivi.

Se i dati sono memorizzati in un’applicazione di terze parti supportata, puoi anche scegliere di creare un connettore di origine per acquisire in tempo reale i dati degli eventi di marketing in Platform.

Passaggi successivi

Questo documento fornisce indicazioni generali sulla preparazione dei dati da utilizzare in Intelligent Services. Se hai bisogno di consulenza aggiuntiva in base al tuo caso d’uso, contatta l’Assistenza Consultiva Adobe.

Dopo aver popolato correttamente un set di dati con i dati sulla customer experience, puoi utilizzare Intelligent Services per generare informazioni. Per iniziare, consulta i seguenti documenti:

In questa pagina