Targeting

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

Prerequisito

Prima di continuare, configura GMA Next-Gen SDK.

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.

Crea un oggetto RequestConfiguration con i tag di targeting necessari utilizzando il relativo builder, quindi imposta la configurazione chiamando MobileAds.setRequestConfiguration().

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Per applicare i tag di targeting dalla prima richiesta di annuncio, fornisci la configurazione della richiesta durante l'inizializzazione dell'SDK:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

Imposta il trattamento in base all'età

Per aiutarti a rispettare le normative sulla privacy vigenti relative a bambini e adolescenti, GMA Next-Gen SDK fornisce un'impostazione per il trattamento in base all'età. L'impostazione del trattamento in base all'età ti consente di indicare se GMA Next-Gen SDK deve applicare protezioni specifiche per la pubblicazione di annunci per bambini, adolescenti o un'età non specificata.

Puoi impostare il trattamento per l'età con il metodo setAgeRestrictedTreatment() con l'API RequestConfiguration.Builder.

L'esempio seguente indica che le richieste di annunci devono essere soggette al trattamento in base all'età dei minori:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Per indicare il trattamento per adolescenti o per un'età non specificata, sostituisci l'impostazione CHILD con quanto segue:

  • TEEN
  • UNSPECIFIED

Quando utilizzi l'impostazione, GMA Next-Gen SDK include un parametro tfat nelle richieste di annunci. Rivolgiti al tuo consulente legale per determinare il trattamento in base all'età applicabile per i tuoi utenti in base alle tue obbligazioni legali e normative. Per saperne di più, consulta Applica un tag a una richiesta di annuncio da un'app per il trattamento con limiti di età.

Esegui la migrazione al trattamento in base all'età da TFCD e TFUA

L'impostazione di trattamento in base all'età sostituisce le impostazioni ritirate .setTagForChildDirectedTreatment() (TFCD) e .setTagForUnderAgeOfConsent() (TFUA).

La tabella seguente mostra le impostazioni TFCD e TFUA e i relativi equivalenti per il trattamento in base all'età:

TFCD

TFCD Trattamento dati sull'età
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Nessun valore assegnato .setTagForChildDirectedTreatment() AgeRestrictedTreatment.UNSPECIFIED
Nessun equivalente AgeRestrictedTreatment.TEEN

TFUA

TFUA Trattamento dati sull'età
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE AgeRestrictedTreatment.CHILD
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE AgeRestrictedTreatment.UNSPECIFIED
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED AgeRestrictedTreatment.UNSPECIFIED
Nessun valore assegnato .setTagForUnderAgeOfConsent() AgeRestrictedTreatment.UNSPECIFIED
Nessun equivalente AgeRestrictedTreatment.TEEN

Informazioni sulle interazioni del trattamento in base all'età con TFCD e TFUA

Se utilizzi l'impostazione di trattamento in base all'età e le impostazioni TFCD o TFUA, Google applica il trattamento più conservativo.

Inoltra il trattamento dei dati in base all'età con Mediazione AdMob

Se imposti il trattamento in base all'età utilizzando GMA Next-Gen SDK, gli adattatori di mediazione inoltrano l'indicatore del trattamento in base all'età agli SDK di terze parti mediati.

La tabella seguente elenca le versioni dell'adattatore di mediazione che supportano l'inoltro dell'indicatore di trattamento con limite di età all'SDK di terze parti mediato:

Nome dell'adattatore di mediazione Versione minima supportata
AppLovin 13.6.3.0
BidMachine 3.7.1.1
Bigo 5.9.0.1
Chartboost 9.12.1.1
DTExchange (Fyber) 8.4.5.1
i-mobile 2.3.2.4
InMobi 11.3.0.1
IronSource 9.4.3.0
Liftoff Monetize (Vungle) 7.7.4.2
LY (Line) 3.1.1.1
maio 2.0.9.0
Meta (Facebook) 6.21.0.4
Mintegral 17.1.61.1
Moloco 4.10.0.0
MyTarget 5.47.1.1
Pangle 8.1.0.3.1
PubMatic 5.1.2.2
Verve 3.9.0.0

Impostazione per i contenuti destinati ai minori

Ai fini del Children's Online Privacy Protection Act (COPPA), esiste un'impostazione denominata "tag per il trattamento per siti o servizi destinati ai minori". Impostando questo tag, dichiari che questa notifica è accurata e che disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Riconosci che l'utilizzo illecito 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, adotteremo le misure necessarie per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing per la richiesta di annuncio in questione.

Puoi applicare l'impostazione per i contenuti destinati 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 sensi del 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 del COPPA.

  • Chiama setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED se non vuoi indicare come vuoi che i tuoi contenuti vengano trattati ai sensi del COPPA nelle richieste di annunci.

L'esempio seguente indica che vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai sensi del COPPA:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Puoi contrassegnare le richieste di annunci 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). Potresti avere altri obblighi di legge ai sensi del GDPR. Consulta le linee guida dell'Unione Europea e rivolgiti a un consulente legale. Gli strumenti di Google sono studiati per favorire la conformità alle norme e non esonerano i publisher dagli obblighi stabiliti dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando utilizzi questa funzionalità, nella richiesta di annuncio viene incluso un parametro TFUA (tag per utenti di età inferiore all'età del consenso digitale in Europa). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per tutte le richieste di annunci. Inoltre, vengono disattivate le richieste a fornitori di annunci di terze parti, come i pixel di misurazione annunci e gli ad server di terze parti.

Come per le impostazioni per i contenuti destinati ai minori, esiste un metodo in RequestConfiguration.Builder 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 previsto per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale. 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) di età inferiore a quella del consenso digitale.

  • Chiama setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED per indicare che non hai specificato se la richiesta di annuncio deve essere soggetta al trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale.

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

I tag per attivare l'impostazione per siti o servizi destinati ai minori e setTagForUnderAgeOfConsent() non devono essere entrambi impostati su true. In caso contrario, l'impostazione per i contenuti destinati 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 all'interno della tua app devono essere appropriati per la classificazione dei contenuti della tua app, anche se i contenuti sono 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 garantire la conformità alle norme della piattaforma.

Le app possono impostare una classificazione massima dei contenuti degli annunci per le proprie richieste di annunci utilizzando il metodo setMaxAdContentRating . Gli annunci AdMob restituiti quando questa opzione è configurata hanno una classificazione dei contenuti pari o inferiore a quel livello. I valori possibili per questa informazione extra della 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 un'etichetta contenuti digitali non superiore a G:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Scopri di più su:

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 annunci utilizzando il metodo setPublisherPrivacyPersonalizationState() . Quando utilizzi questa funzionalità, un parametro Publisher Privacy Treatment (PPT) viene incluso in tutte le richieste di annunci future 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 = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

Raccogli la posizione approssimativa

GMA Next-Gen SDK può raccogliere la posizione approssimativa per scegliere il targeting degli annunci con targeting in base alla posizione del dispositivo. Se un utente concede l'autorizzazione di accesso alla posizione nella tua app, GMA Next-Gen SDK raccoglie la posizione approssimativa.

A partire dalla versione 1.7.0 di GMA Next-Gen SDK, la raccolta della posizione approssimativa è attiva per impostazione predefinita. Puoi disattivare la raccolta della posizione approssimativa utilizzando il metodo setCoarseLocationCollectionEnabled().

L'esempio seguente disattiva la raccolta della posizione approssimativa:

Kotlin

val requestConfiguration =
  RequestConfiguration.Builder()
    // Disable automatic coarse location collection by the SDK.
    .setCoarseLocationCollectionEnabled(false)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration =
    new RequestConfiguration.Builder()
        // Disable automatic coarse location collection by the SDK.
        .setCoarseLocationCollectionEnabled(false)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Richiesta di annuncio

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

Aggiungi informazioni extra della rete

Le informazioni extra della rete sono dettagli aggiuntivi 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 per Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);