Guia para a solução SKAdNetwork (SKAN)

Resumo: como atribuir instalações de aplicativos usando a SkadNetwork. 

5754

SKAN

A SKAdNetwork (SKAN), parte do iOS da Apple, ajuda os anunciantes a mensurar a performance da campanha, ao mesmo tempo em que mantém a privacidade do usuário. A SKAN funciona sem o IDFA ou outro ID de anúncio. A SKAN funciona sem a necessidade de consentimento à ATT.  

Dica

Configurações

  • SDK: versão atual do SDK da AppsFlyer para iOS integrada em um aplicativo.
  • Janela de mensuração da SKAN: relevante para SKAN 4+. Existem 3 períodos de tempo (janelas) durante os quais a atividade pós-instalação do usuário é mensurada:
    • Janela 1: 1-2 dias
    • Janela 2: 3-7 dias
    • Janela 3: 8-35 dias
  • Valor de Conversão (CV): a medida da qualidade do usuário relatada nos postbacks enviados pelo iOS no final das janelas de mensuração da SKAN 4 ou, para SKAN 3 e versões anteriores, no final da Janela de Atividade. O SDK da AppsFlyer define os CVs para você. No entanto, se você quiser definir o CV, use a opção Decode para carregar o arquivo de mapeamento do CV.
    • Para SKAN 4+, existem valores de conversão totais e parciais.
  • Conversion Studio: solução da AppsFlyer para mapear valores de conversão (CV) de infraestrutura para eventos
  • Solução: SDK, Infraestrutura, Conversion Studio e plataforma da AppsFlyer, trabalhando juntas. A solução oferece aos anunciantes e ad networks dados de LTV por meio de análises de dashboard, relatórios e postbacks.  
  • Janela de atividade: relevante para SKAN 3 e versões anteriores. Tem duração definida, padrão de 24 horas, a partir da primeira abertura do app. Se você estiver usando a SKAN 4+, mas os dispositivos do usuário ou as ad networks ainda não oferecem suporte para a SKAN 4, a janela de atividade é de 48 horas. 

Este artigo descreve as características relevantes da infraestrutura e da solução. Para configurar a mensuração, consulte SKAN Conversion Studio.

Sobre a SKAN da Apple

Características Descrição
Pré-requisitos

Para habilitar o uso da SKAN no aplicativo:

*Atenção: Certifique-se de não ter outro SDK que defina valores de conversão em seu aplicativo.

Compatível
  • A versão da SKAdNetwork que é compatível depende da versão do iOS:
    • iOS 11-13: V1 (somente instalações sem valores de conversão)
    • iOS 14-14.5: V2+ (com valores de conversão)
    • iOS 14.6-16: V3 (com valores de conversão)
    • iOS 16.1+: V4+ (com valores de conversão para 3 janelas e valores totais e parciais)
  • Atribuição de aplicativo para aplicativo
Limitações
  • Apple Search Ads não é compatível
  • Web mobile não compatível
  • Até a SKAN 4, a numeração dos IDs de campanha estava restrita ao intervalo 1-100; isso significa 100 valores exclusivos por ad network por aplicativo.  As ad networks fornecem à AppsFlyer o ID e o nome da campanha. Isso se reflete nos dashboards e relatórios da AppsFlyer.
  • A partir da SKAN 4, o source identifier é de 1 a 10.000.  
  • Instalações orgânicas: a SKAN não é compatível com instalações orgânicas.
  • Reengajamento.
Princípios de atribuição da SKAN
  •   A SKAN faz a atribuição seguindo o seguinte modelo:  
    • O usuário clica em um anúncio, em 30 dias instala (faz download) o aplicativo e, a partir de então, em 60 dias abre o aplicativo pela primeira vez.  
    • O usuário visualiza um anúncio, em 24 horas instala (faz download) o aplicativo e, posteriormente, em 60 dias, abre o aplicativo pela primeira vez.  
    • A partir da versão 2.2 da SKAdNetwork, a atribuição de cliques tem prioridade sobre a atribuição de view-through. A versão SKAN depende da versão do iOS.
    • O iOS envia postbacks para a ad network atribuída. A partir do iOS 15, os anunciantes podem enviar uma cópia do postback diretamente para a AppsFlyer.  
Crowd anonymity A Apple envia alguns postbacks com dados limitados para proteger a privacidade do usuário. De acordo com a Apple, o postback não incluirá os CVs totais ou parciais, nem o source app ID ou o identificador completo da origem se isso violar os limites de privacidade da Apple. Saiba mais

Solução para SKAN da AppsFlyer

A AppsFlyer fornece resultados agregados de atribuição do iOS usando postbacks da SKAN. Esses postbacks são enviados pelo iOS para ad networks, que os encaminham para a AppsFlyer. Os postbacks contêm registros de atribuição anônimos enriquecidos com um valor de conversão (CV) definido pelo anunciante. O CV é uma medida da qualidade do usuário durante uma janela inicial de pós-instalação.

A solução da AppsFlyer para SKAN fornece aos anunciantes:

  • Dados da SKAN em dashboards e relatórios obtidos a partir da agregação de postbacks de todas as ad networks enriquecidas com outros pontos de dados, como custo.  
  • A capacidade de controlar, por meio do Conversion Studio, o que o CV mensura sem a necessidade de fazer alterações no código do aplicativo. O CV pode ser usado para mensurar receita, engajamentos ou eventos de conversão.
    Atenção: Apenas o SDK da AppsFlyer deve ter a capacidade de definir valores de conversão. Certifique-se de não ter outro SDK que defina valores de conversão em seu aplicativo.

Princípios e fluxo


Fluxo de atribuição da SKAN

SKAN_flow_-_Affinity_diagram_2.png

  1. O anunciante define as configurações de mensuração da SKAN no Conversion Studio da AppsFlyer.
  2. O usuário abre o aplicativo pela primeira vez.  
  3. Durante cada janela, a AppsFlyer define o CV com base nas ações do usuário e no esquema de valores de conversão configurado.  
  4. Depois que a janela fecha, o iOS envia o postback para a ad network e uma cópia do postback para a AppsFlyer. O postback chega com algum atraso:
    • 1ª janela de mensuração da SKAN 4: 24-48 horas
    • 2ª e 3ª janelas de mensuração da SKAN 4 24-144 horas
    • Para SKAN 3: 24-48 horas após o aumento mais recente no CV.
  5. As cópias de postback enviadas diretamente do dispositivo iOS para a AppsFlyer são reencaminhadas para o endpoint definido pelo anunciante. Consulte enviar cópias de postback do SKAN para a AppsFlyer.
  6. A ad network encaminha um postback enriquecido para a AppsFlyer ou a SRN comunica dados de postback por API.  
  7. A AppsFlyer valida e descodifica o CV. Os dados descodificados são registados e atribuídos antes de serem disponibilizados na AppsFlyer através de dashboards, relatórios e APIs.

Para superar as limitações funcionais e estruturais da infraestrutura da SKAdNetwork, a solução leva em consideração as características da tabela a seguir.

Características Descrição
Coleta de dados
  • Para o anunciante, os postbacks de SKAdNetwork são coletados de várias ad networks.
  • Os anunciantes não precisam fazer a integração individualmente com cada ad network — uma tarefa complexa e chata.
Validação de dados
  • Garante que os postbacks sejam assinados pela Apple. Isso reduz as chances de manipulação de postbacks.
  • Usa o campo transaction ID para validar se os postbacks são exclusivos.
Enriquecimento de dados
  • Enriquece os dados de postback de SKAdNetwork com outros pontos de dados para oferecer uma análise completa do ROI. Por exemplo, o nome da campanha fornecido pela ad network e assim por diante. 
  • Os pontos de dados incluem impressões, cliques, custos, entre outros.
Entrega de dados Os dados enriquecidos da SKAdNetwork ficam disponíveis da seguinte forma: 
Integração direta
  • O encapsulamento total permite um esforço quase nulo da parte do anunciante através da página de configurações do aplicativo.
  • Não é necessária programação. O aplicativo requer a versão mais recente do SDK. 
  • Inclui suporte para alterações esperadas a serem feitas pela Apple na infraestrutura SKAdNetwork.
Agilidade  Os anunciantes podem alterar as configurações de mensuração conforme necessário no dashboard.

Conversion Studio

O Conversion Studio da AppsFlyer é o centro da nossa solução para SKAN. Ele fornece flexibilidade máxima para fazer com que cada bit de um valor de conversão seja útil. Você determina com precisão quais dados de mensuração devem ser codificados no CV - incluindo qual atividade e por quanto tempo mensurar durante o período pós-instalação. Existem vários modos de mensuração que você pode usar para definir suas configurações de CV.

Tipo Modo de mensuração Descrição Janela de atividade
Flexível

SKAN 4.0

[Melhores práticas]

Defina uma combinação de mensurações de receita, conversão (eventos in-app) e engajamento durante 3 janelas de mensuração configuráveis.
  • Janela 1: 1-2 dias
  • Janela 2: 3-7 dias
  • Janela 3: 8-35 dias
Flexível Personalizado Defina uma combinação de mensurações de receita, conversão (eventos in-app) e métricas de engajamento durante uma janela de atividade configurável. 12h-63 dias
Fixo

Receita

[Default]

[Legacy]

Mensure a receita usando um dos seguintes intervalos:  
  • $1-$630 em incrementos de $10
  • $1-$63 em incrementos de $1
  • $0,01-$0,63 em incrementos de $0,01
24 h
Fixo

Conversão

[Legacy]

Selecione de 1 a 6 eventos in-app 24 h
Fixo

Engajamento

[Legacy]

Número de vezes que um usuário realiza um evento 24 h
Flexível Decode
  • Crie o seu próprio mapeamento de eventos para CVs e configure-o manualmente no seu app. Use essa opção se não for possível integrar o SDK da AppsFlyer ao seu aplicativo. Para usar o Decode, vá para o SKAN Conversion Studio, clique nas opções (⋮), selecione Enviar arquivo de mapeamento de decodificação personalizado. 
12-1512h (63 dias)

Informações adicionais sobre a SKAdNetwork

Opções de relatórios

Os relatórios da SKAdNetwork não contêm identificadores a nível de usuário. 

Nome do relatório  Tipo Enriquecido pela AppsFlyer Método de entrega Funcionalidade premium

Relatório de performance agregada da SKAN.

Agregados de instalação, eventos in-app e receita. Os dados são semelhantes aos encontrados no dashboard da SKAN. 

Agregado usando a data de chegada da instalação ou do postback Sim API  Não

Relatório de postback agregado da SKAN.

Postbacks agregados da SKAN, no nível mais granular possível.

Agregação de postback usando a data de chegada do postback Não API  Não

Relatórios de dados brutos da SKAN (a nível de linha) via Data Locker (com exemplos).

Relatórios disponíveis:

  • Postbacks enviados pelo iOS com enriquecimento de dados fornecidos por parceiros de ad network
  • Instalações
  • Re-downloads
  • Eventos in-app
  • Dimensões de anúncios em SRNs 
  Sim Data Locker Sim. Dados brutos necessários. A assinatura do Data Locker não é obrigatória.
Dados da SKAN via Push API   Sim Push API Sim

Checklist da implementação da solução para SKAdNetwork

Não. Ação Descrição Responsabilidade
1 Preparar Profissional de marketing, desenvolvedor
2 Configurar  Na AppsFlyer, configure a solução SKAdNetwork no SKAN Conversion Studio. Profissional de marketing
3 Preparar o aplicativo Migre o aplicativo para o SDK V6 da AppsFlyer.
  • Nenhuma alteração na lógica do aplicativo ou no código do aplicativo é necessária.
  • A solução depende de eventos in-app para definir o CV. Envie eventos in-app da maneira usual. Nenhum teste específico da solução é necessário. 
  • Enviar o aplicativo para a App Store
  • Nenhum cadastro ou processo da SKAdNetwork é necessário na app store.
Desenvolvedor
4 Integrações com parceiros 

Os parceiros de ad networks devem se integrar com a AppsFlyer usando a integração de SKAdNetwork. Atenção! A simulação da SKAdNetwork da AppsFlyer contém os dados de todos os seus parceiros, independentemente do status atual de integração.   Esse não será o caso dos live data relatados por postbacks da SKAdNetwork.
 

Em relação aos parceiros que executam suas campanhas, faça o seguinte, conforme necessário:  

Não-SRNs:

  1. Verifique se o parceiro tem um sinalizador de aptidão da SKAdNetwork da AppsFlyer e se, na interface de usuário do parceiro, o relatório da campanha SKAdNetwork está habilitado.
  2. Verifique se seus nomes de eventos in-app estão mapeados para parceiros de nomes de eventos in-app. 

Meta ads:

Profissional de marketing

Solução de problemas

Sintoma Descrição
O dashboard não contém instalações não-orgânicas.
  1. Verifique se a mensuração de SKAdNetwork está ativa.
    1. Acesse configurações > Conversion Studio da SKAN. 
    2. Clique nas opções (⋮)avalie a configuração de mensuração da SKAN.  
  2. Verifique se a versão do seu SDK é 6.2.6+.
    • Para isso, acesse Integração > Informações do SDK > Usuários por versão do SDK. 
  3. Se estiver usando plug-ins do SDK, verifique se você implementou uma versão compatível com o SKAdNetwork da AppsFlyer. 
  4. Verifique se seus parceiros de ad networks estão integrados à AppsFlyer e se eles encaminham postbacks do iOS para a AppsFlyer.
O dashboard contém instalações não-orgânicas, mas nenhum evento in-app.
  1. Verifique se a versão do seu SDK é 6.2.6+.
    • Para isso, acesse Integração > Informações do SDK > Usuários por versão do SDK. 
  2. Se estiver usando plug-ins do SDK, verifique se você implementou uma versão compatível com o SKAdNetwork da AppsFlyer.
  3. Você envia eventos usando S2S? Se sim, verifique se a opção Gravar eventos dentro da aplicação enviados pela server-to-server API está ativa. 
    1. Acesse configurações > Conversion Studio da SKAN. 
    2. Clique nas opções (⋮) e confirme se a configuração S2S está ativa. Atenção: No modo de mensuração Personalizado e Decode, essa configuração está sempre ativa e não pode ser alterada. 
O dashboard contém instalações e alguns eventos in-app. Alguns eventos in-app estão faltando.
  1. Você envia eventos usando S2S? Se sim, verifique se a opção Gravar eventos dentro da aplicação enviados pela server-to-server API está ativa. 
    1. Acesse configurações > Conversion Studio da SKAN. 
    2. Clique nas opções (⋮) e confirme se a configuração S2S está ativa. Atenção: No modo de mensuração Personalizado e Decode, essa configuração está sempre ativa e não pode ser alterada. 
  2. Verifique seus dados brutos de postback para ver se todos os eventos são relatados.  
As localizações geográficas (países) são confusas Os dados de geolocalização são obtidos da seguinte forma:
  • De acordo com o país associado a uma campanha e conforme foi relatado à AppsFlyer pela ad network.
  • Usando o endereço de IP do dispositivo. A partir do iOS 14.6, esse endereço é um endereço proxy e não representa realmente a geolocalização do usuário.  

Tempo desde a instalação do aplicativo até a atualização do dashboard e dos relatórios

Chave Nome do elemento Descrição Exemplo A  Exemplo B  Exemplo C Exemplo D Exemplo E
A 1ª janela de mensuração da SKAN 4
  • Durante a janela, os CVs são definidos pelo aplicativo
  • 0-2 dias
  • A janela pode ser bloqueada antes de chegar a 2 dias no Conversion Studio
- - 2 dias - -
B 2ª janela de mensuração da SKAN 4
  • Durante a janela, o CV é definido pelo aplicativo
  • 3-7 dias
  • A janela pode ser bloqueada antes de chegar a 7 dias no Conversion Studio
- - - 7 dias -
C 3ª janela de mensuração da SKAN 4
  • Durante a janela, o CV é definido pelo aplicativo
  • 8-35 dias
  • A janela pode ser bloqueada antes de chegar a 35 dias no Conversion Studio
- -   - 35 dias
D Atraso no postback da 1ª janela de mensuração da SKAN 4 24-48 horas - - 24-48 h - -
E Atraso na 2ª e 3ª janelas de mensuração da SKAN 4 24-144 horas - - - 24-144 h 24-144 h
F

Janela de atividade

(Não é relevante para a SKAN 4)

  • Durante a janela, o CV é definido pelo aplicativo. 
  • A janela começa quando o aplicativo é aberto pela primeira vez.
  • Duração 12 horas - 63 dias.
24 h 72 h - - -
G

Timer da SKAdNetwork

(Não é relevante para a SKAN 4)

  • Timer de contagem regressiva: 24 horas
  • A cada vez que o CV aumenta, o timer é reiniciado. Ou seja, a contagem recomeça a partir de 24 horas.
0-24 h 0-24 h - - -
H

Atraso aleatório da SKAdNetwork

(Não é relevante para a SKAN 4)

Tempo de atraso aleatório de postback. A contagem regressiva começa no final do período definido por F+G. 0-24 h 0-24 h - - -
I Processamento pela AppsFlyer Postbacks recebidos em um determinado dia são processados no final do dia a partir das 00:01 no dia seguinte. Os dados ficam disponíveis 8 horas depois. Isso significa que o processamento leva de 8 a 32 horas. Atraso médio de 20 horas. Por exemplo, um postback recebido na segunda-feira é processado na terça-feira. O dashboard é atualizado até às 08:00 UTC.  8-32h 8-32h 8-32h 8-32h 8-32h
J Resumo O tempo total que pode decorrer  32 horas-104h 80-152h 80-128 horas 200-344h 872-1016h

Métricas orgânicas no contexto da SKAdNetwork

As métricas orgânicas no dashboard da SKAdNetwork são calculadas usando o seguinte mecanismo:

  • A receita orgânica está disponível apenas para receita no modo fixo ou legado.
  • Eventos orgânicos no aplicativo estão disponíveis apenas para "conversão" no modo fixo ou legado.
  • Para os modos não legados (SKAN 4, personalizado e encode), os dados orgânicos estão disponíveis apenas para instalações.
  • A SKAdNetwork da Apple envia postbacks relacionados aos usuários que instalam depois de engajar com uma fonte de mídia. Isso oferece as métricas não orgânicas. 
  • Os dashboards tradicionais da AppsFlyer contêm métricas de todas as instalações, independentemente da fonte.    Veja a atribuição da AppsFlyer lado a lado com a atribuição SKAN.
  • Usando esses dados, as métricas orgânicas são calculadas como A-B, onde:  
    • A = Total de todos os usuários com base no dashboard de visão geral tradicional
    • B = Usuários não orgânicos conforme relatado nos postbacks da SKAdNetwork

Advertência relativa ao Apple Search Ads: as instalações trazidas pelo Apple Search Ads no dashboard tradicional não são orgânicas. No entanto, no contexto da SKAdNetwork, elas fazem parte da métrica orgânica.  

Características e limitações

Caraterística Observações 
Acesso da ad network As ad networks recebem postbacks
Agências Indisponível Isso significa que as agências não devem habilitar as ad networks que executam campanhas de SKAdNetwork. Agência! Peça ao anunciante para ativar a ad network, não faça isso sozinho. As agências podem indicar que trouxeram o usuário implementando o reconhecimento de agência da SKAN.  
Transparência da agência N/D
Fuso horário UTC
Moeda  USD
Dados orgânicos Com base nos dados de eventos do SDK. Por exemplo, as métricas de instalação orgânica são calculadas assim: Dados de todas as instalações reportadas pelo SDK menos as instalações não orgânicas reportadas pela SKAdNetworks.
Dados não orgânicos Baseado em postbacks da SKAdNetwork
Atualização dos dados Diária
Histórico de dados Data mais antiga, disponibilidade do iOS 14 (16 de setembro de 2020)
Acesso do usuário Os usuários da conta devem ter as permissões necessárias
App clips Os App clips são atribuídos como orgânicos no dashboard da SKAdNetwork. Use o dashboard de Visão Geral para exibir fontes de mídia de invocação.

Parceiros integrados da SKAN

Registrando receita de anúncios

Atribua a receita de anúncios gerada durante a janela de mensuração da SKAdNetwork à campanha que traz o usuário. Atualmente, isso é limitado aos anunciantes integrados à receita de anúncios a nível de impressão da MoPub via SDK.

Para registrar a receita de anúncios no dashboard da SKAN:  

Atenção: veja a documentação do conector genérico do SDK para mais informações sobre as fontes de anúncios disponíveis para mediação.   

Envio de postbacks para parceiros integrados

A AppsFlyer envia postbacks de parceiros integrados relacionados à atribuição SKAN (para SKAN 4, os postbacks são enviados apenas para a janela 1).

Confira as várias opções e requisitos na tabela a seguir

Assunto Descrição
Compartilhamento de transcation ID

Ação necessária: verifique com o parceiro integrado se eles exigem o ID da transação e configure a definição de acordo.

A AppsFlyer envia os postbacks de parceiros de ad networks atribuídas. Ou seja, os postbacks decodificados, e não uma cópia do postback SKAdNetwork recebido do iOS. Esses postbacks contêm dados de CV decodificados relacionados à instalação e dados de eventos in-app associados de ações realizadas pelo usuário durante a janela de atividade.

Como o transaction ID pode ser usado para decodificar o seu CV, não o compartilhamos sem a sua permissão.  

Compartilhamento de transcation ID

Anunciantes podem ativar o compartilhamento do transaction ID da seguinte forma: na AppsFlyer, acesse configuração > integrações ativas > selecione um parceiro > aba integração > compartilhamento de dados.

Verificação de mapeamento de eventos in-app