Integrações com parceiros

O AdsGram oferece suporte à integração com plataformas populares de atribuição e rastreamento. Elas permitem rastrear cliques, instalações e ações dos usuários após interagirem com os anúncios do AdsGram, além de enviar dados de conversão de volta ao AdsGram, permitindo otimizar campanhas pelo custo de conversão (tCPA).

As seguintes integrações estão disponíveis:

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

Você também pode usar links de outras plataformas de rastreamento. Nesse caso, porém, o AdsGram não poderá transferir todas as informações necessárias ao rastreador para uma análise mais detalhada.

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.

4. Obter Link de Rastreamento

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.

5. Transferência de Dados de Conversão

Por padrão, os dados de atividade do usuário são transferidos do Adjust para o AdsGram e atribuídos automaticamente às metas correspondentes:

• Sessões (Sessions) - para Goal 1
• Instalações (Installs) - para Goal 2

IMPORTANTE

Para lançar uma campanha tCPA, você precisa receber pelo menos 10 conversões para a meta selecionada. Por exemplo, se a campanha for lançada com Goal 2, você precisa receber pelo menos 10 conversões para Goal 2.

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:

4. Escolha o receptor do postback (AdsGram).
5. Especifique o tipo de evento que precisa ser enviado ao AdsGram.
6. Obtenha a URL de Postback — o link através do qual eventos e instalações serão enviados ao servidor do AdsGram.
7. 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 o parâmetro token obrigatório e o parâmetro record. O nome do parâmetro deve corresponder ao parâmetro record especificado no Tracking Link.

   Por exemplo, se você passar a macro do AdsGram no Tracking Link da seguinte forma:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}

   então o seguinte deve ser especificado no postback do Keitaro:

   https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}

   Onde:

   • YOUR_UNIQUE_TOKEN — o token do seu perfil do AdsGram
   • record — o parâmetro que você passa no Tracking Link
   • {_record} — uma macro que passa o valor original do parâmetro record para o postback

   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.

AppsFlyer

A integração do AdsGram com o AppsFlyer permite enviar ao AdsGram dados sobre instalações de aplicativos e ações dos usuários dentro do aplicativo.

Após a integração ser configurada, o AdsGram receberá:

• Instalações do aplicativo (Installs) - atribuídas automaticamente à Goal 1
• Todos os demais In-App Events - atribuídos automaticamente à Goal 2

Nenhuma configuração adicional ou mapeamento de evento para meta é necessário no AdsGram. Por exemplo, se eventos como registration, purchase, deposit, etc. forem enviados pelo AppsFlyer, todos serão automaticamente contabilizados em Goal 2.

IMPORTANT

As campanhas tCPA só podem ser lançadas com a Goal 1. Isso significa que as campanhas tCPA só podem ser otimizadas para instalações de aplicativos. Os In-App Events enviados para a Goal 2 não podem ser usados como meta para campanhas tCPA.

1. Conectando o AdsGram através de Parceiros Integrados

O AdsGram é um parceiro integrado do AppsFlyer. Para conectar:

• Vá para Collaboration → Partner Marketplace no AppsFlyer
• Busque por AdsGram (nome de marketing) ou adsgram1e_int (nome técnico) e selecione o parceiro

2. Configurar os Postbacks de Instalação

Abra a aba Integration:

• Ative Activate Partner
• Desative AAP (deve ser desativado tanto nas configurações do aplicativo quanto nesta aba)
• Em Install Postback, selecione This partner only. Isso significa que o AdsGram receberá as instalações atribuídas a ele. Essas instalações serão contabilizadas como Goal 1 no AdsGram.

IMPORTANT

Se você deseja lançar uma campanha otimizada para instalações, certifique-se de que as instalações estão sendo enviadas ao AdsGram e exibidas em Goal 1. Campanhas tCPA otimizadas para instalações só podem ser lançadas com a Goal 1.

3. Configurar os Postbacks de Eventos In-App

Configure os postbacks para In-App Events (compras, registros, etc.) na seção In-App Event Postbacks:

• Adicione os eventos necessários, por exemplo:
  • purchase - compras
  • af_complete_registration - registros
• No campo For users from, selecione This partner only
• O AdsGram recebe apenas o evento em si, sem seus parâmetros ou receita. Portanto, em Including, você pode selecionar No values & no revenue

Recomendado:

• Permitir a configuração da integração (exceto postbacks de eventos in-app)
• Permitir a configuração de postback de eventos in-app

Outras permissões (relatórios de retenção, receita, etc.) são opcionais.

Após configurar a integração, clique em Save Integration.

4. Configurar o Tracking Link

Abra a aba Tracking Link:

• O AppsFlyer gerará automaticamente um link de rastreamento para o AdsGram e adicionará o identificador de parceiro necessário: pid=adsgram1e_int
• As 4 macros do AdsGram serão preenchidas automaticamente (af_storeid, c, etc.)
• Se necessário, adicione parâmetros estáticos como parâmetros adicionais
• Em Click-through attribution, selecione a janela de atribuição. O padrão é 7 dias, mas você pode alterá-lo se necessário

5. Configurar Permissions

Abra a aba Permissions e ative as permissões necessárias:

• Acesso ao painel do aplicativo
• Conversões agregadas
• Eventos
• Protect360

👉 Clique em Save Integration

6. Configuração da Campanha no AdsGram

Ao criar uma campanha no AdsGram:

• Insira o Click link no campo Link. O sistema gerará automaticamente um link de rastreamento do AppsFlyer e adicionará as macros necessárias
• Especifique no link de rastreamento do AppsFlyer o nome do seu package/bundle, caso ainda não esteja incluído (por exemplo, id12345678 ou com.app.name)
• No campo Link que aparece, insira o link direto para o seu produto no Google Play / App Store / RuStore

7. Observações

• A configuração se aplica a todos os banners dentro da campanha
• O anunciante é responsável pelos parâmetros corretos do link e pela atribuição
• Ao usar um link personalizado, também é necessário especificar um link direto do produto no campo Link