Estúdio de conversão SKAN

Definições

• 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 a 7 dias
  • Janela 3: 8 a 35 dias
  • As 3 janelas mensuram 3 períodos de tempo pós-instalação diferentes, não sobrepostos. Ou seja, a janela 2 mensura os dias 3 a 7 após a instalação, não os dias 0 a 7.
• Janela de atividade: Relevante para SKAN 3 e abaixo. 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.
• Valor de Conversão (CV): a mensuração da qualidade do usuário relatada nos postbacks enviados pelo iOS no final das janelas 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ê deseja definir seus CVs, use a opção Decodificar para fazer upload do seu arquivo de mapeamento de CV.
  • Para SKAN 4+, existem valores de conversão totais e parciais.
    
• Capacidade de valor de conversão: o número de currículos necessários para mapear sua configuração. Quanto mais componentes e elementos de medição você selecionar, mais capacidade de valor de conversão será necessária. Cada faixa ou elemento de configuração selecionado consome capacidade de valor de conversão. (E cada unidade de configuração adicional incluída em um único componente o consome exponencialmente!) Exemplos de uso maximizado de CV.
• Single Source of Truth (SSOT): mecanismo para sinalizar se o usuário foi atribuído por SKAN ou outro método de correspondência de atribuição. O sinalizador é usado para eliminar dados duplicados de instalação em dados brutos da SKAN e calcular métricas de performance verdadeiras.
• Componentes de métrica:
  
  • Receita: mensura a receita gerada
  • Evento in-app: mensura a conversão (número de usuários únicos realizando um evento),
    o engajamento (número de vezes que um evento foi realizado), ou ambos.
  • Funil: mensura a ocorrência de eventos in-app com base em uma lista de eventos sequenciais em um funil. Um usuário realizando qualquer evento no funil é considerado como tendo realizado todos os eventos anteriores a esse evento.
  • Prioridade: um componente que contém receita, evento in-app ou ambos. 
  • Predict: usa algoritmos avançados de machine learning para fornecer previsões precisas, baseadas em LTV, sobre o sucesso da campanha. As previsões de KPIs a nível de usuário (incluindo receita e retenção) são codificadas e transmitidas à SKAN como um único valor de conversão, que a SKAN então relata como um postback, juntamente com a identificação da campanha e a fonte de atribuição. 

Princípios

• Somente administrador: somente um administrador pode salvar as configurações do Estúdio de conversão. Os usuários da conta podem visualizar as configurações. 
• A qualquer momento, apenas um modo está ativo. 
• Para um determinado modo, a AppsFlyer mapeia as combinações definidas por suas configurações para CVs. Você pode visualizar e fazer o download da tabela de mapeamento. 
• No aplicativo, a AppsFlyer define o currículo após cada ação mensurável do usuário usando o modo de medição ativo quando um usuário inicializa o aplicativo pela primeira vez. 
• O iOS considera o crowd anonymity da Apple antes de preencher o CV no postback.
• As ações do usuário que ocorrem após o final de uma janela são desconsideradas.
• Dashboards e relatórios da SKAN:

  • O layout e as métricas do painel do SKAN dependem do modo e da configuração. 

  • O layout é atualizado diariamente com base no modo ativo à meia-noite UTC. Espere que o layout atualizado esteja disponível até as 05:00 UTC. 

  • No SKAN 4, Personalizar e Decodificar, dados orgânicos para eventos in-app e receita geral não estão disponíveis. 

Princípios S2S

Ações mensuráveis podem ser relatadas pela API de servidor para servidor (S2S) . Para cada modo, considere o seguinte: 

• SKAN 4 e Personalizado: S2S está sempre ativado.
• Decodificação: o S2S não é adequado para S2S e não está disponível. A AppsFlyer não define o CV nesse modo.
• Modos de receita, conversão e engajamento: você deve ativar a gravação de eventos S2S antes de enviar eventos.

Na SKAN 4, você usa diferentes componentes de mensuração como receita, eventos in-app, prioridade e Single Source of Truth para determinar o que é mensurado durante cada uma das três janelas de mensuração. Juntos, os componentes formam seu método de mensuração da SKAN 4.

Se você estiver atualizando para SKAN 4 a partir de uma versão anterior da SKAN, seu mapeamento de esquema atual será transferido para a configuração total da janela 1. A AppsFlyer mapeia automaticamente os valores aproximados para você nas janelas 1 a 3.

Para definir manualmente a SKAN 4, teste diferentes opções. À medida que você faz alterações, o resumo da capacidade de valores de conversão é atualizado. Otimize suas configurações para capturar os dados mais valiosos sem exceder sua capacidade. Consulte o Cálculo da capacidade de valores de conversão.

Observação: se você estiver atualizando para a SKAN 4 a partir de uma versão anterior da SKAN, seu mapeamento de esquema atual é transferido para mensurações totais e a AppsFlyer mapeia automaticamente os valores parciais para você. E, se você for novo na SKAN, a AppsFlyer fornece um mapeamento padrão inicial.

Para definir manualmente os valores de conversão no Conversion Studio usando a SKAN 4:

1. No dashboard da AppsFlyer, vá para Configurações > SKAN Conversion Studio.
2. Clique nas opções (⋮) para exibir o menu de opções e verifique se a mensuração da SKAN está ativada. Atenção! Se desativado, o SDK não chama as funções SKAN do iOS, como registerAppForAdNetworkAttribution, updateConversionValue.
3. Selecione o método de mensuração da SKAN 4.0.
4. Clique em Continuar.
   As configurações para o CV total da Janela 1 (1-2 dias) são abertas.
5. [Opcional] Ative a Única fonte confiável (SSOT).
   O mecanismo SSOT sinaliza (e desduplica) instalações relatadas por mais de um método de correspondência de atribuição. Saiba mais
   
6. Clique em + Adicionar métrica para adicionar diferentes componentes de métrica.
   As seções a seguir detalham as opções de configuração e os componentes. Use-os como guias ao experimentar as diferentes configurações de métrica SKAN:
   • Receita
   • Evento in-app
   • Funil
   • Prioridade
   • Predict
7. Clique em Parcial e repita as Etapas 6-7 para definir o CV parcial da Janela 1 (1-2 dias).
   Observação:
   • Apenas os componentes de mensuração de receita e eventos in-app estão disponíveis.
   • CV baixo deve ser uma sessão de usuário para garantir que o postback seja enviado.
8. [Opcional] Ative Bloquear janela e defina a condição (tempo ou valor parcial de conversão) para bloquear a janela da SKAN antes do padrão. Saiba mais
9. Clique em Janela 2 (3-7 dias) e repita as Etapas 6-8 para definir o CV da janela 2.
   Observação:
   • Apenas os componentes de mensuração de receita e eventos in-app estão disponíveis.
   • [Recomendado] O CV baixo deve ser uma sessão de usuário.
10. Clique em Janela 3 (8-35 dias) e repita as Etapas 6-8 para definir o CV da janela 3.
    Observação: 
    • Apenas os componentes de mensuração de receita e eventos in-app estão disponíveis.
    • [Recomendado] O CV baixo deve ser uma sessão de usuário.
11. Clique em Salvar.
12. Verifique se os mapeamentos de postback de eventos in-app do parceiro mapeiam os eventos que você configurou.

Em Personalizar, você usa diferentes componentes de mensuração como receita, eventos in-app, prioridade e Single Source of Truth, para determinar o que é mensurado e definir uma janela de atividade para determinar por quanto tempo e em quais intervalos a mensuração ocorre. Juntos, os componentes criam seu método de mensuração personalizado. 

Para definir Personalizar, teste diferentes opções. À medida que você faz alterações, o resumo da capacidade de valores de conversão é atualizado. Otimize suas configurações para captar os dados mais valiosos para você sem exceder a capacidade. Consulte o Cálculo da capacidade de valores de conversão.

Para definir manualmente os valores de conversão no Conversion Studio usando o modo Personalizado:

1. No dashboard da AppsFlyer, vá para Configurações > SKAN Conversion Studio.
2. Clique nas opções (⋮) para exibir o menu de opções e verifique se a mensuração da SKAN está ativada. Atenção! Se desativado, o SDK não chama as funções SKAN do iOS, como registerAppForAdNetworkAttribution, updateConversionValue.
3. Selecione o método de mensuração personalizada.
4. Clique em Continuar.
   
5. [Opcional] Ative a Única fonte confiável (SSOT).
   O mecanismo SSOT sinaliza (e desduplica) instalações relatadas por mais de um método de correspondência de atribuição. Saiba mais
   
6. Clique em + Adicionar mensuração para adicionar diferentes componentes de mensuração.
   As seções a seguir detalham as opções de configuração e os componentes. Use-os como guias para testar diferentes configurações de mensuração na SKAN:
   • Receita
   • Evento in-app
   • Funil
   • Prioridade
   • Predict
7. Defina a duração da janela de atividade (12 horas a 63 dias) durante a qual você deseja medir a atividade do usuário.
   O cronômetro de atividade padrão permite definir a janela para 24 a 72 horas. E a configuração padrão de Intervalo permite definir 12 ou 24 horas. Use a Janela personalizada para estender a janela de atividade para até 63 dias e definir intervalos mais longos.
8. Clique em Salvar.
9. Verifique se os mapeamentos de postback de eventos in-app do parceiro mapeiam os eventos que você configurou.

Usando métodos fixos, você pode mensurar o valor do usuário usando uma das seguintes mensurações:

• • Receita
  • Conversão
  • Engajamento

À medida que você faz alterações nas configurações de método, o resumo da capacidade de valores de conversão é atualizado. Otimize suas configurações para capturar os dados mais valiosos para você sem exceder a capacidade. Consulte Cálculo da capacidade de valores de conversão.

Atenção!

• O método fixo de mensuração é para uma janela de atividade de 24 horas começando com a primeira abertura do aplicativo. 
• Se você deseja enviar eventos usando o S2S, você deve habilitar explicitamente oSKAN S2S

Para definir manualmente os valores de conversão no Conversion Studio usando um método fixo:

1. No dashboard da AppsFlyer, vá para Configurações > SKAN Conversion Studio.
2. Clique em opções (⋮) para exibir o menu de opções e:
   • Certifique-se de que a mensuração da SKAN esteja ativada. Atenção! Se desativado, o SDK não chama as funções SKAN do iOS, como registerAppForAdNetworkAttribution, updateConversionValue.
   • [Opcional] Ativar envio de eventos por S2S. Disponível se o método selecionado for receita, conversão ou engajamento.
3. Selecione um método de mensuração fixo.
4. Siga as informações e instruções na tabela a seguir para o método de mensuração fixo selecionado.
5. Clique em Salvar.
6. Verifique se os mapeamentos de postback de eventos in-app do parceiro mapeiam os eventos que você configurou.

Métricas de modo fixo

Crie seu próprio mapeamento de currículo para evento e defina você mesmo o currículo no aplicativo. Use essa opção se não for possível integrar o SDK da AppsFlyer ao seu aplicativo.

Para usar a opção Decodificar:

1. No dashboard da AppsFlyer, vá para Configurações > SKAN Conversion Studio.
2. Clique em opções (⋮) para exibir o menu de opções e:
   • Certifique-se de que a mensuração da SKAN esteja ativada. Atenção! Se desativado, o SDK não chama as funções SKAN do iOS, como registerAppForAdNetworkAttribution, updateConversionValue.
   • Carregue seu arquivo de mapeamento de decodificação.
3. Clique em Salvar.
4. Verifique se os mapeamentos de postback de eventos in-app do parceiro mapeiam os eventos que você configurou.

Use o componente de métrica prioritária, parte do modo Personalizado, para classificar as jornadas de ação do usuário no aplicativo com base em sua lógica de negócios, de modo que as métricas de alta prioridade substituam as de baixa prioridade. Isso permite que você escolha o que medir em cada etapa do funil de conversão. 

Cada prioridade (máximo 63) pode conter receita, evento in-app ou ambos. Quando um usuário realiza eventos in-app, a AppsFlyer determina qual prioridade se ajusta às ações executadas pelos usuários e define o currículo de acordo.

Para facilitar a compreensão, vamos comparar o uso do Personalizado com e sem o componente prioritário. Sem prioridade, a AppsFlyer mapeia todas as combinações de métrica possíveis para currículos. Considere que, com prioridade, apenas as combinações de métricas explicitamente definidas por você são mapeadas para CVs. 

A prioridade é melhor explicada no exemplo detalhado deste artigo. 

Princípios de prioridade 

• Você pode definir de 1 a 63 prioridades. O número disponível depende da janela de atividades e das configurações de Única fonte confiável.
• A prioridade 1 sempre tem a prioridade mais alta. A prioridade com o maior número tem a menor prioridade.
• Uma prioridade consiste em receita ou evento in-app, ou ambos os componentes. Uma determinada prioridade pode conter vários eventos in-app e fluxos de receita. 
• O funil não está disponível na prioridade. No entanto, defina vários eventos in-app em uma prioridade para medir a conversão do usuário em um funil.
• Para usar o componente de mensuração de prioridade, você não pode ter outros componentes (por exemplo, eventos in-app ou receita) configurados.

Para definir a mensuração usando prioridade:

1. Na AppsFlyer, acesse o SKAN Conversion Studio.
2. Selecione Personalizado e clique em Continuar. 
3. Se necessário, clique em Excluir para remover as configurações atuais.
4. Clique em + Adicionar métrica. Selecione Prioridade. 
   A prioridade 1 é exibida.
   

   

5. Selecione um componente de métrica de:
   • Receita
   • Evento in-app
