Targeting

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

Prerequisito

Prima di continuare, set up 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 RequestConfiguration.Builder documentazione.

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

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

MobileAds.setRequestConfiguration(requestConfiguration)

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:

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 Ad Manager 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.
}

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 Ad Manager 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 dati sull'età

Per aiutarti a gestire la conformità alle normative sulla privacy applicabili relative a bambini e adolescenti, GMA Next-Gen SDK fornisce un'impostazione di trattamento dati sull'età. L' impostazione di trattamento dati sull'età ti consente di indicare se GMA Next-Gen SDK deve applicare protezioni specifiche per la pubblicazione degli annunci per bambini o adolescenti. Quando utilizzi l'impostazione, GMA Next-Gen SDK include un parametro tfat nelle richieste di annunci. Consulta il tuo consulente legale per determinare l'età minima richiesta applicabile ai tuoi utenti in base ai tuoi obblighi legali e normativi.

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

Imposta il trattamento dati sull'età per i bambini

L'esempio seguente indica che le richieste di annunci devono ricevere il trattamento per l'età dei bambini:

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

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

Imposta il trattamento dati sull'età per gli adolescenti

L'esempio seguente indica che le richieste di annunci devono ricevere il trattamento per gli adolescenti:

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Imposta nessun gruppo sperimentale sull'età specifico

L'esempio seguente indica che le richieste di annunci non devono ricevere un trattamento specifico per l'età:

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Esegui la migrazione al trattamento per età da TFCD e TFUA

L'impostazione di trattamento dati sull'età sostituisce le impostazioni .setTagForChildDirectedTreatment() (TFCD) e .setTagForUnderAgeOfConsent() (TFUA) ritirate.

La tabella seguente mostra le impostazioni TFCD e TFUA e i relativi equivalenti di trattamento sull'età:

Comprendi le interazioni del trattamento dati sull'età con TFCD e TFUA

Se imposti il trattamento dati sull'età e le impostazioni TFCD o TFUA, Google applica il trattamento più conservativo.

Impostazione per siti o servizi rivolti 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". Se imposti questo tag, certifichi che questa notifica contiene informazioni accurate e che sei autorizzato ad agire per conto del proprietario dell'app. Sei consapevole del fatto 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 rivolti ai minori quando esegui una richiesta di annuncio. Se indichi che vuoi che Google tratti i tuoi contenuti come rivolti ai minori, adottiamo misure per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing nella richiesta di annuncio.

Puoi applicare l'impostazione per siti o servizi 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 rivolti ai minori ai fini del COPPA. In questo modo si impedisce la trasmissione dell'identificatore pubblicità Android (AAID).

• Chiama setTagForChildDirectedTreatment con TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE per indicare che non vuoi che i tuoi contenuti vengano trattati come rivolti 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 in relazione al COPPA nelle richieste di annunci.

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

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

MobileAds.setRequestConfiguration(requestConfiguration)

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

MobileAds.setRequestConfiguration(requestConfiguration);

Utenti di età inferiore a quella del consenso digitale

È possibile contrassegnare le richieste di annunci in modo da ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore all'età del consenso digitale. Questa funzionalità è pensata per agevolare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Va tenuto presente che potrebbero essere previste altre obbligazioni legali ai sensi del GDPR. Consulta le indicazioni dell'Unione Europea e rivolgiti a un consulente legale. Tieni presente che gli strumenti di Google sono studiati per favorire la conformità alle norme e non esonerano alcun publisher dalle obbligazioni previste dal diritto. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, nella richiesta di annunci 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 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 siti o servizi rivolti ai minori, in RequestConfiguration.Builder è presente 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 nello Spazio economico europeo (SEE) di età inferiore all'età del consenso digitale. In questo modo si impedisce anche la trasmissione dell'identificatore pubblicità 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 all'età 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 ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore all'età del consenso digitale.

L'esempio seguente indica che vuoi che TFUA sia incluso nelle tue richieste di annunci:

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

MobileAds.setRequestConfiguration(requestConfiguration)

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 contenuti rivolti ai minori e setTagForUnderAgeOfConsent() non devono essere entrambi impostati sutrue contemporaneamente. 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 all'interno dell'app devono essere appropriati per la classificazione dei contenuti dell'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 richieste di annunci utilizzando il setMaxAdContentRating metodo. 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 degli annunci restituiti devono corrispondere a una designazione di etichetta dei contenuti digitali non superiore a G:

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

MobileAds.setRequestConfiguration(requestConfiguration)

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

MobileAds.setRequestConfiguration(requestConfiguration);

Scopri di più sull'impostazione della classificazione massima dei contenuti per ogni richiesta di annuncio.

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 setPublisherPrivacyPersonalizationState() metodo. Quando utilizzi questa funzionalità, nelle richieste di annunci future per il resto della sessione viene incluso un parametro Publisher Privacy Treatment (PPT).

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:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

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

MobileAds.setRequestConfiguration(requestConfiguration);

Richiesta di annuncio

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

Aggiungi extra di rete

Le informazioni extra della rete sono dettagli aggiuntivi inviati con una richiesta di annuncio che sono specifici per una singola origine annuncio.

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

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)

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);

Targeting personalizzato

Puoi trasmettere coppie chiave-valore personalizzate per il targeting delle campagne (elementi pubblicitari) di Google Ad Manager. L'esempio seguente trasmette una coppia chiave-valore personalizzata in una richiesta di annuncio:

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

Puoi trasmettere più valori per una chiave come elenco di stringhe. Ad esempio, per il targeting di persone di età compresa tra i 20 e i 29 anni anziché solo di 25 anni.

.putCustomTargeting("age", listOf("24", "25", "26"))

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

Esclusioni di categoria

Puoi aggiungere un livello di esclusione di categoria a livello di slot a una richiesta utilizzando il addCategoryExclusion() metodo:

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

// Example: Exclude "automobile" and "boat" categories.
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Per un'implementazione delle esclusioni di categoria nell'app Android API Demo, consulta l'esempio di esclusioni di categoria di Ad Manager.

Identificatori forniti dal publisher

Puoi impostare un identificatore fornito dal publisher (PPID) da utilizzare per la quota limite, la segmentazione del pubblico, il targeting per pubblico, la rotazione degli annunci sequenziale e altri controlli di pubblicazione degli annunci basati sul pubblico su tutti i dispositivi.

Ecco un esempio di impostazione del PPID:

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID")
    .setPublisherProvidedId("AB123456789")
    .build();

Per un'implementazione degli identificatori forniti dal publisher (PPID) nell'app Android API Demo, consulta l'esempio di PPID di Ad Manager.

Indicatori forniti dal publisher

Puoi inviare dati contestuali e sui segmenti di pubblico come indicatori forniti dal publisher (PPS) nelle richieste di annunci. Con i PPS, puoi utilizzare i dati utente per migliorare la monetizzazione programmatica comunicando le caratteristiche del tuo pubblico agli offerenti in tutti i tipi di transazione, utilizzando tassonomie standard, senza la necessità di condividere gli identificatori utente. Le caratteristiche del pubblico possono includere dati comportamentali e basati sugli interessi (Tassonomia del pubblico IAB 1.1) e dati contestuali (Tassonomia dei contenuti IAB 2.2).

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build()

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

URL contenuti

Per fornire un URL dei contenuti per gli annunci con targeting per contenuti e la sicurezza del brand, aggiungi quanto segue:

val builder = AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com")
val request = builder.build()

AdRequest.Builder builder = new AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com");
AdRequest request = builder.build();

Sicurezza del brand (beta)

Le applicazioni che mostrano contenuti dinamici destinati a segmenti di pubblico diversi possono fornire un breve elenco di URL:

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdRequest.Builder("AD_UNIT_ID")
  .setNeighboringContentUrls(urls)
  .build()

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() differisce da .setContentUrl() in quanto viene utilizzato solo per la sicurezza del brand.