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, sem esquecer da privacidade do usuário. Para a SKAdNetwork v2.0 e v2.1, a atribuição de instalação de anúncios renderizados pelo StoreKit é determinada 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 é determinada 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 por clique em anúncios para dispositivos móveis

A atribuição da SKAdNetwork é iniciada pelo evento de clique do anúncio do SDK dos anúncios para dispositivos móveis do Google somente se a ação de clique for direcionada especificamente à Apple App Store. O motivo para esse requisito é evitar que a app store seja iniciada por cliques que não são destinados a abrir a app store. Esses tipos de ações de clique podem incluir, por exemplo, a navegação para uma página de 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 os criativos, verifique se o URL de clique do criativo é

  • 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 no servidor que teriam um destino final na app store.

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

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

Qualquer outra página de destino ou uso de outros métodos de redirecionamento do lado do cliente são não direcionados à 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 app store
  • Metatags de 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 criativo da seguinte maneira:

Criativos HTML
Isso pode ser configurado como o URL de destino nas tags de âncora que cercam o elemento clicável ou como o URL de destino das operações window.location de eventos de clique com base 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 o OpenRTB ou no campo native_ad.click_link_url para o protocolo RTB do Google descontinuado.

Atribuição de visualizaçã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 quando o anúncio é renderizado e visualizado pelo usuário. A atribuição só é permitida para anúncios que foram exibidos por pelo menos 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, é possível que uma impressão falhe a iniciação da atribuição de visualização se houver vários anúncios de atribuição de visualização completa na mesma tela. Essa restrição foi removida do iOS versão 15.4 e mais recentes, então a SKAdNetwork agora 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 do OpenRTB (ou BidRequest.mobile.skadn.supported_fidelity_types do protocolo de RTB do Google descontinuado) especifica quais tipos de fidelidade de atribuição são aceitos pela solicitação de lance. Esse campo inclui o tipo de fidelidade VIEW_THROUGH_ADS nas versões v2.2 e 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 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 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 oferece suporte a 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 definem 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 descontinuado do Google RTB). Eles listam todas as versões da SKAdNetwork com suporte à 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, a resposta com versões anteriores será permitida, desde que a versão esteja nesta lista. Isso permite que as redes de anúncios continuem respondendo com versões anteriores e se adaptem às versões mais recentes no próprio ritmo.