6. Preencha os campos de acordo com a interface do usuário.
   • Considere que uma prioridade pode consistir em receita, evento in-app ou ambos. 
   • Os valores de intervalo de ocorrências de eventos e receitas devem ser de ordem ascendente (crescente) e contínuos. Por exemplo, os seguintes intervalos aumentam e são contínuos: 1-5, 5-8, 8-10 e assim por diante.  Um determinado intervalo pode ser usado mais de uma vez (repetido) se a segunda vez que for usado for parte de uma combinação única e for o mesmo intervalo que a última prioridade com um intervalo. Por exemplo, 1-5, 1-5 + adicionar ao carrinho.
7. Clique em Validar.
   A mensagem Prioridade é válida é exibida. Se não for esse o caso, corrija sua prioridade antes de continuar.
8. Siga um dos procedimentos abaixo:
   • Para adicionar uma prioridade, clique em + Adicionar prioridade. A prioridade 1 existente é deslocada para baixo e se torna a prioridade 2. Conclua as configurações de prioridade conforme descrito anteriormente. 
   • Para excluir uma prioridade, clique em ... > Excluir.
   • Para alterar o nível de prioridade, clique em Opções (⋮) e selecione Alterar pedido ou Reduzir o nível de prioridade.
   • Para duplicar uma prioridade, clique em Opções (⋮) e selecione Duplicar.
   • Clique em Salvar para concluir as prioridades de configuração. 

Observação: o bloqueio da janela só é relevante para SKAN 4 e versões mais recentes.

Observação:

• A janela de atividade é relevante apenas para SKAN 3 e versões anteriores (ou seja, para métodos personalizados e fixos).
• 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 atividades é de 48 horas. 

• Veja os eventos mapeados para um currículo selecionando o currículo. Os eventos mapeados são exibidos abaixo da tabela.
• Faça download da tabela de mapeamento de CV como um arquivo CSV. Clique em Fazer download do arquivo de mapeamento. 
• Obtenha o mapeamento de CV usando o esquema SKAN CV API para anunciantes. 

Colunas do arquivo de mapeamento CSV

Conforme explicado anteriormente, o número máximo de valores de conversão disponíveis é 64. A fórmula a seguir calcula quantos valores de conversão disponíveis são usados pelo modo.

(activity time duration in hours / interval size in hours) * 
(number of revenue ranges + 1 ) * 
(number of in-app event ranges + 1 ) * 
(number of steps in a funnel + 1)

Ajuste a fórmula para incluir todos os componentes de métrica

Exemplo 1

Exemplo 2

Exemplo 3

Exemplo 4

Em um aplicativo de compras, o anunciante quer focar a métrica em:

• Ações de usuários não pagantes
• Receita de usuários pagantes

Ao fazer isso, o anunciante usa CVs para gravar a receita com mais precisão. Esses requisitos de métrica se traduzem em um conjunto de prioridades de métrica, conforme estabelecido na tabela a seguir. 

Considere o seguinte:

• A maior prioridade é sempre 1. Atenção! Os números prioritários não são mapeados diretamente para CVs. Os mapeamentos de CV são exibidos na interface do usuário.
• O número máximo de prioridades é 63. O número real disponível depende da janela de atividades e se a Única fonte confiável está ativada.
• Cada prioridade consiste em um intervalo de receita ou de ocorrências de eventos in-app, ou ambos. 
• Valores do intervalo: o valor mais baixo do limite não está incluído no intervalo, mas o valor do limite mais alto é incluído. Por exemplo, o intervalo de US$5 a US$10 não inclui o valor 5, mas inclui o valor 10. 

Exemplo de definição de métrica prioritária

A tabela a seguir contém cenários de jornada do usuário. Cada cenário contém a lista de ações executadas pelo usuário durante sua jornada e a prioridade determinada pela AppsFlyer.

Na tabela:

• Várias ações são separadas usando >
• O valor entre parênteses () é a prioridade determinada pela AppsFlyer definida após o usuário concluir a ação. Usando a prioridade da AppsFlyer, atualize o currículo no aplicativo. 

Cenários de jornada do usuário

Exemplo A: mensuração de receita

Exemplo B: Mensuração de conversão

Exemplo C: Mensuração de engajamento

Se você tiver muitos aplicativos para os quais deseja configurações de valor de conversão SKAN semelhantes, pode ser demorado e desafiador projetar o esquema para cada aplicativo separadamente na IU do Estúdio de Conversão. Para economizar tempo e esforço, você pode configurar seu esquema SKAN na interface do usuário uma vez e, em seguida, usar a API do Estúdio de Conversão SKAN para usar o mesmo esquema em vários aplicativos. Observação: a API oferece suporte apenas a esquemas configurados na interface do usuário usando SKAN 4 ou modos de métrica personalizados (e dentro desses modos, o componente de métrica Predict não é compatível).

Para usar a API do Estúdio de Conversão SKAN:

1. Obtenha o token da API. Um administrador precisa recuperar o token.
2. Forneça ao seu desenvolvedor o token de API a ser usado no cabeçalho de autenticação.
3. Forneça a seus desenvolvedores os IDs de aplicativo:
   • Do aplicativo para o qual o esquema SKAN está configurado na interface do usuário (ou seja, o aplicativo do qual você deseja copiar o esquema SKAN).
   • De todos os aplicativos que você deseja que tenham o mesmo esquema.
4. Diga ao seu desenvolvedor para seguir as instruções da API do Estúdio de Conversão SKAN no hub do desenvolvedor.

Observação:

• A API pode ser usada para copiar o esquema para um aplicativo por chamada de API. No entanto, seu desenvolvedor pode criar um script para copiar o esquema necessário para vários aplicativos.
• A API do Estúdio de Conversão SKAN não está disponível para agências.

Considere: 

• Depois de começar a usar um método de mensuração na SKAN 4, você não pode voltar para um método anterior.
• Quando você faz alterações nas configurações, elas começam a entrar em vigor a partir das 00:00 UTC e um período de transição começa. Durante esse período, decodificamos o valor de conversão usando as configurações selecionadas mais recentemente. No entanto, um postback chegando agora está relacionado a uma instalação que ocorreu em algum momento no passado.
• O número de instalações relatadas não se relaciona com a alteração de configurações, e é um número preciso.

Para desativar a mensuração de SKAdNetwork:

1. Na AppsFlyer, acesse Configuração > Estúdio de conversão SKAN.
2. Clique em ⋮.
3. Desativar a mensuração da SKAdNetwork. 
   Entre outras coisas, o SDK para de chamar funções SKAN como registerAppForAdNetworkAttribution, updateConversionValue.
4. Clique em Salvar alterações.

Tanto o SDK quanto a API de servidor para servidor (S2S) pode enviar eventos in-app para servidores da AppsFlyer. 

O fluxo S2S   é o seguinte:

• Ocorre um evento relacionado ao usuário nos servidores do anunciante. O aplicativo pode estar aberto ou fechado neste momento. 
• Os servidores de anunciantes relatam o evento à AppsFlyer por S2S.
• A AppsFlyer calcula o valor de conversão atualizado e, em seguida: 
  • Se o aplicativo estiver aberto no dispositivo do usuário: o SDK será notificado sobre o valor atualizado. O SDK atualiza o valor de conversão do iOS no dispositivo.
  • Se o aplicativo não estiver aberto no dispositivo do usuário: o servidor aguarda até que o aplicativo seja aberto para notificar o SDK do valor da conversão. Isso deve ocorrer antes da expiração da janela de atividade. Se a notificação falhar, o evento será ignorado.

Versão do SDK necessária

• Adote a versão mais recente do SDK no aplicativo. Atenção! Nenhuma ação adicional é exigida pelo desenvolvedor. 

Para implementar o envio de eventos in-app pela API de servidor para servidor:

1. Siga um dos procedimentos abaixo:
   • Se o método selecionado for SKAN 4 ou Personalizado:
     • Não são necessárias alterações nas configurações. 
   • Se o modo selecionado for receita, conversão ou engajamento:
     1. Na AppsFlyer, acesse Configuração > Estúdio de conversão SKAN.
     2. Clique em opções (⋮).
     3. Ative Registrar eventos in-app enviados pela API de servidor para servidor.
2. Enviar eventos por S2S. 

Limitação

• Se você implementar o anonimato do usuário para um determinado usuário, não poderá enviar eventos pelo S2S para esse usuário. 

Se você tiver a mensuração de receita ou de engajamento configurada, o Single Source of Truth (SSOT, que desduplica e relata com precisão os dados no iOS), não é compatível. Saiba mais sobre SSOT

Para habilitar o SSOT quando o modo de Receita ou Engajamento estiver configurado:

1. Na AppsFlyer, acesse Configuração > SKAN Conversion Studio.
2. Vá até o seu modo de mensuração ativo. 
3. Clique em + Adicionar Single Source of Truth.
   • O toggle do Single Source of Truth fica ativado automaticamente.
   • Seus intervalos de modos de mensuração fixos são minimamente alterados para permitir que o SSOT tenha algum espaço de valor de conversão.
4. Clique em Salvar.