Importare gli eventi da un file CSV o XLSX ti permette di aggiungere grandi quantità di dati sugli eventi in Positive User in modo rapido ed efficiente. Invece di creare gli eventi uno per uno, puoi caricarli in blocco e gestire l'intero processo in pochi semplici passaggi. Questo articolo spiega come preparare il tuo file e importarlo correttamente nella piattaforma.
Prima di iniziare, assicurati che il tuo file sia strutturato correttamente e di capire come vengono memorizzati i dati in Positive User. La piattaforma utilizza sia campi standard (campi predefiniti come indirizzo email o numero di telefono) sia campi personalizzati (campi che crei tu stesso).
Definisci gli eventi: devi prima creare gli eventi nel workspace. Segui i passaggi.
Crea i campi personalizzati: se vuoi includere informazioni aggiuntive sulle occorrenze degli eventi, devi prima creare i campi personalizzati pertinenti. Segui i passaggi in "Come creare un campo personalizzato".
Verifica i tipi di dati: assicurati che ogni colonna abbia il tipo di valore del campo corretto. Ad esempio, se vuoi importare "Scoring", assicurati che il tuo campo sia un intero. Se vuoi importare una "Data", imposta il campo come datetime. Consulta "Cos'è un campo" per i dettagli sui tipi di dati specifici.
Prima di caricare, assicurati che il tuo file sia formattato correttamente. Se non sei sicuro di come debba apparire il tuo file, puoi scaricare un modello pronto all'uso direttamente dall'app cliccando sul pulsante "xlsx" o "csv" nella sezione "Data" → "Import".
Per trovare altri consigli sulla formattazione dei dati, consulta il nostro articolo dedicato.
Campi obbligatori
Importare gli eventi significa che carichi occorrenze specifiche di eventi nelle cronologie dei contatti che le hanno eseguite (ad esempio, cronologia degli acquisti). Per questo motivo è obbligatorio collegare ciascuna occorrenza a un contatto specifico. Puoi farlo tramite
OPPURE
user_id
Il campo "user_id" non dovrebbe mai essere un semplice intero. Consigliamo vivamente di codificarlo.
Inoltre, il file deve includere
event_name (nome dell'evento definito in precedenza nell'app)
datetime (timestamp delle occorrenze dell'evento in formato ISO 8601, ad esempio 2017-07-25T14:14:08.612Z)
Inoltre puoi caricare i campi dell'evento per ciascuna occorrenza dell'evento. Possono essere dettagli specifici cruciali per le statistiche, le automazioni o la segmentazione.
I campi dell'evento nel file dovrebbero essere inseriti nella colonna "attrs" come oggetti JSON con { "key": "value"}
Esempio:
Nota alcuni punti:
- non c'è alcun separatore tra gli oggetti,
- ogni oggetto specifico è inserito in una colonna diversa,
- non dimenticare la parentesi graffa di chiusura.
Intestazioni delle colonne
Includi sempre le intestazioni delle colonne nella prima riga del tuo file. Cerca di dare alle tue colonne esattamente gli stessi nomi dei campi esistenti in Positive User. Se il nome della colonna è identico al nome del campo, il sistema li abbinerà automaticamente durante l'importazione.
Codifica
Cos'è la codifica? La codifica indica al computer come interpretare i caratteri di testo nel tuo file. Il formato predefinito e vivamente consigliato è UTF-8. Scegliendo UTF-8 ti assicuri che caratteri speciali, accenti e simboli vengano importati correttamente senza trasformarsi in simboli casuali.
Separatore
Cos'è un separatore? Nei file CSV (Comma Separated Values), un separatore è il segno di punteggiatura utilizzato per dividere il tuo testo in colonne distinte del foglio di calcolo. I separatori più comuni sono le virgole (,) o i punti e virgola (;).
Controlla come il tuo software di fogli di calcolo ha esportato il file e assicurati di sapere quale carattere divide i tuoi dati.
Vai su "Data" → "Importers" e scegli "Import Events".
OPPURE
Puoi seguire il percorso "Settings" → "Workspace settings" → "Contact data & events" → "Events" →
"Manage" → "Import events"
Carica o trascina in drag & drop il file.
Scegli la codifica adatta al tuo file (UTF-8 è quella predefinita).
Scegli il separatore utilizzato nel tuo file.
Clicca su "Import".
Puoi monitorare il processo di importazione e verificare i risultati finali nella sezione "Import Results", dove vieni reindirizzato automaticamente.
Puoi visitare questa sezione in qualsiasi momento tramite il percorso "Data" → "Importers" → "Import Results".
Qui vedrai:
Stato dell'importazione (Started/Pending/Complete/Archived)
Data di creazione
Completato il
Tipo (che tipo di dati sono stati importati)
Creato da (membro del team che ha caricato il file)
Nome del file
Righe totali (dal tuo file)
Riuscite (numero finale di righe importate)
Fallite (mostra il numero di errori)
Se qualcosa va storto durante l'importazione, clicca sul nome del file per visualizzare un rapporto dettagliato degli errori.
Per visualizzare i profili appena importati, vai su "Data" → "Contacts". Puoi filtrare il tuo database per l'attività specifica del contatto. Inoltre puoi verificare la cronologia degli eventi in "Settings" → "Workspace settings" → "Contact data & events" → "Events".
Mentre modifichi il tuo file nel foglio Google, c'è una regola importante. Ogni oggetto del campo deve essere racchiuso tra virgolette singole, ad esempio "key". Purtroppo, il foglio Google omette una virgoletta se compare come primo carattere della riga. Per evitare questo problema, devi digitare la virgoletta singola due volte. In questo modo sarà corretta sia nel foglio Google sia nel file csv una volta esportato.
