Versioni dell'API di Esportazione dei Contatti

Connectif consente di automatizzare le esportazioni massive di contatti e attività tramite l’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 le modifiche apportate in ciascuna versione.

 

1. Proprietà

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

 

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

Di seguito sono elencati i campi e le attività che presentano modifiche in ciascuna versione, mostrando prima le versioni più recenti:

 

Versione 8

a. Attività

Campi aggiunti:

  • ID esterno del contatto
     

b. Tipo di attività: contact-created, newsletter-subscribe e newsletter-unsubscribe

Campi aggiunti:

  • Origine

     

Versione 7

a. Contatti

Campi aggiunti:

  • Consenso al tracciamento delle email

  • Data dell’ultimo rifiuto del consenso al tracciamento delle email

  • Data dell’ultimo consenso al tracciamento delle email

  

Questi campi vengono inclusi nell’esportazione solo quando è attivata la privacy del tracciamento delle email.

 

Versione 6

a. Contatti

Campi aggiunti:

  • Dispone dell’autorizzazione per le notifiche push mobile Android
  • Dispone dell’autorizzazione per le notifiche push mobile iOS
  • Dispone dell’autorizzazione per le notifiche push mobile
  

Questi campi vengono inclusi nell’esportazione solo quando è attivo il canale App Mobile.

 

Versione 5

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 dalla newsletter    
  • Origine della creazione

Campi modificati:

  • Data dell’ultima disiscrizione: diventa Data dell’ultima disiscrizione dalla newsletter

  • IP dell’ultima disiscrizione: diventa IP dell’ultima disiscrizione dalla newsletter
     

b. Tipo di attività: contact-created

Campi aggiunti:

  • Origine

 

Versione 4

a. Tipo di attività: contact-merged

Campi aggiunti:

  • ID del contatto precedente
     

b. Tipo di attività: purchase

Campi aggiunti:

  • ID del contenuto

  • Nome del contenuto

  • Tag del contenuto

  • ID del workflow

  • Nome del workflow

  • Tag del workflow

  • Affidabilità dell’attribuzione

  • Scenario di attribuzione

     

Versione 3

a. Contatti

Campi aggiunti:

b. Tipo di attività: purchase

Campi aggiunti:

  • Tipo di fonte

  • Nome della fonte

 

Versione 2

a. Tipo di attività: purchase

Campi aggiunti:

  • Versione dell’SDK (visibile solo quando è attivo il canale Push Mobile)

  • Versione dell’app (visibile solo quando è attivo il canale Push Mobile)

  • Sistema operativo del dispositivo mobile (visibile solo quando è attivo il canale Push Mobile)

  • Versione del sistema operativo (visibile solo quando è attivo il canale Push Mobile)

  • Dispositivo

Campi modificati:

  • Origine dell’acquisto: diventa Origine
     

b. Tipo di attività: custom-event

Campi aggiunti:

  • Origine

  • Versione dell’SDK (visibile solo quando è attivo il canale Push Mobile)

  • Versione dell’app (visibile solo quando è attivo il canale Push Mobile)

  • Sistema operativo del dispositivo mobile (visibile solo quando è attivo il canale Push Mobile)

  • Versione del sistema operativo (visibile solo quando è attivo il canale Push Mobile)

  • Dispositivo
     

c. Tipo di attività: newsletter-subscribe

Campi aggiunti:

  • Origine

  • Versione dell’SDK (visibile solo quando è attivo il canale Push Mobile)

  • Versione dell’app (visibile solo quando è attivo il canale Push Mobile)

  • Sistema operativo del dispositivo mobile (visibile solo quando è attivo il canale Push Mobile)

  • Versione del sistema operativo (visibile solo quando è attivo il canale Push Mobile)
     

d. Tipo di attività: product-visited

Campi aggiunti:

  • Origine

  • Versione dell’SDK (visibile solo quando è attivo il canale Push Mobile)

  • Versione dell’app (visibile solo quando è attivo il canale Push Mobile)

  • Sistema operativo del dispositivo mobile (visibile solo quando è attivo il canale Push Mobile)

  • Versione del sistema operativo (visibile solo quando è attivo il canale Push Mobile)

  • 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:

  • Referer della pagina visitata: diventa Referer
     

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

Campi modificati:

  • Referer della pagina visitata: diventa Referer

 

 

 

Congratulazioni! 
Hai raggiunto la fine della lezione.

  

Hai ancora dubbi irrisolti? 
Ricorda che hai a disposizione i nostri specialisti Connectif. Per contattarli, ti basterà aprire un ticket al Supporto facendo clic sul pulsante blu “Aiuto” nella dashboard.

 


Continua a imparare!

Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: