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

O objetivo da API SKAdNetwork da Apple é medir o sucesso das 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 à instalação do app. A SKAdNetwork v2.2 e versões mais recentes também oferece suporte a anúncios de visualização, 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 ao clicar em 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 à Apple App Store. O motivo desse requisito é impedir que a app store seja aberta por cliques que não sejam destinados a abri-la. 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 as instalações de apps subsequentes resultem em uma atribuição da SKAdNetwork, ao gerar os criativos, verifique 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, seja 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 outros métodos de redirecionamento do lado do cliente não vão ser direcionadas à app store e não vão iniciar o processo de atribuição da SKAdNetwork. Exemplos:

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

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 â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 de anúncios para dispositivos móveis

Quando a atribuição de visualização completa da SKAdNetwork v2.2 oferece suporte, 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 foram exibidos por um mínimo de três segundos.

As versões 15.3 e anteriores do iOS só oferecem suporte a um timer de impressão ativo por vez. Nesse caso, pode ser que uma impressão falhe na inicialização de atribuição de visualização se houver vários anúncios de atribuição de visualização na mesma tela. Essa restrição foi reforçada na versão 15.4 e mais recentes do iOS, por isso a SKAdNetwork agora permite várias impressões simultâneas ativadas para atribuição de visualização.

Diretrizes

Os campos da solicitação de lance BidRequest.mobile.skadn.supported_fidelity_types para o protocolo RTB do Google e BidRequest.imp.ext.skadn.fidelities para protocolo OpenRTB 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.

Verifique se a resposta do lance não inclui fidelidade VIEW_THROUGH_ADS se a atribuição de visualização não estiver disponível. Responder com fidelidade VIEW_THROUGH_ADS quando não tem 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úncios ativadas para a atribuição da SKAdNetwork são compatíveis com versões anteriores. Dessa forma, as redes de publicidade podem responder 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 oferecem suporte à solicitação de anúncio. Isso pode ser determinado na solicitação de lance usando o campo BidRequest.mobile.skadn.versions para o protocolo RTB do Google ou o campo BidRequest.imp.ext.skadn.versions para o protocolo OpenRTB. Esse campo 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 listadas na solicitação de lance. Além disso, quando versões mais recentes da SKAdNetwork forem introduzidas, é permitido responder com versões mais antigas, desde que a versão esteja nessa lista. Isso permite que as redes de publicidade continuem respondendo com versões mais antigas e adaptem as versões mais recentes no próprio ritmo.