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

O objetivo da API SKAdNetwork da Apple é medir o sucesso de campanhas publicitárias de instalação de apps, mantendo 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 é impulsionada por cliques no anúncio que levaria 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 é baseada apenas na visualização do anúncio.

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

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

Por padrão, 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 chegar especificamente à App Store da Apple. O motivo desse requisito é impedir que a app store seja inicializada 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, navegar até uma página "Opções de anúncios".

Diretrizes

Para garantir que as ações de clique em anúncios e instalações de apps subsequentes resultem em uma atribuição da SKAdNetwork, confira se o URL de clique do criativo é:

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

Os links para a app store diretamente ou por uma cadeia de redirecionamento serã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 que usam outros métodos de redirecionamento do lado do cliente não vão ser direcionadas à app store e podem não iniciar o processo de atribuição da SKAdNetwork. Por exemplo:

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

Práticas recomendadas para diferentes tipos de criativo

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

Criativos HTML
Isso pode ser configurado como o URL de destino nas tags âncora ao redor do 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 ou o elemento inicial da cadeia de redirecionamento pode ser definido como o elemento ClickThrough no XML VAST.
Nativo
O URL da app store ou o elemento inicial da cadeia de redirecionamento pode ser definido no campo native_ad.click_link_url para o protótipo de RTB do Google ou no campo native.link para o protótipo do OpenRTB.

Atribuição de visualização completa 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 quando o anúncio é renderizado e é visualizado pelo usuário. A atribuição só é permitida para anúncios que são exibidos por um mínimo de três segundos.

As versões 15.3 e mais antigas do iOS são compatíveis com apenas 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 de atribuição de visualização completa na mesma tela. Essa restrição foi alterada no iOS versão 15.4 e mais recentes. Portanto, a SKAdNetwork agora permite várias impressões simultâneas ativadas para atribuição de visualização.

Diretrizes

Os campos de solicitação de lance BidRequest.imp.ext.skadn.fidelities para OpenRTB e BidRequest.mobile.skadn.supported_fidelity_types para o protocolo descontinuado de RTB do Google especificam quais tipos de fidelidade de atribuição são compatíveis com a solicitação de lance. Esses campos incluem o tipo de fidelidade VIEW_THROUGH_ADS nas versões v2.2 e mais recentes da SKAdNetwork.

Garanta que a resposta do lance não inclua fidelidade de VIEW_THROUGH_ADS caso a atribuição de visualização completa não tenha suporte. Responder com fidelidades VIEW_THROUGH_ADS quando não houver suporte faz com que o lance seja filtrado antes do leilão.

Compatibilidade com versões anteriores

A partir da SKAdNetwork v4.0, as solicitações de anúncios ativadas para a atribuição da SKAdNetwork são compatíveis com versões anteriores. Isso permite que as redes de publicidade respondam com versões mais antigas 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 editor 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 o campo BidRequest.imp.ext.skadn.versions do OpenRTB ou o campo BidRequest.mobile.skadn.versions do protocolo RTB do Google que foi descontinuado. Listamos todas as versões da SKAdNetwork compatíveis com a solicitação de anúncio.

Para evitar a filtragem de lances, confira se a versão da SKAdNetwork usada para criar a resposta é uma das listadas na solicitação de lance. Além disso, quando versões mais recentes da SKAdNetwork são introduzidas, é permitido responder com versões mais antigas, desde que elas estejam nessa lista. Isso permite que as redes de publicidade continuem respondendo com versões mais antigas e adaptem as novas no próprio ritmo.