Dicionário de campos de dados brutos

Visão geral: O dicionário de campos de dados (especificação de dados brutos) descreve o conteúdo dos campos. Deve ser utilizado para o ajudar a compreender o significado dos campos, como estão formatados e quando estão disponíveis.

Dicionário de campos de dados brutos

A tabela a seguir é um dicionário que lista os campos de dados brutos disponíveis em vários relatórios da AppsFlyer. A tabela é atualizada regularmente à medida que novos campos de dados brutos são adicionados à AppsFlyer.

As colunas na tabela do dicionário incluem: 

  • Grupo do campo: Agrupamento lógico baseado no uso do campo. Nota! Os campos do grupo de receitas de anúncios aparecem nos relatórios de dados brutos ou como suas próprias colunas ou são preenchidos como parte do Valor do evento.  
  • Nome do Campo:
    • Nome do campo usado nos relatórios fornecidos através da página Exportar e da API Pull.
    • A notação [n] indica múltiplas instâncias do mesmo campo, diferenciadas pelo número da instância. Por exemplo, Subparâmetro [n] quer dizer Subparâmetro 1, Subparâmetro 2, ..., Subparâmetro 5. O intervalo de valores de n é indicado como (n=1-5). 
  • Nome da API:
    • Nome do campo conforme apresentado nos relatórios do Data Locker e da API Push.
    • A notação [n] indica múltiplas instâncias do mesmo campo, diferenciadas pelo número da instância. Por exemplo, Subparâmetro [n] quer dizer Subparâmetro 1, Subparâmetro 2, ..., Subparâmetro 5. O intervalo de valores de n é indicado como (n=1-5). 
  • Fonte: O local de origem original do conteúdo do campo, por exemplo:
  • Descrição
    • Alguns campos têm significados diferentes, dependendo do contexto do evento, como por exemplo, em resultado de uma campanha de UA ou de retargeting.
  • Formato: Tipo e comprimento do campo.
    • String: O comprimento máximo da string. Não recomendamos exceder 1024 caracteres de comprimento ou as limitações de comprimento de campo encontradas aqui.
    • Data e hora:
      • String com o formato yyyy-mm-dd hh:mm:ss. Por exemplo, 2019-09-17 00:09:25 o fuso horário utilizado para apresentar os dados depende da ferramenta de entrega de dados da seguinte forma:
        • Página de exportação de dados: fuso horário selecionado pela aplicação.
        • Push API: os campos de horário têm uma opção selected_time_zone que significa fuso horário específico do aplicativo, salvo UTC.
        • Master API: o padrão é o fuso horário selecionável pelo aplicativo.
        • Data Locker: UTC
      • Os campos de data nos arquivos CSV seguem o formato aaaa-mm-dd. Ao abrir um arquivo CSV no Excel, os campos de data são formatados de acordo com as configurações de data e hora do computador. Pode alterar o formato de visualização no Excel. Para ver o valor não formatado, abra o arquivo usando um editor.
      • Push API:
        • Para campos time_stamp em UTC: formato yyyy-mm-dd hh:mm:ss.sss. Por exemplo, 2019-09-17 00:09:25.123 
        • Para campos de time_stamp no fuso horário selecionado: formato yyyy-mm-dd hh:mm:ss.sss±th:tm. Por exemplo, 2019-01-20 04:51:16.000+0000
    • Enum n char: Os campos de enumeração só podem conter valores específicos. Por exemplo, o código de moeda tem 3 caracteres e só pode conter códigos de moeda conforme especificado.
    • Enum 5 char booleano: FALSEO valor do campo pode ser FALSE ou FALSE.

Dica

  • Para ordenar a tabela, clique no nome da coluna.
  • Também pode descarregar a tabela.
  • O CSV descarregado inclui campos adicionais aos mencionados acima:
    • Parte do esquema principal do relatório da AppsFlyer:
      • A maioria dos relatórios da AppsFlyer são baseados no mesmo esquema e contêm os mesmos campos.
      • Alguns campos podem aparecer com valores nulos ou vazios, dependendo do relatório e se os dados são recolhidos de redes de anúncios, anunciantes, plataformas de dispositivos, etc. 
      • Ao configurar os seus sistemas de BI, é aconselhável configurar todos os campos principais do esquema da AppsFlyer, mesmo que um determinado relatório os apresente sempre como nulos ou vazios. Isto permite-lhe integrar os dados facilmente quando e se estiverem disponíveis. 
      • Se um campo não fizer parte do esquema de relatórios principal da AppsFlyer, ele só estará disponível em alguns relatórios específicos. Por exemplo, nos relatórios SKAN.
    • Método de entrega dos relatórios: O arquivo CSV que você baixou indica se um campo está disponível através da Push API, Exportar dados/Pull API e Data Locker. Atenção: Mesmo que um campo faça parte do esquema de relatórios principal da AppsFlyer, ele pode não estar incluído nos relatórios fornecidos por um método específico. Por exemplo, o campo de posicionamento está no esquema principal da AppsFlyer, mas só aparece nos relatórios entregues através do Data Locker, Pull API ou na página de Exportar dados; não via Push API.
Grupo do campo Nome do campo Nome da API Fonte Descrição Formato
Atribuição Ad af_ad Link Nome do anúncio String
SKAN Ad ID ad_network
_ad_id
Ad network Ad ID String
Atribuição Ad ID af_ad_id Link Ad ID String/Int
SKAN Ad name ad_network
_ad_name
Ad network Nome do anúncio String
SKAN Ad network ID skad_ad
_network_id
iOS ID da ad network para a qual o postback foi enviado String
SKAN Ad network name ad_network
_name
Ad network
  • Nome da ad network informado pela ad network à AppsFlyer.
  • Se esse campo estiver em branco, a ad network não conseguiu preenchê-lo.
  • Você pode determinar o nome da ad network usando skad_ad_network_id. Para isso, use essa tabela.
String
SKAN Ad network source app ID 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
SKAN Ad network timestamp ad_network
_timestamp
Ad network
  • Hora em que o postback foi recebido pela rede de anúncios.
  • No caso do Google Ads, este campo não é preenchido.
Timestamp
Informações do dispositivo ad_personalization_enabled ad_personalization_enabled SDK Indica se o usuário permite que o Google use seus dados a nível de usuário para anúncios pessoais (true) ou não (false) Booleano
Atribuição Ad placement ad_placement Link Preenchido para o posicionamento de anúncios CTV String
Receita de anúncios Ad revenue ad type ad_revenue_ad_type Ad revenue SDK O tipo de anúncio que foi exibido String
Receita de anúncios Ad revenue custom parameters ad_revenue_custom_parameters Ad revenue SDK Os parâmetros personalizados fornecidos pelo anunciante através do SDK de receitas de anúncios para os anúncios exibidos no aplicativo. String
Atribuição Ad type af_ad_type Link Exemplo: banner, footer String
Receita de anúncios Ad unit ad_unit Ad revenue API Nome do segmento de receita de anúncios quando é realizado um teste A/B String
Informações do dispositivo Ad user data enabled ad_user_data_enabled SDK Indica se o usuário permite que o Google use seus dados a nível de usuário para mensuração e anúncios personalizados (true) ou não (false). Booleano
Atribuição Adset af_adset Link Nome do conjunto de anúncios, identifica um grupo que contém um ou mais anúncios String
SKAN Adset ID ad_network
_adset_id
Ad network Adset ID String
Atribuição Adset ID af_adset_id Link ID do conjunto de anúncios, identifica um grupo que contém um ou mais anúncios String
SKAN Adset name ad_network
_adset_name
Ad network Nome do conjunto de anúncios String
Informações do dispositivo Advertising ID for Android devices advertising_id SDK
  • device ID que pode ser resetado pelo usuário, conhecido também como GAID.
  • Para CTV, esse é o ID de CTV, por exemplo, RIDA ou VIDA.
String
SKAN AF attribution flag af_attribution
_flag
AF Quando o mecanismo 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, o sinal será true ou false (com base na modelagem). Booleano
Informações do dispositivo Amazon Fire ID amazon_aid SDK ID de publicidade que pode ser redefinido pelo usuário em dispositivos Amazon. String
SKAN Ambiguous event skad_ambiguous
_event
AF Se "true", o postback do iOS foi recebido nas primeiras 72 horas depois que um anunciante alterou as configurações da SKAN no dashboard.
Devido aos diversos timers usados pela SKAN, a AppsFlyer não consegue mapear o evento com precisão.
Booleano
Informações do dispositivo Android ID android_id SDK ID permanente do dispositivo String
Atribuição App group ID app_group_id AF Aplicativos associados que pertencem a um template do OneLink relacionado para atribuição entre plataformas String
App App ID app_id SDK Identificador único do aplicativo na Appsflyer. Exemplo:
 
  • iOS: id123456789
  • Android: com.appsflyer.referrersender
String
SKAN App ID skad_app_id iOS App ID String
App Nome do aplicativo app_name SDK Definido pelo anunciante String
Atribuição App store ID app_store_id AF ID do aplicativo como aparece na loja de aplicativos String
App App type app_type App clip Valores: app_clip, full_app String
App App version app_version SDK Definido pelo anunciante caracteres
Informações do dispositivo AppsFlyer ID appsflyer_id SDK
  • Um ID exclusivo gerado pelo SDK quando o aplicativo é instalado em um dispositivo. O ID é usado para atribuir eventos in-app em fluxos LTV, buscar dados de conversão e eventos in-app afiliados.
  • Um novo ID é gerado se o aplicativo for excluído e instalado novamente. A restauração do aplicativo a partir de um backup do iCloud não é considerada uma instalação.
  • Para CTV, esse campo é preenchido com custom_device_id (o ID do dispositivo gerenciado pelo anunciante).
String
Informações do dispositivo ATT att SDK
  • A ATT, também conhecida como att_status, está disponível no iOS 14+ e é preenchido com um dos seguintes valores: Retornado por ATTrackingManager, enviado por S2S, determinado pela AppsFlyer.
  • Os valores ATT são: not_determined, restricted, denied, authorized, af_unknown, af_authorized, af_unavailable.
String
Atribuição Attributed touch time attributed_touch _time AF
  • UA: tempo do toque atribuído por nós.
  • Retargeting: hora do engajamento ao qual atribuímos.
Data e Hora
Atribuição Attributed touch type attributed_touch_type AF Classifica o tipo de engajamento. Definido pela AppsFlyer após o engajamento ser associado a uma instalação.
  • UA: Valores possíveis: click, download, impression, pre-install
  • Retargeting: click, impression
Enum
Atribuição Attribution lookback window af_attribution
_lookback
Link
  • Período máximo para atribuir uma instalação a um anúncio específico.
  • UA: Para a atribuição de cliques, configurar no parâmetro af_click_lookback.
  • Retargeting: definido nas configurações do aplicativo para retargeting de lookback de click-through.
Caracteres
SKAN Attribution signature skad_attribution
_signature
iOS Assinatura adicionada pela ad network aos postbacks da SKAN String
Protect360 Blocked reason blocked_reason AF Protect360: Motivo pelo qual a instalação foi bloqueada. Exemplo: sequestro de instalação, bots String
Protect360 Blocked reason rule (deprecated) blocked_reason
_rule
AF Desativada String
Protect360 Blocked reason value blocked_reason
_value
AF Protect360: Informações adicionais sobre o bloqueio. Exemplo: Site Id, nome(s) da(s) regra(s) de validação String
Protect360 Blocked sub reason blocked_sub
_reason
AF Protect360: Submotivo específico para uma instalação bloqueada. Exemplo: Motivo: sequestro de instalação. Submotivo: sequestro de referrer, anomalias de CTIT, regras de validação String
App Bundle ID bundle_id SDK
  • iOS: identificação para corresponder a um único aplicativo ou a um grupo de aplicativos no iOS (consulte /a>ID do pacote de desenvolvedor da Apple)
  • Android: App ID
  • Atenção: esse campo não está relacionado com o PBA da AppsFlyer.
String
SKAN Campaign ad_network
_campaign
_name
Ad network Nome da campanha reportado pela ad network à AppsFlyer String
Atribuição Campaign campaign Link Nome da campanha String
SKAN Campaign ID ad_network
_campaign_id
Ad network ID da campanha reportada pela ad network à AppsFlyer String
Atribuição Campaign ID af_c_id Link Campaign ID String
SKAN Campaign ID skad_campaign
_id
iOS ID da campanha utilizado para publicar o anúncio. Intervalo 0-100 Integer
Atribuição Campaign type campaign_type AF

A fonte que traz o usuário:
 

  • UA
  • Orgânico
  • Retargeting
  • Desconhecido (1)

(1) Eventos/sessões in-app não atribuídos a nenhuma fonte de mídia. Como alternativa, os dados são excluídos devido a uma política de privacidade ou solicitação do GDPR.

String
Informações do dispositivo Carrier carrier SDK O nome da operadora fornecido pelo Android utilizando getSimCarrierIdName(). Consulte também mapeamento de operadoras. String
SKAN Channel ad_network
_channel
Ad network O campo é adicionado aos relatórios, mas não necessariamente será preenchido String
Atribuição Channel af_channel Link Canal da fonte de mídia Exemplo: YouTube para Google, Instagram para Meta Ads Dynamic Enum String
Localização do dispositivo City city AF A localização mais precisa do usuário com base no IP do dispositivo. Normalmente, o valor contém o nome de uma cidade, mas também é possível ter distritos, bairros, etc., que são mais precisos. String
SKAN Coarse conversion value skad_coarse
_conversion
_value
iOS
  • O valor pode ser baixo, médio ou alto.
  • Para SKAN 3, o valor é nulo.
String
Atribuição Contributor[n] campaign contributor[n]
_campaign
(n=1-3)
AF Campanha do contribuidor String
Atribuição Contributor[n] engagement type contributor[n]_engagement_type (n=1-3) AF Valores possíveis: preload, click_to_download, click_to_app, engaged_click, engaged_view, view, listening, click_unspecified, impression_unspecified Enum
Atribuição Contributor[n] engagement type contributor_[n]_engagement_type AF Tipo de engajamento do colaborador Enum
Atribuição Contributor[n] match type contributor[n]
_match_type
(n=1-3)
AF Os valores possíveis são os mesmos do tipo de correspondência. String
Atribuição Contributor[n] media source contributor[n]
_media_source
(n=1-3)
AF Fonte de mídia do colaborador String
Atribuição Contributor[n] partner contributor[n]
_af_prt
(n=1-3)
AF Agência ou PMD - sempre convertido para minúsculas String
Atribuição Contributor[n] touch time contributor[n]
_touch_time
(n=1-3)
AF Tempo de interação do contribuidor Data e Hora
Atribuição Contributor[n] touch type contributor[n]
_touch_type
(n=1-3)
AF Valores possíveis: clique, impressão Enum
Atribuição Conversion type conversion_type AF

O tipo de conversão:

  • Instalação
  • Reinstalação (1)
  • Reengajamento 
  • Desconhecido (2)

(1) Se conversion_type= reinstall e campaign_type=retargeting é equivalente a retargeting_conversion_type=re-attribution

(2) Eventos/sessões in-app não atribuídos a nenhuma fonte de mídia.

String
SKAN Conversion value skad_conversion
_value
iOS
  • Valor de conversão reportado pelo iOS. Intervalo 0-63.
  • Se nulo, o iOS não preencheu o campo.
Integer
Atribuição Cost currency af_cost_currency Link Código de moeda de três letras (USD, EUR) conforme ISO-4217. Por padrão, é USD. String
Atribuição Cost model af_cost_model Link Modelo de custo reportado no link de atribuição. CPC/CPI/CPM/Outro. Atualmente, todo o custo é calculado conforme CPI, independentemente deste valor. String
Atribuição Cost value af_cost_value Link Valor da moeda de custo. São permitidos 4 dígitos após a vírgula. Exemplo: 320.5095 String
Localização do dispositivo Country code country_code AF
  • Código do país usando ISO 3166 (alpha-2). Exemplo: EUA, CN.
  • O código do Reino Unido implementado é UK, não GB.
Enum
SKAN Creative ad_network
_creative
Ad network
  • O valor é baseado no enriquecimento de dados recebido da ad network.
  • Para SKAN 3, o valor é nulo.
String
Assinatura CUIDs af_cuids Conector SDK de compras da AppsFlyer
  • No contexto do ARS, esse parâmetro contém uma lista com todos os CUIDs.
  • A lista de CUIDs é mostrada independentemente dos device IDs. Assim, os mesmos CUIDs podem ser mostrados para mais de um device ID.
 
Atribuição Custom data custom_data SDK Dados definidos pelo anunciante no SDK ou pelo S2S, frequentemente usados para integração com terceiros, audiências, etc. Veja Android e iOS String
Atribuição Custom dimension custom
_dimension
SDK Reservado para uso futuro da AppsFlyer String
Informações do dispositivo Customer user ID customer
_user_id
SDK Um ID de usuário de aplicativo exclusivo, definido pelo proprietário do aplicativo. String
Informações do dispositivo Deeplink URL deeplink_url SDK O caminho para uma atividade interna no aplicativo à qual os usuários estão sendo direcionados. Use-o para deep linking e deferred deep linking.
Ele contém o valor af_dp no link de atribuição
String
Protect360 Detection date detection_date AF Data em que a fraude pós-atribuição é detectada. String
Informações do dispositivo Device category device_category O user_agent reportado

Tipo de dispositivo usado: tablet, mobile_phone, desktop, tv, set_top_box, games_console, media_player, unknown_device_category.


O valor "unknown_device_category" é gerado sempre que a AppsFlyer não consegue identificar o user agent de um dispositivo. Isso indica que a AppsFlyer tentou identificar as características do dispositivo, mas não conseguiu classificá-lo em nenhuma categoria conhecida.

String
Informações do dispositivo Device download Time device_download
_time
SDK Hora de conclusão do download do app usando o relógio do dispositivo Android ou iOS, convertida para UTC. O valor sempre é exibido em UTC.
Formato: aaaa-mm-dd hh:mm:ss.sss
Data e Hora
Informações do dispositivo Device ID type device_id_type SDK Preenchido para CTV com o tipo de ID da plataforma de CTV. Por exemplo, RIDA para Roku. Enum
Informações do dispositivo Device model device_model SDK O nome comercial do modelo do dispositivo. Exemplo: xiaomi::Redmi ou iPhone7 String
Informações do dispositivo Device Type device_type SDK
  • O nome comercial do modelo do dispositivo.
  • [A partir de 2 de fevereiro de 2022, esse campo deixou de ser mais preenchido]
  • Em vez desse campo, use o modelo de dispositivo que é preenchido de forma semelhante.
  • Exemplo:
    • Modelo do dispositivo: xiaomi::Redmi Note 8
    • Tipo de dispositivo: xiaomi-Redmi Note 8
    • Modelo do dispositivo: iPhone7
    • Tipo de dispositivo: iPhone 7
String
SKAN Did win skad_did_win iOS
  • 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
IAP
Assinatura
Discount ID af_discount_id Conector SDK de compras AppsFlyer O offer ID apresentado ao usuário durante a compra inicial. O ID é preenchido apenas quando há um código de desconto.  
Assinatura Discount type af_discount_type Conector SDK de compras AppsFlyer Tipo de desconto resgatado pelo usuário. Valores possíveis:
 
  • iOS:
    • introductory
    • subscription
  • Android:
    • intro price
    • one_time_code
    • vanity_code
 
Localização do dispositivo DMA dma AF Área de Mercado Designada ou áreas geográficas. Definida pela empresa Nielsen. Determinação da localização do usuário. String
IAP
Assinatura
Environment af_environment Conector SDK de compras AppsFlyer O ambiente de onde os dados são recebidos, seja produção ou sandbox.  
Atribuição Engagement type engagement_type AF Valores possíveis: preload, click_to_download, click_to_app, engaged_click, engaged_view, view, listening, click_unspecified, impression_unspecified String
Evento Event hour event_time Postback Hora do evento arredondada para a hora completa mais próxima Data e Hora
Evento Event name event_name AF\/SDK
  • O tipo de evento de atribuição ou o nome do evento in-app enviado pelo aplicativo. Exemplos de tipos de eventos de atribuição: install, re-engagement, entre outros.
  • No Data Locker, no contexto dos relatórios de retargeting, o nome do evento é definido da seguinte forma: retargeting significa reengajamento, instalação significa nova atribuição. Para relatórios SKAN, o nome do evento in-app é conforme configurado na AppsFlyer.
  • Para o relatório SKAN SRN, waaw é o nome do evento in-app conforme configurado no Meta Ads.
String
Evento Event revenue event_revenue SDK
  • Valor da receita usando a moeda da receita do evento.
  • Valores fora do intervalo de US$-1.000.000 a US$+1.000.000 (ou equivalente) aparecem em relatórios de dados brutos, mas não nos agregados.
String
SKAN Event revenue event_revenue AF Fórmula: [soma dos valores para o evento específico em USD]\/ [Número de eventos que ocorreram em um dia específico] Float
Evento Event revenue currency event_revenue
_currency
SDK Código da moeda da receita no evento reportado ao SDK. String
Evento Event revenue selected currency event_revenue
_xxx
 
  • O montante da receita. A moeda dependerá da ferramenta de relatórios usada.
  • Preferido ou selecionado significa a moeda específica do aplicativo definida nas configurações do aplicativo.
  • Data Locker: sempre em USD
  • Página de exportação: moeda selecionada
  • Pull API selecionável: USD ou selecionado usando &currency=preferred.
  • Push API: contém sempre ambos os campos, USD e moeda selecionada
String
Evento Event revenue USD event_revenue
_usd*
AF
  • O montante da receita. A moeda dependerá da ferramenta de relatórios usada.
  • Preferido ou selecionado significa a moeda específica do aplicativo definida nas configurações do aplicativo.
  • Data Locker: sempre em USD
  • Página de exportação: moeda selecionada
  • Pull API selecionável: USD ou selecionado usando &currency=preferred.
  • Push API: contém sempre ambos os campos, USD e moeda selecionada
String
Atribuição Event source event_source AF SDK ou S2S Enum
Evento Event time event_time SDK Hora em que o evento ocorreu Data e Hora
Evento Event type event_type AF/SDK O tipo de evento de atribuição. Exemplos de tipos de eventos de atribuição: install, re-engagement, entre outros. String
Evento PBA Event URL event_url Web SDK URL da página da web onde ocorreu o evento (igual à URL original em visitas ao site) String
Evento Event value event_value SDK Conteúdo detalhado do evento enviado do SDK. Observação: não envie mais de 1000 caracteres; eles podem acabar sendo encurtados. String
SKAN Event value event_value S2S
  • Valor padrão: null
  • Contém uma string definida por apps que implementam descodificação personalizada ou envio de eventos por S2S.
  • Os anunciantes consomem isso em seus sistemas. A AppsFlyer não faz uso disso.
String (JSON)
SKAN Fidelity type fidelity_type  
  • Diferenciar entre opções de exibição de anúncios que afetam a atribuição. Indicado pelos valores 0 e 1 da seguinte forma:
    • Anúncios com view-through (0)
    • Anúncios renderizados pelo StoreKit (1)
    • Ignore o valor do campo se a versão da SKAN for anterior à 2.2
Integer
SKAN Fidelity type skad_fidelity
_type
iOS
  • Diferencie entre opções de apresentação de anúncios que afetam a atribuição. Indicado pelos valores 0 e 1 da seguinte forma:
    • Anúncios com view-through (0)
    • Anúncios renderizados pelo StoreKit (1)
    • Ignore o valor do campo se a versão do SKAN for anterior à 2.2. O campo é adicionado aos relatórios, mas não será necessariamente preenchido
Integer
Protect360 Fraud reason fraud_reason AF Protect360: Consulte o motivo do bloqueio. String
Protect360 Fraud sub reason fraud_sub
_reason
AF Protect360: Consulte o submotivo do bloqueio. String
Informações do dispositivo gdpr_applies gdpr_applies SDK Indica se o usuário se enquadra na jurisdição do DMA (true) ou não (false) Booleano
Atribuição Google Play broadcast referrer gp_broadcast
_referrer
Google Play Store Google Play Broadcast Referrer String
Atribuição Google Play click time gp_click_time Campo do Google Play
  • Tempo de carregamento da página do app no Google Play após um clique no anúncio.
  • Fonte de tempo: API do Google
  • Disponível a partir do Android SDK versão 4.8.5
  • Exemplo: Compare o tempo de instalação com o tempo de clique no GP. Isso fornece um insight sobre quanto tempo passa entre o download do aplicativo até que o usuário o abra.
Timestamp
Atribuição Google Play install begin time gp_install_begin Google Play Store
  • Hora em que a instalação começa
  • Fonte de tempo: API do Google
  • Disponível no Android SDK V4.8.5
Timestamp
Atribuição Google Play referrer gp_referrer Google Play Store
  • A URL de referência do pacote instalado.
  • Disponível no Android SDK V4.8.5
String
Atribuição HTTP referrer http_referrer AF Identifica o endereço da página web que levou ao clica na URL na AppsFlyer. Verificando o referrer, é possível conhecer a origem da solicitação String
Informações do dispositivo IDFA idfa SDK ID de anúncios reconfigurável do usuário, encontrado em dispositivos iOS. Se o IDFA não estiver disponível, normalmente seu valor é preenchido com Zeros. Caracteres
Informações do dispositivo IDFV idfv SDK Vendor ID fornecido pelo iOS. Caracteres
Informações do dispositivo IMEI imei SDK ID permanente do dispositivo Caracteres
Receita de anúncios Impressions impressions Ad revenue API Número de vezes que o usuário viu o anúncio String
Atribuição Install App Store install_app_store SDK A loja Android de onde o aplicativo foi baixado (detalhes) String
SKAN Install date install_date iOS Estimado pela AppsFlyer com base na hora de chegada do postback. Descrição de tempo
Atribuição Install time install_time Postback
  • UA: Primeira abertura após a instalação.
  • Retargeting: Primeira abertura após reengajamento/reatribuição.
Data e Hora
SKAN Install type install_type iOS Novas instalações String
SKAN Interval interval AF Intervalos da janela de atividades. Integer
Localização do dispositivo IP ip AF Endereço IP podendo ser IPV4 ou IPV6. A AppsFlyer usa o endereço para determinar a localização do usuário. Se necessário, os anunciantes podem mascarar o endereço IP em relatórios e postbacks. String
Protect360 Is organic is_organic AF Indica se o evento in-app está associado a uma instalação orgânica. String
Atribuição Is primary attribution is_primary
_attribution
AF UA: True

Retargeting: durante a janela de reengajamento, atribuímos tanto à fonte de mídia original (anterior ao reengajamento) quanto à fonte de mídia de reengajamento. Enquanto o evento ocorrer dentro da janela de reengajamento. A fonte de mídia original aparecerá como 'FALSE' (não é a atribuição principal). A fonte de mídia de reengajamento será TRUE. Mais detalhes
Enum
Evento Is receipt validated is_receipt
_validated
AF TRUE/FALSE/NULL quando implementado no SDK, vazio caso contrário. Enum
Atribuição Is retargeting is_retargeting Link Enum boolean
Atribuição Keyword ID keyword_id Link Keyword ID retornado pela ad network. Esse é o ID de af_keyword. String
Atribuição Keyword match type keyword_match
_type
AF
  • O tipo de correspondência de palavras-chave é fornecido exclusivamente pelo Google AdWords.
  • A partir de 15 de fevereiro de 2021, esse campo deixou de ser preenchido preenchido em relação ao Apple Search Ads.
String
Atribuição Keywords af_keywords Link Palavra(s) usada(s) na pesquisa online do usuário. Conforme relatado pela ad network String
Informações do dispositivo Language language SDK Idioma (localidade) indicado pelo dispositivo e configurado pelo sistema operacional do dispositivo. Normalmente apresenta o formato ll-DD. Onde ll representa a língua e DD o dialeto. Por exemplo, en-ZA significa inglês utilizado na África do Sul. String
Informações do dispositivo Limit ad tracking is_lat SDK Limit ad tracking (LAT):
  • iOS: A partir do iOS 14, o LAT foi descontinuado pela Apple. Determine o status de privacidade do usuário usando ATT. Nesse caso, ignore is_lat.
    Antes do iOS 14, se 'true', o IDFA não estava disponível e era definido como 0.
  • Android: Quando true, o usuário optou por não receber anúncios baseados em interesses. A GAID não coletará dados e, em vez disso, exibirá zeros.
Enum boolean
Atribuição Match type match_type AF Tipo de método de atribuição. Os valores possíveis incluem: String
SKAN Contador máximo de eventos max_event
_counter
AF 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]. 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.
Integer
SKAN Max revenue max_revenue AF A receita é sempre apresentada no campo skad_revenue. Se você usar o modo SKAN 4 ou Personalizado, o intervalo do bucket associado ao evento e usado para calcular skad_revenue é descrito por min_revenue e max_revenue. Número real
SKAN Max time post-install max_time
_post_install
AF
  • 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.
Integer
Atribuição PBA Media channel media_channel Web SDK Canal de mídia atribuído à visita ao site String
Atribuição Media source media_source Link A fonte de mídia atribuída a um evento ou restrita String
Atribuição Media type media_type AF

Posição do anúncio que contém o link da seguinte forma:

  • app: o link está disponível através de um aplicativo
  • web: o link está disponível em um site mobile
String
Receita de anúncios Mediation network mediation
_network
Ad revenue API Rede de mediação de receita de anúncios que relata o evento à AppsFlyer String
SKAN Min event count min_event
_counter
AF Use para calcular o número de vezes que um usuário realiza um evento. 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]. 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.
Integer
SKAN Min revenue min_revenue AF A receita é sempre apresentada no campo skad_revenue. Se você usar o modo SKAN 4 ou Personalizado, o intervalo do bucket associado ao evento e usado para calcular skad_revenue é descrito por min_revenue e max_revenue. Número real
SKAN Min time post-install min_time
_post_install
AF
  • 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.
Integer
Receita de anúncios Monetization network monetization
_network
Ad revenue API Rede de receita de anúncios que envia o anúncio String
IAP
Assinatura
Net revenue af_net_revenue True Revenue API Receita líquida calculada com base em todas as razões consideradas. Consulte af_net_revenue_factors.  
IAP
Assinatura
Net revenue country af_net_revenue
_country
True Revenue API
  • Código ISO de duas letras para o país ao qual o imposto é aplicado.
  • Exemplo: GB
 
IAP
Assinatura
Net revenue factors af_net_revenue
_factors
True Revenue API
  • Uma matriz que representa todos os fatores que contribuem para o valor de af_net_revenue reportado.
  • Valor de exemplo: store_comission
 
IAP
Assinatura
Net revenue postal code af_net_revenue
_postal_code
True Revenue API
  • String de letras e/ou números
  • Exemplo: L4J8E3
 
IAP
Assinatura
Net revenue subdivision af_net_revenue
_subdivision
True Revenue API
  • Para alguns países, pode haver uma subdivisão ou estado adicional. Isso é tratado de acordo com os códigos de subdivisão ISO 3166-2.
  • Inclui o código do país e o código da subdivisão.
  • Exemplo: US-CA
 
IAP
Assinatura
Net revenue tax exclusive af_net_revenue
_tax_exclusive
True Revenue API
  • Parâmetro booleano, true ou false.
  • False significa que o imposto está incluído na receita total.
  • True significa que o imposto é adicionado à receita declarada geral. Por exemplo, nos EUA ou no Canadá, o preço de tabela não inclui o imposto sobre vendas.
 
IAP
Assinatura
Net revenue tax name af_net_revenue
_tax_name
True Revenue API
  • Nome que aparece na fatura do cliente que descreve o tipo específico de imposto.
  • Exemplo: Vendas, IVA, GST
 
IAP
Assinatura
Net revenue tax rate af_net_revenue
_tax_rate
True Revenue API
  • Número com até 4 casas decimais representando o percentual do imposto recolhido.
  • Exemplo: 7.25
 
Atribuição Network account ID network
_account_id
Link ID da conta do anunciante na ad network String
Informações do dispositivo OAID oaid SDK User ID reconfigurável em alguns dispositivos Android, geralmente como alternativa ao GAID Caracteres
Informações do dispositivo Operator operator SDK O nome da operadora móvel derivado do SIM MCCMNC. Disponível se o usuário estiver registado na network através do método getNetworkOperatorName() do Android String
IAP
Assinatura
Order ID af_order_id Conector SDK de compras AppsFlyer
  • O ID do pedido na transação
  • Exclusivo para Android
 
IAP
Assinatura
Original transaction ID af_original
_transaction_id
Conector SDK de compras AppsFlyer
  • O ID da transação original
  • Exclusivo para iOS
 
Atribuição Original URL original_url Link
  • UA: URL de clique/impressão usado. Se o link for um Branded link: o campo será preenchido com o link personalizado.
  • Retargeting: contém um dos seguintes: Link de retargeting, dados de deep linking, vazio para SRNs.
String (URL)
Informações do dispositivo OS version os_version SDK Versão do sistema operacional do dispositivo String
Atribuição Partner af_prt Link Identificador da agência. Para SKAN, pode não ser preenchido String
Receita de anúncios Placement placement Ad revenue API O local onde o anúncio é exibido no aplicativo String
Informações do dispositivo Platform platform SDK Plataforma do dispositivo: Android, iOS, windowsphone, smartcast, tizen, roku, webos, vidaa, playstation, xbox, switch, steam, epic, nativepc, quest Enum
Localização do dispositivo Postal code postal_code AF Usando o endereço IP do dispositivo informado pelo SDK. Para SKAN, a partir de 30 de agosto de 2021, sempre nulo String
SKAN Postback sequence index skad_postback
_sequence_index
iOS
  • O valor representa a janela SKAN: 0, 1 ou 2.
  • Para SKAN 3, o valor é 0
Integer
IAP
Assinatura
Product ID af_product_id Conector SDK de compras AppsFlyer ID do produto na assinatura  
IAP
Assinatura
Purchase date af_purchase
_date_ms
Conector SDK de compras AppsFlyer A data de compra do product ID reportado no evento in-app  
IAP Purchase state af_purchase_state Conector SDK de compras AppsFlyer Valores possíveis:
 
  • Purchased
  • Canceled
  • Pending
 
IAP
Assinatura
Purchase token af_purchase
_token
Conector SDK de compras AppsFlyer
  • Token de compra na transação
  • Exclusivo para Android
 
PBA Query params query_params Link

Parâmetros de consulta na URL de redirecionamento (após o ?)
Exemplo: https://www.brandpitt.com/signin?utm_source=Google
&utm_term=shoes
&utm_campaign=cool
&c=summer
&af_siteid=publisher
&af_sub1=helloworld
&af_keyword=sapatos

Se a URL não tiver parâmetros de consulta, o valor será nulo

String
Informações do dispositivo Raw consent data raw_consent_data SDK Retorna um objeto JSON com os dados brutos de consentimento do DMA conforme enviados do anunciante para a AppsFlyer String
IAP
Assinatura
Reason af_reason Conector SDK de compras AppsFlyer Em casos de cancelamento ou churn, o motivo pelo qual o usuário cancelou ou desistiu. Valores possíveis:
  • iOS:
    • cancel_intent
    • billing_issue
    • declined_price_increase
    • product_unavailable
  • Android:
    • I don't use this service enough
    • Technical issues
    • Cost-related reasons
    • I found a better app
    • Other
  • Em eventos onde a assinatura foi retomada, o motivo pelo qual o usuário a retomou. Valores possíveis: Android: paused e resumed
    disabled e enabled auto-renew
  • Em eventos relacionados com reembolsos, a razão pela qual o usuário recebeu um reembolso. Valores possíveis: iOS: 1: problema com o seu aplicativo
    0: outra razão
 
SKAN Redownload skad
_redownload
iOS Se true, o aplicativo foi baixado novamente Boolean
Atribuição Reengagement window af_reengagement
_window
Link
  • Retargeting: O prazo durante o qual os eventos são atribuídos a uma campanha de retargeting
  • Atenção: O campo não é preenchido em campanhas de retargeting.
String
IAP
Assinatura
Refund ransaction ID af_refunded
_transaction_ids
Conector SDK de compras AppsFlyer
  • Uma lista de todos os IDs das transações reembolsadas
  • Exclusivo para iOS
 
Localização do dispositivo Region region AF Utilizando o endereço IP do dispositivo reportado pelo SDK. Para SKAN, determinado de acordo com o country_code String
Protect360 Rejected reason rejected_reason AF Protect360: Desativação planejada. Contém atualmente o motivo do bloqueio. String
Protect360 Rejected reason value rejected
_reason_value
No Data Locker: validation
_reason_value
AF
  • Protect360: Mostra o contribuidor válido (fonte de mídia) para instalações sequestradas pós-atribuição/eventos in-app. Preenchido com contributor[1-3] ou organic.
  • No Data Locker, isto é apresentado como validation_reason_value.
String
Atribuição Retargeting conversion type retargeting
_conversion_type
AF
  • UA: Re-install
  • Retargeting: Re-engagement, Re-attribution
  • Desativação planejada: esse campo será desativado no futuro. Use conversion_type e campaign_type para determinar o contexto da conversão.
Enum
SKAN Revenue skad_revenue iOS Valor da receita do evento em USD. Float
App SDK version sdk_version SDK Versão do SDK da AppsFlyer String
Receita de anúncios Segment segment Ad revenue API Nome do segmento da receita de anúncios String
Atribuição Site ID af_siteid Link Publisher ID String
SKAN SKAN measurement window measurement
_window
AF Duração da janela de atividade. Padrão 24 horas. Integer
SKAN SKAN mode skad_mode AF 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
SKAN SKAN transaction ID skad
_transaction_id
iOS ID de postback fornecido pela Apple String
SKAN SKAN version skad_version iOS SKAN version String
SKAN Source app ID ad_network
_source_app_id (1)
Ad network ID do aplicativo do publisher relatado pela ad network. Use-o para ajudar a reconciliar custos, reportado pela ad network. A base para esses dados é fornecida pelo aplicativo do publisher. O campo é adicionado aos relatórios, mas não necessariamente será preenchido String
SKAN Source app ID skad_source
_app_id
iOS
  • Site ID - o aplicativo que publica o anúncio.
  • O preenchimento do campo depende dos limites de privacidade
String
SKAN Source domain skad_source
_domain
iOS
  • O valor representa a origem dos anúncios web atribuídos.
  • Para SKAN 3, o valor é nulo.
String
SKAN Source identifier skad_source
_identifier
iOS
  • O valor pode ter até 4 dígitos.
  • Para o SKAN 3, o valor é nulo.
String
Localização do dispositivo State state AF Usando o endereço de IP do dispositivo reportado pelo SDK String
IAP
Assinatura
Store af_store Conector SDK de compras AppsFlyer A loja de aplicativos onde o produto assinado foi comprado  
IAP
Assinatura
Store commission store_commission True Revenue API
  • A porcentagem calculada da comissão que a loja recebe do produto comprado.
  • Exibido como uma casa decimal.
  • Exemplo: 30
 
Atribuição Store product page store_product
_page
AF Página personalizada do produto na App Store Android ou Apple (iOS 15+), para a qual o usuário foi redirecionado. String
Informações do dispositivo Store reinstall store_reinstall SDK
  • A loja de aplicativos da Apple determina se um usuário trazido pelo Apple Search Ads é uma reinstalação usando a ID de usuário Apple:
  • Novo usuário: false
  • Reinstalação por um usuário existente: true
Enum boolean
Atribuição Sub param [n] af_sub[n] (n=1-5) Link Parâmetro preenchido pelo anunciante no link de atribuição String
Atribuição Sub site ID af_sub_siteid Link Sub-publisher ID String
Assinatura Data de expiração da assinatura af_expires
_date_ms
  A data de expiração do ciclo de faturação da assinatura atual  
Assinatura Subscription ownership type af_subscription
_ownership_type
Conector SDK de compras AppsFlyer FAMILY_SHARED significa que o usuário tem acesso através de compartilhamento familiar. PURCHASED significa que o usuário pagante fez a compra.  
Assinatura Subscription period type af_period_type Conector SDK de compras AppsFlyer
  • Tipo de período de assinatura ou avaliação.
  • Valores possíveis: trial, intro, normal
 
SKAN Timestamp timestamp Ad network Hora em que o postback foi recebido pela AppsFlyer
Para Google Ads e Meta ads, esse é o momento em que a AppsFlyer obtém os dados da API do Google e do Meta ads, respectivamente.
Timestamp
IAP
Assinatura
Transaction ID af_transaction_id Conector SDK de compras da AppsFlyer
  • O ID da transação
  • Exclusivo para iOS
 
Informações do dispositivo User agent user_agent Link URL/device user agent String
Evento PBA web_event_type web_event_type Web SDK O tipo de evento da Web (visit, event etc.) String
Informações do dispositivo WIFI wifi SDK Definido como TRUE ou FALSE Enum boolean
IAP   af_cancelation
_date_ms
Conector SDK de compras AppsFlyer Data de cancelamento  
SKAN   did_win iOS
  • 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.
Boolean
SKAN   evento_uuid AF Um identificador aleatório e único que permite aos parceiros identificar postbacks duplicados. String
SKAN   source_app_id AF Site ID. O aplicativo que publica o anúncio. Esse campo é idêntico ao skad_source_app_id String