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
Se uma rede de parceiros disser que não está recebendo postbacks para instalações/conversões ou eventos no aplicativo:
- 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.
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.
Se um parceiro de rede disser que está recebendo postbacks sem atributos de evento:
- 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.
- 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.
- Se as configurações estiverem corretas e os postbacks ainda estiverem sendo enviados com atributos ausentes, entre em contato com o suporte da Singular.
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:
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
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
Consulte Endereços IP do Servidor Postback.
- 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
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).
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.
-
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.
"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.
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 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.
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
As configurações do parceiro são definidas para cada site de aplicativo separadamente.
A Singular geralmente requer certas credenciais para enviar postbacks ao parceiro. Peça ao parceiro as credenciais apropriadas.
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).
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).
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.
Consulte A janela de lookback de atribuição.
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.
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:
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.
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.
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.