Questa guida spiega come fornire informazioni di targeting a una richiesta di annuncio. Per un un esempio funzionante, scarica l'app Android API Demo.
Prerequisito
- Completa la Guida introduttiva.
RequestConfiguration
RequestConfiguration
è un oggetto che raccoglie informazioni di targeting da applicare a livello globale tramite
MobileAds
statico.
Per aggiornare la configurazione della richiesta, ottieni un builder dall'elenco configurazione, eseguire gli aggiornamenti desiderati e impostarli come segue:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Impostazione destinata 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 presente notifica è accurata e che disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Sei consapevole del fatto che l'abuso di questa impostazione può comportare la chiusura del tuo Account Google.
In qualità di sviluppatore di app, puoi indicare se desideri che Google tratti i tuoi contenuti destinati ai minori quando effettui una richiesta di annuncio. Se indichi se vuoi che Google tratti i tuoi contenuti come destinati ai minori, adottiamo disattivare gli annunci IBA (pubblicità basata sugli interessi) e di remarketing per tale richiesta di annuncio.
L'impostazione può essere utilizzata con tutte le versioni dell'SDK Google Play Services
a RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
:
Chiama
setTagForChildDirectedTreatment
conTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
per indicare che vuoi che contenuti trattati come destinati ai minori ai sensi del COPPA. In questo modo La trasmissione dell'identificatore pubblicità di Android (AAID).Chiama
setTagForChildDirectedTreatment
conTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
per indicare che non vuoi che contenuti trattati come destinati ai minori ai sensi del COPPA.Chiama
setTagForChildDirectedTreatment
conTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
se non vuoi indicare come vorresti che venissero trattati i tuoi contenuti nelle richieste di annunci in relazione al COPPA.
L'esempio seguente indica che vuoi che i tuoi contenuti vengano trattati come contenuti destinati ai minori ai fini della legge 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)
Utenti di età inferiore a quella del consenso digitale
Puoi contrassegnare le richieste di annunci per ricevere il trattamento per gli utenti nel Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale. Questa funzionalità è studiati per facilitare il rispetto delle Regolamento sulla protezione dei dati (GDPR). Tieni presente che potresti avere altre richieste ai sensi del GDPR. Leggere la guida dell'Unione Europea e consultare rivolgersi al proprio consulente legale. Gli strumenti di Google sono studiati per facilitare la conformità alle norme e non esonerano i publisher dalle obbligazioni previste la legge. Scopri di più su come il GDPR influisce sui publisher.
Quando si utilizza questa funzionalità, un tag per utenti al di sotto dell'età del consenso digitale in Europa (TFUA) è incluso nella richiesta di annuncio. Questo parametro disabilita 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 ad server di terze parti.
Come per le impostazioni rivolte ai minori, c'è un metodo
RequestConfiguration.Builder
per impostare il parametro TFUA:
setTagForUnderAgeOfConsent()
,
con le seguenti opzioni.
Chiama
setTagForUnderAgeOfConsent()
conTAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
per indicare che desideri che la richiesta di annuncio riceva il trattamento per gli utenti in Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale. Anche questo impedisce la trasmissione dell'identificatore pubblicità di Android (AAID).Chiama
setTagForUnderAgeOfConsent()
conTAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
per indicare che la richiesta di annuncio non deve ricevere un trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale.Chiama
setTagForUnderAgeOfConsent()
conTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
per indicare che non hai specificato se la richiesta di annuncio deve ricevere un trattamento per gli utenti nel Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale.
L'esempio seguente indica che vuoi che TFUA sia incluso nelle 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 Rivolta ai minori
e setTagForUnderAgeOfConsent()
non devono essere entrambi impostati su true
.
In caso affermativo, l'impostazione destinata ai minori ha la precedenza.
Filtro dei contenuti degli annunci
Per rispettare le norme relative agli annunci inappropriati di Google Play che include le offerte associate all'interno di un annuncio, tutti gli annunci e i relativi le offerte mostrate nella tua app devono essere appropriate per i contenuti valutazione di la tua app, anche se i contenuti di per sé sono conformi alle norme di Google Norme di Google Play.
Strumenti come la classificazione massima dei contenuti degli annunci possono aiutarti ad avere un maggiore controllo sul gli annunci mostrati agli utenti. Puoi impostare una classificazione massima dei contenuti su per aiutare la conformità alle norme della piattaforma.
Le app possono impostare una classificazione massima dei contenuti degli annunci per le richieste di annunci utilizzando l'attributo
setMaxAdContentRating
. Gli annunci AdMob restituiti quando questo è configurato hanno una classificazione dei contenuti pari o
al di sotto di quel livello. I valori possibili per questo extra di rete si basano su
classificazioni delle etichette per i contenuti digitali e deve 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
i contenuti degli annunci restituiti devono corrispondere a una designazione di etichetta per contenuti digitali no
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 annuncio richiesta
Impostare la classificazione massima dei contenuti degli annunci per un'app o account.
Trattamento della privacy dei publisher (beta)
La
Trattamento della privacy degli editori
(PPT) è uno strumento facoltativo che consente alle app di indicare se disattivare gli annunci
la personalizzazione per tutte le richieste di annunci
setPublisherPrivacyPersonalizationState()
.
Quando utilizzi questa funzionalità, viene applicato un parametro PPT (Publisher Privacy Treatment)
incluse in tutte le richieste di annunci future per il resto della sessione.
Per impostazione predefinita, alle richieste di annunci inviate a Google vengono pubblicati annunci personalizzati. Le seguenti 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)
Richiesta di annuncio
L'oggetto AdManagerAdRequest
raccoglie i criteri di targeting
informazioni da inviare con una richiesta di annuncio.
Targeting personalizzato
Puoi trasmettere coppie chiave-valore personalizzate per scegliere come target le campagne Google Ad Manager (linea
articoli) a 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 passare più valori per una chiave sotto forma di elenco di stringhe. Ad esempio, per Rivolgersi a persone di età compresa tra i 20 e i 25 anni, anziché solo i 25 anni.
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
Guarda l'esempio di targeting personalizzato di Ad Manager. per l'implementazione del targeting personalizzato nell'app Android API Demo.
Esclusioni di categoria
Puoi aggiungere a una richiesta un livello di esclusione di categoria a livello di area 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 Android API Demo.
Identificatori forniti dal publisher
Puoi impostare un identificatore fornito dal publisher (PPID) da utilizzare nella quota limite, segmentazione del pubblico e targeting, rotazione degli annunci sequenziale e altre controlli di pubblicazione degli annunci basati sul pubblico su tutti i dispositivi.
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 dai publisher (PPID) in Android app API demo.
Indicatori forniti dal publisher
Puoi inviare dati sul pubblico e contestuali indicatori forniti dal publisher (PPS) nelle richieste di annunci. Con i PPS, puoi usare i dati utente per migliorare la monetizzazione programmatica comunicando le caratteristiche del pubblico offerenti in tutto tipi di transazioni, utilizzando tassonomie standard, senza la necessità di condividere gli identificatori utente. Il tuo pubblico di queste caratteristiche possono includere dati comportamentali e basati sugli interessi (Pubblico IAB Tassonomia 1.1) e contestuale (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 di contenuti per gli annunci con targeting dei contenuti e la sicurezza del brand, puoi chiamare
setContentUrl()
quando crei 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)
Le applicazioni che mostrano contenuti dinamici destinati a diversi segmenti di pubblico sono
in grado di fornire un breve elenco di URL utilizzando
setNeighboringContentUrls()
quando crei 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()
è diverso da .setContentUrl()
in quanto
utilizzati per la sicurezza del brand.