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 fromfrom
|
|
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 |