Extrair dados brutos da API

Premium

Resumo: Utilize esta API para obter relatórios de dados brutos em ficheiros CSV.

altPullAPIRaw_us-en.pngalt

Extrair dados brutos da API

  • A API Pull permite-lhe obter relatórios de dados brutos em ficheiros CSV. Saiba mais sobre relatórios de dados brutos
  • Filtre pelas opções disponíveis: Fonte de media, intervalo de datas, nome do evento in-app e localização geográfica. 
  • As funcionalidades adicionais na API Pull são:
    • Escolha a moeda
    • Escolha o fuso horário

Relatórios de dados brutos disponíveis através da Pull API

Relatório Descrição Taxa de atualização
Relatórios de dados brutos (não orgânicos)
Instalações Regista instalações não orgânicas. O registo é feito quando um utilizador abre a aplicação pela primeira vez.
Em tempo real
Eventos in-app Regista os eventos realizados pelos utilizadores.
Em tempo real
Desinstalações Regista quando um utilizador desinstala a aplicação.
Diário
Reinstalações
Regista os utilizadores que, após desinstalarem a aplicação, interagem com uma fonte de media UA e reinstalam a aplicação durante a janela de reatribuição. Em tempo real
Relatórios de dados brutos (orgânicos)
Instalações orgânicas
Regista quando a aplicação é aberta por um utilizador pela primeira vez.
Contínuo
Eventos orgânicos in-app
Regista detalhes sobre os eventos realizados pelos utilizadores.
Contínuo
Desinstalações orgânicas
Regista a desinstalação da aplicação pelos utilizadores.
Diário
Reinstalações orgânicas
Regista a receita de anúncios de utilizadores atribuídos a uma fonte de media de retargeting durante a janela de reengajamento.
Diário
Retargeting
Conversões Registo de um utilizador a abrir a aplicação após interagir com uma campanha de retargeting. Em tempo real
Eventos in-app Eventos in-app realizados pelo utilizador durante a janela de reengajamento. Em tempo real
Receitas de anúncios em dados brutos
Receita de publicidade atribuída
Regista a receita de anúncios para utilizadores atribuídos a uma fonte de media. Diário
Receita de publicidade orgânica Regista a receita de anúncios para utilizadores não atribuídos a nenhuma fonte de media. Diário
Fraude Protect360
Instalações Regista instalações identificadas como fraudulentas e que não são atribuídas a qualquer fonte de media. Em tempo real
Instalações pós-atribuição Regista eventos in-app de instalações fraudulentas, que não são atribuídas. Em tempo real
Eventos in-app Regista os eventos in-app identificados como fraudulentos pelo Protect360. Diário
Eventos in-app pós-atribuição Regista eventos in-app para instalações identificadas como fraudulentas após serem atribuídas a uma fonte de media ou consideradas fraudulentas independentemente da instalação. Diário
Cliques Regista cliques realizados por utilizadores bloqueados pelo Protect360. Diário
Postbacks de instalação bloqueados Regista cópias de postbacks enviadas para uma fonte de media, resultando numa instalação bloqueada. Em tempo real
Postbacks
Postbacks de instalação Regista eventos de instalação gerados quando um utilizador abre a aplicação pela primeira vez. Diário
Postbacks de eventos in-app Regista postbacks de eventos in-app enviados para a fonte de media. Diário
Postbacks de eventos in-app de retargeting Regista eventos in-app que os utilizadores realizaram durante a janela de reengajamento. Em tempo real
Postbacks de conversões de retargeting Regista eventos in-app que os utilizadores realizaram durante a janela de reengajamento. Em tempo real

Utilização de dados brutos da API Pull

Para utilizar dados brutos da API Pull:

  1. AppsFlyerAdmin_us-en.pngObter o token da API. Um administrador precisa de recuperar o token.
  2. Forneça ao seu programador o token da API a ser usado no cabeçalho de autenticação.
  3. Forneça aos seus programadores os parâmetros a inserir quando fizerem a chamada da API, conforme indicado nas secções seguintes. Os parâmetros determinam o foco do relatório, como está organizado e fornecem um período para o relatório.
  4. Peça ao seu programador para seguir as instruções de dados brutos da API Pull no hub do programador.

Parâmetros

Parâmetro Descrição
desde
  • O intervalo de datas é composto pelos parâmetros e . As datas estão relacionadas com a data da atividade.
  • Formato: , ou Nota: O espaço precisa de ser codificado como aqui mostrado from=2020-04-01%2001:00:00 - Em geral, os browsers codificarão o espaço.
  • Exemplo: 01-01-2010 ou 01-01-2010 20:15 (Com parâmetros de horas e minutos disponíveis para relatórios de dados brutos).
até Data final. Relativamente a fromfrom

origem_de_mídia

media_source: Para restringir (filtrar) a chamada a uma origem de mídia específica.

Estabeleça os parâmetros e da seguinte forma:

  • Para anúncios Meta, defina a categoria e a origem de mídia como facebook
  • Para anúncios X, defina a categoria e a origem de mídia como twitter
  • Para todas as outras origens de mídia, defina a categoria como padrão e a origem de mídia como o nome da origem.
  • Exemplos
máximo_de_linhas

Número máximo de linhas devolvidas por uma única chamada de API.

  • [Padrão] Se não for enviado nenhum valor, até 200 mil linhas
  • 200.000: Até 200 mil linhas retornadas
  • 1.000.000: Até 1 milhão de linhas retornadas
  • Exemplo: permite até 1 milhão de linhas.
nome_do_evento

Filtre eventos in-app por eventos específicos. Selecione vários eventos utilizando uma lista separada por vírgulas.

Exemplo:  

reatribuição

Defina os dados de atribuição de retargeting.

  • [Padrão] Se for falso, devolve campanhas de aquisição de utilizadores (UA).
  • Se for verdadeiro, serão devolvidos dados de atribuição de retargeting.
  • Exemplo:
campos_adicionais

Para obter campos adicionais além dos campos padrão.

Exemplo:

moeda

Moeda de receita e custo

Exemplo: Se a moeda específica do aplicativo for EUR, ao enviar currency=preferredos valores serão devolvidos em EUR.

fuso_horário

[Padrão] Os dados são retornados utilizando UTC.

  •  timezone=[Numerical value]
  • Exemplo: Para o fuso horário UTC+10:00, utilize Nota: O , e : precisam ser codificados. Exemplo: +10:00 é codificado para %2B10%3A00
geo

Filtre os dados por código de país.

Limitação: Pode definir apenas um filtro de código de país por chamada de API.

Exemplo:

hora_de_instalação
  • O intervalo de datas é composto pelos parâmetros e . As datas estão relacionadas com a data da atividade.
  • Formato:
  • Exemplo: 01-01-2010
hora_de_início_de_instalação

Data final. Relativamente a

agência

Para restringir (filtrar) a chamada a uma agência específica.

Campos de intervalo de tempo

Se os resultados da API excederem o máximo, divida o relatório com base em horas e minutos. Aplique o seguinte:

  • de/para: aaaa-mm-dd hh:mm
  • de:
    • Apenas data = desde o início (00:00) da data selecionada
    • Data e hora = a partir das 00h, inclusive
  • Parâmetro para:
    • Apenas data = até ao fim (24h) do dia selecionado
    • Data e hora = até, mas sem incluir, a hora apresentada

Exemplo: Um proprietário de aplicação tem 1.300 mil instalações diárias de todas as fontes. Para contornar o limite de 1 milhão de linhas, o proprietário da aplicação divide o dia em duas chamadas URI de 12 horas. Consulte a tabela a seguir para opções. 

Chamada de API De  Para 
Primeira chamada de API

de=aaaa-mm-dd

Exemplo:

  • de=
  • Inicia nesta data no começo do dia às 00:00

para=aaaaa-mm-dd 12:00

Exemplo:

  • para=
  • Continua até às 11:59:59, e não às 12:00

Opção A: Segunda chamada de API 

 

Exemplo:

  • Inicia ao meio-dia de 29 de dezembro de 2019
  • Termina à meia-noite de 29 de dezembro de 2019
 

de=aaaa-mm-dd 12:00

Exemplo:

  • de=
  • Começa a partir das 12:00, inclusive

para=aaaaa-mm-dd

Exemplo:

  • para=
  • Termina à meia-noite

Opção B: Segunda chamada API

de=aaaa-mm-dd 12:00

Exemplo:

  • de=
  • Começa a partir das 12:00, inclusive

para=aaaa-mm-dd+1 00:00

+1 = dia seguinte às 00:00

Exemplo:

  • para=
  • Significa antes de qualquer tempo ter decorrido em 30 de dezembro.

Nota: Utilize a opção A ou B, pois produzem os mesmos resultados.

Campos adicionais

Os campos adicionais do relatório não são incluídos na lista padrão de campos para evitar que novos campos afetem os seus processos atuais de importação e ingestão. Utilize o parâmetro additional_fields para obter campos que não são padrão.

Campos padrão

Campos padrão da API Pull
Tipo de toque atribuído
Tempo de toque atribuído
Tempo de instalação
Hora do evento
Nome do evento
Valor do evento
Receita do evento
Moeda da receita do evento
Receita do evento em USD
Fonte do evento
Recibo validado
Parceiro
Fonte de mídia
Canal
Palavras-chave
Campanha
ID da campanha
Conjunto de anúncios
ID do conjunto de anúncios
Anúncio
ID do anúncio
Tipo de anúncio
ID do site
ID do subsite
Subparâmetro 1
Subparâmetro 2
Subparâmetro 3
Subparâmetro 4
Subparâmetro 5
Modelo de custo
Valor de custo
Moeda de custo
Colaborador 1 Parceiro
Fonte de mídia do Colaborador 1
Campanha do Colaborador 1
Tipo de toque do Colaborador 1
Tempo de toque do Colaborador 1
Colaborador 2 Parceiro
Fonte de mídia do Colaborador 2
Campanha do Colaborador 2
Tipo de toque do Colaborador 2
Tempo de toque do Colaborador 2
Colaborador 3 Parceiro
Fonte de mídia do Colaborador 3
Campanha do Colaborador 3
Tipo de toque do Colaborador 3
Tempo de toque do Colaborador 3
Região
Código do país
Estado
Cidade
Código postal
DMA
IP
WIFI
Operador
Operadora
Idioma
ID da AppsFlyer
ID de publicidade
IDFA
ID Android
ID de utilizador do cliente
IMEI
IDFV
Plataforma
Tipo de dispositivo
Versão do sistema operativo
Versão da aplicação
Versão do SDK
ID da aplicação
Nome da aplicação
ID do pacote
É retargeting
Tipo de conversão de retargeting
Lookback de atribuição
Janela de reengajamento
É atribuição primária
User-Agent
Referenciador HTTP
URL original

Informações adicionais

Características e limitações

Característica Comentários 
Tipo de token API necessário AppsFlyerAdmin_us-en.pngToken V2.0
Acesso à rede de anúncios Não
Acesso de agência Sim
Transparência da agência Sim. Contudo, note que, se utilizar tanto o filtro da agência como os filtros de origem de média, os filtros de origem de média não se aplicam a agências não transparentes. Isto significa que, para agências não transparentes, todos os dados são incluídos; não apenas os dados das fontes de média filtradas.
Moeda específica da aplicação Sim
Fuso horário específico da aplicação Sim
Atualização de dados
  • Equivalente à disponibilidade dos dados no painel de visão geral.
  • Relatórios atualizados com um atraso de algumas horas:
    • Eventos in-app orgânicos
  • Relatórios atualizados diariamente:
    • Desinstalações
    • Eventos in-app pós-atribuição
    • Receita publicitária
Dados históricos Sim.  De acordo com as políticas de retenção e limitação de taxa
Dados não orgânicos Sim
Dados orgânicos Sim
Limitação de taxa

Limitações da API para dados brutos

Limitações de tamanho
  • As chamadas API devolvem um máximo de 200K/1M linhas.
  • Se um relatório tiver exatamente 200K/1M linhas, presuma que faltam linhas.
  • Use o parâmetro maximum_rows para selecionar o número máximo de linhas.
  • Faça várias chamadas à API utilizando parâmetros de/para que incluam a hora do dia.
Data_de_instalação de e data_de_instalação até O intervalo de datas de instalação deve ser anterior ao intervalo de datas de atividades. 

Resolução de problemas

Sintoma/mensagem Solução
O relatório não contém os dados esperados de acordo com o intervalo de tempo seleccionado ou há uma discrepância entre o relatório de dados brutos e o relatório de dados agregados. 

Verifique se configurou o parâmetro timezone. Caso contrário, os dados são enviados usando UTC e não o fuso horário da sua aplicação.