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

A Connectif permite automatizar exportações em massa de contatos e atividades através da API de Exportação. Essa exportação conterá certas 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 mudanças em cada versão.

 

1. Propriedades

  • Se você deseja automatizar periodicamente (diária, semanal…) a exportação de todos ou grande parte dos seus contatos e/ou suas atividades, você pode usar a API de Exportação.
  • A solicitação de exportação contém diferentes Propriedades editáveis, dentre 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 certos campos, dependendo da versão selecionada.
  • Essas versões apresentam algumas variações de modo que, ao mudar a versão, o arquivo CSV gerado apresentará diferenças, que devem ser consideradas (ver ponto 2).
  • Se nenhuma versão for especificada, será utilizada a V1 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 é usado na Connectif: alterações introduzidas nas versões

A seguir, listam‑se os campos e atividades com alterações introduzidas em cada uma das versões, mostrando as versões mais recentes primeiro:

 

Versão V5

a. Contatos

Campos adicionados:

  • Data da última assinatura do boletim informativo
  • IP da última assinatura do boletim informativo
  • Origem da última assinatura do boletim informativo
  • Origem do último cancelamento de assinatura do boletim informativo
  • Origem da criação

Campos modificados:

  • Data da última licença: passa a ser Data do último cancelamento de assinatura do boletim
  • IP da última vítima: passa a ser IP do último cancelamento de assinatura do boletim informativo
     

b. Tipo de atividade: contact-created

Campos adicionados:

  • Origem

     

Versão V4

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
  • Etiquetas de conteúdo
  • ID workflow
  • Nome do workflow
  • Etiquetas de workflow
  • Confiança na atribuição
  • Cenário de atribuição
     

Versão V3

a. Contatos

Campos adicionados:

b. Tipo de atividade: purchase

Campos adicionados:

  • Tipo de fonte
  • Nome da fonte
     

Versão V2

a. Tipo de atividade: purchase

Campos adicionados:

  • Versão do SDK (somente visível quando o canal Push Móvel está ativado)
  • Versão da aplicação (somente visível quando o canal Push Móvel está ativado)
  • SO móvel (somente visível quando o canal Push Móvel está ativado)
  • Versão do sistema operativo móvel (somente visível 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 (somente visível quando o canal Push Móvel está ativado)
  • Versão da aplicação (somente visível quando o canal Push Móvel está ativado)
  • SO móvel (somente visível quando o canal Push Móvel está ativado)
  • Versão do sistema operativo móvel (somente visível quando o canal Push Móvel está ativado)
  • Dispositivo
     

c. Tipo de atividade: newsletter‑subscribe

Campos adicionados:

  • Origem
  • Versão do SDK (somente visível quando o canal Push Móvel está ativado)
  • Versão da aplicação (somente visível quando o canal Push Móvel está ativado)
  • SO móvel (somente visível quando o canal Push Móvel está ativado)
  • Versão do sistema operativo móvel (somente visível quando o canal Push Móvel está ativado)
     

d. Tipo de atividade: product‑visited

Campos adicionados:

  • Origem
  • Versão do SDK (somente visível quando o canal Push Móvel está ativado)
  • Versão da aplicação (somente visível quando o canal Push Móvel está ativado)
  • SO móvel (somente visível quando o canal Push Móvel está ativado)
  • Versão do sistema operativo móvel (somente visível 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:

  • Consulta a página visitada: torna‑se Referer

g. Tipo de atividade: email‑link‑clicked

Campos modificados:

  • Consulta a página visitada: torna‑se Referer

 

 

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

 

Ainda ficou com dúvidas?
Lembre‑se de que você tem à disposição os nossos especialistas da Connectif. Para contactá‑los, basta abrir um ticket no Suporte clicando no botão azul “Ajuda” do seu painel.

 


Continue aprendendo!

Para aproveitar todo o potencial da sua conta na Connectif, recomendamos que você continue com os seguintes artigos: