Relatórios de dados brutos SKAN

Para:
Profissionais de marketing
Última atualização:

Visão geral: os relatórios de dados brutos SKAN contêm dados em nível de linha gerados após traduzir e decodificar postbacks recebidos pela AppsFlyer do iOS, assim como postbacks brutos SKAN. Os dados estão disponíveis via Data Locker e Push API. Se o seu plano de assinatura incluir dados brutos, não há necessidade de uma assinatura do Data Locker. 

Relatórios de dados brutos SKAN

Princípios: 

  • Os dados são fornecidos por:
    • Data Locker
      • Atenção! Disponível para contas com assinatura de dados brutos. Ou seja, não há necessidade de uma assinatura do Data Locker. Se você não estiver usando o Data Locker no momento, um usuário administrador deverá configurar o Data Locker e habilitar os relatórios SKAN. Para fazer isso, vá para Integração > Data Locker. Selecione os relatórios SKAN. 
      • Taxa de atualização de dados: diariamente. Os dados estão contidos na pasta h=23 da data em que o postback é recebido pela AppsFlyer. Exemplo: se o postback foi recebido na segunda-feira, ele é processado após o final do dia. O processamento é concluído às 12:00 UTC de terça-feira e os dados são gravados na pasta segunda-feira h=23. 
    • Push API
  • Data de instalação: é derivada da hora de chegada do postback pela AppsFlyer da seguinte forma:
    • Se os postbacks forem SKAN V4, a fórmula da data de instalação será: Data de instalação = hora de chegada do postback - [tamanho da janela acumulada] - [atraso médio do postback].
      • Postback 1: data de instalação = hora de chegada do postback - 48h - 36h
      • Postback 2: data de instalação = hora de chegada do postback - 168h - 84h
      • Postback 3: data de instalação = hora de chegada do postback - 840h - 84h
    • Se os postbacks forem SKAN V3, a fórmula da data de instalação será: Data de instalação = horário de chegada do postback - 36 horas - [intervalo médio do último ativo]. 
      • O padrão [faixa média da última atividade] é de 12 horas.
      • Para um valor de conversão de 0, o último intervalo ativo médio é definido como 0.
    • O Google estima o tempo de instalação por conta própria e a AppsFlyer usa esse tempo de instalação. Observação: pode levar até 13 dias para o Google relatar as instalações. Saiba mais

Os tipos de relatórios disponíveis são:

  • Postback do dispositivo: 1 postback do dispositivo por instalação ou novo download recebido do dispositivo iOS.
  • Dados brutos SKAN:
    • A AppsFlyer decodifica e traduz o postback do dispositivo em registros de dados brutos.
    • Cada postback gera um registro de instalação ou novo download e registros de eventos in-app.
    • O número de registros de eventos in-app depende do valor de conversão (CV) da seguinte forma:
      • CV = 0, em branco ou nulo: nenhum registro no aplicativo é gerado. 
      • Faixa de CV:
        • 1 a 63: Para valor fino da janela 1 do SKAN 3 e SKAN, este é o número de registros in-app, dependendo de suas configurações de métrica.
        • Baixo, médio ou alto: para valores grosseiros do SKAN 4, este é o número de registros in-app, dependendo de suas configurações de métrica.

Por que alguns campos estão vazios? Isso ocorre por qualquer um dos seguintes motivos:

  • Campos de enriquecimento não obrigatórios, como nome_da_campanha, ad_network_campaign_id e ip, que a ad network não forneceu.
  • A Apple reteve os dados devido às políticas de limite da Apple. Campos como source_app_id, skad_campaign_id, skad_conversion_value. 

Formato e conteúdo do relatório de dados brutos SKAN

Tipos de relatórios de dados brutos

Tipo de relatório Nome do relatório Descrição
Postback Postbacks

Postbacks enviados pelo iOS para a ad network. O postback, após enriquecimento pela ad network, é encaminhado para a AppsFlyer. Faça download do exemplo de postbacks (CSV).

Observação: postbacks não estão incluídos quando did_win=false.

Nome do tópico no Data Locker: skad_postbacks
Postback Cópia de postbacks (direto da Apple)

Postbacks enviados diretamente pelo iOS para a AppsFlyer.

Disponível a partir do iOS 15+ e exige que o anunciante configure o aplicativo para enviar o postback vencedor para a AppsFlyer. Faça download do exemplo de cópia de postbacks (CSV).

Atenção: Este tópico contém apenas postbacks vencedores. 

Nome do tópico no Data Locker: skad_postbacks_copy
Evento decodificado Instalações

Instalações de aplicativos pela primeira vez

SKAN relatou redownload=false. Ou seja, é a primeira vez que o usuário, representado pelo ID Apple, faz download do app.
Faça download do exemplo de instalação (CSV).

Nome do tópico no Data Locker: skad_installs
Evento decodificado Redownloads

Instalações de aplicativos que não são instalações iniciais

SKAN relatou redownload=true. Ou seja, não é a primeira vez que o usuário, representado pelo ID da Apple, faz download do app. Este relatório tem a mesma estrutura das instalações.

Nome do tópico no Data Locker: skad_redownloads
Evento decodificado Eventos in-app

Eventos in-app

A partir de 21 de julho de 2021, haverá mudanças na forma como fornecemos dados brutos de eventos in-app, conforme detalhado nas tabelas. 

O número de registros de eventos in-app depende de suas configurações de métrica. 

Faça download do exemplo de eventos in-app (CSV).

Nome do tópico no Data Locker: skad_inapps

Válido para postbacks do iOS recebidos a partir de 21 de julho de 2021:

Tipo de mensuração Descrição
Receita
  • Receita de um determinado usuário. Se receita > 0, um registro contendo os campos skad_revenue e event_name.
  • Os campos min_revenue e max_revenue são preenchidos com seus valores de intervalo de conversão personalizados.  
Conversão in-app e eventos de funil
  • Um registro para cada evento de conversão exclusivo realizado. O campo event_name é preenchido de forma correspondente. Se nenhum evento for executado, não há registro.
  • Os eventos de conversão têm min_event_counter = 0 e max_event_counter = 1. 
Engajamento in-app  Para determinar o número de vezes que um usuário executou um determinado evento in-app, use a fórmula[round up (min_event_counter + max_event_counter) / 2]

Válido para postbacks de iOS recebidos até 20 de julho de 2021:

Tipo de mensuração Número de registros Descrição
Receita 0 a 1 Se receita > 0, um registro contendo os campos skad_revenue e event_name.
Conversão 

0 a 6

 Um registro para cada evento de conversão exclusivo realizado. O campo event_name é preenchido de forma correspondente. Se nenhum evento for executado, não há registro.
Engajamento

0 a 63

 O número de registros representa o número de vezes que o usuário realizou o evento de engajamento. Se o usuário não se engajar, não haverá registros de engajamento.
Personalizada 0-unlimited De acordo com seu esquema de conversão personalizado. 
Evento decodificado Dimensões de anúncios em SRN 
  • O relatório contém eventos do Meta ads com granularidade de campanha, conjunto de anúncios e anúncios. Cada linha no relatório pode ser um evento de instalação ou in-app.
  • O conjunto de anúncios e a granularidade do anúncio não estão incluídos nos postbacks da SKAN do Meta ads. Esses dados são exclusivos para esse relatório e não são exibidos no dashboard da SKAN, na Performance API e em outros relatórios da SKAN no Data Locker.
  • O relatório não tem esquema. As opções de seleção de campo do Data Locker não se aplicam.
  • Melhor prática: não combine ou compare dados deste relatório com outros relatórios SKAN, pois pode haver discrepâncias entre este relatório, que usa dados decodificados pelo SRN, e outros relatórios, que usam dados decodificados pela AppsFlyer. Essas discrepâncias podem ocorrer devido a diferenças de fuso horário, diferenças de esquema SRN ou eventos in-app mapeados incorretamente para CV na integração SRN.
  • Faça download de um exemplo de dimensões de publicidade SRN (CSV).

Nome do tópico no Data Locker: skad_srn_advertising_dimensions

Tipos de formato do campo de dados brutos

Formatos de campo

Nome do formato Descrição
Cadeia de caracteres [n]

O comprimento máximo da string. Normalmente, não impomos limitações de comprimento de campo no recebimento dos dados, mas os dados podem ser truncados depois disso.
String de tempo

String com o formato aaaa-mm-dd hh:mm:ss. Por exemplo, 2019-09-17 00:09:25 
Enumeração [n] Os campos de enumeração podem conter apenas valores específicos. Por exemplo, a moeda de custo tem 3 caracteres e pode conter apenas códigos de moeda conforme especificado.
Carimbo de data/hora

Carimbo de data/hora UNIX de 10 dígitos. Exemplo:

4 de agosto de 2020, 07:25 UTC se traduz em "timestamp": "1596525944"
Booleano

O valor do campo pode ser TRUE ou FALSE
Inteiro

Inteiro
Float

Número flutuante real que pode ter uma vírgula decimal e valores após a vírgula.

Campos disponíveis em relatórios de postback e cópia de postback

Nome do campo Origem ou versão inicial do iOS SKAN Descrição Formato Disponível em cópia de postbacks 

ad_network_campaign_id

 Ad network ID da campanha reportada pela ad network à AppsFlyer String Não

ad_network_campaign

_name

 Ad network

Nome da campanha informado pela ad network à AppsFlyer.

 

 String Não

ad_network_timestamp

 Ad network

Hora em que a ad network recebeu o postback.

No caso do Google Ads, o tempo é derivado do tempo do último clique informado pelo Google.

 Carimbo de data/hora Não

app_id

 AppsFlyer ID do aplicativo (aplicativo do anunciante) com ID do prefixo. String Sim

cidade

 AppsFlyer A partir de 30 de agosto de 2021, sempre null  String Não

country_code

 Ad network   String Não
dma   A partir de 30 de agosto de 2021, sempre null  String Não

postal_code

   A partir de 30 de agosto de 2021, sempre nulo   String Não

Região

 AppsFlyer De acordo com o country_code informado String Não

skad_ad_network_id

 1.0 

Alguns SRNs não compartilham seu ID e o campo é deixado em branco. Por exemplo, Twitter. 

 String

Sim 

skad_attribution_signature

 1.0   String Sim
skad_campaign_id 1.0 ID da campanha usado para publicar o anúncio. Faixa 0 a 100 String Sim
skad_conversion_value 2.0 

Valor de conversão informado pelo iOS. Faixa 0 a 63.

Se nulo, o iOS não preencheu o campo** 

 Inteiro Sim
skad_redownload 2,0 Se verdadeiro, o aplicativo foi baixado novamente

Booleano

Sim
skad_source_app_id 2,0

ID do site. O aplicativo que publica o anúncio. Este campo é idêntico ao source_app_id.

O preenchimento do campo depende dos limites de privacidade**

 String Sim
skad_transaction_id 1.0   String Sim
skad_version 2,0   String Sim
timestamp Ad network

Horário em que a AppsFlyer recebeu o postback do SKAN. 

 String de tempo Sim
ad_network_name Ad network

Nome da ad network informado pela ad network à AppsFlyer. 

  • Se este campo estiver em branco, a ad network não o preencheu (não poderia) preenchê-lo.
  • Você pode resolver o nome da ad network usando skad_ad_network_id. Use esta tabela para fazer isso. 
 String Não
ip  

Endereço IP na mensagem HTTP do dispositivo iOS que envia o postback.

Este campo é preenchido se a ad network nos fornecer o endereço.

Atenção! O SDK não está envolvido na obtenção do endereço.

 String Não

skad_app_id

 1.0   String Não

source_app_id

 AppsFlyer ID do site. O aplicativo que publica o anúncio. Este campo é idêntico ao skad_source_app_id String Não

ad_network_adset_id

 Ad network   String Não

ad_network_adset_name

 Ad network   String Não

