Por meio de uma API, a Dito integra os dados de qualquer sistema de cashback para que a sua marca possa trabalhar com novos eventos de comportamento e amplie suas estratégias de comunicação.

• Nível de Acesso: Administrador, Desenvolvedor.
  Persona: Analista de Marketing, Desenvolvedor, Gerente de CRM.

Integrações: Como integrar os dados do seu sistema de Cashback com a Dito

1. Entenda quais são os eventos de Cashback que serão usados na Dito

Para garantir que a sua equipe técnica saiba quais dados precisam ser enviados para a API, é essencial realizar um estudo de negócios. Dessa forma, será possível obter uma visão clara dos eventos e propriedades que sua marca deseja utilizar nas estratégias de comunicação.

Neste artigo, apresentamos uma lista de todos os eventos e propriedades disponíveis para serem trabalhados nos produtos Dito. A partir dessa lista, você poderá fazer uma análise detalhada das opções disponíveis e selecionar as mais relevantes para o seu cenário específico. 

Após definir os eventos e propriedades que precisam ser integrados, recomendamos que você discuta com seu time técnico a viabilidade de implementar o envio desses dados.

2. Informe a necessidade de integração

Com os eventos e propriedades já definidos, é importante entrar em contato com o CS da sua conta ou com o time de Atendimento para manifestar o interesse no processo de integração. Dessa forma, será possível solicitar a liberação da API para o seu time técnico. É necessário também informar para o CS ou para o time de Atendimento o e-mail do time técnico que enviará os dados para a API.

Essa liberação faz parte do plano Premium do CDP.

Com a liberação para avançar com o processo de integração, temos duas atividades que podem ocorrer em paralelo: o passo 3, focado na finalização das atividades de negócios, e o passo 4, focado em atividades técnicas.

3. Finalize seu plano de tracking junto com a Dito

Após receber o feedback positivo confirmando a possibilidade de avançar com a integração, o próximo passo será fechar o plano de tracking. Nesse momento, é crucial que a sua marca já tenha uma compreensão clara dos eventos e propriedades que serão trabalhados nos produtos Dito.

Para isso, é necessário preencher um modelo de documento, especificando todos os campos do sistema de cashback a serem integrados.

Exemplo prático:

Se sua marca deseja trabalhar o evento “gerou_cashback”, o modelo de tracking deverá conter o correspondente de cada propriedade desse evento em relação ao seu sistema de cashback.

Além dessas propriedades, é fundamental entender o tracking de outros dados importantes para a criação dos eventos. É necessário também compreender o correspondente de cada um desses dados em relação ao sistema de cashback.

O fechamento desse plano de tracking poderá ser realizado em uma reunião com o nosso time de negócios.

Obs. 1: As propriedades em negrito representam os dados obrigatórios em todos os eventos.

Obs. 2: A Propriedade “Evento_Origem” é relevante, pois é a informação que faz com que a API compreenda qual é o evento que deve ser gerado.

4. Realize configurações para a utilização da API

Após a liberação da API, o time técnico precisará realizar, em paralelo, uma requisição ao OpenAPI para gerar o token de autenticação que será utilizado posteriormente. Para isso, o time técnico receberá um e-mail informado no passo 2, contendo as instruções para criar uma senha.

As informações de login (e-mail) e a senha serão necessárias para que o time técnico possa, então, gerar o token.

5. Envie os dados para a API

Para enviar os dados para a API, o time técnico precisará seguir o plano de tracking para identificar os campos necessários do sistema de cashback. Além disso, para enviar uma requisição, a API requer os campos obrigatórios:

• Token de autenticação gerado no passo 4.
• Nome da marca, que deve corresponder exatamente à informação utilizada dentro da plataforma Dito. Por exemplo: a marca pode ser chamada ABCDEFGH, mas na API, é necessário informar o valor destacado, como abcd-efgh.
  
  

Com essas informações em mãos, a API estará pronta para receber qualquer conjunto de dados em formato JSON, respeitando o limite máximo de 4 MB. Para detalhes técnicos mais aprofundados, consulte a documentação da API na seção Ingest API.

Dessa forma, bastará enviar os campos acordados no plano de tracking e, após o nosso time técnico realizar as configurações necessárias, os eventos já estarão disponíveis no dashboard da sua marca, prontos para serem utilizados de maneira estratégica.

Assim, o processo de integração estará concluído, proporcionando novas possibilidades para aprimorar suas estratégias de comunicação.

6. Delay na atualização de informações

A integração do cashback, considerando o modelo de integração D-1 (os dados de hoje chegam no dia seguinte), deve ser considerada com cuidado pelas marcas, pois pode impactar diretamente os dados exibidos para os clientes.

O delay na atualização das informações significa que os dados das transações de cashback podem não ser refletidos imediatamente nas campanhas.

Como resultado, a marca pode não ter acesso às informações mais recentes para tomar decisões em tempo real, o que pode afetar as informações que são enviadas aos clientes.

Dessa forma, é fundamental que as marcas considerem esse fator ao utilizar variáveis personalizadas, como os custom data, em suas campanhas e garantir que sempre informem nas comunicações que o saldo está sujeito a mudanças.

Recomendação: Ajuste as expectativas e cronogramas de campanhas para refletir o tempo de atualização dos dados na Dito. É importante planejar as campanhas com a compreensão de que a atualização das informações pode não ser imediata, garantindo uma estratégia mais alinhada com a realidade da integração.

FAQ – Perguntas Frequentes

1. Pergunta: O que é o "plano de tracking" e por que ele é necessário?
Resposta: O plano de tracking é um documento onde você e o time da Dito definem exatamente quais dados (eventos e propriedades) do seu sistema de cashback serão enviados e como eles serão nomeados dentro da Dito. Ele é crucial para garantir que a integração funcione corretamente e que os dados recebidos sejam úteis para suas campanhas.

2. Pergunta: A integração via API tem algum custo adicional?
Resposta: Sim, a liberação e o uso da API de integração fazem parte do plano Premium do Dito CDP. É importante entrar em contato com o CS da sua conta para verificar as condições e habilitar o acesso.

3. Pergunta: Enviei os dados via API, mas eles não aparecem na plataforma. Qual é o tempo de atualização?
Resposta: A integração opera em um modelo D-1, o que significa que os dados de transações de um dia são processados e ficam disponíveis na Dito no dia seguinte. Leve em conta esse delay de até 24 horas ao planejar campanhas que usam dados de cashback.

4. Pergunta: Preciso ter conhecimento técnico para realizar a integração?
Resposta: A integração envolve o uso de uma API, o que requer conhecimento técnico. A sua equipe de desenvolvedores precisará gerar um token de autenticação e enviar os dados em formato JSON, seguindo a documentação técnica da Dito e o plano de tracking definido.

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)