Resumo: Utilize esta API para obter relatórios de dados brutos em ficheiros CSV.
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:
Obter o token da API. Um administrador precisa de recuperar o token.
- Forneça ao seu programador o token da API a ser usado no cabeçalho de autenticação.
- 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.
- 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 |
|
até |
Data final. Relativamente a from from
|
origem_de_mídia |
Estabeleça os parâmetros e da seguinte forma:
|
máximo_de_linhas |
Número máximo de linhas devolvidas por uma única chamada de API.
|
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.
|
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 |
fuso_horário |
[Padrão] Os dados são retornados utilizando UTC.
|
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 |
|
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 Protect360
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:
|
para=aaaaa-mm-dd 12:00 Exemplo:
|
Opção A: Segunda chamada de API
Exemplo:
|
de=aaaa-mm-dd 12:00 Exemplo:
|
para=aaaaa-mm-dd Exemplo:
|
Opção B: Segunda chamada API |
de=aaaa-mm-dd 12:00 Exemplo:
|
para=aaaa-mm-dd+1 00:00 +1 = dia seguinte às 00:00 Exemplo:
|
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.
- Liste cada campo apenas uma vez.
- Consulte a lista de campos disponíveis.
- Exemplo:
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 |
|
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 |
|
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 |
|
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 |