Versões da API de Exportação de Contatos

O Connectif permite automatizar exportações em massa de contatos e atividades por meio da API de Exportação. Essa exportação conterá determinadas modificações dependendo da versão da API utilizada. 

Neste artigo, são explicadas as propriedades da API de Exportação de Contatos e as alterações em cada uma das versões.

 

1. Propriedades

  • Se você quiser automatizar periodicamente (diariamente, semanalmente...) a exportação de todos ou de grande parte dos seus contatos e/ou das atividades deles, poderá utilizar a API de Exportação.
  • A solicitação de exportação contém diferentes propriedades editáveis, entre as quais está a versão (version) dessa exportação.
  • A propriedade referente à versão de exportação pode ser especificada para gerar um arquivo CSV que contenha determinados campos, dependendo da versão selecionada.
  • Essas versões apresentam algumas variações. Por isso, ao alterar a versão, o arquivo CSV gerado apresentará diferenças que devem ser levadas em consideração (ver ponto 2).
  • Se nenhuma versão for especificada, a V1 será utilizada por padrão.
  • Na funcionalidade de exportação de Contatos da plataforma, a versão de exportação será sempre a mais recente.

 

2. Como é usada no Connectif: alterações introduzidas nas versões

A seguir, são listados os campos e as atividades com alterações introduzidas em cada uma das versões, mostrando primeiro as versões mais recentes:

 

Versão 8

a. Atividades

Campos adicionados:

  • ID externo do contato
     

b. Tipo de atividade: contact-created, newsletter-subscribe e newsletter-unsubscribe

Campos adicionados:

  • Origem

     

Versão 7

a. Contatos

Campos adicionados:

  • Consentimento para o rastreamento de e-mail

  • Data da última recusa do consentimento para o rastreamento de e-mail

  • Data do último consentimento para o rastreamento de e-mail

  

Esses campos só são incluídos na exportação quando a privacidade do rastreamento de e-mails está ativada.

 

Versão 6

a. Contatos

Campos adicionados:

  • Tem permissão para push móvel Android
  • Tem permissão para push móvel iOS
  • Tem permissão para push móvel
  

Esses campos só são incluídos na exportação quando o canal Aplicativo móvel está ativado.

 

Versão 5

a. Contatos

Campos adicionados:

  • Data da última inscrição na newsletter
  • IP da última inscrição na newsletter    
  • Origem da última inscrição na newsletter    
  • Origem do último cancelamento da newsletter    
  • Origem de criação

Campos modificados:

  • Data do último cancelamento: passa a ser Data do último cancelamento da newsletter

  • IP do último cancelamento: passa a ser IP do último cancelamento da newsletter
     

b. Tipo de atividade: contact-created

Campos adicionados:

  • Origem

 

Versão 4

a. Tipo de atividade: contact-merged

Campos adicionados:

  • ID do contato anterior
     

b. Tipo de atividade: purchase

Campos adicionados:

  • ID do conteúdo

  • Nome do conteúdo

  • Tags do conteúdo

  • ID do workflow

  • Nome do workflow

  • Tags do workflow

  • Confiança da atribuição

  • Cenário de atribuição

     

Versão 3

a. Contatos

Campos adicionados:

b. Tipo de atividade: purchase

Campos adicionados:

  • Tipo de fonte

  • Nome da fonte

 

Versão 2

a. Tipo de atividade: purchase

Campos adicionados:

  • Versão do SDK (visível somente quando o canal Push Móvel está ativado)

  • Versão do aplicativo (visível somente quando o canal Push Móvel está ativado)

  • Sistema operacional do celular (visível somente quando o canal Push Móvel está ativado)

  • Versão do sistema operacional (visível somente quando o canal Push Móvel está ativado)

  • Dispositivo

Campos modificados:

  • Origem da compra: passa a ser Origem
     

b. Tipo de atividade: custom-event

Campos adicionados:

  • Origem

  • Versão do SDK (visível somente quando o canal Push Móvel está ativado)

  • Versão do aplicativo (visível somente quando o canal Push Móvel está ativado)

  • Sistema operacional do celular (visível somente quando o canal Push Móvel está ativado)

  • Versão do sistema operacional (visível somente quando o canal Push Móvel está ativado)

  • Dispositivo
     

c. Tipo de atividade: newsletter-subscribe

Campos adicionados:

  • Origem

  • Versão do SDK (visível somente quando o canal Push Móvel está ativado)

  • Versão do aplicativo (visível somente quando o canal Push Móvel está ativado)

  • Sistema operacional do celular (visível somente quando o canal Push Móvel está ativado)

  • Versão do sistema operacional (visível somente quando o canal Push Móvel está ativado)
     

d. Tipo de atividade: product-visited

Campos adicionados:

  • Origem

  • Versão do SDK (visível somente quando o canal Push Móvel está ativado)

  • Versão do aplicativo (visível somente quando o canal Push Móvel está ativado)

  • Sistema operacional do celular (visível somente quando o canal Push Móvel está ativado)

  • Versão do sistema operacional (visível somente quando o canal Push Móvel está ativado)

  • Dispositivo
     

e. Tipo de atividade: cart-product-added e cart-product-removed

Campos adicionados:

  • Origem

  • Dispositivo
     

f. Tipo de atividade: web-page-visited

Campos modificados:

  • Referer da página visitada: passa a ser Referer
     

g. Tipo de atividade: email-link-clicked

Campos modificados:

  • Referer da página visitada: passa a ser Referer

 

 

 

Parabéns! 
Você chegou ao final da lição.

  

Ficou com alguma dúvida sem resolver? 
Lembre-se de que você pode contar com nossos especialistas do Connectif. Para entrar em contato com eles, basta abrir um ticket com o Suporte clicando no botão azul “Ajuda” do seu dashboard.

 


Continue aprendendo!

Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos: