L'integrazione dei dati di acquisto offline (ad esempio gli acquisti in un negozio fisico) in Dynamic Yield ti consente di offrire esperienze personalizzate ai tuoi visitatori (o agli abbonati ai servizi e-mail) in base alle loro attività offline. Puoi integrare gli acquisti con un identificatore utente, oppure puoi mantenere gli acquirenti anonimi (solo le informazioni sulla transazione).
L'inserimento dei dati di acquisto offline consente di:
- usare gli algoritmi di raccomandazione che sfruttano il comportamento offline, tra cui:
- Popolarità: consiglia i prodotti più popolari in base agli acquisti sia offline che online.
- Acquistati insieme offline: articoli raccomandati che sono stati acquistati offline, indipendentemente dal fatto che ora vengano comprati online.
- Acquistati insieme offline e online: raccomanda articoli che sono stati acquistati insieme offline o online.
- Affinità: raccomanda degli articoli in base al comportamento precedente dell'utente (per gli acquisti offline che includono identificatori).
- Acquisti recenti: raccomanda prodotti in base agli acquisti recenti del visitatore.
- Ultimo acquisto: consiglia dei prodotti in base all'ultimo acquisto del visitatore.
- creare segmenti di pubblico o scegliere come rivolgerti agli utenti in base ai loro acquisti offline, utilizzando la condizione Prodotti acquistati offline.
Carica il feed offline almeno una volta a settimana in modo che i consigli sui prodotti vengano creati con dati recenti relativi alle transazioni.
Per abilitare queste funzionalità, contatta il tuo responsabile del successo dei clienti.
Caricamento delle transazioni offline con identificativo
Puoi sincronizzare un feed contenente transazioni offline di utenti identificati: basta creare un file CSV contenente le transazioni e sincronizzarlo come feed di dati Dynamic Yield come tipologia Acquisti offline identificati.
Per abbinare gli acquisti offline identificati con gli utenti online, dovrai fornire un identificatore univoco comune. A tale scopo, dovrai includere degli eventi omnicanale come login, iscrizione e identificazione utente, e poi includere lo stesso identificatore quando caricherai le transazioni offline, come descritto:
- Creare un file CSV contenente le colonne descritte nella tabella seguente, usando la virgola come separatore. Puoi scaricare un file CSV di esempio qui. Non è richiesta alcuna convenzione di denominazione specifica. Ogni file può contenere un massimo di 1,5 milioni di righe.
Proprietà Descrizione Tipologia cuidType Tipo di identificatore utilizzato per identificare l'utente. Il valore deve essere uno dei seguenti fattori:
- "he" se usi un'e-mail con hashtag,
- "email" se usi e-mail di testo normale,
- "dyid" se DYID è l'identificatore.
- Lo stesso tipo di fattore personalizzato che hai sincronizzato in precedenza con Dynamic Yield sul sito.
String
(fino a 64 caratteri)cuid L'identificatore univoco dell'utente che ha effettuato l'acquisto. String
(fino a 64 caratteri)transactionId L'ID della transazione di acquisto. Ogni riga può contenere al massimo una SKU. Se più articoli sono stati acquistati insieme, dovrai creare più righe con lo stesso transactionId.
L'ID transazione deve essere univoco per ogni transazione, inclusi gli acquisti online.
Una transazione con lo stesso ID di un'altra precedentemente inserita nell'ultimo giorno verrà ignorata.
String
(fino a 64 caratteri)transactionSource
(opzionale)L'origine in cui si è verificata la transazione, in genere l'ID del negozio fisico. String transactionDatetime La data e l'ora dell'acquisto in formato ISO 8601 con data e ora combinate. Ad esempio, 2018-09-23T07:29:51+00:00. String value Valore totale del carrello nella valuta di pagamento utilizzata. Obbligatorio nel caso in cui transactionItemValue non sia stato definito. In caso contrario, è facoltativo. Float
(dollars.cents, solo valori positivi)currency Se la transazione non è nella valuta predefinita, dovrai specificare la valuta qui. Per maggiori informazioni, consulta la sezione dedicata al Supporto multilingua. String productId La SKU così come appare nel feed dei prodotti. Se la SKU non fosse presente nel feed dei prodotti, l'acquisto non verrà caricato. String quantity Quanti articoli singoli sono inclusi nell'acquisto. Numero
(positivo, senza punti decimali)itemPrice Prezzo di listino per ogni articolo (quantità singola). Questo dato potrebbe essere diverso dal parametro transactionItemValue in caso di sconti, tasse e altri fattori simili. Float
(dollars.cents, solo valori positivi)transactionItemValue Valore del dato nella valuta di pagamento effettiva.
Il valore è il prodotto di itemPrice per la quantità, al netto di sconti e tasse.
Eventuali valori negativi verranno ignorati.
Obbligatorio se la proprietà "value" non è stata definita. Altrimenti, è opzionale.Float
(dollars.cents, solo valori positivi)size
(opzionale)La dimensione dell'articolo. String - Dalla console di Experience OS, vai alla sezione Asset › Feed di dati.
- Clicca su Aggiungi nuovo e seleziona Identità acquisti offline.
- Seleziona CSV come metodo di sincronizzazione.
- Annota le credenziali S3 che vedi.
- Salva e attiva il feed di dati.
- Puoi caricare un nuovo file di feed in una cartella nel bucket S3 in qualsiasi momento, come segue: <s3 bucket URL>/YYYY-MM-DD/
Il file di feed può avere qualsiasi nome, ma non può includere il carattere "-" (dash).
È necessario creare una nuova cartella per ogni giorno in cui si sincronizza il file. Ogni volta che viene caricato un nuovo file, Dynamic Yield lo integrerà nel sistema immediatamente. - È possibile controllare lo stato della sincronizzazione e verificare la presenza di errori esaminando l'elenco dei feed di dati e scaricando il registro. Per maggiori dettagli, consulta la sezione dedicata alla Gestione del file degli errori qui sotto.
Note: ci possono volere fino a 24 ore per poter aggiornare i profili degli utenti identificati con le informazioni sugli acquisti offline importate nel tuo account.
Caricamento di transazioni offline anonime
Per sincronizzare gli acquisti offline senza alcun identificatore utente, puoi procedere come segue:
prepara il file
| scarica un file di prova |
- tipologia del file: CSV
- nome del file: acquistiofflineanonimi.csv (consigliato. I caratteri speciali potrebbero non essere supportati)
- Numero massimo di righe: 1,5 milioni
- Ogni riga deve includere una SKU di un acquisto offline:
- Se un acquisto dovesse includere 3 SKU, dovrai usare 3 righe (1 SKU per riga).
- Se un acquisto dovesse includere 1 SKU acquistata 3 volte, dovrai usare una singola riga e utilizzare l'attributo "quantità".
formato:
| Proprietà | Descrizione | Tipologia |
|---|---|---|
| transactionId | ID transazione univoco per un acquisto che include uno o più articoli. Se è stato acquistato più di un tipo di articolo, dovrebbe esserci una riga nel file CSV per ogni SKU univoca inclusa nell'acquisto. Per saperne di più, puoi consultare l'esempio qui sotto. | Riga (fino a 64 caratteri) |
| transactionSource (opzionale) |
L'origine in cui si è verificata la transazione, in genere l'ID del negozio fisico. | Riga |
| transactionDatetime | La data e l'ora dell'acquisto in formato ISO 8601 con data e ora combinate (ad esempio, 2018-09-23T07:29:51+00:00). | Riga |
| value |
Valore totale dell'acquisto (per l'intero contenuto). |
Fluttuazione (dollars.cents, solo valori positivi) |
| currency | La valuta della colonna valore dello specifico acquisto a cui fa riferimento. | Riga Visualizza le valute supportate |
| productId | La SKU dell'articolo esattamente come appare nel feed dei prodotti. Se la SKU non fosse presente nel feed dei prodotti, l'acquisto non verrà caricato. | Riga |
| quantity | Quanti articoli specifici sono stati acquistati all'interno della transazione. | Numero (positivo, senza punti decimali) |
| itemPrice | Prezzo di listino per ogni singolo articolo (quantità singola). Questo valore potrebbe essere diverso dal parametro transactionItemValue in caso di applicazione di sconti, imposte e simili. | Fluttuazione (dollars.cents, solo valori positivi) |
| transactionItemValue |
Valore dell'articolo nella valuta dell'effettivo pagamento. Il valore è il prodotto del parametro itemPrice per la quantità, dopo l'applicazione di sconti e tasse. |
Fluttuazione |
| size (opzionale) |
La dimensione dell'articolo. Ad esempio, L, M o qualsiasi altro modo tu voglia per descrivere le dimensioni dei tuoi prodotti. |
Riga |
Il file non deve includere righe duplicate e deve essere ordinato in base al parametro transactionId. Ogni riga rappresenta una SKU acquistata. Una singola transazione, comprensiva di 2 camicie identiche per $ 20 dollari ciascuna (scontate rispetto al prezzo di listino di 25 $) e una giacca per 100 $, dovrebbe corrispondere a due righe nel tuo CSV con i seguenti valori:
| transactionId | transactionDateTime | valore | valuta | productId | quantità | itemPrice | transactionItemValue |
| 101 | 2018-09-23T07:29:51+00:00 | 140,00 | USD | 12345 | 2 | 25,00 | 40,00 |
| 101 | 2018-09-23T07:29:51+00:00 | 140,00 | USD | 12789 | 1 | 100,00 | 100,00 |
- In Dynamic Yield, basta andare su Asset > feed di dati.
- Poi dovrai cliccare su Aggiungi nuovo e selezionare Acquisti offline anonimi.
- Seleziona CSV come metodo di sincronizzazione.
- Annota le credenziali S3 visualizzate.
- Salva e attiva il feed di dati.
- Puoi caricare un nuovo file di feed in una cartella nel bucket S3 in qualsiasi momento, come segue: è l'URL del bucket>/AAAA-MM-DD/
Il file di feed può avere qualsiasi nome, ma non può includere il carattere "-" (dash).
È necessario creare una nuova cartella per ogni giorno in cui si sincronizza il file. Ogni volta che viene caricato un nuovo file, Dynamic Yield lo integrerà nel sistema immediatamente. - È possibile controllare lo stato della sincronizzazione e verificare la presenza di errori esaminando l'elenco dei feed di dati e scaricando il registro. Per maggiori dettagli, consulta la sezione dedicata alla Gestione del file degli errori qui sotto.
Se disponi di più di un sito Dynamic Yield, ti consigliamo di caricare i dati degli acquisti offline sul sito più pertinente e condividere i segmenti di pubblico con tutti gli altri siti. In alternativa, puoi anche caricare i dati degli acquisti offline per ciascuno dei tuoi siti individualmente.
Caricare il file tramite CLI
Questa procedura è la stessa sia per i feed di dati di acquisto con identificativo che anonimi:
- Esegui la configurazione AWS nella directory desiderata: aws configure
- Usa l'ID della tua chiave di accesso
- Usa la tua chiave di accesso segreta
- Sotto regione, inserisci us-east-1 se usi i dati degli Stati Uniti centrali o eu-central-1 per il data center dell'UE.
- Formato di output predefinito: è possibile lasciare vuoto questo campo (basta premere Invio).
- Esegui il comando seguente per caricare il file:
aws s3 cp local file .csv <s3 bucket URL>/YYYY-MM-DD/feedName.csv - Verifica che il file si trovi in S3:
aws s3 ls <s3 bucket URL>/YYYY-MM-DD/
Nota: assicurati di utilizzare la barra (/) alla fine di questo indirizzo, per evitare errori in fase di accesso.
Gestione degli errori nei file
Quando un file viene sincronizzato il sistema esegue diverse convalide e crea un file di errori con tutte le righe contenenti errori e una colonna aggiuntiva con il relativo messaggio di errore. È possibile scaricare il log degli errori direttamente nell'elenco dei feed di dati. Per maggiori dettagli, consulta la sezione dedicata alla Convalida dell'implementazione web. Le convalide verificano che siano soddisfatte le seguenti condizioni:
- il file non è vuoto,
- le colonne obbligatorie (ad esempio, transactionId, productId) siano presenti nel file,
- nessun valore negativo per alcuni campi (valore, transactionItemValue, prezzo degli articoli, quantità),
- TRANSACTION_DATE deve essere un dato valido.
Il file degli errori verrà caricato nella stessa cartella del file che si sta sincronizzando, denominandolo nome del feed>-Feed-Log-MM-DD-YYYY-HH-MM-SS.
Se più del 20% delle righe dovesse contenere errori, il file non verrà sincronizzato e sarà contrassegnato con l'errore: "Sincronizzato con errori". I file con meno del 20% di errori verranno sincronizzati con lo stato "Sincronizzato con avvisi".
Duplicazioni in transactionId
Se dovessi importare 2 file che contengono lo stesso transactionId in 24 ore, gli acquisti corrispondenti inseriti nel 2° file verranno ignorati. Dopodiché, gli eventi di acquisto verranno memorizzati.
Validazione
Dopo aver importato gli acquisti offline, vai sull'Audience Explorer e filtra gli utenti per "Prodotti acquistati offline". Assicurati di visualizzare gli utenti.
Se non dovessi vedere alcun utente, assicurati che non si siano verificati i seguenti errori:
- il feed degli acquisti offline non è stato sincronizzato correttamente,
- l'identificatore utilizzato nel feed degli acquisti offline non è lo stesso che usi sul tuo sito.
Cosa puoi fare con i dati di acquisto offline?
- Creare segmenti di pubblico basati sugli acquisti offline e indirizzarli a campagne pertinenti.
- Fornire consigli personalizzati utilizzando l'algoritmo "Affinità utente", includendo anche gli acquisti offline.
- Usare gli algoritmi Acquistati insieme - offline o Acquistati insieme - offline e online per sfruttare i tuoi dati offline, nel caso in cui tu abbia una grande quantità di dati offline.
- Evitare di proporre prodotti che l'utente ha già acquistato offline.
- Per ogni articolo acquistato offline, verrà generato un evento di acquisto offline. Puoi cercare tra questi eventi nel modulo Audience Explorer.
Limitazioni note
- Ogni file può includere un massimo di 1,5 milioni di righe.
- Se hai bisogno di più di 1,5 milioni di righe, puoi caricare più file al giorno, ma assicurati di attendere il completamento del caricamento precedente (questa operazione può richiedere diverse ore, a seconda delle dimensioni del file).