Aggiorna il tuo feed di dati utente tramite API

L'API per i dati utente consente di aggiornare i dati utente su richiesta, anche tramite aggiornamenti parziali.      

Con l'API per i dati utente, è possibile utilizzare i dati raccolti al di fuori di Dynamic Yield per la segmentazione e il targeting, in tempo reale e con un carico ridotto rispetto al feed basato su file. Inoltre, è possibile eseguire aggiornamenti, visualizzare i risultati e monitorare le operazioni senza bisogno dell'assistenza del tuo account manager.

Flusso di onboarding dei dati utente

Il processo di onboarding include i seguenti passaggi: 

• Passaggio 1 - preparazione: dovrai decidere quali attributi (colonne) trasferire all'API. 
• Passaggio 2 - crea lo schema JSON: imposta lo schema che determina dove e come vengono archiviate le informazioni in Dynamic Yield. 
• Passaggio 3 - configura il feed: crea un nuovo feed, testalo e carica i tuoi dati utente.

Passaggio 1: preparazione

1. Decidi quali attributi (colonne) trasferire nell'API (includendo attributi come nome, tipo e così via). Nota: per motivi di privacy, non includere attributi considerati PII (ad esempio nome, data di nascita, indirizzo e così via).

2. Genera una chiave API (se non l'hai già fatto).

Passaggio 2: crea lo schema JSON

Lo schema è una tabella che determina dove e come vengono archiviate le informazioni in Dynamic Yield. Queste informazioni vengono fornite nella sintassi JSON e copiate nella console Dynamic Yield. 

Abbiamo creato uno strumento per semplificare la creazione e la modifica dello schema JSON:

• accedi allo strumento per la creazione di schemi,
• scopri di più sul Creatore di schemi di dati utente,

"fields": [
  {
  "name": "purchase_count",→ il nome del campo inviato all'API o della colonna nel file CSV
  "display": "Purchase Count", → il nome della condizione, che appare in DY admin
  "type": [
  "null", → l'oggetto ammette valori nulli o meno
  "int" → la natura del campo da trasferire
  ],
  "uiType": "number" → la natura del campo che appare in DY admin
  }
]

"fields": [
{

  "name": "has_offer",
  "display": "Has Offer",
  "type": [
  "null",
  "boolean"
  ],
  "uiType": "ref",
  "uiTypeRef": "UIhas_offer"
  }
],

"uiTypes": {
  "UIhas_offer": {
  "uiType": "select",
  "validation": {
  "values": [
  {
  "name": "Yes",
  "value": "true"
  },
  {
  "name": "No",
  "value": "false"
  }
  ]
  }
  }

{
  "fields": [
  {
  "//": "Esempio di campo con valori - riferimento per uiType con i valori possibili",
  "name": "VIPPersona",
  "display": "VIP Persona",
  "type": [
  "null",
  "int"
  ],
  "uiType": "ref",
  "uiTypeRef": "UIMetalVIP"
  },
  {
  "//": "Esempio di numero - non è necessario inserire un riferimento in uiType",
  "name": "CustomerScore",
  "display": "Customer Score",
  "type": [
  "null",
  "int"
  ],
  "default": null,
  "uiType": "number"
  },
  {
  "//": "Esempio di stringa - non è necessario inserire un riferimento in uiType",
  "display": "Account Manager",
  "name": "AccountManager",
  "type": [
  "null",
  "string"
  ],
  "uiType": "input"
  },
  {
  "//": "Esempio booleano - non è necessario inserire un riferimento in uiType",
  "name": "IsSubscribedTo",
  "display": "Is Subscribed To Emails",
  "type": [
  "null",
  "boolean"
  ],
  "uiType": "ref",
  "uiTypeRef": "UIIsSubscribed"
  },
  {
  "//": "Esempio di data - non è necessario inserire un riferimento in uiType",
  "name": "AnniversaryGiftExpires",
  "display": "Anniversary Gift Expires",
  "type": [
  "null",
  "long"
  ],
  "uiType": "date"
  },
  {
  "//": "Esempio di matrice di enumerazioni - valori che si possono selezionare da un elenco a discesa, di cui si può inserire un riferimento in uiType con i valori possibili",
  "name": "VIPPersona",
  "display": "VIP Persona",
  "type": [
  "null",
  {
  "type": "array",
  "items": "int"
  }
  ],
  "uiType": "ref",
  "uiTypeRef": "UIMetalVIP"
  },
  {
  "//": "Esempio di array di stringhe - non è necessario inserire un riferimento in uiType",
  "name": "nicknames",
  "display": "Nicknames",
  "type": [
  "null",
  {
  "type": "array",
  "items": "string"
  }
  ],
  "uiType": "input"
  }
  ],
  "uiTypes": {
  "UIMetalVIP": {
  "//": "Esempio di rappresentazione di valori di visualizzazione diversi nella console Dynamic Yield",
  "uiType": "select",
  "validation": {
  "values": [
  {
  "name": "VIP Gold",
  "value": 0,
  "source": "goldVIP"
  },
  {
  "name": "Other",
  "value": 1,
  "source": "otherVip"
  },
  {
  "name": "VIP Silver",
  "value": 4,
  "source": "vipSilver"
  }
  ]
  }
  },
  "UIIsSubscribed": {
  "//": "Valori admin: booleani",
  "uiType": "select",
  "validation": {
  "values": [
  {
  "name": "No",
  "value": "false"
  },
  {
  "name": "Yes",
  "value": "true"
  }
  ]
  }
 } 
 } 
}

Usa il nostro Generatore di schemi di dati utente per creare o modificare gli schemi.

Passaggio 3: configura il feed

Crea un nuovo feed

1. Vai a Asset › Feed di dati e crea un nuovo feed di dati utente.
   
2. Per la Fonte del feed, seleziona la Sincronizzazione tramite API.
3. Entra nello schema per il feed.
4. Definisci il tipo CUID. L'impostazione predefinita è e-mail, quindi dovrai modificare questo valore solo se volessi utilizzare un tipo di ID diverso.
5. Clicca su Salva in bozza.

Testare il feed

1. Chiama l'API codificata nel passaggio precedente.
2. La chiamata API restituirà un ID transazione in un campo denominato dy_trace_id. Utilizzando questo ID, vai al registro API e cerca lo stato della chiamata API.
3. Nel registro, verifica che lo stato della richiesta API sia corretto (202). Quindi, controlla che non esistano errori per gli oggetti nidificati: lo stato della chiamata API restituito non li dovrà includere.
   
   Quando il sistema chiama l'API, verrà restituito uno stato. Questo stato indica che la chiamata è stata ricevuta. Nel log è possibile visualizzare i dettagli di eventuali errori per ogni azione, relativi agli specifici oggetti inclusi. 

Onboarding dei dati utente 

1. Attiva il feed (sviluppatore).
2. Chiama le API in base al tuo flusso aziendale.
3. Monitora il feed (utente aziendale e sviluppatore). Consulta la sezione Registri e avvisi API in Experience per ulteriori informazioni. I log dell'API per i dati utente si comporteranno allo stesso modo.

Account esistenti: passaggio da CSV ad API

Se hai già impostato l'onboarding dei dati utente tramite il metodo di caricamento CSV e vuoi trasferire all'API dei dati utente:  

1. apri il feed di dati utente.
2. Modifica le impostazioni del feed a Sincronizza via API. Nota che i cambiamenti nello schema non sono supportati al momento.
3. Chiama le API in base al tuo flusso aziendale.
4. Monitora il feed (utente aziendale e sviluppatore). Usa:
   
   • Alert: puoi fornire informazioni sui problemi relativi alla chiamata API e agli oggetti inclusi; 
   • Log: consulta la sezione log delle API Experience per avere maggiori informazioni. I log dell'API per i dati utente si comportano allo stesso modo.
5. Attiva la funzione 

Nota: gli attributi utente esistenti verranno mantenuti quando si passano ad API. 

Importante: una volta passati alla sincronizzazione API, non è possibile tornare indietro al metodo CSV senza l'assistenza del supporto tecnico, quindi, assicurati che sia ciò che vuoi fare. 

Creazione di chiamate API

Per ulteriori informazioni, consulta la sezione dedicata ai riferimenti API sul sito del nostro sviluppatore.

Creazione di segmenti di pubblico in base ai dati degli utenti

Quando si imposta l'onboarding dei dati, è possibile utilizzare immediatamente il comando Audience Explorer per esplorare questi importanti segmenti e analizzare le relative prestazioni rispetto all'intera base di utenti online, integrandoli con dati comportamentali degli utenti acquisiti tramite Dynamic Yield. Visualizzerai la nuova condizione sotto le Proprietà utente utilizzando il nome del feed dati utenti, da abbinare a qualsiasi altra condizione di Dynamic Yield disponibile nel tuo account e utilizzata per creare e salvare segmenti micro-targetizzabili (segmenti di pubblico) che si possono incorporare nelle tue esperienze di personalizzazione del sito Dynamic Yield e nei consigli.

Nota: quando crei un segmento di pubblico con condizioni che si basano sui dati mappati come array di stringhe (Text Array), gli operatori disponibili sono "is", "is not", "contains", e "does not contain", dove "is" soddisfa uno dei valori nell'array corrispondente al valore elencato, mentre "contains" soddisfa uno dei valori qualsiasi nella matrice che contiene il valore elencato. 

Prerequisiti e limitazioni

• Il feed incentrato sulle API non si può modificare nel metodo CSV.
• Ogni sito deve avere una chiave API univoca.
• Limite di richieste API: 
• puoi aggiornare fino a 100 utenti in 1 chiamata API
• fino a 100 chiamate API in 1 secondo, per un totale di 600.000 aggiornamenti al minuto