Estrutura do callback

Para configurar um callback, você precisa especificar:

O parâmetro de callback correto para seu tipo de callback.
A URL do endpoint do servidor onde você quer receber os dados.
Os placeholders da Adjust para os pontos de dados que você quer registrar.
Os macros para os pontos de dados que você quer compartilhar.
Parâmetros dos parceiros (se aplicável) para receber informações sobre eventos ou sessões in-app dos seus clientes.

Observação:

Quando você faz a integração com o Campaign Lab, pedimos para que compartilhe seus URLs de callbacks e macros. Anexamos seus URLs de callbacks (exceto para callbacks de eventos) e macros quando seu cliente gera o URL do link.
Para callbacks de eventos, você precisa anexar tokens de eventos ao parâmetro do callback de eventos. Nesse caso, recomendamos que você use a ferramenta de codificação.
Em caso de dúvidas, entre em contato pelo e-mail integration@adjust.com.

Parâmetros de callback

Use parâmetros de callback para anexar diferentes tipos de callbacks à URL do link.

Importante:

Se você está usando links de marca ou Branded Links ou Universal Links, deve utilizar o prefixo no parâmetro de callback com adj_ . Por exemplo: use adj_install_callback para o parâmetro install_callback.

Aviso:

Não é possível alterar a sintaxe do parâmetro de callback.

A tabela a seguir lista parâmetros de callback para diferentes tipos de callbacks:

Tipo de callback	Parâmetro de callback
Instalação	`install_callback`
Reatribuição	`reattribution_callback`
Conversão (inclui instalações e reatribuições)	`conversion_callback`
Sessão	`session_callback`
Evento Você precisa anexar tokens de eventos no parâmetro de callback. Peça para seu cliente compartilhar esse token de eventos com você.	`event_callback_`
Instalação rejeitada	`rejected_install`
Reatribuição rejeitada	`rejected_reattribution`

Observação:

Se necessário, use os parâmetros de callback click_callback e impression_callback para configurar callbacks de clique e impressão, respectivamente.

URL do callback/endpoint

A URL de callback ou o endpoint determina aonde a Adjust envia seus dados. Trata-se da URL do endpoint do servidor. Você pode adicionar essa URL de callback a uma URL do link da Adjust para receber dados relacionados a instalações, sessões, reatribuições ou eventos in-app.

Observação:

Certifique-se de especificar a URL do endpoint do servidor/nome do domínio como a URL de callback. A Adjust não suporta endereços IP na URL de callback por motivos de segurança.Exemplo: Se você usar http://1.2.3.4:80/xxxxx como a URL de callback, os servidores da Adjust rejeitarão o clique recebido.

Você pode adicionar várias URLs de callback para um parâmetro de callback separando as URLs de callback codificadas pelo sinal "+".

Exemplo: URL de um callback

No exemplo a seguir, https://mynetworkserver.com/callback é a URL de callback do callback de instalação.

Callback codificado

URL de callback não codificadaNão usar

install_callback=https%3A%2F%2Fmynetworkserver.com%2Fcallback_%3Fclick_id%3D123456%26idfa%3D%7Bidfa%7D%26gps_adid%3D%7Bgps_adid%7D

Exemplo: Duas URLs de callbacks

No exemplo a seguir, http://mynetworkserver.com/callback e http://myothernetworkserver.com/install são as URLs de callback separadas pelo sinal de "+" do callback de instalação.

Callback codificado

URL de callback não codificadaNão usar

install_callback=https%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}+https%3A%2F%2Fmyothernetworkserver.com%2Finstall%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}

Placeholders da Adjust

Macros

Parâmetros de parceiros

Opcional

Exemplo

URL do link de clique com parâmetros de estrutura de campanha e identificadores do dispositivo, e callback de instalação e de eventos

URL codificadaSempre codificar callback

URL não codificadaNão usar

https://app.adjust.com/abc1234?campaign=new-campaign&adgroup={sub_id}&creative={crt_id}&idfa={network_idfa_macro}&gps_adid={network_gaid_macro}&install_callback=http%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}&event_callback_r8oaj2=http%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}%26event%3Dregister%26partner_parameter%3D%7Bpartner_parameters%7D

Neste exemplo, nós explicamos a estrutura de uma URL não codificada final. Sempre codifique sua URL antes de lançar sua campanha.

URL do link da Adjust com token de link compartilhado por seu cliente - https://app.adjust.com/abc1234
Parâmetros de estrutura da campanha - campaign, adgroup, creative
Macros do parceiro - new-campaign, {sub_id}, {crt_id}
Identificadores de publicidade - idfa, gps_adid
Macros do parceiro parceiro para advertising ID - {network_idfa_macro}, {network_gaid_macro}
Callback de instalação - install_callback=http://mynetworkserver.com/callback?country={country}&click_id={click_id}
- Parâmetro do callback - install_callback
- URL/endpoint do callback - http://mynetworkserver.com
- Placeholder da Adjust (servidores da Adjust preenchem dados) - {country}
- Macro da rede (servidores da Adjust preenchem dados) - {click_id}
Callback de eventos - event_callback_r8oaj2=http://mynetworkserver.com/callback?country={country}&click_id={click_id}&event=register
- Parâmetro do callback - event_callback
- Token de eventos (compartilhado pelo cliente e anexado ao parâmetro de callback de eventos) - r8oaj2
- Valor codificado correspondente ao token de eventos - event=register
Placeholder de parâmetros do parceiro - {partner_parameters}