O que é integração
Integração é a configuração da operação conjunta de dois sistemas independentes: seu site e/ou aplicativo e a plataforma Admitad.
A integração com a Admitad é um passo obrigatório para o lançamento de um programa afiliado, pois a integração permite:
- rastrear ações de usuários em seu site e/ou aplicativo;
- e enviar dados gravados de ações para o sistema Admitad.
Os dados de uma ação incluem o código do programa, o código da ação, o código da taxa, o número do pedido, seu valor e outros parâmetros da ação.
O sistema Admitad salva em relatórios os dados enviados pelo seu site e/ou aplicativo e determina o afiliado do espaço através do qual o usuário acessou seu site e fez uma ação. Dessa forma, a ação é atribuída ao afiliado correspondente.
Uma integração configurada corretamente permite que você registre todas as ações de usuários e atribua-as corretamente aos afiliados.
Como resultado, você controla seus custos com o programa afiliado, e os afiliados recebem sua remuneração integralmente.
Leia mais sobre a integração de aplicativos para celular neste artigo.
Formas de integração com a Admitad
Você pode fazer a integração:
-
usando plugins prontos. É o caminho mais rápido para sites em sistemas SaaS ou CMS: WordPress, Shopify ou 1C-Bitrix. Saiba mais sobre a integração por meio de plugins
-
de maneira personalizada. Essas formas são adequadas para sites e aplicativos tecnicamente mais complexos. Portanto, a integração exige a contribuição de seus desenvolvedores.
A integração está disponível por meio de uma requisição postback, um código de rastreamento, um XML, a API do Google Analytics e a API do seu site ou aplicativo. Saiba mais sobre integrações personalizadas
Como iniciar a integração
1. Antes de iniciar a integração, certifique-se de que pelo menos uma ação e uma taxa já foram adicionadas ao seu programa. A integração não pode ser concluída sem esse passo.
- Se você tiver um gestor pessoal, ele adicionará ações e taxas para você.
- Se você não tiver um gestor, você mesmo precisa adicionar ações e taxas na seção Actions (Program → Traffic settings → Actions and rewards) — instruções para adicionar ações.
2. Decida uma forma de integrar seu site e/ou aplicativo com a Admitad.
Se você tiver dificuldade para escolher uma forma de integração, consulte seus desenvolvedores ou vá para esta seção das instruções.
3. Depois, em sua conta pessoal, vá para a seção Integration (Program → Integration) e clique em Next.
4. Vá para uma das guias, dependendo da forma selecionada:
-
integração usando plugins: a integração por meio de um plugin pronto para seu site em um sistema CMS: WordPress, Shopify ou 1C-Bitrix;
-
integração personalizada: a integração por meio de uma requisição postback, um XML, um código de rastreamento, a API do Google Analytics.
5. Selecione a forma desejada e clique em Next.
6. Na página Configurações de integração, você verá as seguintes seções:
-
Configurações de integração: valores de parâmetros exclusivos para seu programa: os valores de parâmetros para seu programa necessários para concluir a integração.
-
Configurações de deduplicação: um link para as instruções para configurar a deduplicação.
-
Teste de integração: um link de teste que você pode usar para verificar se a integração foi bem-sucedida e se as ações em seu site estão sendo rastreadas corretamente.
7. Vá para as instruções da forma de integração selecionada e siga todos os passos descritos nelas.
- Instruções de integração via plugins:
- Instruções de integração personalizada:
Como escolher uma forma de integração
A escolha de uma forma de integração depende das características técnicas do seu site.
- Você pode determinar a forma apropriada usando o diagrama ou a descrição abaixo.
- Ou consulte seu próprio especialista que desenvolve e oferece suporte ao seu site: ele o ajudará a escolher a forma ideal, levando em consideração as características do seu projeto.
- Você também pode se familiarizar com os recursos de diferentes formas de integração nesta seção.
Como escolher uma forma de integração
Para escolher a forma de integração mais adequada, especifique:
Você mesmo planeja enviar dados de ações de seu site para o servidor Admitad?
-
Se sua resposta for "sim":
Você vai transferir dados do servidor web (back-end) ou do site (front-end)?
-
Se for do servidor web:
Seu site foi desenvolvido na plataforma 1C-Bitrix, WordPress ou Shopify?- Se sua resposta for "sim" → selecione a integração via plugins.
- Se sua resposta for "não" → selecione a integração via requisição postback.
-
Se for do site → use a integração via código de rastreamento.
- Se sua resposta for "não", a Admitad receberá dados de ações de sua parte. Você tem sua própria API?
- Se sua resposta for "sim" → use a integração via API.
-
Se sua resposta for "não" → use a integração via XML ou a API do Google Analytics.
Recursos e vantagens das formas de integração
Integração via plugins
A integração com plugins prontos é a forma mais rápida e fácil de integrar seu site à Admitad.
Use se o seu site estiver em uma das seguintes plataformas:
Vantagens:
- A forma mais rápida e acessível de realizar a integração. Nenhuma assistência do desenvolvedor é necessária para configuração e teste.
Desvantagens:
- Esta forma de integração é adequada apenas para sites criados em determinadas plataformas.
- Se forem feitas alterações no módulo do sistema CMS, o plugin pode funcionar incorretamente.
Integração personalizada
As seguintes formas de integração personalizada estão disponíveis na Admitad:
- Integração por meio de requisição postback
- Integração por meio de um código de rastreamento
- Integração por meio de arquivo XML
- Integração por meio da API do Google Analytics
- Integração por meio de API
Para todas as formas de integração personalizada, a deduplicação e o rastreamento entre dispositivos podem ser configurados.
-
A deduplicação é um método de processamento de dados que permite identificar corretamente uma fonte de tráfego paga para atribuir um pedido a ela, bem como eliminar ações duplicadas, se houver.
Uma fonte de tráfego paga é qualquer recurso de terceiros ao qual você paga por atrair usuários ao seu site sob certas condições: por cada acesso ao site, visualização de anúncios, solicitação, cadastro ou compra. Por exemplo, publicidade direcionada e contextual, publicações pagas em canais de influenciadores, etc.
O rastreamento entre dispositivos é uma tecnologia que permite rastrear ações feitas por um usuário em diferentes dispositivos. Saiba mais
Integração por meio de requisição postback
Ao integrar por meio de uma requisição postback, seu servidor envia uma requisição postback ao servidor Admitad com dados de ações feitas pelos usuários em seu site.
O servidor Admitad registra os dados recebidos em relatórios, com base nos quais os afiliados são pagos.
Vantagens:
- A requisição postback garante a transferência segura de dados, pois contém uma chave de autorização particular. Se necessário, a fonte da requisição pode ser encontrada nos logs.
- As alterações no site (front-end) não afetam a transmissão dos dados de ações, pois a requisição postback é enviada do servidor (back-end).
Desvantagens:
- Para implementar a solução, você precisa acessar o back-end do site.
Leia mais sobre essa forma de integração e sua configuração no artigo "Integração por meio de requisição postback".
Integração por meio de um código de rastreamento
Ao integrar com um código de rastreamento, um código JavaScript (código de rastreamento) é implementado em seu site e acionado quando o usuário faz uma ação. Ao mesmo tempo, os dados da ação (código da ação, número do pedido, código da taxa, valor do pedido, entre outros) são registrados e enviados ao servidor Admitad.
O servidor Admitad registra os dados recebidos em relatórios, com base nos quais os afiliados são pagos.
Vantagens:
- Edição do código de rastreamento ao atualizar o site.
- Teste da integração usando a TagTag Check.
- O código de rastreamento não afeta a velocidade de carregamento do site.
Desvantagens:
- Ao fazer alterações no site, você precisa garantir que o código de rastreamento não seja excluído e continue funcionando.
Leia mais sobre essa forma de integração e sua configuração no artigo "Integração por meio de um código de rastreamento".
Integração por meio de arquivo XML
Ao integrar via XML, os dados de ações de usuários são exportados para um arquivo XML de uma determinada estrutura. O servidor Admitad acessa esse arquivo em intervalos especificados e carrega dados de novas ações do arquivo para os relatórios Admitad.
Vantagens:
- É possível proteger o arquivo com login e senha.
- Com as configurações corretas, os afiliados podem receber dados de ações quase que imediatamente.
- Em caso de problemas técnicos, os dados de ações nos relatórios da Admitad podem ser facilmente restaurados.
Desvantagens:
- Em caso de aumento da fila de processamento do arquivo XML, os dados podem ser exibidos com atraso.
Leia mais sobre essa forma de integração e sua configuração no artigo "Integração por meio de XML".
API do Google Analytics
Se você costuma registrar dados de ações de usuários usando o serviço Google Analytics, configure a integração por meio da API do Google Analytics. Com essa forma de integração, o servidor Admitad recebe dados de ações usando uma requisição GET para a API do serviço Google Analytics.
Vantagens:
- O uso de uma única solução para a coleta e transferência de dados para todos os parceiros.
- O mínimo de ajustes, contanto que a Admitad seja a única fonte de tráfego.
- A redução do número de ações não registradas usando a transmissão de dados de backup pelo Google Measurement Protocol.
Desvantagens:
- Dependência das soluções externas e restrições do serviço do Google Analytics.
- Falta de opções de personalização de ações e taxas.
- Ao trabalhar no modelo de atribuição Last Paid Click e sem configurar uma transferência de dados de backup, haverá uma alta porcentagem de ações não registradas comparando com outras formas de integração.
Importante: a Admitad Partner Network não fornece suporte técnico para o Google Analytics e não é responsável por programas afetados negativamente como resultado do uso do Google Analytics como uma ferramenta para coletar dados de ações.
Leia mais sobre essa forma de integração e sua configuração no artigo "Integração por meio da API do Google Analytics".
Integração por meio de API
Se uma API foi desenvolvida para o seu site, você pode disponibilizar a documentação da API a um especialista do Integration Services para elaborar uma opção de integração personalizada.
Vantagens:
- Configuração flexível das condições de coleta de dados.
- O mínimo de ajustes da API de sua parte.
- Configuração da deduplicação de ações e do rastreamento entre dispositivos.
Desvantagens:
- Uma forma de integração mais demorada, porque exige a contribuição dos desenvolvedores na implementação e teste do código.
