Linee guida per l'avvio dell'attribuzione di SKAdNetwork

L'API SKAdNetwork di Apple mira a misurare il successo delle campagne pubblicitarie per l'installazione di app rispettando la privacy degli utenti. Per SKAdNetwork v2.0 e v2.1, l'attribuzione dell'installazione per gli annunci visualizzati da StoreKit è generata dai clic sull'annuncio che portano all'installazione dell'app da parte dell'utente. SKAdNetwork v2.2 e versioni successive supportano inoltre gli annunci view-through in cui l'attribuzione si basa sulla sola visualizzazione dell'annuncio.

Vengono fornite le seguenti linee guida per garantire che l'SDK Google Mobile Ads possa avviare correttamente l'attribuzione SKAdNetwork.

Attribuzione al clic per annunci mobile

Per impostazione predefinita, l'attribuzione di SKAdNetwork viene avviata dall'evento di clic sull'annuncio dell'SDK Google Mobile Ads solo se l'azione di clic rimanda specificamente all'App Store di Apple. Il motivo di questo requisito è impedire che lo store venga avviato da clic che non intendono aprire lo store. Questi tipi di azioni di clic potrebbero includere, ad esempio, la navigazione a una pagina Scegli Tu!.

Linee guida

Per garantire che le azioni di clic sugli annunci e le successive installazioni di app comportino un'attribuzione di SKAdNetwork, quando sviluppi le creatività, assicurati che l'URL di clickthrough di quest'ultima sia:

  • Un link diretto all'app pubblicizzata nello store oppure
  • utilizza metodi di reindirizzamento, come HTTP 301, 302 o altri tipi di catene di reindirizzamento HTTP lato server che hanno una destinazione finale dello store.

I link allo store direttamente o tramite una catena di reindirizzamento vengono confermati se l'URL inizia con uno dei seguenti pattern:

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

Qualsiasi altra pagina di destinazione o che utilizza altri metodi di reindirizzamento lato client è determinato che non vengano visualizzate nello store e potrebbero non avviare il processo di attribuzione SKAdNetwork. Esempi:

  • Pagina HTML che richiede un'azione dell'utente per reindirizzare all'app store
  • Pagina HTML contenente uno script di reindirizzamento automatico basato su JavaScript allo store
  • Meta tag di aggiornamento

Best practice per i diversi tipi di creatività

L'azione di clic per avviare l'attribuzione di SKAdNetwork può essere configurata per i diversi tipi di creatività nel seguente modo:

Creatività HTML
Può essere impostato come URL di destinazione negli anchor tag che circondano l'elemento cliccabile o come URL di destinazione delle operazioni window.location dagli eventi al clic basati su JavaScript.
MRAID
L'azione di clic deve chiamare Mraid.open() per avviare l'attribuzione di SKAdNetwork.
Video VAST
L'URL dello store o l'elemento iniziale della catena di reindirizzamento può essere impostato come elemento ClickThrough nel file XML VAST.
Nativo
L'URL dello store o l'elemento iniziale della catena di reindirizzamento può essere impostato nel campo native_ad.click_link_url per il protocollo RTB di Google o nel campo native.link per il protocollo OpenRTB.

Attribuzione view-through per annunci mobile

Se l'attribuzione view-through SKAdNetwork v2.2 è supportata, l'API SKAdNetwork avvia un timer per le impressioni dopo che l'annuncio viene visualizzato e visualizzato dall'utente. L'attribuzione è consentita solo per gli annunci visualizzati per un minimo di 3 secondi.

Tieni presente che le versioni iOS 15.3 e precedenti supportano solo un timer per le impressioni attive alla volta. In questo caso, è possibile che un'impressione non riesca ad avviare l'attribuzione view-through se nella stessa schermata sono presenti più annunci di attribuzione view-through. Questa limitazione è stata eliminata su iOS 15.4 e versioni successive, pertanto ora SKAdNetwork consente più impressioni simultanee abilitate per l'attribuzione view-through.

Linee guida

I campi della richiesta di offerta BidRequest.imp.ext.skadn.fidelities per OpenRTB e BidRequest.mobile.skadn.supported_fidelity_types per il protocollo Google RTB ritirato specificano i tipi di fedeltà dell'attribuzione supportati dalla richiesta di offerta. Questi campi includono il tipo di fedeltà VIEW_THROUGH_ADS nelle versioni 2.2 e successive di SKAdNetwork.

Assicurati che la risposta all'offerta non includa le fedeltà VIEW_THROUGH_ADS se l'attribuzione view-through non è supportata. Se rispondi con le fedeltà VIEW_THROUGH_ADS se non supportate, l'offerta viene filtrata prima dell'asta.

Compatibilità con le versioni precedenti

A partire da SKAdNetwork v4.0, le richieste di annunci abilitate per l'attribuzione di SKAdNetwork sono compatibili con le versioni precedenti. In questo modo le reti pubblicitarie possono rispondere con versioni precedenti di SKAdNetwork anche se la richiesta di annuncio supporta versioni più recenti.

Linee guida

La versione del sistema operativo del dispositivo dell'utente e la versione dell'SDK Google Mobile Ads dell'app del publisher indicano quali funzionalità di SKAdNetwork sono supportate dalla richiesta di annuncio. Questo può essere determinato nella richiesta di offerta utilizzando il campo BidRequest.imp.ext.skadn.versions di OpenRTB o il campo BidRequest.mobile.skadn.versions del protocollo RTB di Google obsoleto. in cui sono elencate tutte le versioni di SKAdNetwork supportate dalla richiesta di annuncio.

Per impedire il filtro delle offerte, assicurati che la versione di SKAdNetwork utilizzata per creare la risposta sia una delle versioni elencate nella richiesta di offerta. Inoltre, quando vengono introdotte le versioni più recenti di SKAdNetwork, tieni presente che è consentito rispondere con versioni precedenti, purché la versione sia presente in questo elenco. In questo modo, le reti pubblicitarie possono continuare a rispondere con le versioni precedenti e adattare le versioni più recenti in base ai propri tempi.