A página Configuração de 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 configurar definições de parceiros e postbacks.
Observação: Este guia é para clientes da Singular. Se você for um parceiro da Singular ou quiser se tornar um, consulte Informações para parceiros.
Solução de problemas
Se uma rede de parceiros disser que não está a receber postbacks para instalações/conversões ou eventos in-app:
- Vá para Atribuição > Exportar logs e baixe os logs de postbacks para o parceiro. Para obter ajuda sobre o download de logs, consulte as Perguntas frequentes sobre logs de exportação e dados no nível do usuário.
- Certifique-se de filtrar os postbacks com o Código HTTP de resposta = 200. Se o Código HTTP de resposta for "200", isso significa que o parceiro confirmou que recebeu o postback.
- Selecione também o campo Corpo do HTTP de resposta, pois ele pode ajudar a identificar um problema técnico no parceiro.
- Partilhe o registo 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.
Se o parceiro da rede de anúncios estiver configurado para receber todas as instâncias de eventos de instalação ou in-app e você tiver selecionado "enviar todos" os eventos para o parceiro, a configuração de postback continuará a enviar postbacks para ele. Você terá que excluir o postback ou desmarcar as caixas "enviar todos" na Configuração do parceiro para parar de enviar esses dados. Consulte a definição de Receber todas as instalações no Glossário do Singular.
Algumas razões possíveis são:
- Janelas de lookback: Um ou mais eventos podem ter uma janela de lookback diferente configurada para postbacks. Verifique as definições na página Configuração do parceiro.
- Problemas técnicos: O parceiro pode não ter recebido um ou mais postbacks devido a problemas técnicos no lado do parceiro. Para verificar, consulte Porque é que o meu parceiro de rede não está a receber postbacks?
- Eventos duplicados: O Singular SDK no 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 in-app. 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 para ambos. Caso contrário, o Singular enviará dois postbacks para cada compra in-app.
Se um parceiro de rede disser que está recebendo postbacks sem atributos de evento:
- Vá para Atribuição > Exportar logs e baixe os logs de postbacks para o parceiro. Verifique os campos Corpo HTTP do postback ou URL de destino para ver se eles incluem atributos de evento. Para obter ajuda para descarregar registos, consulte as Perguntas frequentes sobre registos de exportação e dados ao nível do utilizador.
- Se os registos mostrarem que os postbacks estão de facto a ser enviados sem atributos de evento, verifique novamente as definições de postback na página Configuração do parceiro. Se não tiver configurado atributos adicionados para serem enviados juntamente com eventos, altere as definiçõ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 o 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 Atribuição > Exportar logs.
Para obter ajuda geral com a página Exportar logs, consulte as Perguntas frequentes sobre Exportar logs e dados no nível do usuário.
Para validação de postback, recomendamos o download de 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 e Destinatário do Postback:
- Parceiro é a rede à qual o evento foi atribuído.
- Odestinatário do postback é o parceiro que recebeu o postback do evento. O evento não é necessariamente atribuído a esse parceiro (lembre-se que alguns parceiros pedem para receber postbacks de todos os seus eventos, quer sejam atribuídos a esse parceiro ou a outra rede, e pode ativar essa opção na página Configuração do parceiro ).
Um campo adicional, É atribuído, esclarece melhor 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 pode ver no campo Parceiro ).
Nota: O filtro Parceiros filtrará os postbacks pelo nome do parceiro que recebeu os postbacks - quer se trate de uma rede de parceiros, do seu BI interno, de ferramentas de análise de terceiros, etc.
Para outros tipos de registo, o filtro Parceiros significa o parceiro a quem foi atribuída uma conversão ou um evento (redes de anúncios).
PERGUNTAS FREQUENTES
Perguntas frequentes sobre a configuração de parceiros
A Singular envia a cada rede de parceiros um postback quando uma instalação de aplicativo é atribuída a essa rede. Não é possível desativar estes postbacks.
Outros tipos de postbacks são opcionais e dependem das preferências da rede de parceiros:
- Postbacksde reengajamento
- Postbacks de eventos in-app
- Postbacks sobre conversões (instalações/engajamentos) e eventos que não são atribuídos ao parceiro
Consulte Endereços IP do servidor de postback.
- A Singular tenta enviar um postback se receber um código de resposta HTTPS entre 500 e 559.
- O mecanismo tem um máximo de 5 tentativas.
- As tentativas são feitas em intervalos de 1, 5, 15, 30 e 60 minutos a partir da tentativa original.
Tipos de parceiros e terminologia
Os parceiros na página Configuração de parceiros 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 ao Singular de quais fontes extrair dados de campanha para apresentar os dados nos relatórios do Singular. Para isso, é necessário configurar redes de anúncios e outras fontes de mídia separadamente na página Conectores de dados (consulte as Perguntas frequentes sobre conectores de dados).
A página Configuração de parceiros permite-lhe configurar os seguintes aspectos por parceiro e site:
- A janela de lookback para atribuição de cliques
- Quais postbacks devem ser enviados para o parceiro
- Também é aqui que você insere suas credenciais de login na plataforma do parceiro, se o Singular precisar delas para se conectar ao parceiro. Isso varia de parceiro para parceiro.
Para obter mais detalhes, consulte Configuração de definições e postbacks abaixo.
-
Alguns parceiros são redes de anúncios, agências de anúncios, etc. Você define as configurações de atribuição para esses parceiros e, em seguida, cria links de rastreamento que incorporam as macros personalizadas dos parceiros. Também pode fazer com que o Singular envie a estes parceiros informações sobre instalações atribuídas, decisões de fraude, etc., sob a forma de postbacks automatizados.
- Outros parceiros são sistemas de BI de terceiros, serviços de análise de fraudes, etc. Se trabalhar com esses serviços, pode configurá-los na página Configuração de parceiros para que possam receber postbacks.
O "BI interno" é um tipo especial de parceiro que pode configurar se pretender que a sua própria plataforma interna receba postbacks sobre decisões de atribuição, decisões de fraude, etc. Consulte Configuração de 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. Configura as definições de parceiro para cada site de aplicação separadamente.
Por exemplo, se tiver uma aplicação que é executada no Android e no iOS, tem dois sites de aplicações e pode configurar as definições de parceiro para cada um deles.
Veja 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, o Singular começa a criar postbacks com base nesse modelo.
Para exportar as configurações de postback para todos os parceiros:
- Clique em Exportar tudo no canto superior direito da página Configuração de parceiros.
- Para exportar 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 Exportar selecionados.
Isso faz o download de um arquivo CSV com informações sobre cada postback que foi configurado.
Observações:
- Cada linha no arquivo CSV representa um postback configurado para o parceiro.
- Novos campos estão disponíveis no arquivo exportado a partir de maio de 2023.
Coluna | Descrição |
Parceiro | O nome do parceiro |
Agência | [NOVO CAMPO] O nome da agência configuradora (se relevante) |
Aplicação | O nome de apresentação da aplicação |
ID do pacote | O nome longo ou a ID do pacote da aplicação |
ID pública do sítio | [NOVO CAMPO] O ID da aplicação na Apple App Store ou no Google Play, ou o URL do sítio Web para sítios Web. |
SO | O sistema operativo da aplicação (iOS ou Android) |
Enviar postbacks de visualização |
[NOVO CAMPO] Verdadeiro se o parceiro tiver sido configurado para receber postbacks sobre a visualização |
Janela de lookback de atribuição de cliques | A janela de lookback configurada para este site de parceiro e aplicativo. |
Tipo de postback | Se o postback específico descrito nesta linha é para uma instalação ou um evento. |
Tipo de lookback de evento | Opções da janela de lookback: - Ponto de contacto: O período de tempo começa a partir do clique/visualização do anúncio ao qual a instalação foi atribuída. - Instalação: O período de tempo começa a partir da instalação. - Nenhum: Sem limite de tempo para postbacks de eventos. |
Janela de lookback de evento | Uma janela de lookback para limitar os postbacks de evento a um período de tempo especificado de acordo com o tipo de lookback de evento, em dias. |
Nome do SDK do evento |
[NOME DO CAMPO ALTERADO: ANTIGAMENTE "EVENTOS"] Se o postback descrito nesta linha for para um evento: o nome do SDK Singular do evento. |
Nome do parceiro do evento |
[NOVO CAMPO] Se o postback descrito nesta linha for para um evento: o nome do parceiro para o evento, mapeado na configuração do parceiro. |
Apenas atribuído | Se o postback é enviado para todos os eventos deste tipo ou apenas se o evento tiver sido atribuído ao parceiro específico. |
URL do postback | O URL completo do postback, incluindo macros Singular. |
Data de criação |
[NOVO CAMPO] Data de criação da configuração |
Data da última atualização |
[NOVO CAMPO] Data da última atualização da configuração |
O URL do postback é personalizado | [NOVO CAM PO] Sim/não (este campo só está disponível se a funcionalidade de postback flexível tiver sido activada para este cliente Singular). |
Nome do filtro do rastreador | [NOVO CAMPO] O nome do filtro ou "Sem filtro" (este campo só está disponível se a funcionalidade de postback flexível tiver sido activada para este cliente Singular). |
Restrição limitada de partilha de dados | [NOVO CAM PO] Verdadeiro/Falso (este campo só está disponível se a funcionalidade de partilha limitada de dados tiver sido activada para este cliente Singular). |
Padrão de partilha de dados limitada | [CAMPO NOVO] Verdadeiro/Falso (este campo só está disponível se a funcionalidade de partilha de dados limitada tiver sido activada para este cliente Singular). |
Tipo de limitação de país | [NOVO CAM PO] "Incluir" ou "Excluir" (este campo só está disponível se a funcionalidade relevante tiver sido activada para este cliente Singular). |
Limitação do país | [NOVO CAMPO] Lista de nomes de países separados por vírgulas (nomes completos, não códigos de país) (este campo só está disponível se a funcionalidade relevante tiver sido activada para este cliente Singular). |
Definições e postbacks
As definições de parceiro são configuradas para cada site de aplicações separadamente.
O Singular normalmente requer determinadas credenciais para enviar postbacks para o parceiro. Peça ao parceiro as credenciais apropriadas.
Estes são postbacks que notificam o parceiro sobre um reengajamento bem-sucedido. A opção de ativar estes postbacks só está disponível para parceiros que suportam campanhas de reengajamento (campanhas de retargeting).
As atribuições de visualização são atribuições determinadas com base numa visualização do anúncio e não num clique no anúncio. Se você executar qualquer campanha de exibição, selecione Incluir atribuições de exibição para que a Singular envie postbacks ao parceiro sobre essas atribuições também (caso contrário, a Singular só enviará postbacks sobre atribuições de cliques).
Observação - as atribuições de visualização para eventos no aplicativo serão determinadas pela configuração de atribuição de instalação ou reengajamento. Isso significa que o view-through só será aplicado a eventos in-app se estiver ativado para instalação ou reengajamento.
Os postbacks de fraude incluem informações sobre decisões tomadas pelo sistema de deteção de fraudes da Singular. Para saber mais, consulte Postbacks de fraude. Além disso, consulte Prevenção de fraudes da Singular para obter uma introdução aos métodos avançados de deteção de fraudes da Singular.
Consulte A janela de lookback de atribuição.
Esta é 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 depois que o número de dias especificado tiver passado, nenhum postback será enviado. A predefinição para o envio de eventos pós-instalação atribuídos é de 7 dias a partir do ponto de contacto atribuído (consulte a definição de "Ponto de contacto" abaixo).
Eventos in-app são quaisquer eventos de usuário que acontecem no seu aplicativo após a conversão. Por exemplo, um utilizador que instala a sua aplicação pode depois iniciar sessão ou registar-se na sua plataforma, ver o tutorial ou subir de nível se for uma aplicação de jogos. Alguns parceiros querem receber postbacks sobre esses eventos do serviço de atribuição da Singular.
Primeiro, escolha quais postbacks você deseja enviar:
Opção | Significado |
Todos | Enviar a este parceiro postbacks sobre todos os eventos in-app |
Somente se a instalação foi atribuída a X | Só envia postbacks a este parceiro sobre eventos in-app se a instalação do aplicativo tiver sido atribuída a este parceiro. |
Desligado | Nunca enviar a este parceiro postbacks sobre eventos in-app. |
Em seguida, adicione seus eventos in-app da seguinte forma:
No menu suspenso Eventos no aplicativo (SDK), você verá vários eventos diferentes relacionados à receita, alguns dos quais se sobrepõem.
Para evitar que sejam enviados postbacks duplicados para o mesmo evento in-app, siga as instruções abaixo.
Nome do evento de receita |
Descrição |
__IAP__ |
Um evento acionado por qualquer compra in-app que não tenha recebido um nome personalizado na implementação do SDK/S2S. |
(Eventos de receita personalizados) |
Os eventos de compra in-app 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 tiver configurado a atribuição de receitas de anúncios utilizando o método de envio de eventos SDK). |
RECEITA |
Um evento acionado por qualquer receita que entre na aplicação (incluindo __IAP__, eventos de compra com nomes personalizados e eventos de receita de anúncios). Ver aviso abaixo. |
O que fazer se tiver apenas receitas de compras in-app:
- Configure mapeamentos para __IAP__ e quaisquer eventos de compra personalizados.
- Ou, em alternativa, utilize __REVENUE__, que engloba todos os seus eventos de compra in-app.
O que fazer se tiver receitas de compras in-app e receitas de anúncios:
- Configure mapeamentos para __IAP__, quaisquer eventos de compra personalizados e __ADMON_USER_LEVEL_REVENUE__.
- Não recomendamos a utilização do evento geral __REVENUE__ neste caso, uma vez que inclui eventos de compras e de receitas de anúncios, e o mapeamento de ambos os tipos de receitas para o mesmo evento de receitas no lado da rede pode causar problemas.
- Em vez disso, mapeie os eventos de compra in-app para o evento de compra da rede e o evento __ADMON_USER_LEVEL_REVENUE__ para o evento de receita de anúncios ou admon da rede.
- Se não tiver a certeza de quais os eventos a utilizar do lado da rede, contacte a rede para obter mais informações.
Aviso: Se a sua configuração existente para um parceiro estiver a enviar postbacks __REVENUE__ e estiver a começar a ter eventos de receita de anúncios para além dos eventos de compra in-app, isto pode causar problemas se a rede parceira não estiver configurada para receber eventos de receita de anúncios ou precisar que estes sejam mapeados para um evento separado. Verifique com a rede para ver se e como deve enviar postbacks de receitas de anúncios.
A equipa de integração da Singular está em constante contacto com os parceiros para garantir que temos a melhor integração possível. Ocasionalmente, um parceiro pode solicitar que você atualize a integração, por exemplo, devido a alterações na forma como o parceiro deseja receber postbacks da Singular.
Na maioria dos casos, é possível atualizar a integração fazendo login no Singular, acessando a página Configuração do parceiro, abrindo a integração e salvando-a novamente.
Em alguns casos raros, uma atualização pode exigir mais etapas, como o fornecimento de um novo campo ou configuração que não existia antes. Nesses casos, o parceiro ou a Singular entrará em contacto consigo para fornecer instruções.
Não. Embora as definições de configuração do parceiro possam parecer semelhantes, cada configuração é integrada de forma exclusiva na Singular. Neste momento, não é possível atualizar várias configurações ao mesmo tempo.