Targeting

Questa guida spiega come fornire informazioni di targeting a una richiesta di annuncio. Per un esempio funzionante, scarica l'app Demo API Android.

Scarica la demo dell'API

Prerequisito

• Completa la Guida introduttiva.

RequestConfiguration

RequestConfiguration è un oggetto che raccoglie informazioni di targeting da applicare a livello globale tramite un metodo statico MobileAds.

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

Java

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

Kotlin

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

Impostazione Rivolto ai minori

Ai fini del Children's Online Privacy Protection Act (COPPA), è presente un'impostazione chiamata "tag per il trattamento per siti o servizi destinati ai minori". Se imposti questo tag, dichiari che la notifica è accurata e che hai l'autorizzazione ad agire per conto del proprietario dell'app. Sei consapevole che l'utilizzo scorretto di questa impostazione può 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 le misure necessarie per disattivare gli annunci per la pubblicità basata sugli interessi e di remarketing nella richiesta di annuncio in questione.

L'impostazione può essere utilizzata con tutte le versioni dell'SDK Google Play Services tramite RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• 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. Ciò impedisce 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 del COPPA.

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

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

Java

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

Kotlin

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

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

Utenti di età inferiore a quella del consenso digitale

Puoi contrassegnare le richieste di annunci per ricevere il trattamento per gli utenti al di sotto dell'età 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 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à 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 tag per gli utenti di età inferiore all'età del consenso digitale (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per tutte le richieste di annunci. Inoltre, disattiva le richieste a fornitori di annunci di terze parti, come i pixel di misurazione degli annunci e gli ad server di terze parti.

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

• Chiama setTagForUnderAgeOfConsent() con l'indirizzo TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE per indicare che vuoi che la richiesta di annuncio riceva il trattamento per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE). Ciò impedisce inoltre 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 di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE).

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

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

Java

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

Kotlin

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

I tag per attivare l'impostazione Rivolto ai minori e setTagForUnderAgeOfConsent() non devono essere entrambi impostati su true. In caso affermativo, l'impostazione Rivolto ai minori ha la precedenza.

Filtro dei contenuti degli annunci

Per rispettare le norme relative agli annunci inappropriati di Google Play che includono le offerte associate a un annuncio, tutti gli annunci e le relative 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 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 metodo setMaxAdContentRating. Gli annunci AdMob restituiti quando questa funzione è configurata hanno una classificazione dei contenuti pari o inferiore a quel livello. I valori possibili per questa rete aggiuntiva si basano su classificazioni delle etichette per 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 codice seguente configura un oggetto RequestConfiguration per specificare che il contenuto dell'annuncio restituito deve corrispondere a una designazione di etichetta per contenuti digitali non superiore a G:

Java

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

Kotlin

var 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 di classificazione dei contenuti specificate tramite l'SDK Google Mobile Ads sostituiscono quelle configurate utilizzando l' Ad Manager interfaccia utente.

Trattamento della privacy dei publisher (beta)

Il Trattamento della privacy per i publisher (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 si utilizza questa funzionalità, un parametro per il trattamento della privacy (PPT) del publisher è incluso in tutte le richieste di annunci future per il resto della sessione.

Per impostazione predefinita, alle richieste di annunci inviate a Google vengono mostrati annunci personalizzati. Il seguente codice disattiva la personalizzazione degli annunci per tutte le richieste di annunci:

Java

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

Kotlin

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

Nota: per le richieste di annunci con più indicatori sulla privacy dell'utente, avrà la precedenza l'indicatore più restrittivo. Consulta la API Publisher Privacy trattamento per esempi specifici.

Richiesta di annuncio

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

Targeting personalizzato

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

Java

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

Kotlin

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

Puoi trasferire più valori per una chiave sotto forma di elenco di stringhe. Ad esempio, scegliere come target individui di metà ventenni anziché solo 25.

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

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

Esclusioni di categorie

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

Java

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

Kotlin

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

Guarda l'esempio di esclusione di categoria di Ad Manager per un'implementazione delle esclusioni di categoria nell'app Demo API Android.

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.

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

Ecco un esempio di impostazione del PPID:

Java

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

Kotlin

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

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

Indicatori forniti dal publisher

Puoi inviare dati contestuali e relativi al 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 transazioni, 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).

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

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

URL contenuti

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

Java

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

Kotlin

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

Sicurezza del brand (beta)

Nota: l'URL di contenuti multipli è in versione beta chiusa per un gruppo selezionato di publisher.

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

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

Kotlin

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

.setNeighboringContentUrls() differisce da .setContentUrl() perché è utilizzato solo per la sicurezza del brand.

Nota: setNeighboringContentUrls utilizza solo i primi quattro URL dell'elenco. Le altre vengono ignorate.