Os dados ao nível do utilizador são os dados em bruto que são registados pelo rastreador de atribuição da Singular, pelo motor de proteção contra fraudes e pelas integrações da SKAdNetwork. É possível fazer o download dos logs no nível do usuário por meio da página Exportar logs (Atribuição > Exportar logs).
Para obter uma descrição dos campos em cada log, consulte Exportar logs: Campos suportados.
Este artigo descreve os recursos de Logs de exportação disponíveis para os clientes da Singular. Se você for um parceiro da Singular, consulte Usando o Partner Portal.
Solução de problemas dos logs
Se você baixar os logs de Conversões ou Eventos (na página Exportar logs ) e as contagens não corresponderem ao que você vê nos relatórios da Singular (a página Relatórios ou relatórios da API), verifique o seguinte:
O relatório pode estar usando a análise de coorte
Seu relatório pode estar exibindo eventos por coorte, o que significa que para cada dia no intervalo de datas, o relatório conta os eventos que foram criados por usuários que instalaram o aplicativo nesse dia (consulte O que são métricas de coorte e períodos de coorte?) Por outro lado, os eventos em registos exportados estão sempre associados à data e hora reais em que ocorreram.
Verifique as definições do relatório para se certificar de que o período de coorte está definido como real, de modo a mostrar os eventos que ocorreram na data real.
Hora do servidor vs. hora ajustada
A base de dados Singular tem dois valores de tempo distintos associados a cada evento:
- O carimbo de data/hora do servidor reflete a hora em que o evento foi recebido pelos servidores do Singular. Este valor pode ser significativamente diferente da hora original em que o evento ocorreu, caso tenha havido um atraso técnico no envio dos dados do evento.
- O carimbo de data/hora ajustado reflete a hora original em que o evento ocorreu.
O intervalo de datas na página Exportar registos é baseado no carimbo de data/hora do servidor.
Os intervalos de datas na página Relatórios e em outras ferramentas de relatório do Singular (por exemplo, a API do Singular) são baseados no carimbo de data/hora ajustado.
Isso pode causar discrepâncias na contagem de eventos se, por exemplo, um evento que ocorreu em 1º de junho foi atrasado de forma que chegou aos servidores do Singular em 2 de junho.
" Para obter mais dicas de resolução de problemas, consulte a secção Resolução de problemas dos seus relatórios.
Pode haver vários motivos para esses valores aparecerem nos logs baixados.
1. Conversões orgânicas reais
Se uma conversão for considerada como não tendo uma origem paga, é marcada como orgânica e é assim que aparece nos registos ao nível do utilizador:
- Rede: "Orgânica"
- Campanha: "Não atribuída"
2. Campanhas do Facebook
Devido a preocupações com a privacidade do utilizador final, o Facebook não nos permite apresentar dados ao nível do utilizador para atribuições baseadas na API de auto-atribuição do Facebook. Essas atribuições aparecem como:
- Rede: "Não atribuído"
- Campanha: "Não atribuído"
Observe que, além da API de auto-atribuição, o Facebook também tem um método de atribuição separado baseado no Referenciador de instalação do Android. As atribuições baseadas nesse método são apresentadas com todos os detalhes normais nos relatórios ao nível do utilizador.
" Para obter mais informações, consulte Integração de atribuição de anúncios do Facebook.
3. Campanhas de visualização do TikTok
Apartir de 22 de março de 2022, o TikTok exige que as MMPsmascarem os dados no nível do usuário para campanhas de visualização devido a preocupações com a privacidade do usuário. Portanto, se uma conversão for atribuída a uma campanha de visualização do TikTok (baseada em impressões), ela será exibida da seguinte forma, tanto em seus postbacks quanto nos logs:
- Rede: "TikTok Restricted" (Restrito ao TikTok)
- Campanha: "TikTok Restricted" (Restrito ao TikTok)
" Para obter mais informações, consulte Integração de atribuição do TikTok For Business.
4. O período de retenção de dados já passou
Alguns parceiros exigem que a Singular mascare os dados no nível do usuário após um determinado período de tempo devido a preocupações com a privacidade do usuário.
Se uma instalação ou reengajamento for atribuído a um dos seguintes itens e um evento in-app for acionado após o período de retenção de dados ter passado, você verá os seguintes detalhes nos logs de eventos no nível do usuário:
- Rede: "Orgânica"
- Campanha: "Suprimida"
Parceiro | Período máximo de retenção de dados |
6 meses | |
TikTok | 6 meses |
6 meses | |
Anúncios do Google | 6 meses |
Snapchat | 2 meses |
Dica: Se estiver a receber postbacks para a sua plataforma de BI interna que incluem conversões e eventos, pode analisar os detalhes internamente para compreender a fonte de aquisição original para o ID de dispositivo específico.
A partir de outubro de 2021, o Facebook não permite que MMPs como o Singular exibam informações no nível do usuário sobre qualquer instalação ou evento que tenha sido atribuído por meio da API de autoatribuição do Facebook. Portanto, essas instalações e eventos não são marcados como do Facebook nos Logs de exportação ou postbacks enviados ao seu BI interno. A limitação não se aplica a dados agregados, portanto, o Singular mostra informações sobre essas instalações e eventos em relatórios agregados (ou seja, a página Relatórios, API do Singular, etc.).
Observe que, além da API de auto-atribuição, o Facebook tem outra solução de atribuição, baseada no Referenciador de instalação do Android. As instalações e os eventos que foram atribuídos por meio do referenciador de instalação aparecem nos logs de exportação.
Recomendamos que você forneça à Singular as Chaves de descriptografia do Referenciador de instalação para seus aplicativos, para que possamos fornecer informações baseadas no Referenciador de instalação sobre as campanhas do Facebook.
" Para obter mais informações, consulte Integração de atribuição de anúncios do Facebook.
PERGUNTAS FREQUENTES
Os dados no nível do usuário são os dados brutos que são registrados pelo mecanismo de atribuição e pelo mecanismo de proteção contra fraudes da Singular
Eles contêm os detalhes das atividades do usuário e registros relacionados à atribuição, incluindo cliques, conversões, reengajamentos, eventos de usuário in-app, postbacks, decisões de fraude e muito mais.
A Singular utiliza estes dados para calcular os dados agregados que vê nos relatórios (por exemplo, na página Relatórios).
Como cliente do serviço de atribuição da Singular, você pode acessar os dados brutos no nível do usuário e usá-los de várias maneiras - por exemplo, para verificar os dados em relatórios agregados se suspeitar que há um problema.
Exemplo: Registo com dados de eventos ao nível do utilizador
Existem três formas de aceder aos dados ao nível do utilizador:
1. A página Exportar logs (Atribuição > Exportar logs) |
A página Exportar registos na plataforma Singular permite-lhe transferir manualmente dados ao nível do utilizador para cliques, instalações, reengajamentos, eventos in-app, postbacks e dados relacionados com fraudes. A página gera um arquivo CSV. Como cliente, pode descarregar dados desde o início do mês anterior. Por exemplo, se for meados de fevereiro, pode descarregar dados de 1 de janeiro em diante. Para opções disponíveis para parceirosSingular, consulte Usando o Portal do parceiro: Exportar logs. |
2. Destinos de dados |
Os destinos de dados da Singular (ETL) enviam dados da Singular diretamente para sua plataforma interna de BI, data warehouse ou serviço de armazenamento. Um dos tipos de dados que você pode exportar dessa forma são as conversões e eventos no nível do usuário. " Saiba mais em Singular Data Destinations FAQ. |
3. Configurando postbacksinternos do BI |
Se você configurar o Singular para enviar postbacks para sua plataforma interna de BI, poderá receber dados em tempo real sobre instalações, reengajamentos, eventos in-app e decisões de fraude. " Saiba mais nas Perguntas frequentes sobre postbacks de BI interno. |
Para exportar um registo:
- Aceda a Atribuição > Exportar registos.
- Escolha o intervalo de datas relevante. Pode exportar registos até ao início do mês passado. Recomendamos manter o intervalo de datas o mais restrito possível para evitar ultrapassar o limite de registos por download.
- Selecione a aplicação, o site da aplicação e o tipo de registo que pretende exportar (cliques, instalações, eventos ou postbacks).
-
Selecione os campos que pretende incluir, arrastando-os para a caixa Campos selecionados.
Certifique-se de que seleciona o campo ID do dispositivo ao exportar quaisquer registos para obter dados precisos ao nível do utilizador.
- Opcionalmente, pode filtrar o registo por Parceiros atribuídos, Países, ID do dispositivo e Tipo de dispositivo. Para os registos de eventos, também pode filtrar por eventos específicos e, para os registos de conversão, pode filtrar por tipo de conversão. Recomendamos que filtre o registo tanto quanto possível para evitar ultrapassar o limite de registos.
- Selecione Exportar registo.
Limitações
- O Facebook não permite o acesso a quaisquer dados ao nível do utilizador com base na API de auto-atribuição do Facebook. Qualquer campo que normalmente identifique uma instalação auto-atribuída do Facebook é marcado como "Não atribuído". Observe que o Facebook também tem uma solução de atribuição separada com base no referenciador da Instalação do Android e as instalações atribuídas com base nessa solução aparecem nas exportações no nível do usuário. Para obter mais informações, consulte a documentação da Integração de atribuição de anúncios do Facebook.
- O intervalo de datas é limitado até o início do mês passado para clientes da Singular. Para obter opções disponíveis para parceiros Singular, consulte Usando o Portal do parceiro: Exportar logs.
- A exportação é limitada a 5 milhões de registros por solicitação.
- Os logs fornecerão dados até os últimos 60 minutos do dia atual. Selecione a caixa de seleção de dados em tempo real para os dados dos últimos 60 minutos.
- A base de dados Singular tem dois valores de tempo distintos associados a cada registo nos registos: o carimbo de data/hora do servidor (que reflecte a hora em que o evento foi recebido pelos servidores Singular) e o carimbo de data/hora ajustado (que reflecte a hora original em que o evento ocorreu). Isso pode causar discrepâncias entre os dados no nível do usuário e os relatórios agregados(saiba mais).
Outras notas
- O campo fuso horário indica o fuso horário definido para a sua conta Singular.
- Os campos com carimbo de data/hora (por exemplo, touchpoint__timestamp) são exportados no seu fuso horário configurado. Os carimbos de data/hora baseados na hora Unix (por exemplo, touchpoint__unix_timestamp) estão no fuso horário UTC.
- Se pretender alterar a lista de campos exportados por predefinição ou adicionar um pedido de exportação de um novo campo, contacte o seu Gestor de Sucesso do Cliente.
- Se uma rede solicitar dados de fraude no nível do usuário e não estiver habilitada para receber postbacks de fraude por meio da Configuração de parceiro, você poderá baixar e compartilhar os logs de fraude com a rede. A Singular não compartilhará esses dados com nenhuma rede por meio de um tíquete de suporte sem consentimento.
Cliques
Inclui todos os cliques que foram examinados para determinar a atribuição de uma instalação ou reengajamento.
Conversões
Inclui informações sobre instalações e eventos de reengajamento, a quem foram atribuídos e outros detalhes sobre a atribuição (por exemplo, se foi determinística ou probabilística).
Nota: A localização fornecida para o evento de conversão é baseada no IP de onde foi acionado - não em qualquer localização detectada internamente na sua aplicação ou em qualquer informação fornecida pelo utilizador. Se você tiver outra fonte de dados de localização para o evento, poderá verificá-la lendo o parâmetro de passagem enviado pelo seu aplicativo para o Singular.
Eventos
Inclui dados sobre eventos in-app, incluindo sessões, registos, compras e quaisquer outros eventos que tenham sido definidos na aplicação ao integrar o Singular SDK/S2S.
Ao comparar dados de logs de eventos com contagens de eventos em Relatórios, certifique-se de usar ACTUAL em Relatórios em vez de um período de coorte de 1d,7d,14d, etc. Observe que os relatórios não mostram dados em relação a eventos exclusivos para o período REAL.
Postbacks
Inclui dados sobre quaisquer postbacks enviados pela Singular (não apenas postbacks sobre decisões de atribuição). O registo inclui postbacks para o seu BI interno (se os tiver configurado) e para ferramentas de análise de terceiros.
Dica: Ao fazer o download dos logs de postback, certifique-se de selecionar os campos Código HTTP de resposta e Corpo HTTP de resposta. O Código HTTP de resposta informa se o postback foi entregue com êxito. Um código 200 significa sucesso; outros valores significam que houve um erro. Quando há um erro no envio, o Singular tenta novamente o postback mais 5 vezes, em intervalos de 1, 5, 15, 30 e 60 minutos. O corpo HTTP da resposta pode incluir detalhes adicionais sobre o erro.
Postbacks deSKAN(SKAdNetwork)
Registos dos postbacks de SKAdNetwork que a Singular recebeu dos seus parceiros de rede de anúncios. Esses postbacks estão disponíveis apenas para aplicativos iOS que usam o rastreamento da SKAdNetwork e para parceiros que têm uma integração da SKAdNetwork com a Singular que envolve o encaminhamento de postbacks. Saiba mais sobre a solução SKAdNetwork da Singular.
Fraude
O resultado bruto do sistema de prevenção de fraudes da Singular.
Observe que esse log inclui uma linha para cada ponto de contato (clique, impressão, etc.) associado a um evento de instalação, incluindo uma linha para a opção "instalação orgânica", que também é examinada como uma opção de atribuição para cada instalação (consulte O processo de deteção de fraude para obter mais informações). Portanto, você pode ver vários pontos de contato rejeitados por fraude para uma única instalação.
" Para obter uma descrição dos campos em cada log, consulte Exportar logs: Campos suportados.
- Execute um relatório na página Relatórios (ou na API de relatórios) mostrando as instalações por fonte e campanha.
- Na página Exportar logs, escolha o tipo de log Conversões e extraia os seguintes campos para o mesmo intervalo de datas:
Para cumprir com nossos parceiros integrados e padrões globais de privacidade do usuário, a Singular pode restringir a retenção de dados no nível do usuário a um máximo de 30 dias em certos casos. Salvo indicação em contrário, os períodos de retenção predefinidos para os dados ao nível do utilizador são os seguintes:
- Dados de impressão: Retidos por 14 dias a partir da data de coleta.
- Dados de cliques: Retidos durante 30 dias a partir da data de recolha.
- Dados de postback: Mantidos durante 30 dias a partir da data de recolha.
- Dados de evento: Retidos desde o início do mês anterior(até 60 dias).
- Dados de atribuição: Retidos desde o início do mês anterior(até 60 dias).
- Dados de fraude: Retidos desde o início do mês anterior(até 60 dias).
Estes períodos de retenção garantem a conformidade com os regulamentos de privacidade, ao mesmo tempo que fornecem acesso a dados essenciais para análise e relatórios. Para preservar todos os dados de nível de registo para além destes períodos, recomendamos vivamente a configuração de exportações automáticas para capturar e armazenar estas informações nos seus sistemas internos.