Integração: o que é e como escolher uma forma de integração com a Admitad

O que é integração

Integração é a configuração da colaboração entre dois sistemas independentes: seu site e/ou aplicativo e a plataforma Admitad.

A integração com Admitad é uma etapa obrigatória para iniciar o programa de parceria, pois a integração permite:

monitorar ações* dos usuários em seu site e/ou aplicativo;
enviar informações registradas sobre as ações ao sistema Admitad.

A informação sobre a ação inclui o código do programa, código da ação, código da taxa, número do pedido, seu valor e outros parâmetros da ação.

O sistema Admitad salva em estatísticas os dados enviados pelo seu site e/ou aplicativo, e identifica o webmaster a partir do qual o usuário foi direcionado ao seu site e realizou a ação. Assim, a ação é atribuída ao respectivo webmaster.

Uma integração configurada corretamente permite registrar todas as ações dos usuários e atribuí-las corretamente aos webmasters.

Como resultado, você controla os seus gastos no programa de parceria, enquanto os webmasters recebem sua recompensa na totalidade.

Para mais informações sobre a integração de aplicativos móveis, consulte este artigo.

Métodos de integração com Admitad

Nem todos os métodos de integração permitem rastrear as ações de forma eficaz. Por exemplo, se os dados dos pedidos são transmitidos para Admitad a partir do site do anunciante através do navegador do usuário, alguns deles podem ser perdidos devido às configurações de privacidade do navegador e ao funcionamento dos bloqueadores de anúncios — como resultado, os webmasters perdem recompensas que merecem pelos pedidos gerados.

Métodos de integração prioritários S2S

Para que os dados sobre as ações não sejam perdidos durante a transmissão, recomendamos enviá-los para Admitad diretamente da fonte primária — ou seja, de onde os pedidos são gerados. Isso é chamado de rastreamento servidor-servidor (S2S).

A fonte primária de dados pode ser:

servidor onde estão os bancos de dados com informações sobre os pedidos;
CRM, onde os pedidos são gerados;
CMS, onde os pedidos são gerados.

Os métodos prioritários de integração com Admitad incluem:

Integração via postback a partir do servidor, de um CRM ou CMS.
Integração via XML — exportação dos pedidos do servidor, de um CRM ou CMS para um arquivo XML, ao qual o Admitad possui acesso via link.
Integração via API — se você tem sua própria API ou planos de desenvolvê-la.
Integração via plugin para 1C-Bitrix — se seu site for criado na plataforma 1C-Bitrix
Integração via plugin para inSales — se seu site for criado na plataforma inSales.

Recomendamos escolher um desses métodos de integração, pois somente eles podem garantir a transmissão completa dos dados. Se as capacidades técnicas do seu site não permitirem isso, você pode contatar um desenvolvedor e pedir que ele configure a possibilidade de conexão S2S para você. Nós, por nossa parte, estamos prontos para fornecer a ele consultoria sobre a lógica de implementação.

Métodos indesejados de integração

Além da conexão S2S, outros métodos de integração são possíveis, mas apresentam riscos de perda de dados. Portanto, não recomendamos o seu uso, embora tecnicamente seja possível.

A partir de 1º de junho de 2025, Admitad adotará novos padrões de integração e aplicará uma política de correção de perdas aos parceiros que utilizarem métodos não prioritários de integração. Recomendamos fortemente a transição para os novos padrões de integração agora, para garantir o rastreamento preciso das ações e evitar discrepâncias. Nossa equipe está pronta para ajudar na transição.

Os métodos indesejados de integração incluem:

Qualquer integração front-end — quando os dados sobre as ações são transmitidos não do servidor, mas do site via navegador do usuário. As restrições do navegador (por exemplo, bloqueadores de anúncios) levam à perda de parte dos dados.
Integração através de sistemas de análise web de terceiros: Google Analytics 4, Yandex.Metrica, etc. Esses sistemas também recebem estatísticas não do servidor, mas do site.
Uso de uma plataforma de rastreamento: Affise, Trackier, etc. Apesar de que os dados são transmitidos da plataforma de rastreamento para o Admitad via S2S, a própria plataforma de rastreamento na maioria dos casos recebe esses dados do navegador do usuário.

Como escolher um método de integração

Para um rastreamento eficaz das ações, recomendamos escolher os métodos prioritários de integração, descritos na seção abaixo. No restante, a escolha depende das capacidades técnicas do seu site.

Esquema para escolher o método de integração

Destacados em verde estão os métodos prioritários, em vermelho — indesejados.

Caso as capacidades técnicas do seu site não permitam selecionar imediatamente um método prioritário de integração, você pode contactar um desenvolvedor e solicitar que ele configure a possibilidade de conexão S2S para você. Nós, por nossa parte, estamos prontos para fornecer a ele consultoria sobre a lógica de implementação.

Particularidades e vantagens dos métodos de integração

Métodos prioritários

Para todos esses métodos de integração, a configuração de deduplicação e rastreamento cross-device está disponível.

