Resumo: use essa API para obter relatórios de dados brutos em arquivos CSV.
Dados brutos da Pull API
- A Pull API permite que você obtenha relatórios de dados brutos em arquivos CSV. Saiba mais sobre relatórios de dados brutos
- Filtre pelas opções disponíveis: fonte de mídia, intervalo de datas, nome do evento in-app e geolocalização.
- Os recursos adicionais da Pull API 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 | Registra instalações não orgânicas. O registro é gerado quando um usuário abre o aplicativo pela primeira vez. |
Em tempo real |
| Eventos in-app | Registra os eventos realizados pelos usuários. |
Em tempo real |
| Desinstalações | Registra quando um usuário desinstala o aplicativo. |
Diário |
|
Reinstalações |
Registra os usuários que, após desinstalar o aplicativo, engajam com um canal de mídia de UA e reinstalam o aplicativo durante a janela de reatribuição. | Diário |
Relatórios de dados brutos (orgânicos) | ||
|
Instalações orgânicas |
Registra quando o aplicativo é aberto por um usuário pela primeira vez. |
Contínuo |
|
Eventos orgânicos in-app |
Registra informações sobre os eventos realizados pelos usuários. |
Contínuo |
|
Desinstalações orgânicas |
Registra os usuários que desinstalaram o aplicativo. |
Diário |
|
Reinstalações orgânicas |
Registra os usuários que, após desinstalar o aplicativo, engajam com um canal de mídia de UA e reinstalam o aplicativo durante a janela de reatribuição. | Diário |
Redirecionamento | ||
| Conversões | Registro do usuário que abre o aplicativo depois de se engajar com uma campanha de retargeting. | Em tempo real |
| Eventos in-app | Eventos in-app realizados pelo usuário durante a janela de reengajamento. | Em tempo real |
Receitas de anúncios em dados brutos | ||
|
Receita de anúncios atribuída |
Registra a receita de anúncios dos usuários atribuída a um canal de mídia. | Diário |
| Receita publicitária orgânica | Registra a receita de anúncios dos usuários não atribuída a um canal de mídia. | Diário |
Fraude no Protect360 | ||
| Instalações | Registra instalações identificadas como fraudulentas e, portanto, não atribuídas a nenhum canal de mídia. | Em tempo real |
| Instalações pós-atribuição | Registra eventos in-app de instalações fraudulentas e, portanto, não são atribuídos de forma alguma. | Diário |
| Eventos in-app | Registra eventos in-app identificados como fraudulentos pelo Protect360. | Em tempo real |
| Eventos in-app pós-atribuição | Registra eventos in-app para instalações identificadas como fraudulentas após serem atribuídas a um canal de mídia ou consideradas fraudulentas sem levar em conta a instalação em si. | Diário |
| Cliques | Registra cliques realizados por usuários bloqueados pelo Protect360. | Em tempo real |
| Postbacks de instalação bloqueados | Registra cópias de postbacks enviados para um canal de mídia, resultando em uma instalação bloqueada. | Em tempo real |
| Postbacks | ||
| Postbacks de instalação | Registra eventos de instalação gerados quando um usuário abre o aplicativo pela primeira vez. | Diário |
| Postbacks de eventos in-app | Registra postbacks de eventos in-app enviados ao canal de mídia. | Diário |
| Postbacks de eventos in-app de retargeting | Registra eventos in-app realizados por usuários durante a janela de reengajamento. | Em tempo real |
| Postbacks de conversões de retargeting | Registra eventos in-app realizados por usuários 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 desenvolvedor o token da API para ser usado no header de autenticação.
- Forneça aos seus desenvolvedores os parâmetros que eles devem inserir quando fizerem a chamada da API, conforme indicado nas secções seguintes. Os parâmetros determinam o foco do relatório, como ¬ele está organizado e fornecem um período para o relatório.
- Diga ao seu desenvolvedor para seguir as instruções de dados brutos da Pull API no hub do desenvolvedor.
Parâmetros
| Parâmetro | Descrição |
|---|---|
| início |
|
| to (até) | Data final. Quanto ao from_install time
|
| fonte_de_mídia |
Estabeleça os parâmetros
|
| maximum_rows |
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: |
| reattr |
Defina os dados de atribuição de retargeting.
|
| additional_fields |
Para obter campos adicionais além dos campos padrão. Exemplo: |
| símbolos monetários |
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: você pode definir apenas um filtro de código de país por chamada de API. Exemplo: |
| from_install time |
|
| to_install_time | Data final. Relativo a from_install time
|
| agency | 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:
- from/to: aaaa-mm-dd hh:mm
-
Receitas de anúncios em dados brutos
- Apenas data = desde o início (00:00) da data selecionada
- Data e hora = a partir das 00h, inclusive
- Parâmetro to:
- Apenas data = até ao fim (24h) do dia selecionado
- Data e hora = até, mas sem incluir, a hora apresentada
Exemplo: um proprietário de aplicativo tem 1300K de instalações diárias de todas as fontes. Para superar o limite de linha de 1M, o proprietário do aplicativo divide o dia em duas chamadas URI de 12 horas. Consulte a tabela a seguir para opções.
| Chamada de API | From | to (até) |
|---|---|---|
| Primeira chamada de API |
from=aaaa-mm-dd Exemplo:
|
to=aaaaa-mm-dd 12:00 Exemplo:
|
|
Opção A: Segunda chamada de API
Exemplo:
|
from=aaaa-mm-dd 12:00 Exemplo:
|
to Exemplo:
|
| Opção B: Segunda chamada API |
from=aaaa-mm-dd 12:00 Exemplo:
|
to=aaaa-mm-dd+1 00:00 +1 = dia seguinte às 00:00 Exemplo:
|
| Observação: use a opção A ou B, pois elas têm 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 default.
- Liste cada campo apenas uma vez.
- Consulte a lista de campos disponíveis.
-
Exemplo:
additional_fields=device_download_time,deeplink_url
Campos padrão
| Campos padrão da Pull API |
|---|
| 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 |
| Adset ID |
| 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 (área de mercado designada) |
| IP |
| WiFi |
| Operador |
| Operadora |
| Idioma |
| ID da AppsFlyer |
| ID de publicidade |
| IDFA |
| ID Android |
| Customer User ID |
| IMEI |
| IDFV |
| Plataforma |
| Tipo de dispositivo |
| Versão do sistema operativo |
| Versão do aplicativo |
| Versão do SDK |
| ID da aplicação |
| Nome do aplicativo |
| ID do pacote |
| É retargeting |
| Tipo de conversão de retargeting |
| Lookback de atribuição |
| Janela de reengajamento |
| É atribuição primária |
| User-Agent |
| Referência HTTP |
| URL original |
Informações adicionais
Características e limitações
| Caraterística | Comentários |
|---|---|
| Tipo de token API necessário |
|
| Acesso da ad network | Não |
| Acesso da agência | Sim |
| Transparência da agência | Sim. No entanto, é importante lembrar que se você tanto usar o filtro de agência quanto os filtros de fonte de mídia, os filtros de fonte de mídia não se aplicarão a agências não transparentes. Isso implica que, para agências não transparentes, todos os dados são incluídos, e não apenas aqueles provenientes das fontes de media filtradas. |
| Moeda específica do aplicativo | Sim |
| Fuso horário específico do aplicativo | Sim |
| Atualização de dados |
|
| Dados históricos | Sim. De acordo com as políticas de retenção e limite de taxa. |
| Dados não orgânicos | Sim |
| Dados orgânicos | Sim |
| Limite de taxa |
Limitações da API para dados brutos. |
| Limitações de tamanho |
|
| install_date de e install_date_to | 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 selecionado 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 |
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.