Show Menu
ARGOMENTI×

Preparare i dati per l'utilizzo in Intelligent Services

Per Intelligent Services scoprire informazioni ricavate dai dati degli eventi di marketing, i dati devono essere arricchiti e mantenuti in modo semantico in una struttura standard. Intelligent Services utilizzare gli schemi Experience Data Model (XDM) per ottenere questo risultato. Nello specifico, tutti i set di dati utilizzati in Intelligent Services devono essere conformi allo schema XDM Consumer ExperienceEvent (CEE) .
Questo documento fornisce linee guida generali sulla mappatura dei dati degli eventi di marketing da più canali a questo schema, delineando le informazioni sui campi importanti all'interno dello schema per consentire di determinare in modo efficace come mappare i dati alla relativa struttura.

Riepilogo 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 passi necessari da intraprendere, in base a uno dei due scenari.

Preparazione dati esterni

Se i dati sono memorizzati al di fuori di Experience Platform, attenetevi alla procedura seguente:
  1. Contattare Adobe Consulting Services per richiedere le credenziali di accesso per un contenitore di archiviazione BLOB di Azure dedicato.
  2. Utilizzando le credenziali di accesso, caricate i dati nel contenitore BLOB.
  3. Utilizzate Adobe Consulting Services per mappare i dati sullo schema Consumer ExperienceEvent e assimilarli in Intelligent Services.

Experience Platform preparazione dei dati

Se i dati sono già memorizzati in Platform, segui i passaggi indicati di seguito:
  1. Esaminare la struttura dello schema Informazioni sullo schema CEE Consumer ExperienceEvent e determinare se i dati possono essere mappati ai relativi campi.
  2. Contattare Adobe Consulting Services per facilitare la mappatura dei dati sullo schema e l'assimilazione Intelligent Servicesoppure seguire i passaggi di questa guida se si desidera mappare i dati da soli.

Informazioni sullo schema CEE

Lo schema Consumer ExperienceEvent descrive il comportamento di un individuo in quanto si riferisce a eventi di marketing digitale (Web o mobile) nonché alle attività commerciali online o offline. L'utilizzo di questo schema è richiesto Intelligent Services a causa dei relativi campi (colonne) semanticamente ben definiti, evitando nomi sconosciuti che altrimenti renderebbero i dati meno chiari.
Lo schema CEE, come tutti gli schemi XDM ExperienceEvent, acquisisce lo stato del sistema basato sulle serie temporali quando si verifica un evento (o un set di eventi), incluso il punto nel tempo e l'identità dell'oggetto interessato. 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 al livello principale ed espansi per mostrare i relativi sottocampi richiesti.
Come tutti gli schemi XDM, il mixin CEE è estensibile. In altre parole, è possibile aggiungere altri campi al mixin CEE, e se necessario è possibile includere diverse varianti in più schemi.
Un esempio completo del mixin è disponibile nell'archivio XDM pubblico. Inoltre, potete visualizzare e copiare il seguente file CEE_XDM_sample_rows.json JSON per un esempio di come i dati possono essere strutturati in modo da rispettare lo schema CEE. Fare riferimento a entrambi gli esempi per apprendere i campi chiave descritti nella sezione seguente, al fine di determinare come mappare i propri dati sullo schema.

Campi chiave

All'interno del mixin CEE esistono diversi campi chiave che devono essere utilizzati per Intelligent Services generare informazioni utili. Questa sezione descrive i casi di utilizzo e i dati previsti per questi campi e fornisce collegamenti alla documentazione di riferimento per ulteriori esempi.

Campi obbligatori

Sebbene l'uso di tutti i campi chiave sia fortemente consigliato, esistono due campi obbligatori per Intelligent Services funzionare:

Identità principale

Uno dei campi dello schema deve essere impostato come campo di identità principale, che consente Intelligent Services di collegare ogni istanza di dati relativi alle serie temporali a una singola persona.
È necessario determinare il campo migliore da utilizzare come identità primaria in base all'origine e alla natura dei dati. Un campo di identità deve includere uno spazio dei nomi di identità che indichi il tipo di dati di identità che il campo prevede come valore. Alcuni valori di spazio nomi validi includono:
  • "email"
  • "phone"
  • "mcid" (per Adobe Audience Manager ID)
  • "aaid" (per Adobe Analytics ID)
Se non sei sicuro di quale campo debba essere utilizzato come identità principale, contatta Adobe Consulenza per determinare la soluzione migliore.

xdm:timestamp

Questo campo rappresenta il datetime in cui si è verificato l’evento. Questo valore deve essere fornito come stringa, in base allo standard ISO 8601.

xdm:channel

Questo campo è obbligatorio solo quando si utilizzano Attribution AI.
Questo campo rappresenta il canale di marketing correlato a 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 , consultate la specifica dello schema del canale esperienza. Per alcuni esempi di mappature, vedere la tabella seguente .
Esempio di mappature dei canali
Nella tabella seguente sono riportati alcuni esempi di canali di marketing mappati allo xdm:channel schema:
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
Referente interno
https:/ /ns.adobe.com/xdm/channel-types/direct
di proprietà
click
VisualizzazioneTramite
https:/ /ns.adobe.com/xdm/channel-types/display
pagato
impressioni
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

Gli altri campi chiave sono descritti in questa sezione. Anche se questi campi non sono necessariamente necessari Intelligent Services per funzionare, si consiglia vivamente di utilizzarne il maggior numero possibile per ottenere informazioni più approfondite.

xdm:productListItems

Questo campo è un array di elementi che rappresentano i prodotti selezionati da un cliente, inclusi SKU di 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 , fare riferimento alla specifica dello schema dei dettagli commerciali.

xdm:commerce

Questo campo contiene informazioni commerciali specifiche sull’ExperienceEvent, compreso il numero dell’ordine di acquisto e le informazioni di 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 , fare riferimento alla specifica dello schema dei dettagli commerciali.

xdm:web

Questo campo rappresenta i dettagli Web relativi a 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 , consulta la specifica dello 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 , consulta le specifiche sechma di marketing.

Mapping 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 in quali dati si desidera importare Intelligent Services. Tutti i dati storici utilizzati in Intelligent Services devono rientrare nel periodo 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, contattare Adobe Consulting Services per facilitare la mappatura dei dati sullo schema e l'assimilazione nel servizio.
Se disponete di un’ Adobe Experience Platform iscrizione e desiderate mappare e assimilare i dati voi stessi, seguite i passaggi descritti nella sezione seguente.

Utilizzo di Adobe Experience Platform

Per i passaggi seguenti è necessaria una sottoscrizione a Experience Platform. Se non disponete dell'accesso alla piattaforma, passate alla sezione dei passaggi Passaggi successivi successivi.
In questa sezione viene illustrato il flusso di lavoro per la mappatura e l’assimilazione dei dati in Experience Platform da utilizzare in Intelligent Services, compresi i collegamenti alle esercitazioni per i passaggi dettagliati.

Creare uno schema e un dataset CEE

Quando si è pronti per iniziare a preparare i dati per l'assimilazione, il primo passo consiste nel creare un nuovo schema XDM che utilizzi il mixin CEE. Le seguenti esercitazioni forniscono informazioni dettagliate sul processo di creazione di un nuovo schema nell'interfaccia utente o nell'API:
Le esercitazioni riportate sopra seguono un flusso di lavoro generico per la creazione di uno schema. Quando si sceglie una classe per lo schema, è necessario utilizzare la classe ExperienceEvent XDM. Una volta scelta questa classe, è possibile aggiungere il mixin CEE allo schema.
Dopo aver aggiunto il mixin CEE allo schema, è possibile aggiungere altri mixin come richiesto per campi aggiuntivi all'interno dei dati.
Dopo aver creato e salvato lo schema, è possibile creare un nuovo dataset basato su tale schema. Le seguenti esercitazioni forniscono informazioni dettagliate sul processo di creazione di un nuovo set di dati nell'interfaccia utente o nell'API:
Dopo la creazione del set di dati, è possibile trovarlo nell'interfaccia utente della piattaforma all'interno dell' Datasets area di lavoro.

Aggiunta di un tag dello spazio dei nomi dell'identità primaria al dataset

I rilasci futuri di Intelligent Services Adobe Experience Platform Identity Service Identity Servicepanoramica integreranno le funzionalità di identificazione dei clienti. Di conseguenza, i passaggi descritti di seguito sono soggetti a modifiche.
Se trasferisci dati da Adobe Audience Manager, Adobe Analyticso da un'altra origine esterna, devi aggiungere un primaryIdentityNameSpace tag al dataset. Questa operazione può essere eseguita eseguendo una richiesta PATCH all'API Catalog Service.
Se state acquisendo dati da un file CSV locale, potete passare alla sezione successiva sulla mappatura e l’assimilazione dei dati .
Prima di seguire la chiamata API di esempio riportata di seguito, consultate la sezione Catalog Service guida per sviluppatori introduttiva nella guida per gli sviluppatori di Catalog per informazioni importanti sulle intestazioni richieste.
Formato API
PATCH /dataSets/{DATASET_ID}

Parametro
Descrizione
{DATASET_ID}
ID del set di dati creato in precedenza.
Richiesta
A seconda dell’origine da cui vengono acquisiti i dati, nel payload della richiesta dovete fornire valori primaryIdentityNamespace e sourceConnectorId tag appropriati.
La richiesta seguente aggiunge i valori tag appropriati per Audience Manager:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

La seguente richiesta aggiunge i valori tag appropriati per Analytics:
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

Per ulteriori informazioni sull'utilizzo degli spazi dei nomi di identità in Piattaforma, consultate la panoramica dello spazio dei nomi di identità.
Risposta
Una risposta corretta restituisce un array contenente l'ID del set di dati aggiornato. Questo ID deve corrispondere a quello inviato nella richiesta PATCH.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Mappa e acquisizione dei dati

Dopo aver creato uno schema CEE e un set di dati, è possibile iniziare a mappare le tabelle di dati sullo schema e a assimilare i dati in Platform. Per informazioni su come eseguire questa operazione nell’interfaccia utente, consultate l’esercitazione sulla mappatura di un file CSV su uno schema XDM. Puoi usare il seguente file JSON di esempio per testare il processo di assimilazione prima di usare i tuoi dati.
Una volta compilato il 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 Panoramica sui connettori sorgente sorgente per trasferire i dati degli eventi di marketing Platform in tempo reale.

Passaggi successivi

Questo documento fornisce indicazioni generali sulla preparazione dei dati da utilizzare in Intelligent Services. Se hai bisogno di consulenze aggiuntive in base al tuo caso d'uso, contatta Adobe Consulenza Assistenza.
Dopo aver popolato con successo un dataset con i dati dell'esperienza cliente, potete utilizzarlo Intelligent Services per generare informazioni approfondite. Per iniziare, consulta i seguenti documenti: