Dicionário de campo de dados brutos (especificação V5.0)

Resumo: o dicionário de campo de dados (especificação de dados brutos) contém os campos encontrados nos relatórios de dados brutos.

Campos de data nos arquivos CSV: Campos de data nos arquivos CSV têm o formato aaaa-mm-dd. Quando você abre um arquivo CSV no Excel, os campos de data são formatados usando as configurações de data e hora do seu computador. Certifique-se de selecionar a exibição de data apropriada no Excel

Sobre o dicionário de dados

As colunas do dicionário são: 

  • Nome da API: nome usado pela Push API e pelo Data Locker
  • Nome de exibição: nome do campo usado nos relatórios, como CSV, Pull API,
  • Fonte: o local da fonte original do conteúdo do campo, da seguinte maneira:
  • Descrição
    • Alguns campos têm significados diferentes, dependendo do contexto do evento. Ou seja, como resultado de uma campanha de UA ou de retargeting.
  • Contexto:  Onde um campo está disponível em relatórios específicos/ou tem um significado ligeiramente diferente, dependendo do contexto do relatório, isso é indicado aqui da seguinte maneira:
    • Retargeting: esses campos têm um significado específico no contexto de uma campanha de retargeting.
    • Data Locker: disponível apenas no Data Locker.
    • Protect360: disponível apenas nos relatórios Protect360
    • Campos adicionados após dezembro de 2019, a data em que o campo foi adicionado
  • Tipo e comprimento do campo:
    • String: o comprimento máximo da string. Normalmente, não impomos limitações de tamanho de campo ao recebimento dos dados, mas os dados podem ser truncados posteriormente. Não exceda a especificação de comprimento do campo.
    • Data hora: 
      • Sequência com formato, aaaa-mm-dd hh:mm:ss. Por exemplo, 2019-09-17 00:09:25 O fuso horário usado para exibir os dados depende da ferramenta de entrega de dados da seguinte maneira:
        • Exportar página de dados: fuso horário selecionado pelo aplicativo.
        • 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.
        • Mater API: o padrão é o fuso horário selecionável pelo aplicativo.
        • Data Locker: UTC
      • Observação: ao abrir arquivos CSV usando o Excel, o campo é exibido usando as configurações regionais padrão. Você pode alterar o formato de exibição no Excel. Para ver o valor não formatado, abra o arquivo usando um editor.
      • Push API:
        • Para campos de carimbo de data/hora em UTC: formato aaaa-mm-dd hh: mm: ss.sssPor exemplo, 2019-09-17 00: 09: 25.123 
        • Para campos de carimbo de data/hora no fuso horário selecionado: formato aaaa-mm-dd hh:mm:ss.±th:tm. Por exemplo, 2019-01-20 04:51:16.000+0000
    • Enumeração n caracteres: os campos da enumeração podem conter apenas valores específicos. Por exemplo, a moeda de custo possui 3 caracteres e pode conter apenas códigos de moeda, conforme especificado
    • Enumeração 5 caracteres booleanos: O valor do campo pode ser VERDADEIRO ou FALSO
    • Exemplo de registro de instalação com formato csv

Campos de dados brutos

Nome do parâmetro da API

Nome do campo

Fonte

Descrição


Contexto

Tipo de campo

af_ad

Anúncio

Link

   

Sequência  100

af_ad_id

ID do anúncio

Link

   

Sequência de caracteres 24

af_ad_type

Tipo de anúncio

Link

Tipo de anúncio (faixa, rodapé etc.)

 

Sequência de caracteres 24

af_adset

Conjunto de anúncios

Link

   

Sequência 1 100

af_adset_id

ID do conjunto de anúncios

Link

 

 

Sequência de caracteres 24

af_c_id

ID da campanha

Link

    Sequência de caracteres 24

af_channel

Canal

Link

Canal da fonte de mídia, exemplo: YouTube para Google, Instagram para Facebook   Enumeração dinâmica Sequência de caracteres 20

af_cost_
moeda *

Moeda do custo

Link

Moeda de custo (lista)   Enumeração 3 caracteres

af_cost_model

Modelo de custo

Link

CPC/CPI/CPM/Outros. Atualmente, todos os custos são calculados de acordo com o CPI, independentemente deste valor

 

Sequência de caracteres 20

af_cost_value

Valor de custo

Link

Custo na moeda original. Oferece suporte a até 4 dígitos após o ponto decimal. Exemplo: 320.5095   Sequência de caracteres 20

af_keywords

Palavras-chave

Link

Recebido da ad network

 

Sequência de caracteres 100

af_attribution_
lookback

Lookback de atribuição Link

UA: janela de lookback para atribuição de cliques. A duração da janela é o CTIT (tempo entre o clique e a instalação) máximo para o usuário novo ser atribuído à fonte que exibe o anúncio/link. Observação: o parâmetro equivalente no link de atribuição é af_click_lookback.

Retargeting: Retargeting de lookback por clique

 Retargeting

 

 

Máximo de 3 caracteres

af_prt

parceira

Link

Agência ou PMD

 

Sequência de caracteres 50

af_reengagement
_window

Reengagement Window

Link

A janela de atribuição de reengajamento é o período de tempo durante o qual um evento pode ser atribuído a uma campanha de redirecionamento

Limitação:  O campo não é preenchido em campanhas de redirecionamento.

Redirecionamento Máximo de 3 caracteres

af_siteid

ID do site

Link

ID do editor   Sequência de caracteres 24

af_sub_siteid

ID do sub-site

Link

ID do subeditor

 

Sequência de caracteres 50

af_sub1

Subparâmetro 1

Link

Parâmetro personalizado opcional definido pelo anunciante   Sequência de caracteres 100

af_sub2

Subparâmetro 2

Link

Parâmetro personalizado opcional definido pelo anunciante   Sequência de caracteres 100

af_sub3

Subparâmetro 3

Link

Parâmetro personalizado opcional definido pelo anunciante   Sequência de caracteres 100

af_sub4

Subparâmetro 4

Link

Parâmetro personalizado opcional definido pelo anunciante   Sequência de caracteres 100

af_sub5

Subparâmetro 5

Link

Parâmetro personalizado opcional definido pelo anunciante   Sequência de caracteres 100

campanha

Campanha

Link

Nome da campanha

 

Sequência de caracteres 100

is_retargeting

Está redirecionando

Link

UA: FALSO

Retargeting: VERDADEIRO para conversões e eventos de retargeting

Redirecionamento

Enumeração 5 caracteres booleanos

media_source

Fonte de mídia

Link

A fonte de mídia atribuída a um evento ou restrita

 

Sequência de caracteres 50

original_url

URL original

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 itens: link de retargeting , dados de link direto, vazios para SRNs.

Redirecionamento Sequência 2083 (URL)

user_agent

Agente do usuário

Link

O agente do usuário para o URL   Sequência 200

advertising_id

ID de publicidade

SDK

A ID de publicidade é uma ID que pode ser redefinida pelo usuário, exclusiva e anônima para publicidade, fornecida pelos serviços do Google Play (GAID)   Sequência 40

android_id

ID do Android

SDK

ID do dispositivo Android    Sequência de caracteres 20
app_id ID do aplicativo

SDK

ID do aplicativo:
  • iOS: id123456789
  • Android: com.appsflyer.referrersender
 

iOS: Sequência 12

Android: Sequência 100

app_name

Nome do aplicativo

SDK

Nome do aplicativo   Sequência de caracteres 100

app_version

Versão do aplicativo

SDK

Versão do aplicativo   Máximo de 8 caracteres

appsflyer_id

ID da AppsFlyer

SDK

UA: identificador de instalação exclusivo. Um ID exclusivo gerado pela AppsFlyer quando o aplicativo é iniciado pela primeira vez. O ID é exclusivo por aplicativo por instalação. Isso significa que um novo ID será alocado se o aplicativo for excluído e depois instalado novamente. Consulte também ID do usuário cliente.

Redirecionamento:
reatribuição: um novo ID é alocado, reengajamento: o ID permanece inalterado 

Redirecionamento

iOS: Sequência 24

Android: Sequência 33

bundle_id

ID do pacote

SDK

Identificação que corresponde a um único aplicativo ou a um grupo de aplicativos (para iOS)   Sequência de caracteres 100

carrier

Carrier

SDK

O nome da operadora fornecido pelo Android com getSimCarrierIdName(). Veja também mapeamento de operadora.

  Sequência de caracteres 50

country_code

Código do país

SDK

Código do país usando ISO 3166 (alfa-2) Exemplo: US, CN.

O código do Reino Unido implementado é UK, não GB

  Enumeração sequência 2

custom_data

Dados personalizados

SDK

  • Dados enviados usando o SDK
  • Consulte Android e iOS
  Sequência 1024

ID_USUÁRIO_CLIENTE

ID de usuário cliente

SDK

Um identificador exclusivo, definido pelo proprietário do aplicativo.    Sequência de caracteres 100
deeplink_url

URL de links diretos (deep link)

SDK

O caminho para uma atividade interna no aplicativo à qual os usuários estão sendo direcionados. Use-o para links diretos e links diretos adiados.

Disponível desde janeiro de 2020

Sequência 1024

device_category

Categoria de dispositivo

SDK

  • Os valores possíveis incluem: telefone, tablet, outro
  • Compatível com Android SDK V4.8.8 e posterior
  Sequência de caracteres 20

device_type

Tipo do dispositivo

SDK

Nome do modelo comercial do dispositivo.Ex: SM-GM284 ou iPhone7

 

Sequência de caracteres 100

device_download_
time

Tempo de Download do Dispositivo

SDK

Hora de conclusão do download do aplicativo usando o relógio do dispositivo (Android , iOS) e convertida para UTC. O valor sempre é exibido em UTC.

Formato: aaaa-mm-dd hh:mm:ss.sss

Disponível no Data Locker desde outubro de 2019. Disponível em geral desde janeiro de 2020. -

event_name

Nome do evento

SDK

Nome do evento que ocorreu   Sequência de caracteres 100

event_revenue

Receita do evento

SDK

Valor da receita usando a moeda da receita do evento.   Sequência de caracteres 20

event_revenue_

moeda*

Moeda da receita do evento

SDK

A moeda da receita do evento conforme relatada no  SDK.   Sequência de caracteres 20

event_time

Data/hora do evento

SDK

UA: hora em que o evento ocorreu

Retargeting: será igual à hora da instalação

Redirecionamento Data Hora

event_value

Valor do evento

SDK

Valor do evento

Observação: não envie mais de 1000 caracteres do SDK, pois dependendo do tipo de relatório, podemos truncá-los. 

  Sequência 1000

idfa

IDFA

SDK

iOS: ID do anunciante   Máximo de 40 caracteres

idfv

IDFV

SDK

Identificador em nível do aplicativo para um fornecedor específico   Máximo de 40 caracteres

imei

IMEI

SDK

IMEI do dispositivo para Android e iOS   Máximo de 14 caracteres

install_app_store

Loja de aplicativos da instalação

Link

Identifica a loja Android de onde o aplicativo foi baixado (detalhes)   Sequência de caracteres 50

install_time

Data/hora da instalação

SDK

UA: hora da primeira inicialização após a instalação.

Retargeting: a primeira inicialização do aplicativo após o novo reengajamento/reatribuição

Redirecionamento

Data Hora

ip

IP

SDK

Endereço IP   Sequência 15 para IP V4

is_lat

Is LAT

SDK

Limit ad tracking (LAT): quando verdadeiro, o usuário ativou o LAT no dispositivo e nenhum ID de anunciante está disponível para AppsFlyer.  Desde janeiro de 2020 Enumeração 5 caracteres booleanos

language

language

SDK

Idioma do dispositivo   Sequência de caracteres 20

oaid

OAID

SDK

Android: ID do anunciante disponível em alguns dispositivos como alternativa ou além da ID do Android. Desde janeiro de 2020 Máximo de 40 caracteres

operator

Operator

SDK

O nome da operadora móvel derivado do SIM MCCMNC disponível se o usuário estiver registrado na rede usando o Android getNetworkOperatorName   Sequência de caracteres 50

os_version

Versão do SO

SDK

Versão do sistema operacional   Sequência 8

platform

platform

SDK

Valores possíveis: iOS, Android ou Windows Mobile

 

Enumeração sequência 8

sdk_version

Versão do SDK

SDK

Versão do SDK   Sequência 8

wifi

WiFi

SDK

true / false

 

Enumeração 5 caracteres booleanos

store_reinstall

Reinstalação da Apple Store

SDK

Para o tráfego gerado pelo Apple Search Ads, o uso da ID do usuário Apple determina se este é um:

  • Falso: novo usuário
  • Verdadeiro: reinstalação por um usuário existente
Desde janeiro de 2020 Enumeração 5 caracteres booleanos

amazon_aid

ID do Amazon Fire

SDK

ID de publicidade Amazon

  Sequência de caracteres 100

CIDADE

CIDADE

AF

A localização mais granular do usuário com base no IP do dispositivo. Geralmente, o valor contém o nome da cidade, mas também é possível ter distritos, vilas etc., que são mais precisos.

 

Sequência de caracteres 100

attributed_touch_

tempo

Data/hora do toque atribuído

AF

UA: hora na qual o toque foi atribuído.

Retargeting: hora do engajamento do retargeting

Redirecionamento

Data Hora

attributed_touch_

Tipo

Tipo do toque atribuído

AF

UA: o tipo de toque atribuído pela AppsFlyer. Valores possíveis:  clique/impressão/TV/pré-instalado

Reengajamento: clique, impressão (apenas reatribuição)

Redirecionamento

Enumeração máximo 10 caracteres

contributor_1_

af_prt

Parceiro do colaborador 1

AF

Agência ou PMD —
sempre convertido para minúsculas

 

Sequência de caracteres 50

contributor_1_

campanha

Campanha do colaborador 1

AF

Campanha do colaborador   Sequência de caracteres 100

contributor_1_

match_type

Tipo de correspondência do colaborador 1

AF

Os valores possíveis incluem:

gp_referrer, id_matching, srn

  Sequência de caracteres 50

contributor_1_

media_source

Fonte de mídia do colaborador 1

AF

Fonte de mídia do colaborador   Sequência de caracteres 50

contributor_1_

touch_time

Hora do toque do colaborador 1

AF

Hora do toque

 

Data Hora

contributor_1_

touch_type

Tipo de toque do colaborador 1

AF

Tipo do toque

click, impression, TV

 

Enumeração máximo 10 caracteres

contributor_2_af_
prt

Parceiro colaborador 2

AF

Agência ou PMD   Sequência de caracteres 50

contributor_2_

campanha

Campanha colaborador 2

AF

Campanha do colaborador   Sequência de caracteres 100

contributor_2_

match_type

Tipo de correspondência colaborador 2

AF

Os valores possíveis incluem:

gp_referrer/id_matching/srn

  Sequência de caracteres 50

contributor_2_

media_source

Fonte de mídia do colaborador 2

AF

Fonte de mídia do colaborador   Sequência de caracteres 50

contributor_2_

touch_time

Data e hora toque do colaborador 2

AF

Hora do toque   Data Hora

contributor_2_

touch_type

Tipo de toque do colaborador 2

AF

Tipo do toque

(pode ser clique/impressão/TV)

 

Enumeração máximo 10 caracteres

contributor_3_af_
prt

Parceiro colaborador 3

AF

Agência ou PMD   Sequência de caracteres 50

contributor_3_

campanha

Campanha colaborador 3

AF

Campanha do colaborador   Sequência de caracteres 100

contributor_3_

match_type

Tipo de correspondência do colaborador 3

AF

Os valores possíveis incluem:

gp_referrer/id_matching/srn

  Sequência de caracteres 50

contributor_3_

media_source

Fonte de mídia do colaborador 3

AF

Fonte de mídia do colaborador   Sequência de caracteres 50

contributor_3_

touch_time

Data/hora do toque do colaborador 3

AF

Hora do toque   Data Hora

contributor_3_

touch_type

Tipo do toque do colaborador 3

AF

Tipo do toque

(pode ser clique/impressão/TV)

 

Enumeração máximo 10 caracteres

dma

DMA

AF

Área de mercado designada — as regiões são áreas geográficas nos EUA onde a audiência de televisão local é medida pela empresa Nielsen.   Sequência 10

