Visão geral: Desempenho do SKAN enriquecido com pontos de dados adicionais. Semelhante aos dados no painel do SKAdNetwork. Agregue usando a data de instalação ou a data de chegada do postback.
Relatório de performance agregada da SKAN
A API retorna métricas de atribuição relatadas pela Apple SKAdNetwork (dados reais) e outros pontos de dados usando a data de chegada de instalação ou postback. O relatório é semelhante em estrutura aos dados apresentados noPainel da SKAN.
Usar a API de relatório de desempenho agregado do SKAN
Para usar a API de relatório de desempenho agregado do SKAN:
- Obtenha o token da API. Um administrador precisa obter o token.
- Forneça ao seu desenvolvedor o token de API a ser usado no cabeçalho de autenticação.
- 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.
- Diga ao seu desenvolvedor para seguir a API de relatório de desempenho agregado do SKAN no hub do desenvolvedor.
Parâmetros
| Nome do parâmetro | Formato | Obrigatoriedade |
|---|---|---|
|
|
O tipo de data usado no intervalo de datas delimitado por Opções:
Dados do Google Ads: As datas de instalação e chegada são as mesmas devido à metodologia de relatórios do Google Ads. |
Não |
|
|
O intervalo de datas de instalação é limitado por start_date e end_date. Atenção! A data de instalação é diferente da data de chegada do postback.
|
Sim |
end_date |
|
Sim |
view_type |
Filtre as instalações por tipo da seguinte maneira:
|
Não |
modeled_conversion_values |
|
Não |
Estrutura e exemplo do relatório
A API retorna um arquivo CSV.
- Os campos e métricas disponíveis no relatório estão listados na tabela a seguir.
- Algumas métricas (receita, engajamento, conversão) dependem da SKAN configurações de mensuração de desempenho.
- O relatório inclui apenas os eventos in-app que os usuários realizaram durante o período do relatório. Dessa forma, o número e a sequência de colunas de eventos in-app podem mudar de relatório para relatório. Não confie na sequência de colunas ao projetar seu processo de importação de dados.
- Exemplos: V1 | V2
Campos do relatório
| Nome do campo | Dimensão ou métrica | Disponível com token API V1 | Disponível com token API V2 |
Disponível com token API V2 (para SKAN 4) |
Disponível com filtro somente de dados modelados |
|---|---|---|---|---|---|
|
Data Os dados estão de acordo com o date_type selecionado. |
Dimensão | N | S | S | S |
| Fonte de mídia (pid) | Dimensão | S | S | S | S |
| Campanha (c) |
Dimensão |
S |
S |
S |
S |
| ID da campanha | Dimensão | S | S | S | S |
| ID do site | Dimensão | S | S | S | N |
| Conjunto de anúncios | Dimensão | N | S | S | S |
| ID do conjunto de anúncios | Dimensão | N | S | S | S |
| Anúncio | Dimensão | N | S | S | N |
| ID do anúncio | Dimensão | N | S | S | N |
| País | Dimensão | S | S | S | N |
|
Sinalizador de atribuição AF Veja: Guia SSOT |
Dimensão | N | S | S | S |
|
Índice de sequência de postback |
Dimensão | N | N | S | S |
|
Criativo |
Dimensão | N | N | S | N |
|
Canal |
Dimensão | N | N | S | N |
| Impressões | Métrica | S | S | S | S |
| Cliques | Métrica | S | S | S | S |
| CTR | Métrica | S | S | S | S |
| Instalações | Métrica | S | S | S | S |
|
Clique nas instalações (fidelity_type = 1) |
Métrica | S | S | S | S |
|
Instalações de visualização (fidelity_type = 0) |
Métrica | S | S | S | S |
|
Taxa de valor de conversão nula [Disponível a partir de 23 de janeiro de 2022] |
Métrica | N | S | S | S |
| Taxa de conversão | Métrica | S | S | S | S |
| Usuários convertidos | Métrica | S | S | S | S |
| Usuários convertidos/Instalações | Métrica | S | S | S | S |
| Receita total | Métrica de receita | S | S | S | S |
| Custo total | Métrica | S | S | S | S |
| ROI | Métrica de receita | S | S | S | S |
| ARPU | Métrica de receita | S | S | S | S |
| eCPI médio | Métrica | S | S | S | S |
| {af_skad_revenue} (Usuários únicos) | Métrica de receita | S | S | S | S |
| {af_skad_revenue} (Contador de eventos) | Métrica de receita | S | S | S | S |
|
{nome do seu evento in-app} (Usuários únicos) |
Métrica | S | S | S | S |
| {nome do seu evento in-app} (Contador de eventos) | Métrica | S | S | S | S |
Especificações e limitações
| Especificações | Observações |
|---|---|
| Atualização dos dados | A disponibilidade de dados está de acordo com a taxa de atualização de dados do SKAN. |
| Período |
|
| Limites de taxa |
|
| SRNs |
|
| Acesso da ad network | Se você for um parceiro de análise, peça permissão ao anunciante. |
| Acesso de agência | Não disponível |
| Fuso horário específico do aplicativo | Somente UTC |
| Moeda específica do aplicativo | Sempre USD |
| Dados orgânicos | Calculado como a diferença entre todos os dados relatados pelo SDK diretamente à AppsFlyer menos os dados não orgânicos relatados pelos postbacks da SKAN |
| Dados não-orgânicos | Calculado usando postbacks da SKAN recebidos pela AppsFlyer |
| Histórico de dados | Dados de conversão mais antigos aceitos (instalação ou retarget): 1 de novembro de 2020 |
| Acesso do usuário da conta | O token de autorização está disponível para um usuário administrador no painel. |
| Custo total | A API SKAN pode não incluir a métrica de custo total se a atribuição regular (visão geral regular) contiver campanhas do SKAN que, no nível de granularidade mais baixo (por exemplo: anúncio, país ou ID do site) tenham mais de 50 mil linhas. |