Skip to content

Integrações com parceiros

O AdsGram está integrado com Adjust e AppMetrica. Também é possível trabalhar com links de outros rastreadores, mas neste caso, o AdsGram não poderá transferir as informações necessárias ao rastreador para uma análise mais detalhada.

IMPORTANTE

Os anunciantes que usam Adjust e AppMetrica para seu aplicativo móvel agora podem obter dados sobre as conversões que os usuários realizaram após clicar nos banners publicitários do AdsGram.

Adjust

1. Escolher Rede

Na seção Campaign Lab, vá para Partners

  • Clique em New Partner.
  • Na barra de busca, digite AdsGram e selecione esta rede.
  • Após selecionar, clique em Next.

2. Escolher o Aplicativo

Na tela seguinte, escolha o aplicativo para o qual deseja criar o link. Use a barra de busca para encontrar seu aplicativo ou role a lista para encontrá-lo. Você pode configurar links para um aplicativo por vez.
Após selecionar o aplicativo, clique em Next.

3. Definir Opções de Compartilhamento de Dados

Nesta seção, você configurará os parâmetros de compartilhamento de dados com o AdsGram, selecionando quais eventos e parâmetros do aplicativo serão enviados ao AdsGram para análise.
Instruções detalhadas estão disponíveis na página de documentação do Adjust.

Após configurar todos os parâmetros e atribuições, você receberá um link de rastreamento único, que deve ser usado ao criar campanhas publicitárias no AdsGram.
Além disso, você pode adicionar parâmetros adicionais como tags UTM para um rastreamento mais preciso das fontes de tráfego.

IMPORTANTE

Após configurar os links de rastreamento, os dados sobre as conversões de usuários para instalações de aplicativos e eventos no aplicativo após clicar nos anúncios do AdsGram serão exibidos apenas na interface do Adjust.

AppMetrica

Criar um rastreador:

  1. Após se registrar na conta pessoal do AppMetrica, integrar o SDK no aplicativo e configurar o rastreamento de ações de destino, você pode prosseguir para criar o rastreador.
  2. Especifique o nome do rastreador.
  3. Adicione o aplicativo.

Instruções detalhadas estão disponíveis na página de documentação do AppMetrica.

Transferência de dados de instalação:

  1. Escolha o receptor do postback (AdsGram).
  2. Especifique o tipo de evento que precisa ser enviado ao AdsGram.
  3. Obtenha a URL de Postback — o link através do qual eventos e instalações serão enviados ao servidor do AdsGram.
  4. Após criar os postbacks, você receberá um link de rastreamento. Este link deve ser usado ao criar campanhas no AdsGram. Além disso, você pode adicionar parâmetros adicionais, como tags UTM, se necessário.

Keitaro

1. Criar um Rastreador no Keitaro

  1. Após fazer login no painel do Keitaro, vá para a seção Trackers.
  2. Clique em Create tracker ou New tracker.
  3. Insira o nome do rastreador e selecione AdsGram como tipo de fonte de tráfego.
  4. Clique em Save para criar o rastreador.

2. Configurar Postback no Keitaro

  1. Na configuração do rastreador criado, vá para a seção Postback ou API Integration.

  2. No campo Postback URL, insira o endpoint do AdsGram:

    https://api.adsgram.ai/confirm_conversion?
  3. Adicione os seguintes parâmetros de consulta obrigatórios:

    token=YOUR_UNIQUE_TOKEN&record={_record_data}

    onde YOUR_UNIQUE_TOKEN é o token do seu perfil do AdsGram.

    ATENÇÃO

    Para obter um valor sem formatação do sistema de rastreamento, adicione "_" (sublinhado) antes do nome da macro. Isso é relevante apenas para o rastreador Keitaro e é necessário para prevenir ataques XSS.

3. Configurar uma Campanha no AdsGram

  1. Copie a Click URL da configuração do seu rastreador Keitaro (por exemplo: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
  2. No painel do AdsGram, ao criar uma campanha, cole este link no campo Click URL.
  3. Adicione as macros obrigatórias do AdsGram ao link:
    https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}
  4. Certifique-se de que a macro {record_data} esteja incluída no link final.

4. Configurar Metas no Keitaro

  1. Na configuração do seu rastreador Keitaro, vá para a seção Goals ou Conversions.
  2. Crie uma nova meta ou selecione uma existente.
  3. Habilite o envio de postback para a URL especificada anteriormente para esta meta.
  4. Defina as condições de ativação (por exemplo, após confirmação de conversão ou status específico).

Kochava

1. Criar um Rastreador no Kochava

  1. Após fazer login no painel do Kochava, vá para a seção Apps & Assets.
  2. Clique em Add New e selecione App para criar um novo rastreador de aplicativo.
  3. Preencha os campos obrigatórios:
    • Platform: Escolha a plataforma do aplicativo (iOS, Android, Web).
    • App Name: Insira o nome do seu aplicativo.
    • Store ID: Insira o identificador da loja do aplicativo (App Store ID, Package Name, etc.).
  4. Clique em Save para criar o aplicativo.

2. Configurar Integração com Parceiros

  1. Na página do aplicativo criado, navegue até a seção Partner Management.
  2. Clique em Add Partner.
  3. Encontre e selecione AdsGram na lista de parceiros.
  4. Clique em Next para prosseguir para a configuração.

3. Configurar Parâmetros de Integração

  1. Na seção Integration Settings, selecione o tipo de rastreamento (Click-Through, View-Through ou Hybrid).

  2. Habilite a opção Server-to-Server Postbacks.

  3. No campo Postback URL, insira o endpoint do AdsGram:

    https://api.adsgram.ai/confirm_conversion
  4. Adicione os seguintes parâmetros ao Postback Parameters:

    • Parâmetro obrigatório: {record_data} (inserido automaticamente pelo Kochava).
    • Adicione parâmetro: token com o valor YOUR_UNIQUE_TOKEN (obtido do seu perfil do AdsGram).
  5. Configure as macros de atribuição de dados:

    • {campaign_id} → campaign_id
    • {click_id} → click_id
    • {publisher_id} → publisher_id

4. Configurar uma Campanha no AdsGram

  1. Volte para a seção Tracking Links no Kochava e crie um link de rastreamento (por exemplo: https://your-app.kochava.com/install?data={encrypted_data}).
  2. No painel do AdsGram, ao criar uma campanha, cole este link no campo Click URL.
  3. Adicione as macros obrigatórias do AdsGram ao link como parâmetros:
    https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}
  4. Certifique-se de que a macro {record_data} esteja incluída na URL final.

5. Configurar Eventos no Kochava

  1. No painel do Kochava, vá para a seção Events.
  2. Crie um novo evento ou escolha um padrão (por exemplo, install, purchase).
  3. Configure o postback para o evento selecionado:
    • Habilite Send Postback.
    • Selecione a integração do AdsGram criada anteriormente.
    • Defina filtros e condições de ativação.
  4. Salve a configuração do evento.

6. Testar a Integração

  1. Use o Modo de Teste no Kochava para verificar o rastreamento de instalações.
  2. Verifique as solicitações recebidas nos registros do Kochava e do AdsGram.
  3. Certifique-se de que o parâmetro record_data está sendo passado corretamente.