ad_network_ad_name

 Ad network   String Não

ad_network_ad_id

 Ad network   String Não

did_win

 3.0 (iOS 14.6)

Usado para distinguir entre campanhas que contribuem ou são atribuídas à instalação. 

  • Se verdadeiro, a campanha é atribuída por trazer a instalação.
  • Se falso, a campanha é reconhecida como se contribuísse para a instalação, mas não é incluída em nenhum dashboard ou relatório da SKAN.
  • Se nulo, o iOS não preencheu o campo devido a uma versão herdada do iOS ou do SKAdNetwork.
 Booleano Sim

fidelity_type

 2.2 (iOS 14.5)

Diferencie as opções de apresentação de anúncios que afetam a atribuição. Indicado usando os valores 0 e 1 da seguinte forma: 

  • Anúncios de exibição (0)
  • Anúncios renderizados pelo StoreKit (1)

Desconsidere o valor do campo se a versão do SKAN for anterior a 2.2

 Inteiro Sim

ad_network_source_app_id

 Ad network ID do aplicativo do publisher relatado pela ad network. Use para ajudar a reconciliar custos; informado pela ad network. O aplicativo do publisher fornece a base para esses dados.  String Não

ad_network_channel

 Ad network   String Não

af_prt

 Ad network   String Não

skad_postback_sequence_index

 4.0 (iOS 16.2)
  • O valor representa a janela SKAN, seja 0,1ou2.
  • Para SKAN 3 o valor é0
 Inteiro Sim
skad_coarse_conversion_value

4.0 (iOS 16.2)

 
  • O valor pode ser baixo (low), médio (medium)ou alto (high).
  • Para SKAN 3 o valor é nulo (null).
 String Sim
skad_source_identifier 4.0 (iOS 16.2)
  • O valor pode ter até 4 dígitos.
  • Para SKAN 3 o valor é nulo (null). 
 String Sim
skad_source_domain 4.0 (iOS 16.2)
  • O valor representa a origem dos anúncios da Web atribuíveis.
  • Para SKAN 3 o valor é nulo (null).
 String Sim
ad_network_creative Ad network
  • O valor é baseado no enriquecimento de dados recebido da ad network.
  • Para SKAN 3 o valor é nulo (null).
 String Não

** A Apple determina se o campo é preenchido usando um mecanismo de limite de privacidade 

 

Campos disponíveis em relatórios de eventos decodificados

Nome do campo Fonte Descrição Formato Incluído no relatório de dimensões de publicidade SRN
ad_network_campaign_id Ad network ID da campanha reportada pela ad network à AppsFlyer String Sim
ad_network_campaign
_name		 Ad network Nome da campanha reportado pela ad network à AppsFlyer String Sim
ad_network_timestamp Ad network

Hora em que o postback foi recebido pela ad network

No caso do Google Ads, esse campo não é preenchido. 

Carimbo de data/hora

(string de tempo para relatório de dimensões de publicidade SRN)

 Sim
app_id iOS O ID do aplicativo (aplicativo do anunciante) String Sim
cidade   A partir de 30 de agosto de 2021, sempre null  String Não
country_code Ad network   String Não
dma   A partir de 30 de agosto de 2021, sempre null  String Não
event_name AppsFlyer

Nome do evento in-app conforme configurado na AppsFlyer.

Para o SRN ___report, esse é o nome do evento in-app conforme configurado no Meta ads.

 String Sim
event_uuid AppsFlyer Um identificador aleatório exclusivo que permite aos parceiros identificar postbacks duplicados String Não
install_date iOS Estimado pela AppsFlyer com base na hora de chegada do postback. String de tempo Não
install_type iOS Novas instalações String Não
ip iOS

O endereço IP na mensagem HTTP do dispositivo iOS que está enviando o postback.

Este campo é preenchido se a ad network nos fornecer o endereço.

Atenção! O SDK não está envolvido na obtenção do endereço. 

 String Não
media_source iOS Ad network atribuída usando nomes de rede da AppsFlyer String Sim
postal_code   A partir de 30 de agosto de 2021, sempre null  String Não
Região AppsFlyer Determinado de acordo com o country_code String Não
skad_ad_network_id iOS ID da ad network para quem o postback foi enviado String Não
skad_ambiguous_event AppsFlyer Se verdadeiro (true), o postback do iOS foi recebido durante as primeiras 72 horas depois que um anunciante alterou as configurações de SKAN no painel. Devido aos vários cronômetros empregados pelo SKAN, a AppsFlyer não pode mapear o evento com precisão. Booleano Não
skad_attribution_signature iOS   String Não
skad_campaign_id iOS ID da campanha usado para publicar o anúncio. Faixa 0 a 100 Inteiro Não
skad_conversion_value iOS

Valor de conversão informado pelo iOS. Faixa 0 a 63.

Se nulo, o iOS não preencheu o campo**

 Inteiro Não
skad_mode AppsFlyer

O modo de métrica de conversão usado para decodificar o postback do iOS. Opções:

  • custom_decode
  • receita
  • eventos
  • skan4
  • custom_encode
  • Engajamento
 String Não
skad_redownload iOS Se verdadeiro, o aplicativo foi baixado novamente Booleano Não
skad_revenue iOS Valor da receita do evento em USD. Float Não
skad_source_app_id iOS

ID do site - o aplicativo que publica o anúncio.

O preenchimento do campo depende dos limites de privacidade**

 String Não
skad_transaction_id iOS - String Não
skad_version iOS - String Não
timestamp iOS

Horário em que a AppsFlyer recebeu o postback do SKAN.

Para Google Ads e Meta ads, este é o momento em que a AppsFlyer obtém os dados da API do Google e do Meta ads, respectivamente.

Carimbo de data/hora

(string de tempo para relatório de dimensões de publicidade SRN)

 Sim
event_value S2S

Valor padrão: null

Contém uma sequência definida por aplicativos que implementam decodificação personalizada.

Os anunciantes consomem isso em seus sistemas. A AppsFlyer não faz uso dele. 

 String (JSON) Não

ad_network_adset_id

 Ad network   String Sim

ad_network_adset_name

 Ad network   String Sim

ad_network_ad_name

 Ad network   String Sim

ad_network_ad_id

 Ad network

 

 String Sim

skad_did_win (1)

 3.0 (iOS 14.6)

Usado para distinguir entre campanhas que contribuem ou são atribuídas à instalação. 

  • Se verdadeiro, a campanha é atribuída por trazer a instalação.
  • Se falso, a campanha é reconhecida como se contribuísse para a instalação, mas não é incluída em nenhum painel ou relatório SKAN.
  • Se nulo, o iOS não preencheu o campo devido a uma versão herdada do iOS ou do SKAdNetwork.
 Booleano Não

skad_fidelity_type (1)

 2.2 (iOS 14.5)

Diferencie as opções de apresentação de anúncios que afetam a atribuição. Indicado usando os valores 0 e 1 da seguinte forma: 

  • Anúncios de exibição (0)
  • Anúncios renderizados pelo StoreKit (1)

Desconsidere o valor do campo se a versão do SKAN for anterior a 2.2

 Inteiro Sim

ad_network_source_app_id (1)

 Ad network ID do aplicativo do publisher relatado pela ad network. Use para ajudar a reconciliar custos; informado pela ad network. A base para esses dados é fornecida pelo aplicativo do editor. String Não

ad_network_channel (1)

 Ad network   String Não

af_prt (1)

 Ad network   String Não

min_revenue 

 AppsFlyer Ver nota (4) Número real Não

max_revenue 

 AppsFlyer Ver nota (4) Número real Não

event_revenue

 AppsFlyer

Fórmula: [soma dos valores para o evento específico em USD]/[O número de eventos que aconteceram em um dia específico]

 Float Sim

min_event_counter

 AppsFlyer Use para calcular o número de vezes que um usuário realiza um evento. Ver nota (3) Inteiro Não

max_event_counter

 AppsFlyer Ver nota (3) Inteiro Não

min_time_post_install

 AppsFlyer Ver nota (5) Inteiro Não

max_time_post_install

 AppsFlyer Ver nota (5) Inteiro Não

af_attribution_flag

 AppsFlyer

Quando o mecanismo de Single Source of Truth (SSOT) está ativado: se verdadeiro (true), a instalação foi atribuída pela AppsFlyer e SKAN. Se falso (false), a instalação não foi atribuída pela AppsFlyer. Se skad_conversion_value for nulo, o sinalizador será true ou false (com base na modelagem).

 Booleano Não

measurement_window

 AppsFlyer Duração da janela de atividade. Padrão 24h.  Inteiro Não

Intervalo

 AppsFlyer Intervalos da janela de atividade.  Inteiro Não

user_agent

 AppsFlyer Agente de usuário do dispositivo String Não

skad_postback_sequence_index

 4.0 (iOS 16.2)
  • O valor representa a janela SKAN, seja 0,1ou2.
  • Para SKAN 3 o valor é0
 Inteiro Sim
skad_coarse_conversion_value

 

4.0 (iOS 16.2)
  • O valor pode ser baixo (low), médio (medium)ou alto (high).
  • Para SKAN 3 o valor é nulo (null).
 String Sim
skad_source_identifier 4.0 (iOS 16.2)
  • O valor pode ter até 4 dígitos.
  • Para SKAN 3 o valor é nulo (null). 
 String Sim
skad_source_domain 4.0 (iOS 16.2)
  • O valor representa a origem dos anúncios da Web atribuíveis.
  • Para SKAN 3 o valor é nulo (null).
 String Sim
ad_network_creative Ad network
  • O valor é baseado no enriquecimento de dados recebido da ad network.
  • Para SKAN 3 o valor é nulo (null).
 String Não

** A Apple determina se o campo é preenchido usando um mecanismo de limite de privacidade

(1) A partir de 2 de junho de 2021, o campo será adicionado aos relatórios, mas não será necessariamente preenchido.

(3) Para determinar o número de vezes que um usuário executa um determinado evento in-app, use a fórmula: [round up (min_event_counter + max_event_counter) / 2]. Observação!  Você deve arredondar o inteiro mais próximo.
Exemplo:
A. Se min = 0 e max = 1, a média é 0,5; o arredondamento retorna um resultado de 1.
B. Se min = 5 e max = 10, a média é 7,5; o arredondamento retorna um resultado de 8.

(4) A receita é sempre fornecida no campo skad_revenue. Se você usar o SKAN 4 ou o modo Personalizado, o intervalo de bucket associado ao evento e usado para calcular skad_revenue é descrito por min_revenue e max_revenue.

(5)

  • Na conversão personalizada: a AppsFlyer calcula o tempo de instalação como o tempo de chegada do postback - 36h - média (min_time_post_install + max_time_post_install). No entanto, se CV=0, a média (min_time_post_install + max_time_post_install) é considerada 0. 
  • Na conversão Decode: o min_time_post_install é uma hora a menos do que o definido em max_time_post_install, que é igual a hours_from_install definido por você em seu mapeamento de conversão Decode. 

 

Informações adicionais

Características e limitações

Característica Observações 
Acesso da ad network As a networks são oferecidas com postbacks
Acesso das agências Não disponível
Transparência da agência N/D
Fuso horário UTC
Moeda  USD
Dados orgânicos Com base nos dados de eventos do SDK. Por exemplo, as métricas de instalação orgânica são calculadas da seguinte forma: dados de todas as instalações relatadas pelo SDK menos as instalações não orgânicas relatadas pelo SKAN.
Dados não orgânicos Com base em postbacks SKAN
Atualização de dados

Diariamente. O tempo SKAN significa que o iOS informa sobre uma instalação 24 a 48 horas após o fechamento da janela.
Dados históricos

Limitado à janela de disponibilidade do Data Locker. 
Acesso do usuário da conta Disponível. De acordo com as permissões da conta

 Veja também