Targeting

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

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

Scarica la demo dell'API

Prerequisito

• Completa la Guida introduttiva.

RequestConfiguration

RequestConfiguration raccoglie le informazioni sul 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 generatore 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);

Impostazione per i 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 hai l'autorizzazione 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, adotteremo misure 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 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 sensi 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 base alla legge COPPA nelle richieste di annunci.

Il seguente esempio indica che vuoi che i tuoi contenuti vengano trattati come rivolti ai bambini ai sensi 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 hanno automaticamente tutti i contenuti trattati come rivolti ai bambini per tutte le richieste di annunci.

Utenti di età inferiore a quella minima richiesta nel tuo paese

Puoi contrassegnare le richieste di annunci in modo da ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella minima richiesta nel proprio paese. Questa funzionalità è pensata per agevolare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che potresti avere altre obligations 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 i publisher dagli obblighi stabiliti dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, nella richiesta di annunci viene incluso un parametro Tag per utenti sotto l'età del consenso in Europa (TFUA). Questo parametro disattiva la pubblicità personalizzata, incluso il remarketing, per tutte le richieste di annunci. 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 per i minori, in RequestConfiguration.Builder è disponibile 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 nel Spazio economico europeo (SEE) di età inferiore a quella del consenso. Inoltre, viene impedita la trasmissione dell'identificatore pubblicità di Android (AAID).

• Chiama setTagForUnderAgeOfConsent() con TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE per indicare che la richiesta di annuncio non deve essere trattata per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella minima richiesta nel proprio paese.

• 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 a quella minima richiesta nel proprio paese.

Il seguente esempio indica che vuoi che TFUA sia incluso 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 Per i minori e setTagForUnderAgeOfConsent() non devono essere entrambi impostati contemporaneamente su true. Se lo sono, 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 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 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 annunci utilizzando il metodo setMaxAdContentRating . Gli annunci AdMob restituiti quando questa impostazione è configurata hanno una classificazione dei contenuti pari o inferiore a questo livello. I valori possibili per questo 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 una designazione dell'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 per la classificazione dei contenuti specificate tramite l'SDK Google Mobile Ads superano qualsiasi impostazione configurata utilizzando la Ad Manager UI.

Publisher Privacy Treatment (beta)

L' 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 di trattamento della privacy dell'editore (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 = 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 dell'utente, avrà la precedenza l'indicatore più restrittivo. Per esempi specifici, consulta la documentazione dell' API Publisher Privacy Treatment .

Richiesta di annuncio

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

Targeting personalizzato

Puoi passare coppie chiave-valore personalizzate per scegliere come target le campagne Google Ad Manager (elementi pubblicitari) tramite AdManagerAdRequest.Builder.addCustomTargeting():

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

Puoi passare più valori per una chiave sotto forma di elenco di stringhe. Ad esempio, per scegliere come target persone di circa 25 anni anziché solo di 25 anni.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Consulta l'esempio di targeting personalizzato di Ad Manager per un'implementazione del targeting personalizzato nell'app di demo dell'API Android.

Esclusioni di categoria

Puoi aggiungere un livello di esclusione di categorie a livello di area a una richiesta utilizzando il metodo addCategoryExclusion() fornito da AdManagerAdRequest.Builder:

Kotlin

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

Java

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

Consulta l'esempio di esclusioni di categorie di Ad Manager per un'implementazione delle esclusioni di categorie nell'app di demo dell'API Android.

Identificatori forniti dal publisher

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

Nota: questa funzionalità non è disponibile per tutti i publisher. Per maggiori dettagli, consulta Informazioni sugli identificatori forniti dai publisher.

Ecco un esempio di impostazione del PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Java

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

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

Indicatori forniti dal publisher

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

Kotlin

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()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

Java

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

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

URL contenuti

Per fornire un URL dei contenuti per gli annunci con targeting per contenuti e la sicurezza del brand, puoi chiamare setContentUrl() durante la creazione di un AdManagerAdRequest:

Kotlin

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

Java

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

Sicurezza del brand (beta)

Nota: gli URL di contenuti multipli sono in versione beta chiusa per un gruppo selezionato di publisher.

Le applicazioni che mostrano contenuti dinamici destinati a segmenti di pubblico diversi sono in grado di fornire un breve elenco di URL utilizzando il metodo setNeighboringContentUrls() quando viene creato un AdManagerAdRequest:

Kotlin

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

Java

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");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

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

Nota: setNeighboringContentUrls utilizza solo i primi quattro URL nell'elenco. Gli altri vengono ignorati.