Configurar retornos

Última atualização:

Retornos são notificações de eventos sobre cliques, exibições de vídeos ou instalações convertidas.

Você pode usar o painel Chartboost para ativar seus retornos facilmente. Comece acessando a página de gerenciamento de retornos e clique em Adicionar novo retorno no canto superior direito. Você verá um formulário de Retorno novo:

Abaixo um tour rápido pelo formulário:

Fundamentos

Digite um nome e descrição para o seu retorno e selecione sua função (anunciante ou editora).

Selecione um modelo de terceiro

O Chartboost fornece modelos de configuração de retorno pré-configurados para a maioria dos fornecedores de terceiros e os parâmetros que suportam. Configurar um modelo preenche automaticamente todos os parâmetros e componentes necessários para configurar o retorno. Em muitos casos, será solicitado que você envie suas informações específicas em um fornecedor particular (como seu URL de acompanhamento, ID do pacote, ID de anunciante, etc.) Você pode adicionar parâmetros a estas configurações conforme necessário usando as configurações descritas abaixo.

Se você não está usando um ponto de extremidade definido de terceiros, pode selecionar Modelo personalizado e configurar seu retorno usando as instruções a seguir.

URL de base

O URL de base é o ponto de extremidade no seu servidor ou no serviço de acompanhamento de terceiro, onde enviaremos o retorno - https://myserver.com/tracker, por exemplo. Nosso sistema anexa variáveis estáticas e parâmetros a este URL conforme especificado.

Variáveis estáticas

Você pode usar os campos de Variáveis estáticas para adicionar um identificador a cada retorno conforme exigido pelo servidor ou serviço. Para incluir uma variável estática como rede=chartboost, você adicionaria rede ao campo Chave e chartboost a Valor.

Parâmetros dinâmicos

A seguir, o menu suspenso Parâmetros  Dinâmicos, onde você decide quais informações deve enviar sobre o evento. Você pode consultar esta lista completa de parâmetros de retorno para decidir quais selecionar no menu suspenso.

Quando estiver pronto para adicionar parâmetros, note que você pode nomeá-los como quiser: nós enviaremos os valores e você pode especificar o nome do parâmetro no campo Chave.

Teste ping

Após definir seu ponto de extremidade, variáveis estáticas e parâmetros dinâmicos, é hora de movimentar seu URL.

Você perceberá que a seção URL de retorno mostra o retorno que você construiu; clique emTestar agora para verificar se o seu ponto de extremidade está funcionando corretamente. Nós teremos de receber um resultado de teste com êxito para ativar o seu retorno! Abaixo encontra-se um exemplo de quais informações enviamos em um teste ping:

{
    "from" : "TestPublisherGame",
    "uuid" : "5555555555555555",
    "campaign" : "TestCampaign",
    "campaign_id" : "444444444444444444444444",
    "to" : "TestAdvertiserGame",
    "ifa" : "66666666666666666666666666666666",
    "type" : "click"
}
Uma chamada de retorno post é retornada no URL como uma chamada get.
Anexar retornos à conta, apps ou campanhas

Por fim, você precisa anexar o retorno a uma campanha, app ou sua conta inteira. Aqui está a ordem de precedência:

  • Retornos no nível de campanha informam sobre cliques ou instalações convertidas em uma campanha e substituem outros retornos.
  • Retornos no nível de app informam sobre cliques/conversões de todas as campanhas executadas em um jogo específico, e substituem retornos no nível da conta. Note que isso também inclui campanhas de editora.
  • Retornos no nível da conta aplicam-se a todos os jogos e campanhas na sua conta, exceto os que possuem retornos de nível mais alto anexados.  (NÃO RECOMENDADO)

Exemplo: se você precisa receber notificações de evento sobre cliques, exibições de vídeo concluídas e instalações convertidas em toda a sua conta, você anexa um retorno no nível da conta. Se você precisa de diferentes informações sobre um determinado app ou campanha, então pode anexar um retorno separado em um desses níveis.

Note que você também pode anexar retornos a campanhas através de Editar campanha > Configurações avançadas...

...E para apps pela seção Configurações avançadas da página Configurações do app:

Duplicar um retorno

O Chartboost facilita clonar retornos para uso com jogos ou campanhas diferentes. Se o seu sistema ou serviço de terceiros precisa receber os mesmos parâmetros ou similares aos que incorporou em um retorno existente, visite a Página de lista de retornos e clique no nome do retorno:

Depois disso, clique em Duplicar no tipo do formulário Editar retorno:

Então você poderá fazer os ajustes necessários, sem começar do zero.

 

Após adicionar retornos à sua conta, app ou campanha, você pode usar a lista de retornos para:

  • Editar um retorno existente
  • Excluir um retorno existente
  • Pausar um retorno existente
  • Duplicar um retorno para usar com um jogo ou campanha diferente (clique em Editar primeiro)
  • Adicionar um novo retorno