Evento de Conversão via API Key

A API key método envolve o uso de chaves exclusivas para autenticar e controlar o acesso aos recursos da API, garantindo segurança e identificação do aplicativo que está realizando as requisições.

É uma forma fácil de fornecer acesso seguro de um sistema a uma Web API.

Com a API Key é muito mais simples para enviar eventos de conversão e integrar os seus formulários com o RD Station Marketing, pois as "chaves" são estáticas, curtas e não expiram. Você faz a chamada informando a API Key e pronto, obtém a resposta, sem fluxos adicionais, sem refresh, etc.

Ou seja, a chave será válida até que você revogue o seu acesso.

📘

Por que usar Chaves de API

As APIs 1.2 e 1.3 são modelos de autenticação simples, quando comparado com o OAuth. Porém, com a API 2.0, além de recursos novos, você também poderá utilizar as Chaves de API.

As chaves de API não são tão seguras quanto a autenticação via OAuth, mas elas ajudam a identificar o aplicativo ou projeto que está chamando uma API de uma forma mais simples.

As integrações de formulário, por exemplo, contam com os recursos das APIs 1.2 e 1.3, e com a utilização das Chaves de API, você passará a ter total controle na criação, ativação e desativação dos tokens.

Bases Legais

Esse tipo de evento aceita a atualização de Bases Legais:

CampoTipoParâmetros válidosDescrição
categoryStringcommunicationsA única categoria aceita é "communications".
typeStringpre_existent_contract, consent, legitimate_interest, judicial_process, vital_interest or public_interestQual base legal autoriza o tratamento de dados pessoais.
statusStringgranted or declinedValores aceitos: "granted" para confirmar o consentimento e "declined" para indicar que o consentimento foi recusado.

Saiba mais sobre os conceitos de Bases Legais aqui.

Casos de utilização

  • Integrações de formulário de conversão;
  • Sistemas internos que enviam conversões para o RD Station Marketing.

Requisitos

Para utilizar esse recurso, você precisa:

  1. Criar um App na Appstore do RD Station Marketing;
  2. Gerar a sua chave;
  3. E utilizar a chave na sua requisição.

Passo a passo para utilizar a API Key

Confira aqui todos os detalhes sobre: