Diretrizes de iniciação de atribuição da SKAdNetwork

A API SKAdNetwork da Apple tem como objetivo medir o sucesso das campanhas publicitárias de instalação de apps, sem deixar de lado a privacidade do usuário. Para a SKAdNetwork v2.0 e v2.1, a atribuição de instalação para anúncios renderizados pelo StoreKit é gerada por cliques no anúncio que levariam o usuário a instalar o app. A SKAdNetwork v2.2 e versões mais recentes também oferecem suporte a anúncios de visualização completa em que a atribuição é gerada apenas pela visualização do anúncio.

As diretrizes a seguir são fornecidas para garantir que o SDK dos anúncios para dispositivos móveis do Google possa iniciar a atribuição da SKAdNetwork corretamente.

Atribuição de clique para anúncios para dispositivos móveis

A atribuição da SKAdNetwork é iniciada pelo evento de clique no anúncio do SDK dos anúncios para dispositivos móveis do Google somente se a ação de clique for direcionada especificamente à App Store da Apple. O motivo desse requisito é evitar que a app store seja iniciada por cliques que não têm a intenção de abrir a app store. Esses tipos de ações de clique podem incluir, por exemplo, a navegação até uma página "Opções de anúncios".

Diretrizes

Para garantir que as ações de clique em anúncios e as instalações de apps subsequentes resultem em uma atribuição da SKAdNetwork, ao criar as peças, verifique se o URL de clique da peça é

  • um link direto para o app anunciado na app store ou
  • usa métodos de redirecionamento, como HTTP 301, 302 ou outros tipos de cadeias de redirecionamento HTTP do lado do servidor que teriam como destino final a loja de apps.

Os links para a app store, seja diretamente ou por uma cadeia de redirecionamento, são confirmados se o URL começar com um dos seguintes padrões:

  • https://apps.apple.com
  • https://itunes.apple.com
  • itms-apps://
  • itms://

Outras páginas de destino ou métodos de redirecionamento do lado do cliente são considerados como não chegando à app store e podem não iniciar o processo de atribuição da SKAdNetwork. Exemplos:

  • Página HTML que exige uma ação do usuário para redirecionar à app store
  • Página HTML com um script de redirecionamento automático baseado em JavaScript para a loja de apps
  • Tags de atualização meta

Práticas recomendadas para diferentes tipos de criativos

A ação de clique para iniciar a atribuição da SKAdNetwork pode ser configurada para os diferentes tipos de criativos da seguinte maneira:

Criativos HTML
Isso pode ser configurado como o URL de destino nas tags de âncora que envolvem o elemento clicável ou como o URL de destino das operações window.location de eventos de clique baseados em JavaScript.
MRAID
A ação de clique precisa chamar Mraid.open() para iniciar a atribuição da SKAdNetwork.
Vídeo VAST
O URL da app store precisa ser definido no elemento ClickThrough no XML VAST.
Nativo
O URL da app store precisa ser definido no campo native.link.url para OpenRTB (ou no campo native_ad.click_link_url para o protocolo RTB do Google descontinuado).

Atribuição de conversão de exibição para anúncios para dispositivos móveis

Quando a atribuição de visualização completa da SKAdNetwork v2.2 é compatível, a API SKAdNetwork inicia um timer de impressão assim que o anúncio é renderizado e visualizado pelo usuário. A atribuição só é permitida para anúncios que foram exibidos por um mínimo de 3 segundos.

As versões 15.3 e anteriores do iOS só são compatíveis com um timer de impressão ativo por vez. Nesse caso, é possível que uma impressão não inicie a atribuição de visualização completa se houver vários anúncios com atribuição de visualização completa na mesma tela. Essa restrição foi removida no iOS versão 15.4 e mais recentes. Agora, a SKAdNetwork permite várias impressões simultâneas ativadas para atribuição de visualização completa.

Diretrizes

O campo de solicitação de lance BidRequest.imp.ext.skadn.fidelities especifica quais tipos de fidelidade de atribuição são aceitos. Esse campo inclui o tipo de fidelidade VIEW_THROUGH_ADS nas versões 2.2 ou mais recentes da SKAdNetwork.

Verifique se a resposta de lance não inclui fidelidades VIEW_THROUGH_ADS se a atribuição de visualização não for compatível. Responder com VIEW_THROUGH_ADS fidelidades quando não há suporte faz com que o lance seja filtrado antes do leilão.

Compatibilidade com versões anteriores

A partir da versão 4.0 da SKAdNetwork, as solicitações de anúncio ativadas para atribuição da SKAdNetwork são compatíveis com versões anteriores. Isso permite que as redes de publicidade respondam com versões anteriores da SKAdNetwork, mesmo quando a solicitação de anúncio é compatível com versões mais recentes.

Diretrizes

A versão do SO do dispositivo do usuário e a versão do SDK dos anúncios para dispositivos móveis do Google do app do publisher determinam quais recursos da SKAdNetwork são compatíveis com a solicitação de anúncio. Isso pode ser determinado na solicitação de lance usando BidRequest.imp.ext.skadn.versions. Ela lista todas as versões da SKAdNetwork compatíveis com a solicitação de anúncio.

Para evitar a filtragem de lances, verifique se a versão da SKAdNetwork usada para criar a resposta é uma das versões listadas na solicitação de lance. Além disso, quando versões mais recentes da SKAdNetwork forem lançadas, observe que responder com versões anteriores será permitido desde que a versão esteja nesta lista. Isso permite que as redes de publicidade continuem respondendo com versões anteriores e adaptem as mais recentes no próprio ritmo.