API de data de chegada do postback agregado do SKAN

Para:

Profissionais de marketing

Última atualização: 19 de Setembro de 2024 12:50

Visão geral: Postbacks agregados do SKAdNetwork via API. Os dados são agregados usando a data de chegada do postback.

A API retorna postbacks agregados do SKAdNetwork, usando o intervalo da data de chegada do postback.

Nota! A data de chegada do postback é diferente da data de instalação usada no painel e nos relatórios do SKAdNetwork.

Para usar a API de relatório de desempenho agregado do SKAN:

Obtenha o token da API. Um administrador precisa recuperar o token.
Forneça ao seu desenvolvedor o token da API para ser usado no cabeçalho de autenticação.
Dê aos seus desenvolvedores os parâmetros para inserir quando fizerem a chamada da API, conforme descrito na seção que se segue. Os parâmetros determinam no que o relatório se foca, como ele é organizado e fornecem um período de tempo para o relatório.
Peça ao seu desenvolvedor que siga a API de relatório de desempenho agregado do SKAN no hub do desenvolvedor.

Nome do parâmetro	Detalhes	Obrigatório
`start_date`	O intervalo de datas de chegada dos postbacks é delimitado por start_date e end_date. Nota! A data de chegada é diferente da data de instalação usada no painel e nos relatórios do SKAdNetwork. YYYY-MM-DD Data mais antiga permitida: $2020-11-01 Exemplo: `2020-11-05`	Sim
`end_date`	YYYY-MM-DD Número máximo de dias por chamada de relatório: 60 dias Exemplo: `2020-11-12`	Sim
`ad_network_name`	Filtrar por fonte de mídia	Não
`geo`	Filtrar por código de país usando ISO 3166 (alpha-2). Exemplo: `US`, `CN`	Não
`skad_redownload`	Filtrar por `true` ou `false`	Não
`skad_source_app_id`	Filtrar por ID da app de origem	Não
`ad_network_campaign_id`	Filtrar por ID da campanha da rede de publicidade. Nota: Este não é o ID da campanha reportado pelo SKAdNetwork.	Não
`modeled_conversion_values`	Apenas suportado a partir da V2 O valor pode ser tanto como Se `true`, o postback preenche a coluna “contagem” com dados de valor de conversão modelados. Veja o campo disponível para dados modelados Se , o postback apresenta a contagem de valor de conversão com todos os campos disponíveis conforme recebido e listado na estrutura do relatório, sem dados modelados. O valor predefinido é .	Não

A API retorna um ficheiro CSV.

As colunas e métricas disponíveis estão listadas na tabela a seguir.

Exemplos: V1 | V2

Estrutura do relatório agregado do SKAdNetwork
Nome da coluna	Dimensão ou medida	Disponível com o token API V1	Disponível com o token API V2	Disponível com o token API V2 (para SKAN 4)	Disponível apenas com filtro de dados modelados
skad_postback_sequence_index	Agrupar por	N	N	S	S
skad_conversion_value	Agrupar por	S	S	S	S
skad_coarse_conversion_value	Agrupar por	N	N	S	S
skad_ad_network_id Algumas SRNs não partilham o seu ID connosco. Neste caso, o campo fica vazio e o nome da ad_network é preenchido.	Agrupar por	S	S	S	S
ad_network_name Atualmente, na maioria dos casos, este campo fica vazio. Preenchemo-lo no caso das SRNs que não partilham o seu skad_ad_network_id	Agrupar por	S	S	S	S
skad_source_identifier	Agrupar por	N	N	S	S
skad_campaign_id	Agrupar por	S	S	S	S
ad_network_campaign_id	Agrupar por	S	S	S	S
ad_network_campaign_name	Agrupar por	S	S	S	S
ad_network_adset_id	Agrupar por	N	S	S	S
ad_network_adset_name	Agrupar por	N	S	S	S
ad_network_ad_id	Agrupar por	N	S	S	N
ad_network_ad_name	Agrupar por	N	S	S	N
ad_network_creative	Agrupar por	N	N	S	N
ad_network_channel	Agrupar por	N	N	S	N
skad_version	Agrupar por	S	S	S	N
skad_redownload	Agrupar por	S	S	S	N
skad_source_app_id	Agrupar por	S	S	S	N
skad_source_domain	Agrupar por	N	N	S	S
skad_fidelity_type	Agrupar por	N	S	S	N
geo	Agrupar por	S	S	S	N
arrival_date	Agrupar por	S	S	S	S
count	Medida	S	S	S	S

Especificação	Observações
Atualização dos dados	O relatório atualiza-se diariamente. A disponibilidade dos dados está de acordo com a taxa de atualização de dados da SKAdNetwork.
Intervalo de datas	Data mais antiga suportada: 1 de novembro de 2020 Intervalo máximo de consulta: 60 dias
Limite de taxa	Consultas retornam até 200K linhas 60 chamadas por minuto
SRNs	Google Ads: A data de chegada do postback é derivada utilizando a última hora do clique relatada pelo Google.
Acesso à rede de anúncios	Disponível para parceiros de análise se o anunciante conceder permissão.
Acesso à agência	Não disponível
Fuso horário específico do aplicativo	UTC apenas
Moeda específica do aplicativo	Sempre USD
Dados orgânicos	Não disponível com esta API
Dados não orgânicos	Calculados usando postbacks do SKAdNetwork recebidos pela AppsFlyer
Dados históricos	Dados de conversão mais antigos (instalação ou retargeting) suportados: 1 de novembro de 2020
Acesso do utilizador à conta	O token de autorização está disponível para um utilizador administrador no painel de controlo.