Exportar logs e perguntas frequentes de dados no nível do usuário

Os dados no nível do usuário são os dados brutos registrados pelo rastreador de atribuição da Singular, pelo mecanismo de proteção contra fraudes e pelas integrações da SKAdNetwork.Você pode fazer o download dos registros no nível do usuário por meio da página Exportar registros ( Atribuição > Exportar registros).

Para obter uma descrição dos campos em cada registro, consulte Exportar registros: Campos suportados.

Este artigo descreve os recursos de Export Logs disponíveis para os clientes da Singular. Se você for um parceiro da Singular, consulte Usando o Partner Portal.

Solução de problemas com os registros

Por que os registros de conversões/eventos não correspondem aos relatórios agregados da Singular?

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óriosou relatórios de API), verifique o seguinte:

O relatório pode estar usando 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 naquele dia (consulte O que são métricas de coorte e períodos de coorte? Em contraste, os eventos em logs exportados estão sempre associados à data e hora reais em que ocorreram.

Verifique as configurações do relatório para garantir que o período de coorte esteja definido como real, de modo a mostrar os eventos que ocorreram na data real.

Hora do servidor vs. hora ajustada

O banco 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. Isso pode ser significativamente diferente da hora original em que o evento ocorreu se houver 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 registros é baseado no carimbo de data/hora do servidor.

Os intervalos de datas na página Relatórios e em outras ferramentas de relatório da Singular (por exemplo, a API da Singular) são baseados no carimbo de data/hora ajustado.

Isso pode causar discrepâncias nas contagens de eventos se, por exemplo, um evento que ocorreu em 1º de junho foi atrasado de tal forma que chegou aos servidores da Singular em 2 de junho.

" Para obter mais dicas de soluçãode problemas, consulte a seção Solução de problemas de seus relatórios.

Por que vejo "Orgânico", "Suprimido" ou "Não atribuído"nos registros em vez de redes e nomes de campanhas?

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, ela será marcada como orgânica, e é assim que ela aparece nos logs em nível de usuário:

  • Rede: "Orgânica"
  • Campanha: "Unattributed" (Não atribuído)

2. Campanhas do Facebook

Devido a preocupações com a privacidade do usuário final, o Facebook não nos permite exibir dados no nível do usuário para atribuições com base na API de autoatribuiçã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 autoatribuiçã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 exibidas com todos os detalhes normais em relatórios no nível do usuário.

" Para obter mais informações, consulte Integração de atribuição de anúncios do Facebook.

3. Campanhas de visualização do TikTok

Desde 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 view-through (baseada em impressões) da TikTok, ela será exibida da seguinte forma, tanto em seus postbacks quanto nos registros:

  • Network (Rede): "TikTok Restricted" (Restrito ao TikTok)
  • Campaign (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 oculte 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 término do período de retenção de dados, você verá os seguintes detalhes nos logs de eventos no nível do usuário:

  • Rede: "Orgânica"
  • Campanha: "Suprimido"
Parceiro Período máximo de retenção de dados
Facebook 6 meses
TikTok 6 meses
Twitter 6 meses
Google Ads 6 meses
Snapchat 2 meses

Dica: se estiver recebendo postbacks em sua plataforma interna de BIque incluem conversões e eventos, você pode examinar os detalhes internamente para entender a fonte de aquisição original para o ID de dispositivo específico.

Por que há menos eventos/instalações do Facebook no registro do que nos relatórios agregados da Singular?

Desde outubro de 2021, o Facebook não permite que MMPs, como a 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 sendo 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, a Singular mostra informações sobre essas instalações e eventos em relatórios agregados (ou seja, na página Relatórios, na API da Singular etc.).

Observe que, além da API de autoatribuiçã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 registros 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

O que são dados no nível do usuário?

Os dados no nível do usuário são os dados brutos 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 no aplicativo, postbacks, decisões de fraude e muito mais.

A Singular usa esses dados para calcular os dados agregados que você 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: Log mostrando dados de eventos no nível do usuário

Screen_Shot_2020-12-30_at_19.46.06.png

Como posso acessar os dados no nível do usuário?

Há três maneiras de acessar os dados no nível do usuário:

1. A página Export Logs (Atribuição > Export Logs)

A página Export Logs na plataforma Singular permite que você faça o download manual de dados no nível do usuário para cliques, instalações, reengajamentos, eventos in-app, postbacks e dados relacionados a fraudes. A página gera um arquivo CSV.

Como cliente, você pode baixar dados do início do mês anterior. Por exemplo, se estivermos em meados de fevereiro, você poderá fazer o download dos dados de 1º de janeiro em diante.

Para conhecer as opções disponíveis para os parceiros da Singular, consulte Usando o Partner Portal: Export 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 podem ser exportados dessa forma são as conversões e eventos no nível do usuário.

" Saiba mais em Singular Data Destinations FAQ.

3. Configuração de postbacksinternos de 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 sobre fraudes.

" Saiba mais nasPerguntas frequentes sobre postbacks de BI interno.

Como faço o download de dados em nível de usuário da página Export Logs?

Para exportar um registro:

  1. Vá para Attribution > Export Logs (Atribuição > Exportar registros).
  2. Escolha o intervalo de datas relevante. Você pode exportar registros até o início do mês passado. Recomendamos manter o intervalo de datas o mais restrito possível para evitar ultrapassar o limite de registros por download.
  3. Selecione o aplicativo, o site do aplicativo e o tipo de log que deseja exportar (cliques, instalações, eventos ou postbacks).
  4. Selecione os campos que deseja incluir arrastando-os para a caixa Campos selecionados.

    Screen_Shot_2020-12-30_at_19.52.07.png

    Certifique-se de selecionar o campo ID do dispositivo ao exportar os logs para obter dados precisos no nível do usuário.

  5. Opcionalmente, você pode filtrar o log por Parceiros atribuídos, Países, ID do dispositivo e Tipo de dispositivo.Para logs de eventos, você também pode filtrar por eventos específicos e, para logs de conversão, pode filtrar por tipo de conversão. Recomendamos filtrar o log o máximo possível para evitar ultrapassar o limite de registros.Screen_Shot_2020-12-30_at_19.19.49.png
  6. Selecione Exportar registro.

Limitações

  • O Facebook não permite acesso a nenhum dado de nível de usuário com base na API de autoatribuição do Facebook. Qualquer campo que normalmente identifique uma instalação autoatribuí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 aparecemnas 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 os parceiros da Singular, consulte Usando o Portal do parceiro: Exportar registros.
  • A exportação é limitada a 5 milhões de registros por solicitação.
  • Os registros fornecerão dados até os últimos 60 minutos do dia atual. Marque a caixa de seleção de dados em tempo real para obter os dados dos últimos 60 minutos.
  • O banco de dados da Singular tem dois valores de tempo distintos associados a cada registro nos logs: o carimbo de data/hora do servidor(que reflete a hora em que o evento foi recebido pelos servidores da Singular) e o carimbo de data/hora ajustado (que reflete 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 observações

  • O campo de fuso horário informa o fuso horário definido para sua conta do Singular.
  • Os campos com registro de data e hora (por exemplo, touchpoint__timestamp) são exportados em seu fuso horário configurado. Os registros de data e hora baseados no horário Unix (por exemplo, touchpoint__unix_timestamp) estão no fuso horário UTC.
  • Se desejar alterar a lista de campos exportados por padrão ou adicionar uma solicitação para que um novo campo seja exportado, entre em contato com o gerente 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 do parceiro, você poderá fazer download 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.
Que tipos de registros posso baixar?

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 eles foram atribuídos e outros detalhes sobre a atribuição (por exemplo, se foi determinísticaou probabilística).

Observação: o local fornecido para o evento de conversão é baseado no IP de onde ele foi acionado - não em qualquer local detectado internamente em seu aplicativo ou em qualquer informação fornecida pelo usuário. 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 no aplicativo, incluindo sessões, registros, compras e quaisquer outros eventos que tenham sido definidos no aplicativo ao integrar o Singular SDK/S2S.
Ao comparar dados de registros 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 ACTUAL.

Postbacks

Inclui dados sobre quaisquer postbacks enviados pela Singular (não apenas postbacks sobre decisões de atribuição). O registro inclui postbacks para seu BI interno (se você 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 Response HTTP Code e Response HTTP Body. O Response HTTP Code 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 da SKAN(SKAdNetwork)

Registros dos postbacks de SKAdNetwork que a Singular recebeu de 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

A saída bruta do sistema de prevenção de fraudes da Singular.

Observe que esse registro 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 detecção de fraudepara obter mais informações). Portanto, você pode ver vários pontos de contato rejeitados por fraude para uma única instalação.

O que significam os diferentes campos?

" Para obter uma descrição dos campos em cada registro, consulte Exportar registros: Campossuportados.

Como posso usar os registros para verificar as instalações no meu relatório agregado?
  1. Execute um relatório na página Relatórios (ou na API de relatórios) mostrando as instalações por fonte e campanha.
  2. Na página Exportar registros, escolha o tipo de registro Conversões e extraia os seguintes campos para o mesmo intervalo de datas:

crosscheck.png

Por quanto tempo a Singular retém dados no nível do usuário?

Em conformidade com os parceiros integrados, bem como com os padrões globais de privacidade do usuário, a Singular não retém dados de nível de usuário por mais de 30 dias.