Deduplicação — é um método de processamento de dados que permite identificar corretamente a fonte de tráfego paga, para atribuir a ela o pedido, além de eliminar ações duplicadas, se existirem.
Fonte de tráfego paga — refere-se a qualquer recurso de terceiros ao qual você paga para atrair usuários para o seu site sob certas condições: por cada clique no site, visualização de anúncios, solicitação, registro ou compra. Por exemplo, publicidade segmentada e contextual, postagens pagas em canais de influenciadores, etc.
Rastreamento cross-device — refere-se a uma tecnologia que permite rastrear as ações dos usuários realizadas em diferentes dispositivos. Saiba mais

Integração via postback

Na integração via postback, seu servidor envia para o servidor do Admitad uma solicitação de postback com dados sobre as ações realizadas pelos usuários em seu site.

O servidor Admitad recebe esses dados e os registra nas estatísticas, com base nos quais o cálculo com os webmasters é realizado.

Vantagens:

A solicitação de postback garante a transmissão segura dos dados, pois contém uma chave privada de autenticação. Se necessário, a fonte de solicitação pode ser verificada nos logs.
Mudanças no site (front-end) não afetam a transmissão dos dados sobre as ações, pois a solicitação de postback é enviada do servidor (back-end).

Desvantagens:

Para implementar a solução, é necessário ter acesso à parte de servidor do site.

Para mais informações sobre este método de integração e sua configuração, leia o artigo “Integração via postback”.

Integração via XML

Na integração via XML, os dados sobre as ações dos usuários são exportados para um arquivo XML de estrutura definida. A cada novo período, o servidor do Admitad acessa esse arquivo e descarrega os dados sobre novas ações nas estatísticas do Admitad.

Vantagens:

Possibilidade de restringir o acesso ao arquivo por meio de login e senha.
Com as configurações apropriadas, os webmasters podem receber informações sobre as ações com mínima latência.
Em caso de falhas técnicas, as informações sobre as ações nas estatísticas do Admitad podem ser facilmente restauradas.

Desvantagens:

Com o aumento da fila de processamento do arquivo XML, podem ocorrer atrasos na disponibilização dos dados.

Para mais informações sobre este método de integração e sua configuração, leia o artigo “Integração via XML”.

Integração via API

Se uma interface de programação foi desenvolvida para o seu site, você pode fornecer a documentação da API ao especialista do departamento de Serviços de Integração para que ele desenvolva uma opção de integração personalizada.

Vantagens:

Possibilidade de configuração flexível das condições de coleta de dados.
Mínimas alterações na API da sua parte.
Possibilidade de configurar a deduplicação das ações e o rastreamento cross-device.

Desvantagens:

Método mais demorado de integração, pois requer a contratação de desenvolvedores para implementação e teste do código.

Métodos indesejados

A partir de 1º de junho de 2025, Admitad adotará novos padrões de integração e aplicará uma política de correção de perdas aos parceiros que utilizarem os métodos de integração listados abaixo. Recomendamos fortemente a transição para os novos padrões de integração agora, para garantir o rastreamento preciso das ações e evitar discrepâncias. Nossa equipe está pronta para ajudar na transição.

Como iniciar a execução da integração

1. Antes de iniciar a integração, certifique-se de que em seu programa já foi adicionada pelo menos uma ação e a taxa correspondente — sem isso, não é possível realizar a integração.

Se você tiver um gestor pessoal, ele adicionará as ações e taxas para você.
Se você não tem um gestor, precisa adicionar as ações e taxas por conta própria na seção Actions (Program → Traffic settings → Actions and rewards) — instruções para adicionar ações.

2. Decida o método de integração do seu site e/ou aplicativo com a Admitad.

Se você tiver dificuldades para escolher o método de integração, consulte seus desenvolvedores ou vá para esta seção das instruções.

3. Em seguida, na sua área pessoal, vá para a seção Integration (Program → Integration) e clique em Next.

4. Vá para uma das abas dependendo do método escolhido:

integração via plugins — se você escolheu a integração por meio de um plugin pronto para sites baseados em CMS: WordPress, Shopify, inSales ou 1C-Bitrix;
integração customizada — se você escolheu a integração por meio de postback, XML, código de rastreamento ou API do Google Analytics.

5. Marque o método desejado e clique em Next.

6. Na próxima página Configurações de integração, você verá os blocos:

Configuração da integração: valores únicos dos parâmetros para seu programa — neste bloco, estão apresentados os valores dos parâmetros para seu programa, que são necessários para realizar a integração.
Configuração de deduplicação — neste bloco está disponível um link para as instruções sobre como configurar a deduplicação.
Teste da integração — neste bloco está disponível um link de teste, através do qual você pode verificar se a integração foi realizada com sucesso e se as ações desejadas no seu site estão sendo monitoradas corretamente.

7. Vá para as instruções do método de integração escolhido e siga todos os passos descritos nelas.

Instruções para os métodos prioritários de integração:

Instruções para métodos indesejados de integração: