Dados agregados da Pull API

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

Visão geral: use esta Pull API para obter seus relatórios agregados da AppsFlyer em arquivos CSV.

PullAPIAverage_us-en.png

 Procurando por dados brutos da Pull API?

Aprenda tudo aqui.

Dados agregados da Pull API

  • A Pull API permite obter relatórios de dados agregados para aquisição de usuários (UA) e redirecionamento em arquivos CSV.
  • As taxas de atualização dos dados são iguais às do relatório equivalente na página de Exportar Dados e na página de Visão Geral do dashboard. Considere que o custo pode ser atualizado com um atraso de várias horas, dependendo do parceiro que fornece os dados de custo. 
  • Filtrar por opções disponíveis: fonte de mídia e intervalo de datas.
  • Os recursos adicionais da Pull API são:
    • Adicionar tipo de toque de atribuição
    • Selecione o fuso horário 

Relatórios de desempenho agregados disponíveis na Pull API

Categoria  UA Retargeting*
Parceiros (fonte de mídia) ✓ ✓

Parceiros por data

 ✓ ✓

Diariamente

 ✓ ✓

Geolocalização

 ✓ ✓

Relatório de geolocalização por data

 ✓ ✓

* Para relatórios de redirecionamento, adicione &reattr=true ao URI. 

Usando dados agregados da Pull API 

Para usar os dados agregados da Pull API:

  1. AppsFlyerAdmin_us-en.pngObtenha o token da API. Um administrador precisa recuperar o token.
  2. Forneça ao seu desenvolvedor o token de API a ser usado no cabeçalho de autenticação.
  3. Forneça a seus desenvolvedores os parâmetros a serem inseridos quando eles fizerem a chamada de API, conforme descrito na seção a seguir. Os parâmetros determinam o foco do relatório, como ele é organizado e fornecem um cronograma de relatório.
  4. Diga ao seu desenvolvedor para seguir as instruções de dados agregados da Pull API no hub de desenvolvedores.

Parâmetros

Parâmetro Descrição
app_id ID do aplicativo
from (a partir de)
  • O intervalo de datas consiste em um parâmetro frome to. O intervalo é o período de LTV (instalação).
  • Formato: yyyy-mm-dd, 
  • Exemplo: 01-01-2010
to (até) Data final. Quanto a from
media_source

Use para limitar (filtrar) uma fonte de mídia específica.

  • Exemplo:media_source=facebook
attribution_touch_type

Defina este parâmetro como mostrado no exemplo para obter KPIs de atribuição de visualização (VTA). 

Exemplo: attribution_touch_type=impression

Alguns KPIs de VTA, como cliques, impressões e APIs de custo, não têm valores associados a eles e exibem o valor N/A. 
currency

Moeda de receita e custo.

Relatórios agregados de Pull API sempre usam a moeda específica do aplicativo. 
reattr

Obtenha dados de conversões de retargeting.

  • [Padrão] Se falso, as campanhas de dados de aquisição de usuários (UA) serão retornadas.
  • Se verdadeiro, a conversão de retargeting irá retornar.
  • Exemplo:reattr=true
Fuso horário

[Padrão] Os dados retornam usando UTC.

  • Os templates de URIs são preenchidos com o parâmetro de fuso horário definido para o fuso horário específico do aplicativo. 
  • [Padrão] Se o parâmetro não for enviado, os dados retornarão usando UTC.
  • Se você enviar timezone=[Joda-Time], os dados serão retornados usando o fuso horário específico do aplicativo.

Observações sobre a seleção de fusos horários

  • O formato de fuso horário Joda-Time considera o horário de verão.
  • O valor de Joda-Time deve ser idêntico ao valor definido na página de definições do aplicativo. Por exemplo, se o fuso horário definido é o de Paris, o valor do fuso horário na URL da Pull API deve ser timezone=Europe%2fParis.
  • Extrair dados no fuso horário selecionado está disponível somente a partir da data em que a configuração do fuso horário foi feita. Qualquer dado anterior à data da mudança usa UTC como fuso horário. 

Características e limitações

Característica Comentários 
Tipo de token de API necessário AppsFlyerAdmin_us-en.pngToken V2.0
Acesso da ad network N
Acesso das agências S
Transparência da agência S
Moeda específica do aplicativo S
Fuso horário específico do aplicativo S
Custo Os dados de custo são apenas para campanhas de UA; não para retargeting ou campanhas inativas (campanhas sem instalações).
Atualização de dados Contínuo
Dados históricos 5 anos
Dados não orgânicos S
Dados orgânicos S
Limitações de taxa

Limitação
Limitações de tamanho
  • As chamadas de API retornam no máximo 200 mil linhas.
  • Se um relatório tiver exatamente 200 mil linhas, assuma que estão faltando linhas.
  • Faça múltiplas chamadas de API usando os parâmetros from/to que incluem a hora do dia.  

Atenção! A Pull API para dados brutos aceita 1 milhão de linhas. Os relatórios de dados agregados são limitados a 200 mil linhas. 
Alterações de nome da campanha Os relatórios de Pull API não são compatíveis com alterações no nome da campanha

Veja também