Configurar callbacks de servidor

Você pode configurar callbacks de servidor para receber IDs de publicidade, informações de atribuição, dados do aplicativo e outros diretamente nos seus servidores na forma de dados brutos.

Antes de começar

O que você precisa saber antes de começar.

Requisitos

• Permissões de Administrador, Editor ou Editor Personalizado
• Você precisa de uma solução de business intelligence própria ou de uma data warehouse para receber requisições de callback. Confirme se seu servidor pode receber todos os seus parâmetros e armazenar todos os dados recebidos. O número de usuários no seu aplicativo afeta o quão rápidos seus servidores precisam ser. Se você mensura eventos que acontecem uma única vez, como cadastros, você recebe um callback para cada usuário convertido. Callbacks para eventos de conversão geralmente não têm um grande impacto na largura de banda do servidor.
• Para garantir que você só receba dados da Adjust, inclua nossos IPs de servidor na lista de permissão.

Tipos de callbacks

Você pode configurar callbacks para os seguintes acionadores:

Callbacks globais

Callback global é um callback principal para todos os acionadores mensurados pela Adjust, por exemplo, cliques, instalações, sessões, entre outras. Essa é a maneira mais rápida de obter os mesmos pontos de dados para cada atividade que a Adjust mensura, uma vez que há apenas uma URL em vez de várias.

Callbacks de uma atividade

Um callback de uma atividade é um callback para uma atividade específica (p. ex., cliques). Essa é uma ótima opção se você só precisar de dados para essa única atividade. Em alguns casos, o callback global pode gerar uma quantia grande de dados, especialmente impressões e cliques. Se quiser diminuir a quantidade de dados que a Adjust envia ao seu sistema de BI, configure callbacks de uma atividade.

Callbacks múltiplos para a mesma atividade

A Adjust pode enviar um callback de uma atividade para quantos endpoints você quiser. Para isso, basta separar cada URL com um espaço simples ().

Configurar callbacks de servidor

Você pode criar callbacks de servidor com a configuração guiada ou clássica. A Adjust recomenda usar a configuração guiada para criar URLs de callback.

Para ajuda com quais placeholders usar para um determinado acionador, consulte nosso guia de placeholders recomendados.

Configuração guiada

1. Acesse as configurações de callback de servidor a partir do seu cartão do app ou na aba de Gerenciamento de dados nas configurações do seu app.

   • (apenas para permissões de Admin, Editor ou Editor personalizado) Para configurar um callback de servidor a partir do cartão do app, em AppView , selecione Todos os apps . Encontre seu app e selecione Callbacks de servidor .
   • Para configurar um callback de servidor a partir da aba Gerenciamento de dados da sua configuração de apps, em AppView , selecione Todos os aplicativos . Selecione seu app e, em seguida, selecione a aba Gerenciamento de dados.

2. Em Callbacks de servidor, selecione Adicionar callback > Configuração guiada.

3. Na lista Ativação de callback , selecione a atividade ou o evento que aciona o callback.

4. No campo Endpoint do servidor, insira a URL do endpoint do servidor onde você quer receber os dados.

5. (Opcional) Selecione Adicionar uma condição para adicionar uma condição com placeholders e valores. O callback será acionado apenas se a condição for atendida.

6. No campo Método de requisição , selecione se o callback usa GET ou POST. O padrão é GET.

   • Quando você seleciona POST, você pode inserir pares de chave-valor como o corpo da requisição usando o formato key=value. A Adjust codifica o corpo e o envia como um objeto JSON plano ("flat").

7. Selecione Adicionar um placeholder para incluir dados de usuários ou de engajamento dinamicamente. Você pode adicionar quantos placeholders preferir.

8. Selecione Criar URL de callback para gerar um callback codificado.

Configuração clássica

Quando você usa a configuração clássica, é possível editar diretamente a string de callback completa. O sistema agora reconhece tanto o formato GET quanto o POST.

• <method>,<conditions>,<url>[,<body>]
• Os corpos POST usam key1=value1&key2=value2 e a Adjust os converte em um JSON plano.

Você pode inserir múltiplos callbacks separados por um espaço. O método de requisição padrão é GET a não ser que você especifique o POST.

Gerenciar seus callbacks

Depois de gerar suas URLs de callback, você pode visualizá-las na página Callbacks de servidor. É possível realizar as seguintes tarefas no seu callback:

• Selecionar (ícone de cópia) para copiar a URL de callback.
• Selecionar (ícone de duplicação) para duplicar o callback e abrir a configuração clássica.
• Selecionar (ícone de exclusão) para excluir o callback.
• Selecionar (ícone de edição) para editar a URL de callback usando a configuração clássica.