Configuração de parceiros e postbacks: perguntas frequentes e solução de problemas

A página Parter Configuration (Configuração do parceiro) é onde você configura o rastreador Singular para trabalhar com suas várias redes de anúncios e outros parceiros. Se você está apenas começando, consulte Como definir configurações de parceiros e postbacks.

Observação: Este guia é para clientes Singular. Se você é um parceiro Singular ou deseja se tornar um, consulte Informações para parceiros.

Solução de problemas

Por que meu parceiro de rede não está recebendo postbacks?

Se uma rede de parceiros disser que não está recebendo postbacks para instalações/conversões ou eventos no aplicativo:

  1. Vá para Attribution (Atribuição) > Export Logs (Exportar logs) e faça download dos logs de postbacks para o parceiro. Para obter ajuda para baixar logs, consulte o Perguntas frequentes sobre exportação de registros e dados no nível do usuário.
  • Certifique-se de filtrar os postbacks com Código HTTP de resposta = 200. Se o código HTTP da resposta for "200", significa que o parceiro confirmou que recebeu o postback.
  • Selecione também o campo Response HTTP Body (Corpo HTTP da resposta), pois pode ajudar a identificar um problema técnico no final do parceiro.
  • Compartilhe o log com o parceiro para validar os dados internamente. Se houver muitos postbacks com outros códigos de resposta, informe-os de que pode haver um problema técnico com o recebimento de postbacks da Singular.
Por que há uma incompatibilidade entre o número de eventos recebidos pelo parceiro como postbacks e os eventos no relatório da Singular?

Alguns motivos possíveis são:

  • Janelas de lookback: Um ou mais eventos podem ter uma janela de lookback diferente configurada para postbacks. Verifique as configurações na página Partner Configuration (Configuração do parceiro).
  • Problemas técnicos: O parceiro pode não ter recebido um ou mais postbacks devido a problemas técnicos do lado do parceiro. Para verificar, consulte Por que meu parceiro de rede não está recebendo postbacks?
  • Eventos duplicados: O SDK Singular em seu aplicativo gera automaticamente um evento chamado __REVENUE__, que é acionado em qualquer compra no aplicativo. Além disso, você também pode criar seus próprios eventos de receita do SDK para diferentes tipos de compras no aplicativo. Ao configurar postbacks de eventos, certifique-se de enviar postbacks para __REVENUE__ ou para seu(s) evento(s) de receita com nome personalizado, mas não ambos. Caso contrário, a Singular enviará dois postbacks para cada compra no aplicativo.
Por que os postbacks estão sendo enviados para um parceiro sem atributos de evento?

Se um parceiro de rede disser que está recebendo postbacks sem atributos de evento:

  1. Vá para Attribution (Atribuição) > Export Logs (Exportar logs) e faça download dos logs de postbacks para o parceiro. Verifique os campos HTTP Body (Corpo HTTP) de postback ou Target URL (URL de destino) para ver se eles incluem atributos de evento. Para obter ajuda para baixar logs, consulte o Perguntas frequentes sobre exportação de registros e dados no nível do usuário.
  2. Se os logs mostrarem que os postbacks estão realmente sendo enviados sem atributos de evento, verifique novamente as configurações de postback na página Partner Configuration (Configuração do parceiro). Se você não configurou atributos adicionados para serem enviados junto com eventos, altere as configurações agora.
  3. Se as configurações estiverem corretas e os postbacks ainda estiverem sendo enviados com atributos ausentes, entre em contato com o suporte da Singular.
Como faço para verificar quais postbacks foram enviados a um parceiro de rede, por exemplo, para fins de cobrança e faturamento?

Se seu faturamento com uma rede for baseado no número de postbacks de instalação/evento que a Singular enviou a eles durante o período, você pode verificar novamente quais postbacks foram enviados a um parceiro baixando logs de postback brutos em Attribution > Export Logs (Atribuição > Exportar logs).

Para obter ajuda geral com a página Export Logs (Exportar logs), consulte as Perguntas frequentes sobre exportação de logs e dados no nível do usuário.

Para validação de postback, recomendamos baixar um log com as seguintes configurações:

postback_log1.png

postback_log2.png

Certifique-se de filtrar o valor "200" no Código HTTP de resposta para ver os postbacks recebidos com êxito pelo destinatário do postback.