event_revenue_usd

event_revenue_
selected_currency

 

Receita do evento em USD

Receita do evento preferida

Receita do evento XXX

AF

O valor da receita. A moeda dependerá da ferramenta de relatório usada.

Preferido ou selecionado significa a moeda específica do aplicativo definida nas configurações do aplicativo.

Data Locker: USD

Exportar página: moeda selecionada 

Pull API selecionável : USD ou selecionada usando &currency=preferred. 

Push API: sempre contém os dois campos, USD e a moeda selecionada

 

  Sequência de caracteres 20

event_source

Fonte do evento

AF

A fonte do evento — SDK ou S2S   Enumeração máximo 3 caracteres

http_referrer

Referência HTTP

AF

Identifica o endereço da página da web vinculada ao URL do clique da AppsFlyer. Verificando a referência, é possível conhecer a origem da solicitação   Sequência máximo 2083 caracteres

is_primary_
atribuição

É atribuição primária

AF

UA: verdadeiro

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 estiver dentro da janela de reengajamento. A fonte de mídia original será FALSA (não atribuição principal). A fonte de mídia de reengajamento será VERDADEIRA.

Redirecionamento

Enumeração máximo 5 caracteres

is_receipt_
validated

O recibo está validado

AF

verdadeiro/falso/nulo quando implementado no SDK, caso contrário, vazio

 

Enumeração máximo 5 caracteres

match_type

Tipo de correspondência

AF

Tipo do método de atribuição. Os valores possíveis incluem:

gp_referrer (string de referência da Google Play)

id_matching

Fingerprinting

srn (Rede com autorrelatório)

tv (atribuição de TV)

preinstall

  Sequência de caracteres 50

postal_code

Código postal

AF

Com base no IP do SDK   Cadeia de caracteres - máximo de 10 caracteres

Região

Região

AF

Com base no IP do SDK

 

Sequência de caracteres 100

retargeting_

conversion_type

Tipo de conversão de redirecionamento

AF

UA: N/A

Retargeting: Reengajamento, Reatribuição

Redirecionamento

 

Enumeração máximo 14 caracteres

state

Estado

AF

Com base no IP do SDK

 

Sequência de caracteres 100

keyword_id

ID da palavra-chave

Link

ID da palavra-chave retornada pela ad network. Este é a ID da af_keyword.   Sequência de caracteres 100

keyword_match_
type

Tipo de correspondência das palavras-chave

AF

O tipo de correspondência de palavra-chave é retornado pela pesquisa das APIs das redes ou os links de atribuição devem ser mapeados para o relatório bruto.

Observação: o Google Adwords e a Apple Search Ads são as únicas redes que retornam este parâmetro para pesquisa de campanhas.

  Sequência de caracteres 100

network_
account_id

ID da conta da rede

AF

ID da conta do anunciante com o parceiro

 

Sequência de caracteres 100

rejected_reason_

valor

Rejected Reason value

AF

Em regras de validação de direcionamento relatórios: o Ruleset ID que causou a rejeição

Validação de direcionamento

Sequência de caracteres 100

rejected_reason Rejected Reason AF Nos relatórios das regras de validação de direcionamento - o tipo de regra que causou a rejeição. Ex: install-validation-rule Validação de direcionamento Sequência de caracteres 100
blocked_reason Blocked Reason AF No Protect360, o motivo pelo qual a instalação está bloqueada. Exemplo: install_hijacking, bots  Protect360  Sequência de caracteres 100
blocked_sub_
reason
Blocked Sub Reason AF

No Protect 360, um sub-motivo específico para uma instalação bloqueada. Exemplo: Motivo: install_hijacking. Sub-motivo: sequestro de referenciador, CTCT_anomalies

Protect360  Sequência de caracteres 100

blocked_reason_

valor

Blocked Reason Value AF Informações adicionais sobre o bloqueio. Exemplo: ID do site. Protect360  Sequência de caracteres 100

blocked_reason_

rule

Blocked Reason Rule AF Este campo será reprovado. Até então, o valor é sempre nulo.   Protect360  Para ser reprovado

gp_click_time

Hora do clique da Google Play

Campo Google Play

Hora de carregamento da página do aplicativo no Google Play após um clique no anúncio.

Fonte do tempo: API do Google

Disponível a partir do Android SDK versão 4.8.5

Exemplo de caso de uso: comparando o tempo entre install_time e gp_click, você pode obter informações sobre quanto tempo os usuários levam desde o momento em que começam a baixar o aplicativo até abri-lo. 

  Carimbo de data/hora

gp_install_begin

Hora de início da instalação da Google Play

Campo Google Play

Hora em que a instalação começa 
Fonte da hora: dispositivo do usuário. Significa a hora exibida no dispositivo. 

Observação:

Disponível a partir do Android SDK versão 4.8.5

  Carimbo de data/hora

gp_referrer

Google Play Referrer

Campo Google Play

A URL de referência do pacote instalado.

Disponível a partir do Android SDK versão 4.8.5

  Sequência 1024

gp_broadcast_
referrer

Referência de transmissão GP

Campo Google Play

Referência de transmissão do Google Play

  Sequência 1024

ad_unit

Ad unit

API de receita publicitária

Tipo de anúncio

Receita de anúncios Sequência 1024

segment

Segment

API de receita publicitária

Nome do posicionamento do anúncio Receita de anúncios Sequência 1024

monetization_network

Monetization network

API de receita publicitária

Rede que envia o anúncio

Receita de anúncios Sequência 1024

Impressões

Impressões

API de receita publicitária

Número de vezes que o usuário viu o anúncio

Receita de anúncios Sequência 1024

mediation_network

Mediation network

API de receita publicitária

Rede de mediação que reporta o evento para a AppsFlyer

Receita de anúncios Sequência 1024

Exemplo de registro de dados brutos de evento in-app

Sample_v5_in_app_event.csv

Exemplo de registro de dados brutos de evento in-app
Nome do campo valor
WiFi verdadeiro
Anúncio 101548
Conjunto de anúncios 18212447
ID de publicidade 452c96af-7dc8-4d4c-9579-example
ID do aplicativo abc.example
Nome do aplicativo Exemplo: nº 1 Aplicativo de compras online & ofertas
Versão do aplicativo 4.0.11
ID da AppsFlyer 1570515992667-612279933540example
Data/hora do toque atribuído 2019-10-08 10:21.31
Tipo do toque atribuído CLIQUE
Lookback de atribuição 7d
ID do pacote abc.example
Campanha abc_ad_network_9999999
Carrier example-carrier
CIDADE Johannesburg
Modelo de custo CPI
Valor de custo 1900-01-00 07:12.00
Código do país ZA
ID de usuário cliente abc123xyz
Categoria de dispositivo celular
Tempo de Download do Dispositivo 2019-10-07 19:52.23
Tipo do dispositivo vivo-vivo 1727
DMA Nenhum
Nome do evento af_purchase
Receita do evento 100
Moeda da receita do evento ZAR
Receita do evento em USD 13
Fonte do evento SDK
Data/hora do evento 2020-02-23 20:40.17
Valor do evento {"af_content":"[{\"id\":\"99988089\",\"item_price\":100,\"quantity\":2}]",
"af_price":[100],"appsflyer_device_id":"99999992667-279933540example",
"af_order_id":"99998496842","af_receipt_id":"99998496842"
,"af_content_id":"99998089"],"af_content_type":"product",
"af_currency":"ZAR","af_revenue":100"af_description":["00008"],"af_quantity":[1],"af_param_1":"999963"}
Campo valor
Data/hora da instalação 2019-10-08 13:26.41
IP 192.0.2.1.1
É atribuição primária FALSE
Está redirecionando FALSE
language English
Tipo de correspondência id_matching
Fonte de mídia abc_ad_network_int
Operator example-carrier
Versão do SO 9
platform Android
Código postal 8100
Região AF 
Versão do SDK v5.1.1
ID do site abc.example_1099548_35281
Estado GAU
Subparâmetro 1 99999
ID do sub-site 99999
Agente do usuário Dalvik/2.1.0 (Linux; U; Android 9; vivo 1727 Build/PKQ1.190118.001)
Este artigo foi útil?