Linee guida per l'avvio dell'attribuzione di SKAdNetwork

L'API SKAdNetwork di Apple ha lo scopo di misurare il successo delle campagne pubblicitarie per l'installazione di app, rispettando al contempo la privacy degli utenti. Per SKAdNetwork 2.0 e 2.1, l'attribuzione delle installazioni per gli annunci visualizzati da StoreKit è basata sui clic sull'annuncio che inducono l'utente a installare l'app. SKAdNetwork 2.2 e le versioni successive supportano inoltre gli annunci view-through, in cui l'attribuzione si basa solo sulla visualizzazione dell'annuncio.

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

Attribuzione on-click per gli annunci mobile

L'attribuzione SKAdNetwork viene avviata dall'evento di clic sull'annuncio dell'SDK Google Mobile Ads solo se l'azione di clic indirizza specificamente all'App Store di Apple. Il motivo di questo requisito è evitare che l'app store venga aperto da clic non destinati ad aprirlo. Questi tipi di azioni di clic potrebbero includere, ad esempio, la navigazione verso una pagina Scegli Tu!.

Linee guida

Per garantire che le azioni di clic sugli annunci e le installazioni di app successive generino un'attribuzione SKAdNetwork, quando crei le creatività assicurati che l'URL di clickthrough della creatività sia

• un link diretto all'app pubblicizzata nello store oppure
• utilizza metodi di reindirizzamento, ad esempio HTTP 301, 302 o altri tipi di catene di reindirizzamenti HTTP lato server che hanno come destinazione finale l'app store.

I link all'app 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 l'utilizzo di altri metodi di reindirizzamento lato client è destinato a non essere visualizzato nell'app store e potrebbe non avviare la procedura di attribuzione di SKAdNetwork. Esempi:

• Pagina HTML che richiede un'azione dell'utente per il reindirizzamento allo store
• Pagina HTML con uno script di reindirizzamento automatico basato su JavaScript al store
• Meta tag di aggiornamento

Best practice per diversi tipi di creatività

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

Creatività HTML

Questo può essere configurato come URL di destinazione nei tag di ancoraggio che circondano l'elemento cliccabile o come URL target delle operazioni window.location degli eventi basati su clic JavaScript.

MRAID

L'azione di clic deve chiamare Mraid.open() per avviare l'attribuzione SKAdNetwork.

Video VAST

L'URL dello store deve essere impostato nell'elemento ClickThrough nel file VAST XML.

Nativo

L'URL dello store deve essere impostato nel campo native.link.url per OpenRTB (o nel campo native_ad.click_link_url per il protocollo Google RTB ormai obsoleto).

Attribuzione view-through per gli annunci mobile

Quando l'attribuzione view-through SKAdNetwork 2.2 è supportata, l'API SKAdNetwork avvia un timer delle impressioni dopo che l'annuncio è stato visualizzato dall'utente. L'attribuzione è consentita solo per gli annunci che sono stati visualizzati per almeno 3 secondi.

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

Linee guida

Il campo della richiesta di offerta BidRequest.imp.ext.skadn.fidelities per OpenRTB (o BidRequest.mobile.skadn.supported_fidelity_types per il protocollo Google RTB deprecato) specifica quali tipi di fedeltà dell'attribuzione sono supportati dalla richiesta di offerta. Questo campo include il tipo di fedeltà VIEW_THROUGH_ADS nelle versioni SKAdNetwork 2.2 e successive.

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

Compatibilità con le versioni precedenti

A partire dalla versione 4.0 di SKAdNetwork, le richieste di annunci attivate per l'attribuzione SKAdNetwork sono compatibili con le versioni precedenti. In questo modo, le reti pubblicitarie possono rispondere con versioni precedenti di SKAdNetwork anche quando la richiesta di annunci 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 determinano le funzionalità di SKAdNetwork supportate dalla richiesta di annuncio. Questo valore 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 Google RTB deprecato). Vengono elencate tutte le versioni di SKAdNetwork supportate dalla richiesta di annuncio.

Per evitare 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 versioni più recenti di SKAdNetwork, tieni presente che è consentito rispondere con versioni precedenti, purché siano incluse in questo elenco. In questo modo, le reti pubblicitarie possono continuare a rispondere con le versioni precedenti e adattare le versioni più recenti al proprio ritmo.