Não se confunda entre os campos Parceiro (Partner) e Destinatário do postback (Postback Recipient):

  • Partner (Parceiro) é a rede à qual o evento foi atribuído.
  • Postback Recipient (Destinatário do postback) é o parceiro que recebeu o postback para o evento. O evento não é necessariamente atribuído a esse parceiro (lembre-se, alguns parceiros pedem para receber postbacks de todos os seus eventos, sejam eles atribuídos a esse parceiro ou a outra rede, e você pode ativar essa opção na página Partner Configuration (Configuração do parceiro)).

Um campo adicional, Is Attributed (É atribuído), esclarece ainda mais se o destinatário do postback é a rede à qual o evento foi atribuído ("Y" significa que é a mesma rede, "N" significa que o evento foi atribuído a outro parceiro que você pode ver no campo Partner (Parceiro)).

Observação: O filtro Partners (Parceiros) filtrará os postbacks pelo nome do parceiro que recebeu os postbacks - seja uma rede de parceiros, seu BI interno, ferramentas de análise de terceiros etc.

Para outros tipos de registro, o filtro Partners (Parceiros) significa o parceiro a quem uma conversão ou um evento foi atribuído (redes de anúncios).

Perguntas frequentes

Perguntas frequentes de configuração do parceiro

Quais postbacks são obrigatórios e quais são opcionais?

A Singular envia um postback para cada rede de parceiros quando uma instalação de aplicativo é atribuída a essa rede. Você não pode desativar esses postbacks.

Outros tipos de postbacks são opcionais e dependem das preferências da rede parceira:

  • Retomada dos postbacks
  • Postbacks de evento no aplicativo
  • Postbacks sobre conversões (instalações/retomadas) e eventos que não são atribuídos ao parceiro
De quais IPs são enviados os postbacks da Singular?
Quando e com que frequência a Singular tenta enviar um postback novamente? Quanto tempo o sistema espera entre as tentativas?
  • A Singular tenta enviar um postback novamente se recebermos um código de resposta HTTPS entre 500 e 559.
  • O mecanismo tem um máximo de 5 tentativas.
  • As novas tentativas ocorrem em intervalos de 1, 5, 15, 30 e 60 minutos a partir da tentativa original.

Tipos de parceiro e terminologia

O que são parceiros?

Os parceiros na página Partner Configuration (Configuração do parceiro) são todas as redes e serviços que você configura para trabalhar com o serviço de atribuição da Singular.

Observação: Não é aqui que você informa a Singular de quais fontes extrair os dados da campanha para apresentar os dados nos relatórios da Singular. Para isso, você precisa configurar as redes de anúncios e outras fontes de mídia separadamente na página Data Connectors (Conectores de Dados) (consulte as Perguntas frequentes sobre Conectores de Dados).

Que tipo de configurações posso definir para um parceiro?

A página Partner Configuration (Configuração do parceiro) permite configurar as seguintes coisas por parceiro e site:

  • A janela de lookback para atribuição de cliques
  • Quais postbacks enviar ao parceiro
  • Também é aqui que você insere suas credenciais de login na plataforma do parceiro, se a Singular precisar delas para se conectar ao parceiro. Isso varia de acordo com o parceiro.

Para obter mais detalhes, consulte Definindo configurações e postbacks abaixo.

Que tipos de parceiros existem?
  • Alguns parceiros são redes de publicidade, agências de publicidade etc. Você define as configurações de atribuição para esses parceiros e cria links de rastreamento que incorporam as macros personalizadas dos parceiros. Você também pode fazer com que a Singular envie a esses parceiros informações sobre instalações atribuídas, decisões de fraude etc. na forma de postbacks automatizados.

  • Outros parceiros são sistemas de BI de terceiros, serviços de análise de fraude, etc. Se você trabalha com esses serviços, pode configurá-los na página de configuração do parceiro para que possam receber postbacks.
O que são parceiros "internos" (BI interno)?

"BI Interno" é um tipo especial de parceiro que você pode configurar se desejar que sua própria plataforma interna receba postbacks sobre decisões de atribuição, decisões de fraude, etc. Consulte Configurando Postbacks de BI Interno para obter mais informações.

O que são sites?

Um site (ou um site de aplicativo) é uma versão do seu aplicativo desenvolvida para uma plataforma específica. Você define as configurações do parceiro para cada site de aplicativo separadamente.

Por exemplo, se você tiver um aplicativo executado no Android e no iOS, terá dois sites de aplicativos e poderá definir as configurações do parceiro para cada um.

Consulte também: Perguntas frequentes sobre a configuração do aplicativo.

Como a Singular sabe quais dados enviar a cada parceiro?

Como parte do processo de desenvolvimento de integrações com um parceiro de atribuição, a Singular cria um modelo de postback que contém todos os campos suportados pelo parceiro. Quando você salva uma nova configuração de parceiro, a Singular começa a criar postbacks com base nesse modelo.

Como exportar as configurações do parceiro? Como posso obter uma lista completa dos postbacks configurados para meus parceiros?

Para exportar as configurações de postback para todos os parceiros, clique em Export All (Exportar tudo) no canto superior direito da página Partner Configuration (Configuração do parceiro).

Para exportar as configurações de postback para parceiros selecionados, primeiro selecione um ou mais parceiros clicando na caixa de seleção à esquerda do parceiro e, em seguida, clique em Export Selected (Exportar selecionados).

Isso baixa um arquivo CSV com informações sobre cada postback que foi configurado:

Coluna Descrição
Parceiro O nome do parceiro
Aplicativo O nome de exibição do aplicativo
Nome longo O nome longo ou ID do pacote do aplicativo
OS O SO do aplicativo (iOS ou Android)
Criado  
Janela de lookback de atribuição de cliques A janela de lookback configurada para este parceiro e site de aplicativo.
Tipo de postback Instalação ou Evento.
Eventos O nome do evento que aciona o postback.
Apenas atribuído Se o postback é enviado para todos os eventos desse tipo ou apenas se a instalação tiver sido atribuída ao parceiro específico.
URL de postback O URL completo do postback, incluindo macros Singular.

Configurações e postbacks

Como faço para verificar quais postbacks foram enviados a um parceiro de rede, por exemplo, para fins de cobrança e faturamento?
Por que preciso escolher o aplicativo e o site do aplicativo ao configurar um parceiro?

As configurações do parceiro são definidas para cada site de aplicativo separadamente.

Qual é a chave/token/senha de segurança que me pedem para inserir?

A Singular geralmente requer certas credenciais para enviar postbacks ao parceiro. Peça ao parceiro as credenciais apropriadas.

O que são postbacks de retomada?

Estes são postbacks que notificam o parceiro sobre uma retomada bem-sucedida. A opção de habilitar esses postbacks está disponível apenas para parceiros que oferecem suporte a campanhas de retomada (campanhas de retargeting).

O que são atribuições de visualização?

Os atributos de revisão são atributos determinados com base em uma revisão do anúncio, não um clique sobre ele. Se você estiver executando campanhas com atributos de visualização, selecione Include View-Through Attributions (Incluir atributos de visualização) para que Singular envie mensagens de feedback ao parceiro também para esses atributos (caso contrário, Singular enviará mensagens de feedback apenas para os atributos clicáveis).

O que são os postbacks de fraude?

Postbacks de fraude incluem informações sobre decisões tomadas pelo sistema de detecção de fraude da Singular. Para saber mais, consulte Postbacks de fraude. Além disso, consulte Prevenção de fraude da Singular para uma introdução aos métodos avançados de detecção de fraudes da Singular.

O que é a janela de lookback de atribuição?
O que são eventos no aplicativo?

Os eventos no aplicativo são quaisquer eventos do usuário que ocorrem na pós-conversão do seu aplicativo. Por exemplo, um usuário que instala seu aplicativo pode fazer login ou se registrar em sua plataforma, assistir ao tutorial ou subir de nível se for um aplicativo de jogos. Alguns parceiros desejam receber postbacks sobre esses eventos do serviço de atribuição da Singular.

Como configuro postbacks de eventos?

image4.png

Primeiro, escolha quais postbacks você deseja enviar:

Opção Significado
Tudo Envie postbacks para este parceiro sobre todos os eventos no aplicativo
Somente se a instalação foi atribuída ao X Envie postbacks a este parceiro sobre eventos no aplicativo somente se a instalação do aplicativo tiver sido atribuída a esse parceiro.
Desligado Nunca envie postbacks a este parceiro sobre eventos no aplicativo.

Em seguida, adicione seus eventos no aplicativo da seguinte maneira:

Campo Significado
Nome do evento no aplicativo (SDK) O nome do evento conforme enviado do seu aplicativo por meio da integração do Singular SDK.
Nome do evento O nome ou ID do evento conforme reconhecido pelo parceiro (o parceiro normalmente teria uma lista de eventos que ele pode reconhecer).
Lookback Defina uma janela de lookback para limitar os postbacks de eventos a um período de tempo especificado, por exemplo, 5 dias após a instalação. Se o evento ocorrer após o número de dias especificado, nenhum postback será enviado.

Opções da janela Lookback:
Touchpoint (Ponto de toque): O período começa a partir do clique/visualização do anúncio ao qual a instalação foi atribuída.
Install (Instalação): O período começa a partir da instalação.
None (Nenhum): Sem limite de tempo para postbacks de eventos.
Days (Dias) A duração da janela de lookback em dias.
Include Revenue Value (Incluir valor da receita) Para eventos de receita, inclua as informações de receita no postback (se você não marcar essa caixa de seleção, a Singular enviará apenas uma contagem dos eventos).
Quais são os diferentes eventos de receita (__IAP__, __REVENUE__, __ADMON_ USER_LEVEL_REVENUE__)? Para qual(is) devo configurar os postbacks?

Na lista suspensa In-App (SDK) Events (Eventos no aplicativo (SDK)), você verá vários eventos relacionados à receita diferentes, alguns dos quais se sobrepõem.

Para evitar que postbacks duplicados sejam enviados para o mesmo evento no aplicativo, certifique-se de entender as diferenças entre os eventos e siga as instruções abaixo.

Nome do evento de receita
Descrição

__IAP__

Um evento acionado por qualquer compra no aplicativo que não recebeu um nome personalizado na implementação do SDK/S2S.

(Eventos de receita personalizados)

Os eventos de compra no aplicativo que receberam nomes personalizados na implementação do SDK/S2S também aparecem na lista.
__ADMON_ USER_LEVEL_REVENUE__ Um evento acionado pela receita obtida com a monetização de anúncios (se você configurou a atribuição de receita de anúncios usando o método de envio de eventos do SDK).
__REVENUE__

Um evento acionado por qualquer receita recebida no aplicativo (incluindo __IAP__, eventos de compra com nomes personalizados e eventos de receita de anúncios). Veja o aviso abaixo.

Se você tiver apenas receita de compra no aplicativo:

  • Configure mapeamentos para __IAP__ e quaisquer eventos de compra personalizados.
  • Ou, alternativamente, use __REVENUE__, que abrange todos os seus eventos de compra no aplicativo.

Se você tiver receita de compras no aplicativo e receita de anúncios:

  • Configure mapeamentos para __IAP__, quaisquer eventos de compra personalizados e __ADMON_USER_LEVEL_REVENUE__.
  • Não recomendamos o uso do evento geral __REVENUE__ nesse caso, pois ele inclui compras e eventos de receita de anúncios, e mapear os dois tipos de receita para o mesmo evento de receita no lado da rede pode causar problemas.
  • Em vez disso, mapeie eventos de compra no aplicativo para o evento de compra da rede e o evento __ADMON_USER_LEVEL_REVENUE__ para o evento admon ou de receita de anúncios da rede.
  • Se você não tiver certeza de quais eventos usar no lado da rede, entre em contato com a rede para obter detalhes.

Aviso: Se sua configuração existente para um parceiro estiver enviando __REVENUE__ postbacks e você estiver começando a ter eventos de receita de anúncios além de eventos de compra no aplicativo, isso poderá causar problemas se a rede de parceiros não estiver configurada para receber eventos de receita de anúncios ou precisar deles para ser mapeado para um evento separado. Verifique com a rede se e como você deve enviar postbacks de receita de anúncios.

Como atualizo as integrações de parceiros e a configuração de postback?

A equipe de integração da Singular está em constante contato com os parceiros para garantir que tenhamos a melhor integração possível. Ocasionalmente, um parceiro pode solicitar que você atualize a integração, por exemplo, devido a alterações em como o parceiro deseja receber postbacks da Singular.

Na maioria dos casos, você pode atualizar a integração fazendo login na Singular, acessando a página Partner Configuration (Configuração do parceiro), abrindo a integração e salvando-a novamente.

Em alguns casos raros, uma atualização pode exigir mais etapas, como fornecer um novo campo ou configuração que não existia antes. Nesses casos, o parceiro ou a Singular entrarão em contato com você para fornecer instruções.

Posso fazer uma mudança global nas integrações de parceiros? Posso atualizar as configurações padrão para configurações de parceiros?

Não. Embora as configurações do parceiro possam parecer semelhantes, cada configuração é integrada exclusivamente na Singular. Não é possível neste momento atualizar várias configurações ao mesmo tempo.