Versioni dell’API di Esportazione dei Contatti

Connectif consente di automatizzare esportazioni massive di contatti e attività tramite la API di Esportazione. Tale esportazione conterrà alcune modifiche a seconda della versione dell’API utilizzata. 

In questo articolo, vengono spiegate le proprietà dell’API di Esportazione dei Contatti e i cambiamenti in ciascuna versione.

 

1. Proprietà

  • Se desideri automatizzare periodicamente (giornalmente, settimanalmente…) l’esportazione di tutti o gran parte dei tuoi contatti e/o delle loro attività, puoi utilizzare la API di Esportazione.
  • La richiesta di esportazione contiene diverse Proprietà modificabili, tra cui figura la versione (version) di tale esportazione.
  • La proprietà relativa alla versione di esportazione può essere specificata, per generare un file CSV contenente alcuni campi, a seconda della versione selezionata.
  • Queste versioni presentano alcune variazioni quindi, cambiando la versione, il file CSV generato presenterà delle differenze, che devono essere considerate (vedi punto 2).
  • Se non viene specificata nessuna versione, verrà utilizzata la V1 per impostazione predefinita.
  • Nella funzionalità di esportazione di Contatti della piattaforma, la versione di esportazione sarà sempre la più recente.

 

2. Come viene usato in Connectif: modifiche introdotte nelle versioni

Di seguito sono elencati i campi e le attività con modifiche introdotte in ciascuna delle versioni, mostrando prima le versioni più recenti:

 

Versione V5

a. Contatti

Campi aggiunti:

  • Data dell'ultima iscrizione alla newsletter
  • IP dell'ultima iscrizione alla newsletter
  • Origine dell'ultima iscrizione alla newsletter
  • Origine dell'ultima disiscrizione alla newsletter
  • Origine della creazione

Campi modificati:

  • Data ultimo annullamento abbonamento diventa Data dell'ultima disdetta della newsletter
  • IP ultimo annullamento abbonamento diventa IP dell'ultima cancellazione della newsletter
     

b. Tipo di attività: contact-created

Campi aggiunti:

  • Origine

 

Versione V4

a. Tipo di attività: contact‑merged

Campi aggiunti:

  • ID contatto precedente
     

b. Tipo di attività: purchase

Campi aggiunti:

  • ID contenuto
  • Nome contenuto
  • Tag contenuto
  • ID workflow
  • Nome workflow
  • Tag workflow
  • Fiducia nell'attribuzione
  • Scenario di attribuzione

     

Versione V3

a. Contatti

Campi aggiunti:

b. Tipo di attività: purchase

Campi aggiunti:

  • Tipo di fonte
  • Nome della fonte

 

Versione V2

a. Tipo di attività: purchase

Campi aggiunti:

  • Versione SDK (visibile solo quando il canale Push Mobile è attivato)
  • Versione dell’app (visibile solo quando il canale Push Mobile è attivato)
  • Sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Versione del sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Dispositivo

Campi modificati:

  • Origine acquisto : diventa Origine
     

b. Tipo di attività: custom‑event

Campi aggiunti:

  • Origine
  • Versione SDK (visibile solo quando il canale Push Mobile è attivato)
  • Versione dell’app (visibile solo quando il canale Push Mobile è attivato)
  • Sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Versione del sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Dispositivo
     

c. Tipo di attività: newsletter‑subscribe

Campi aggiunti:

  • Origine
  • Versione SDK (visibile solo quando il canale Push Mobile è attivato)
  • Versione dell’app (visibile solo quando il canale Push Mobile è attivato)
  • Sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Versione del sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
     

d. Tipo di attività: product‑visited

Campi aggiunti:

  • Origine
  • Versione SDK (visibile solo quando il canale Push Mobile è attivato)
  • Versione dell’app (visibile solo quando il canale Push Mobile è attivato)
  • Sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Versione del sistema operativo mobile (visibile solo quando il canale Push Mobile è attivato)
  • Dispositivo
     

e. Tipo di attività: cart‑product‑added e cart‑product‑removed

Campi aggiunti:

  • Origine
  • Dispositivo
     

f. Tipo di attività: web‑page‑visited

Campi modificati:

  • Referente pagina visitata : diventa Referer
     

g. Tipo di attività: email‑link‑clicked

Campi modificati:

  • Referente pagina visitata : diventa Referer

 

 

Congratulazioni!
Sei arrivato alla fine della lezione.

 

Hai ancora dubbi non risolti?
Ricorda che hai a disposizione i nostri specialisti Connectif. Per contattarli, ti basta aprire un ticket al Supporto cliccando sul pulsante blu “Aiuto” della tua dashboard.

 


Continua a imparare!

Per sfruttare appieno il potenziale del tuo account su Connectif, ti consigliamo di proseguire con i seguenti articoli: