Con il flusso di attività giornaliero, puoi esportare i dati grezzi di Dynamic Yield e inserirli nella tua piattaforma di analisi. Ciò ti consente di collegare i dati di Dynamic Yield alle origini dati del tuo database e creare rapporti personalizzati in base alle tue esigenze aziendali.
L'esportazione consiste in due set di dati:
- Dati grezzi: include interazioni grezze con le varianti, gli eventi e le visualizzazioni pagina di Dynamic Yield.
- Dati di attribuzione: include la relazione tra gli eventi e le varianti a cui sono stati attribuiti in base alle impostazioni dell'esperienza.
I dati vengono esportati quotidianamente in un bucket Amazon S3 protetto, dove vengono memorizzati per 30 giorni.
I dati vengono esportati come file Apache Parquet, un formato ottimizzato per grandi set di dati.
Set di dati
Dati grezzi
Questo set di dati contiene tutte le interazioni dei seguenti tipi:
- Coinvolgimento della variante: clic e impressioni sulle varianti.
- Eventi: ad esempio Acquisti o Sottoscrizioni
- Visualizzazioni di pagina
Ad esempio, se un utente visualizza 3 pagine, attiva 2 eventi e ha 1 impressione di una variante, l'esportazione contiene 6 righe.
Ogni interazione, indicata nel set di dati come eventType, comporta proprietà specifiche. Ad esempio:
eventType | Descrizione | Attributi aggiuntivi (esempi) |
---|---|---|
UIA | Visualizzazione di pagina | URL, contesto pagina |
DPX | Hit da evento | Proprietà evento, valore evento |
VARIATION_ENGAGEMENT | Impressione o clic sulla variante | Nome campagna, nome variante |
Le tabelle seguenti contengono l'elenco completo degli attributi disponibili per ciascun eventType.
Rappresenta una pagina visualizzata dall'utente.
Attributo | Descrizione | Esempio |
---|---|---|
eventType Stringa |
Il tipo di attività. Per la visualizzazione pagina, il valore è UIA (a differenza di VARIATION_ENGAGEMENT o DPX). | "UIA" |
interactionId |
L'identificatore dell'interazione (per un evento specifico, ad esempio un acquisto specifico). Può essere utilizzato per unire questo set di dati al set di dati di attribuzione. |
1234567890 |
contextType Stringa |
Il tipo di pagina, in base al contesto della pagina. | "HOMEPAGE" |
contextData Array di stringhe |
Dati sul tipo di pagina.
|
["Women","Shoes"] |
dyId Long |
L'identificatore interno che Dynamic Yield assegna a ciascun visitatore del sito o dell'app, unico per dispositivo. | 123456789012345678 |
timestamp Long |
L'ora in cui si è verificata l'attività, in millisecondi, dalla UNIX epoch. | 1621798861400 |
sessionId Integer |
L'identificatore interno che Dynamic Yield assegna alla sessione di un visitatore. | 1234567890 |
url Stringa |
L'URL da cui è stato generato l'evento. | "https://www.example.com/?url_params=123" |
urlClean Stringa |
L'URL da cui è stato generato l'evento, dopo aver rimosso eventuali parametri dell'URL. | "https://www.example.com/" |
segmenti di pubblico Array di numeri interi |
L'elenco degli identificatori per i segmenti di pubblico di cui l'utente fa parte al momento della generazione dell'evento. | [1234567, 9876543] |
Browser Stringa |
Il tipo di browser da cui è stato generato l'evento. | "Safari" |
"device": Stringa |
Il tipo di dispositivo che ha attivato l'evento. | "Tablet" |
operatingSystem Stringa |
Il sistema operativo del dispositivo che ha generato l'evento. | "Mac OS X" |
screenResolution Stringa |
La risoluzione dello schermo del dispositivo che ha generato l'evento. | "Bassa (da 1024px in giù)" |
reqTimestamp Long |
Timestamp della richiesta interno alla pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
procTimestamp Long |
Timestamp di elaborazione interno della pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
resTimestamp Long |
Timestamp di risoluzione interno della pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
Rappresenta un evento di Dynamic Yield attivato dall'utente.
Attributo | Descrizione | Esempio |
---|---|---|
eventType Stringa |
Il tipo di attività. Per una hit da evento, il valore è DPX (a differenza di VARIATION_ENGAGEMENT o UIA). | "DPX" |
interactionId |
L'identificatore dell'interazione (per un evento specifico, ad esempio un acquisto specifico). Può essere utilizzato per unire questo set di dati al set di dati di attribuzione. |
1234567890 |
eventId Integer |
Un identificatore univoco per ogni evento generato esplicitamente dal sito. | 12345 |
eventName Stringa |
Il nome dell'evento come scritto nell'API dell'evento. | "Purchase" |
eventProperties Stringa (JSON) |
Le proprietà dell'evento come scritte nell'API dell'evento. Queste differiscono a seconda del valore di eventType. | { "transaction_id": "ABC123456", "value": 100.0, "currency": "USD", "dyType": "purchase-v1", "Brands": "Nike", "Categories": "Sneakers", "Number_of_items": 1.0, "cart": [{ "productId": "AIR-123", "quantity": 1.0, "itemPrice": 100.0 }] } |
eventValue Long |
Il valore totale di tutti gli articoli presenti nel carrello, così come come appaiono nell'attributo eventProperties. Il valore è espresso in centesimi. |
10000 |
uniqueTransactionId Stringa |
L'ID della transazione, come appare nell'attributo eventProperties per un evento di acquisto. |
ABC123456 |
productIds |
L'elenco degli ID prodotto su cui è stata eseguita un'azione. |
[“12345”] |
dyId Long |
L'identificatore interno che Dynamic Yield assegna a ciascun visitatore del sito o dell'app, unico per dispositivo. | 123456789012345678 |
timestamp Long |
L'ora in cui si è verificata l'attività, in millisecondi, dalla UNIX epoch. | 1621798861400 |
sessionId Integer |
L'identificatore interno che Dynamic Yield assegna alla sessione di un visitatore | 1234567890 |
url Stringa |
L'URL da cui è stato generato l'evento. | "https://www.example.com/?url_params=123" |
urlClean Stringa |
L'URL da cui è stato generato l'evento, dopo aver rimosso eventuali parametri dell'URL. | "https://www.example.com/" |
segmenti di pubblico Array di numeri interi |
L'elenco degli identificatori per i segmenti di pubblico di cui l'utente fa parte al momento della generazione dell'evento. | [1234567, 9876543] |
browser Stringa |
Il tipo di browser da cui è stato generato l'evento. | "Safari" |
device Stringa |
Il tipo di dispositivo che ha attivato l'evento | "Tablet" |
operatingSystem Stringa |
Il sistema operativo del dispositivo che ha generato l'evento. | "Mac OS X" |
screenResolution Stringa |
La risoluzione dello schermo del dispositivo che ha generato l'evento. | "Bassa (da 1024px in giù)" |
reqTimestamp Long |
Timestamp interno della richiesta alla pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
procTimestamp Long |
Timestamp interno della richiesta alla pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
resTimestamp Long |
Timestamp di risoluzione interno della pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
Rappresenta un'impressione di una variante o un clic su una variante
Attributo | Descrizione | Esempio |
---|---|---|
eventType Stringa |
Il tipo di attività. Per il clic o l'impressione sulla variante, il valore è VARIATION_ENGAGEMENT (a differenza di UIA o DPX). | VARIATION_ENGAGEMENT |
interactionId |
L'identificatore dell'interazione (per un evento specifico, ad esempio un acquisto specifico). Può essere utilizzato per unire questo set di dati al set di dati di attribuzione. |
1234567890 |
engagementType Stringa |
Il tipo di coinvolgimento con la variante. Valori possibili
|
"IMPRESSION" |
campaignId Integer |
L'ID della campagna di cui fa parte questa variante. Per il coinvolgimento con i blocchi di Experience Email, questo valore rappresenta l'ID del blocco, mentre parentCampaignId contiene l'ID della campagna Experience Email. | 123456 |
campaignName Stringa |
Il nome della campagna di cui fa parte questa variante. Per il coinvolgimento con i blocchi di Experience Email, questo valore rappresenta il nome del blocco, mentre parentCampaignName contiene il nome della campagna Experience Email. | "Homepage Banner" |
experienceId Integer |
L'ID dell'esperienza di cui fa parte questa variante. | 123456 |
experienceName Stringa |
Il nome dell'esperienza di cui fa parte questa variante. | "Summer Promo" |
experimentId Integer |
L'identificatore univoco del test. | 123456 |
versionId Integer |
L'identificatore univoco della versione del test. Un test A/B può avere più versioni. | 245467 |
variationIds Array di numeri interi |
L'ID della variante proposta all'utente (se il tipo è IMPRESSION) o su cui l'utente ha fatto clic (se il tipo è CLICK). Di solito, l'elenco contiene un singolo ID, ma se il tipo di campagna è "Elenco di elementi con contenuto dinamico", contiene un elenco di varianti, separate da virgole. |
[1234567, 9876543] |
attributionVariationIds Array di numeri interi |
L'ID della variante nel set di dati di attribuzione. Questo identificatore deve essere usato per unire il set di dati di attribuzione al set di dati grezzi, dove raw.attributionVariationIds = attribution.variations. Di solito, l'elenco contiene un singolo ID, ma se il tipo di campagna è "Elenco di elementi di contenuto dinamico", contiene un elenco di varianti, separate da virgole. |
[1234567, 9876543] |
variationNames Array di stringhe |
Il nome della variante proposta all'utente (se il tipo è IMPRESSION) o su cui l'utente ha fatto clic (se il tipo è CLICK). Di solito, l'elenco contiene un singolo ID, ma se il tipo di campagna è "Elenco di elementi di contenuto dinamico", contiene un elenco di varianti, separate da virgole. |
["Blue Button", "Red Button"] |
sku Array di stringhe |
Se l'evento è una visualizzazione o un clic su un widget di raccomandazione, ossia engagementType è "CLICK" or "STRATEGY_IMPRESSION", è l'elenco delle SKU consigliate o la SKU su cui l'utente ha fatto clic. |
["1234", "9876"] |
strategyId Array di numeri interi |
Se l'evento è una visualizzazione o un clic su un widget di raccomandazione, è l'ID della Strategia proposta. Una singola variante può includere più widget con strategie multiple. |
[126651,426356] |
strategyName |
Se l'evento è una visualizzazione o un clic su un widget di raccomandazione, è il nome della Strategia proposta. Una singola variante può includere più widget con strategie multiple. |
["Most Popular","Affinity"] |
touchpointId Integer |
Solo nei punti di contatto: l'ID del punto di contatto. | 245467 |
touchpointName |
Solo nei punti di contatto: il nome del punto di contatto. | ["Hero Banner"] |
parentVariationId Integer |
Solo nei punti di contatto: l'ID della variante che viene proposta a questo punto di contatto nella campagna multi-touch. | [9876543] |
parentVariationName |
Solo nei punti di contatto: il nome della variante che viene proposta a questo punto di contatto nella campagna multi-touch. | "Blue Design" |
parentCampaignId |
Se il coinvolgimento è con un blocco Experience Email, questo campo contiene l'ID campagna della campagna Experience Email | 123456 |
parentCampaignName |
Se il coinvolgimento è con un blocco Experience Email, questo campo contiene il nome campagna della campagna Experience Email. | "Experience Email Campaign 1" |
dyId Long |
L'identificatore interno che Dynamic Yield assegna a ciascun visitatore del sito o dell'app, unico per dispositivo. | 123456789012345678 |
timestamp Long |
L'ora in cui si è verificata l'attività, in millisecondi, dalla UNIX epoch. | 1621798861400 |
sessionId Integer |
L'identificatore interno che Dynamic Yield assegna alla sessione di un visitatore | 1234567890 |
url Stringa |
L'URL da cui è stato generato l'evento. | "https://www.example.com/?url_params=123" |
urlClean Stringa |
L'URL da cui è stato generato l'evento, dopo aver rimosso eventuali parametri dell'URL. | "https://www.example.com/" |
segmenti di pubblico Array di numeri interi |
L'elenco degli identificatori per i segmenti di pubblico di cui l'utente fa parte al momento della generazione dell'evento. | [1234567, 9876543] |
reqTimestamp Long |
Timestamp interno della richiesta alla pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
procTimestamp Long |
Timestamp interno della richiesta alla pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
resTimestamp Long |
Timestamp di risoluzione interno della pipeline di analisi, in millisecondi, dalla UNIX epoch. | 1621798861400 |
Dati di attribuzione
Questo set di dati contiene la relazione tra una variante e gli eventi ad essa attribuiti in base alle impostazioni dell'esperienza.
Ogni record dei set di dati rappresenta una combinazione distinta di evento-variante.
Tieni presente che, solitamente, esiste una relazione uno-a-molti tra eventi e variazioni. Ad esempio, se 1 acquisto è stato attribuito a 2 varianti (controllo del test A, variante del test B), il set di dati contiene 2 righe.
Campo | Descrizione |
---|---|
interactionId Int |
L'identificatore dell'interazione (per un evento specifico, ad esempio, un acquisto specifico). Può essere utilizzato per unire questo set di dati al set di dati di attribuzione. |
eventType (varchar) |
Il tipo di evento attribuito a una variante. Attualmente, solo gli eventi DPX vengono esportati. |
dyid (int) |
L'identificatore dell'utente che ha attivato l'evento attribuito. |
experimentId (int) |
L'ID dell'esperimento a cui è stato attribuito l'evento. |
versionId (int) |
L'ID della versione dell'esperimento a cui è stato attribuito l'evento. |
varianti (array) |
L'array degli ID delle variazioni a cui è stato attribuito l'evento, Questo array contiene, in genere, un singolo valore, ma può contenere più valori se l'esperienza è un elenco di articoli. Questo identificatore corrisponde a attributionVariationIds nel set di dati grezzo. |
eventId (int) |
L'ID dell'evento DPX attribuito alla variante. Ad esempio, per un acquisto, sarebbe l'ID dell'evento Acquisto. |
eventValue (int) |
Il valore dell'evento DPX attribuito alla variante. Ad esempio, per un acquisto, rappresenterebbe il ricavo collegato all'evento Acquisto.
Il valore è espresso in centesimi. |
Attivazione del flusso di attività giornaliero
Per attivare il flusso di attività giornaliero:
- Vai a Impostazioni › Impostazioni generali › Flusso di attività giornaliero.
- Fai clic su Attiva esportazione giornaliera.
- Copia il percorso e le credenziali del bucket S3 in un luogo sicuro. Vengono visualizzati solo una volta.
Hai perso le tue credenziali?
Fai clic sull'icona delle opzioni aggiuntivee su Genera nuove credenziali. Tieni in mente che puoi generare nuove credenziali solo una volta.
- Questo è tutto! l primo set di dati sarà esportato dopo la mezzanotte, dopo di che i nuovi dati saranno aggiunti quotidianamente.
Nota: se una sezione non ha traffico in un giorno specifico, per quel giorno non verranno esportati dati o cartelle nel bucket AWS S3.
Dopo aver attivato il Flusso di attività giornaliero (attivando il pulsante di attivazione/disattivazione), la pagina visualizza anche lo stato dell'esportazione.
Puoi sempre disattivare l'esportazione nel menu delle opzioni. Se disabiliti l'esportazione e poi la abiliti di nuovo, il bucket S3 rimane lo stesso, ma ti verrà fornito un nuovo set di credenziali;.
Accesso al tuo bucket S3
Dopo aver attivato il flusso di attività giornaliero, otterrai l'accesso a un bucket S3 con il seguente percorso:
- s3://dy-raw-data-export/sectionId=1234567, per il data center USA
- s3://dy-raw-data-export-eu/sectionId=1234567, per il data center UE.
In questo percorso troverai le sottocartelle per ogni data, dove sono memorizzati i file Parquet.
Ad esempio, questo percorso contiene tutti i dati raccolti il 01-01-2022, in base al fuso orario configurato nelle Impostazioni generali:
s3://dy-raw-data-export-eu/sectionId=1234567/date=2022-01-01
In questo percorso troverai le sottocartelle per ogni tipo di rapporto
-
Questo percorso include i dati grezzi attualmente esportati:
s3://dy-raw-data-export/sectionId=1234567/date=2023-01-01/reportType=raw
-
Questo percorso include i nuovi dati di attribuzione:
s3://dy-raw-data-export/sectionId=1234567/date=2023-01-01/reportType=attribution
Download dei file a livello locale tramite Terminal
- Crea sul computer una cartella che conterrà i file scaricati.
- Apri Terminal e vai alla cartella che hai creato.
- Inserisci il comando aws configure.
- Quando viene richiesto, immetti la chiave di accesso e la chiave segreta, come generate nella sincronizzazione del feed.
- Quando viene richiesto, inserisci la tua regione del data center: eu-central-1 or us-east-1, a seconda dei casi.
- Al successivo prompt (output predefinito), è sufficiente premere Invio.
- Quando viene richiesto, inserisci aws s3 sync e il relativo percorso S3 (vedi Accesso al tuo bucket S3). Ad esempio:
aws s3 sync s3://dy-raw-data-export-eu/sectionId=SECTIONID/date=2023-05-05/reportType=raw/ - I file vengono scaricati. Puoi vederli in Terminal e, al completamento, li vedrai nella cartella che hai creato nel passaggio 1.
Importazione dei dati nella tua piattaforma di analisi
Per integrare automaticamente i dati del Flusso di attività giornaliero nei tuoi sistemi, puoi creare un lavoro per estrarre i file Parquet da S3 e caricarli nel database scelto. Ecco alcuni link ad articoli pertinenti per soluzioni popolari: