Relatórios de dados brutos da SKAN

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

Resumo: os relatórios de dados brutos da SKAN contêm dados em nível de linha gerados após a tradução e decodificação de postbacks recebidos pela AppsFlyer do iOS, assim como postbacks brutos da SKAN. Os dados estão disponíveis através do Data Locker e da 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 da SKAN

Princípios: 

  • Os dados são fornecidos via:
    • 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 ativar os relatórios da SKAN. Para isso, acesse relatórios > Data Locker. Selecione os relatórios da SKAN.  
      • Atualização dos dados: Diariamente. Os dados estão contidos na pasta h=23 da data em que o postback é recebido pela AppsFlyer.  
    • 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 é: Data de instalação = hora de chegada do postback - [duração acumulada da janela] - [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 é: Data de instalação = hora 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 faz uma estimativa da hora de instalação por conta própria e essa informação é usada pela AppsFlyer. Atenção: pode levar até 45 dias para o Google relatar as instalações. Saiba mais

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

  • Postbacks de dispositivos: 1 postback de dispositivo por instalação ou novo download recebido do dispositivo iOS.
  • Dados brutos da 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 null: nenhum registro no aplicativo é gerado. 
      • Faixa de CV:
        • 1-63: para valores ge granularidade total (fine-grained) da janela 1 da SKAN 3 e SKAN 4, esse é o número de registros no aplicativo, dependendo das suas configurações de mensuração.
        • Baixo, médio ou alto: para valores parciais (coarse-grained) da SKAN 4, esse é o número de registros no aplicativo, dependendo das suas configurações de mensuração.

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

  • Campos de enriquecimento não obrigatórios, como campaign_name, ad_network_campaign_id, 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 da 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, depois de ser enriquecido pela ad network, é enviado para a AppsFlyer. Baixe nosso exemplo de postbacks (CSV).

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

Nome do tópico no Data Locker: skad_postbacks
Postback Postbacks copy (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. Baixe nosso exemplo de cópia de postbacks (CSV).

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

Nome do tópico no Data Locker: skad_postbacks_copy
Evento decodificado Installs

Primeiras instalações do aplicativo

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

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

Reinstalações do aplicativo

SKAN relatou redownload=true. Ou seja, não é a primeira vez que o usuário, representado pelo ID da Apple, faz download do app. Esse relatório tem a mesma estrutura do relatório de installs.

Nome do tópico no Data Locker: skad_redownloads
Evento decodificado In-app events

In-app events

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 das suas configurações de mensuração.  

Baixe nosso 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 realizou um determinado evento in-app, use a fórmula[round up (min_event_counter + max_event_counter) / 2]

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

Tipo de mensuração Número de registros Descrição
Receita 0-1 Se receita > 0, um registro contendo os campos skad_revenue e event_name.
Conversão  0-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-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.
Personalizado 0-ilimitado De acordo com seu esquema de conversão personalizado.  
Evento decodificado Dimensões de publicidade da SRN 
  • O relatório contém eventos do Meta ads com a granularidade da campanha, adset e anúncios. Cada linha no relatório pode ser um evento de instalação ou evento in-app.
  • A granularidade do adset e dos anúncios não está incluída 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.
  • Prática recomendada: Não combine ou compare os dados desse relatório com outros relatórios da SKAN, pois pode haver discrepâncias entre esse relatório, que usa dados decodificados pela 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 no esquema da SRN ou eventos in-app mapeados incorretamente para CVs na integração da SRN.
  • Baixe nosso um exemplo de dimensões de publicidade da 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
String [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 yyyy-mm-dd hh:mm:ss. Por exemplo, 2019-09-17 00:09:25 
Enumeração [n] Os campos de enumeração só podem conter valores específicos. Por exemplo, a moeda de custo tem 3 caracteres e pode conter apenas códigos de moeda conforme especificado.
Timestamp

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
Número flutuante 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 Fonte de origem ou versão inicial da SKAN Descrição Formato Disponível em cópia de postbacks  
ad_network_campaign_id Ad network ID da campanha reportado 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 da hora do último clique informado pelo Google.

 Timestamp Não
app_id AppsFlyer App ID (aplicativo do anunciante) com prefix ID. String Sim
city 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 null    String Não
region AppsFlyer De acordo com o country_code informado String Não
skad_ad_network_id 1.0  Algumas SRNs não compartilham seu ID e o campo é deixado em branco. Por exemplo, X Ads.  String Sim 
skad_attribution_signature 1.0   String Sim
skad_campaign_id 1.0 ID da campanha utilizada para publicar o anúncio. Intervalo 0-100 String Sim
skad_conversion_value 2.0 

Valor de conversão reportado pelo iOS. Intervalo 0-63.

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

 Inteiro Sim
skad_redownload 2.0 Se true, o aplicativo foi baixado novamente Booleano Sim
skad_source_app_id 2.0

Site ID. O aplicativo que publica o anúncio. Esse 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 da SKAN.   Timestring Sim
ad_network_name Ad network Nome da ad network informado pela ad network à AppsFlyer. 
  • Se esse campo estiver vazio, significa que a ad network não o preencheu (ou não pôde preencher).
  • Pode determinar o nome da ad network utilizando o skad_ad_network_id. Use essa tabela para isso. 
 String Não
ip  

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

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

Atenção! O SDK não obtém essa informação.

 String Não
skad_app_id 1.0   String Não
source_app_id AppsFlyer Site ID. O aplicativo que publica o anúncio. Esse campo é igual 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 true, a campanha é atribuída como responsável pela instalação.
  • Se o valor for false, a campanha é reconhecida como contribuindo para a instalação, mas não é incluída em dashboards ou relatórios SKAN.
  • Se null, o iOS não preencheu o campo devido a uma versão legada do iOS ou da SKAdNetwork.
 Booleano Sim
fidelity_type 2.2 (iOS 14.5)

Diferencia as opções de exibição de anúncios que afetam a atribuição. Indicado pelos valores 0 e 1 da seguinte forma: 

  • Anúncios visualizados (0)
  • Anúncios renderizados pelo StoreKit (1)

Ignore o valor do campo se a versão da SKAN for anterior à 2.2

 Inteiro Sim
ad_network_source_app_id Ad network Publisher app ID informado pela ad network. Use-o para ajudar a reconciliar custos, reportado 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: 0, 1 ou2.
  • Para SKAN 3, o valor é 0
Inteiro Sim
skad_coarse_conversion_value

4.0 (iOS 16.2)

 
  • O valor pode ser low,medium ouhigh.
  • Para SKAN 3, o valor é null.
 String Sim
skad_source_identifier 4.0 (iOS 16.2)
  • O valor pode ter até 4 dígitos.
  • Para SKAN 3, o valor é null. 
 String Sim
skad_source_domain 4.0 (iOS 16.2)
  • O valor representa a origem dos anúncios web atribuídos.
  • Para SKAN 3, o valor é null.
 String Sim
ad_network_creative Ad network
  • O valor é baseado no enriquecimento de dados recebido da ad network.
  • Para SKAN 3, o valor é 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 reportado pela rede de anúncios à 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. 

Timestamp

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

 Sim
app_id iOS O app ID (aplicativo do anunciante) String Sim
city   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 a SRN ___report, esse é o nome do evento in-app conforme configurado no Meta ads.

 String Sim
evento_uuid AppsFlyer Um identificador aleatório e único que permite aos parceiros identificar postbacks duplicados. String Não
install_date iOS Estimado pela AppsFlyer com base na hora de chegada do postback. Time string 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.

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

Atenção! O SDK não obtém essa informaçã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
region AppsFlyer Determinado de acordo com o country_code String Não
skad_ad_network_id iOS ID da rede de anúncios para a qual o postback foi enviado String Não
skad_ambiguous_event (obsoleto com SKAN 4+) 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 dashboard. Devido aos diversos timers usados pela SKAN, a AppsFlyer não consegue mapear o evento com precisão.
  • Indisponível na SKAN 4 e versões mais recentes
 Booleano Não
skad_attribution_signature iOS   String Não
skad_campaign_id iOS ID da campanha utilizada para publicar o anúncio. Intervalo 0-100 Inteiro Não
skad_conversion_value iOS

Valor de conversão reportado pelo iOS. Intervalo 0-63.

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

 Inteiro Não
skad_mode AppsFlyer O modo de mensuração de conversão usado para decodificar o postback do iOS. Opções:
  • custom_decode
  • revenue
  • events
  • skan4
  • custom_encode
  • engagement
 String Não
skad_redownload iOS Se verdadeiro, a aplicação foi descarregada novamente Booleano Não
skad_receita iOS Montante da receita do evento em USD. Número flutuante Não
skad_source_app_id iOS

Site ID - 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 da 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.

Timestamp

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

 Sim
event_value S2S

Valor padrão: null

Contém uma string definida por apps que implementam descodificação personalizada.

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

 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 true, a campanha é atribuída como responsável pela instalação.
  • Se o valor for false, a campanha é reconhecida como contribuindo para a instalação, mas não é incluída em dashboards ou relatórios SKAN.
  • Se null, o iOS não preencheu o campo devido a uma versão legada do iOS ou da SKAdNetwork.
 Booleano Não
skad_fidelity_type (1) 2.2 (iOS 14.5)

Diferencia as opções de exibição de anúncios que afetam a atribuição. Indicado pelos valores 0 e 1 da seguinte forma: 

  • Anúncios visualizados (0)
  • Anúncios renderizados pelo StoreKit (1)

Ignore o valor do campo se a versão da SKAN for anterior à 2.2

 Inteiro Sim
ad_network_source_app_id (1) Ad network Publisher app ID informado pela ad network. Use-o para ajudar a reconciliar custos, reportado pela ad network. A base desses dados é fornecida pela app do publisher. 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]/[Número de eventos que ocorreram em um dia específico] Número flutuante 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 do Single Source of Truth (SSOT) está ativo: Se true, a instalação foi atribuída tanto pela AppsFlyer quanto pela SKAN. Se false, a instalação não foi atribuída pela AppsFlyer. Se o valor de skad_conversion for nulo, a flag será true ou false (com base na modelagem). Booleano Não
measurement_window AppsFlyer Duração da janela de atividade. Padrão 24 horas.  Inteiro Não
interval AppsFlyer Intervalos da janela de atividades.  Inteiro Não
user_agent AppsFlyer User agent do dispositivo String Não
skad_postback_sequence_index 4.0 (iOS 16.2)
  • O valor representa a janela SKAN: 0, 1 ou2.
  • Para SKAN 3, o valor é 0
Inteiro Sim
skad_coarse_conversion_value

 

4.0 (iOS 16.2)
  • O valor pode ser low,medium ouhigh.
  • Para SKAN 3, o valor é null.
 String Sim
skad_source_identifier 4.0 (iOS 16.2)
  • O valor pode ter até 4 dígitos.
  • Para SKAN 3, o valor é null. 
 String Sim
skad_source_domain 4.0 (iOS 16.2)
  • O valor representa a origem dos anúncios web atribuídos.
  • Para SKAN 3, o valor é null.
 String Sim
ad_network_creative Ad network
  • O valor é baseado no enriquecimento de dados recebido da ad network.
  • Para SKAN 3, o valor é 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 realizou um determinado evento in-app, use a fórmula[round up (min_event_counter + max_event_counter) / 2] Atenção! Você deve arredondar para o número inteiro mais próximo.
Exemplo:
A. Se min = 0 e max = 1, a média é 0,5; arredondando, obtém-se 1.
B. Se min = 5 e max = 10, a média é 7,5; arredondando, obtém-se 8.

(4) A receita é sempre apresentada no campo skad_revenue. Se você usar a SKAN 4 ou o modo personalizado, o intervalo associado ao evento 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 menos 36 horas, menos a 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 de decodificação: O min_time_post_install é uma hora a menos do que o definido em max_time_post_install, igualando hours_from_install definido por si no mapeamento de conversão Decode. 
  

Informações adicionais

Características e limitações

Caraterística Observações 
Acesso à ad network As ad networks recebem postbacks
Acesso de agência Indisponível
Transparência das agências N/D
Fuso horário UTC
Moeda  USD
Dados orgânicos Baseado em dados de eventos do SDK. Por exemplo, as métricas de instalação orgânica são calculadas assim: Dados de todas as instalações reportadas pelo SDK menos as instalações não orgânicas reportadas pela SKAN.
Dados não orgânicos Com base em postbacks da SKAN
Atualização dos dados Diária. O tempo da SKAN significa que o iOS informa sobre uma instalação de 24 a 48 horas após o fechamento da janela.
Histórico de dados Limitado à janela de disponibilidade do Data Locker.  
Acesso do usuário à conta Disponível. De acordo com as permissões da conta

 Veja também