L'URL di trasparenza pubblicitaria ti consente di personalizzare l' AdChoices che viene visualizzata in alcuni annunci. Per impostazione predefinita, questa icona viene mostrata agli utenti tramite un'esperienza di trasparenza e controllo degli annunci (AT&C) con rendering di Google che include informazioni come l'inserzionista e l'annuncio stesso.
Puoi ottenere l'URL di trasparenza pubblicitaria inviando una richiesta di annuncio all'SDK Google Mobile Ads e ricevendo una risposta con l'URL di trasparenza pubblicitaria. Dopo aver ricevuto l'URL all'interno dell'app, puoi integrare un'icona personalizzata che possa essere conforme al design dei tuoi annunci e presentare la tua esperienza AT&C agli utenti.
Questa pagina spiega come richiedere, analizzare e convalidare l'URL di trasparenza pubblicitaria.
Prerequisiti
Prima di continuare, assicurati di aver completato le seguenti operazioni:
- Configura gli annunci nativi nella tua app. Per maggiori dettagli sugli annunci nativi, consulta Annunci nativi.
- Richiedi l'accesso alla lista consentita per questa funzionalità. Per richiedere l'accesso, contatta il tuo account manager.
- Se non hai accesso, le risposte non restituiscono l'URL di trasparenza pubblicitaria e l'icona predefinita viene visualizzata come previsto.
Richiedi l'URL
Affinché GMA Next-Gen SDK ti restituisca l'URL di trasparenza pubblicitaria, devi aggiungere un parametro di richiesta aggiuntivo nelle richieste di annunci nativi. Questo parametro indica che la tua app è pronta e preparata per gestire un'icona personalizzata.
Nella richiesta, devi aggiungere la chiave "ad_transparency_url_requested" con
il valore "1" al bundle di informazioni extra della rete. Per maggiori dettagli sulle informazioni extra della rete,
consulta
setGoogleExtrasBundle
.
L'esempio seguente imposta questa chiave e questo valore per richiedere l'URL di trasparenza pubblicitaria:
Java
private void loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation.
Bundle extras = new Bundle();
extras.putString("ad_transparency_url_requested", "1");
NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
}
Kotlin
private fun loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation
val extras = Bundle()
extras.putString("ad_transparency_url_requested", "1");
val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
}
Sostituisci AD_UNIT_ID con l'ID unità pubblicitaria. Ad esempio, ca-app-pub-3940256099942544/2247696110 per gli annunci nativi.
Analizza l'URL
Dopo aver richiesto l'URL, riceverai una risposta all'annuncio con l'URL di trasparenza pubblicitaria nell'oggetto delle informazioni sulla risposta. Per maggiori dettagli sull'oggetto delle informazioni sulla risposta, consulta Informazioni sulla risposta.
Puoi accedere all'URL di trasparenza pubblicitaria all'interno della chiave "ad_transparency_url" dalle informazioni extra della risposta. L'esempio seguente recupera l'URL di trasparenza pubblicitaria nell'oggetto delle informazioni sulla risposta:
Java
nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");
Kotlin
nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")
Convalida l'URL
Per testare e convalidare l'URL di trasparenza pubblicitaria, verifica di non visualizzare l'icona predefinita fornita da Google nell'annuncio nativo, ma l'icona personalizzata. Fai clic sull'icona per visualizzare l'esperienza AT&C.
Inoltre, verifica di visualizzare l'URL di trasparenza pubblicitaria dagli extra della risposta nell'oggetto delle informazioni sulla risposta. Se non vedi l'URL di trasparenza pubblicitaria, viene visualizzata l'icona predefinita di Google al posto dell'icona personalizzata. Di seguito è riportato un esempio di URL di trasparenza pubblicitaria:
https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID