How can we help?

Pesquisa

Dados agregados da Pull API

  • Atualizado

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 Remarketing*
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
ativado 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
fonte_de_mídia

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

  • Exemplo:media_source=facebook
tipo_de_toque_de_atribuição

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. 
símbolos monetários

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

Caraterística Comentários 
Tipo de token de API necessário AppsFlyerAdmin_us-en.pngToken V2.0
Acesso da ad network Não
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 Os dados agregados de LTV ficam disponíveis por até 25 meses (2 anos + 1 mês)
Dados não orgânicos S
Dados orgânicos S
Limitações de taxa Limitação
Limitações de tamanho
  • A Pull API para dados brutos oferece suporte a até 1 milhão de linhas. A Pull API para dados brutos aceita 1 milhão de linhas.
  • 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. 
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

Relacionado com

This article was translated using AI and may contain errors. For the most accurate information, please refer to the English version using the language selector.

Share article: