Targeting

Seleziona la piattaforma: Android iOS Unity Flutter

Questa guida spiega come fornire informazioni sul targeting all'SDK Google Mobile Ads.

Per un esempio funzionante, scarica l'app Android API Demo.

Scarica la demo dell'API

Prerequisito

• Completa la Guida introduttiva.

RequestConfiguration

RequestConfiguration raccoglie le informazioni di targeting applicate a livello globale a ogni richiesta di annuncio. Per i tag di targeting disponibili, consulta la documentazione di RequestConfiguration.Builder.

Per aggiornare la configurazione della richiesta, ottieni un builder dalla configurazione esistente, esegui gli aggiornamenti desiderati e impostalo come segue:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Per assicurarti che tutte le richieste di annunci applichino le modifiche alla configurazione delle richieste, imposta la configurazione delle richieste prima di inizializzare l'SDK Mobile Ads.

Impostazione rivolta ai minori

Ai fini del Children's Online Privacy Protection Act (COPPA), esiste un'impostazione chiamata "Tag per il trattamento per siti o servizi destinati ai minori". Se imposti questo tag, certifichi che questa notifica è accurata e che sei autorizzato ad agire per conto del proprietario dell'app. Sei consapevole del fatto che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

In qualità di sviluppatore di app, puoi indicare se vuoi che Google tratti i tuoi contenuti come destinati ai minori quando esegui una richiesta di annuncio. Se indichi che vuoi che Google tratti i tuoi contenuti come destinati ai minori, adottiamo misure per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing per quella richiesta di annuncio.

Puoi applicare l'impostazione relativa ai contenuti rivolti ai minori tramite setTagForChildDirectedTreatment():

• Chiama setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE per indicare che vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai fini della legge COPPA. In questo modo, viene impedita la trasmissione dell'identificatore pubblicità di Android (AAID).

• Chiama setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE per indicare che non vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai fini della legge COPPA.

• Chiama setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED se non vuoi indicare come vuoi che i tuoi contenuti vengano trattati in relazione alla legge COPPA nelle richieste di annunci.

Il seguente esempio indica che vuoi che i tuoi contenuti vengano trattati come destinati ai bambini ai fini del COPPA:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Nota: le app del programma Per la famiglia come app destinate principalmente ai bambini e gli utenti che hanno eseguito l'accesso ad Account Google gestiti con Family Link trattano automaticamente tutti i contenuti come destinati ai bambini per tutte le richieste di annunci.

Utenti di età inferiore a quella del consenso digitale

Puoi contrassegnare le tue richieste di annuncio perché ricevano il trattamento previsto per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE). Questa funzionalità è pensata per facilitare il rispetto del Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che potresti avere altri obblighi di legge ai sensi del GDPR. Consulta le indicazioni dell'Unione Europea e rivolgiti a un consulente legale. Tieni presente che gli strumenti di Google sono progettati per facilitare la conformità e non esonerano i publisher dalle obbligazioni previste dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, nella richiesta di annuncio viene incluso un parametro Tag For Users under the Age of Consent in Europe (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per tutte le richieste di annuncio. Inoltre, disattiva le richieste a fornitori di annunci di terze parti, come i pixel di monitoraggio degli annunci e gli ad server di terze parti.

Come per le impostazioni rivolte ai bambini, in RequestConfiguration.Builder esiste un metodo per impostare il parametro TFUA: setTagForUnderAgeOfConsent(), con le seguenti opzioni.

• Chiama setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE per indicare che vuoi che la richiesta di annuncio riceva il trattamento per gli utenti dello Spazio economico europeo (SEE) sotto l'età del consenso. In questo modo viene impedita anche la trasmissione dell'identificatore pubblicità di Android (AAID).

• Chiama setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE per indicare che vuoi che la richiesta di annuncio non riceva il trattamento per gli utenti nello Spazio economico europeo (SEE) sotto l'età del consenso.

• Chiama setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED per indicare che non hai specificato se la richiesta di annuncio deve ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) sotto l'età del consenso.

Il seguente esempio indica che vuoi includere TFUA nelle tue richieste di annunci:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

I tag per attivare l'impostazione relativa ai contenuti destinati ai bambini e setTagForUnderAgeOfConsent() non devono essere entrambi impostati su true. Se lo fossero, l'impostazione Rivolta ai minori avrà la precedenza.

Filtro dei contenuti degli annunci

Per rispettare le norme relative agli annunci inappropriati di Google Play, che includono le offerte associate all'interno di un annuncio, tutti gli annunci e le offerte associate mostrati nella tua app devono essere appropriati per la classificazione dei contenuti della tua app, anche se i contenuti stessi sono altrimenti conformi alle norme di Google Play.

Strumenti come la classificazione massima dei contenuti degli annunci possono aiutarti ad avere un maggiore controllo sui contenuti degli annunci mostrati agli utenti. Puoi impostare una classificazione massima dei contenuti per contribuire a garantire la conformità alle norme della piattaforma.

Le app possono impostare una classificazione massima dei contenuti degli annunci per le loro richieste di annuncio utilizzando il metodo setMaxAdContentRating. Gli annunci AdMob restituiti quando questa opzione è configurata hanno una classificazione dei contenuti pari o inferiore a questo livello. I valori possibili per questo extra di rete si basano sulle classificazioni delle etichette dei contenuti digitali e devono essere una delle seguenti stringhe:

• MAX_AD_CONTENT_RATING_G
• MAX_AD_CONTENT_RATING_PG
• MAX_AD_CONTENT_RATING_T
• MAX_AD_CONTENT_RATING_MA

Il seguente codice configura un oggetto RequestConfiguration per specificare che i contenuti dell'annuncio restituiti devono corrispondere a una designazione di etichetta contenuti digitali non superiore a G:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Scopri di più su:

• Impostare la classificazione massima dei contenuti per ogni richiesta di annuncio

• Impostare la classificazione massima dei contenuti degli annunci per un'app o un account

Nota: le impostazioni del filtro della classificazione dei contenuti specificate tramite l'SDK Google Mobile Ads sostituiscono qualsiasi impostazione configurata utilizzando l'interfaccia utente di AdMob.

Publisher Privacy Treatment (beta)

L'API Publisher Privacy Treatment (PPT) è uno strumento facoltativo che consente alle app di indicare se disattivare la personalizzazione degli annunci per tutte le richieste di annuncio utilizzando il metodo setPublisherPrivacyPersonalizationState(). Quando usi questa funzionalità, nelle richieste di annuncio future viene incluso un parametro Publisher Privacy Treatment (PPT) per il resto della sessione.

Per impostazione predefinita, le richieste di annunci a Google determinano la pubblicazione di annunci personalizzati. Il seguente codice disattiva la personalizzazione degli annunci per tutte le richieste di annunci:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Nota: per le richieste di annunci con più indicatori della privacy degli utenti, avrà la precedenza l'indicatore più restrittivo. Per esempi specifici, consulta la documentazione dell'API Publisher Privacy Treatment.

Richiesta di annuncio

L'oggetto AdRequest raccoglie le informazioni di targeting da inviare con una richiesta di annuncio.

Aggiungere contenuti aggiuntivi delle emittenti

I dati aggiuntivi della rete sono dettagli extra inviati con una richiesta di annuncio specifici per una singola origine annuncio.

Il seguente snippet di codice imposta una chiave di parametro aggiuntiva di collapsible con un valore di bottom su Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()
adLoader.loadAd(adRequest)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter.class, extras)
    .build();
adLoader.loadAd(adRequest);