Questa guida spiega come fornire informazioni di targeting a una richiesta di annuncio.
Per vedere il targeting degli annunci in azione, scarica l'app demo dell'API iOS in Swift o Objective-C.
Prerequisiti
Completa la guida introduttiva.
GADRequestConfiguration
GADRequestConfiguration
è un oggetto che raccoglie informazioni di targeting da applicare a livello globale tramite l'istanza condivisa GADMobileAds
. È possibile accedervi con il seguente codice:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Impostazione destinata ai minori
Ai fini del Children's Online Privacy Protection Act (COPPA), è disponibile un'impostazione chiamata tagForChildDirectedTreatment
.
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. Quando indichi che desideri che Google tratti i tuoi contenuti come destinati ai minori, adotta misure per disattivare gli annunci IBA (pubblicità basata sugli interessi) e di remarketing per tale richiesta di annuncio. Le opzioni di impostazione sono le seguenti:
- Imposta
tagForChildDirectedTreatment
sutrue
per indicare che vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai sensi del COPPA. Questo impedisce la trasmissione dell'identificatore pubblicità, IDFA. - Imposta
tagForChildDirectedTreatment
sufalse
per indicare che non vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai sensi del COPPA. - Non impostare
tagForChildDirectedTreatment
se non vuoi indicare come vorresti che i tuoi contenuti venissero trattati in conformità al COPPA.
L'esempio seguente indica che vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai sensi del COPPA:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;
Se imposti questo tag, dichiari che la presente notifica è accurata e disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Sei consapevole che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.
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à è progettata per facilitare il rispetto del Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che potresti avere altri obblighi di legge ai sensi del GDPR. Consulta la guida dell'Unione Europea e rivolgiti al tuo 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 interessa i publisher.
Quando utilizzi questa funzionalità, in tutte le richieste di annunci future verrà incluso un tag per utenti di età inferiore all'età del consenso digitale (TFUA). Questo parametro disattiva la pubblicità personalizzata, incluso il remarketing, per quella specifica richiesta di annuncio. 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.
L'impostazione può essere utilizzata con tutte le versioni dell'SDK Google Mobile Ads impostando la proprietà tagForUnderAgeOfConsent
sull'oggetto GADMobileAds.requestConfiguration
e passando true
.
- Imposta
tagForUnderAgeOfConsent
sutrue
per indicare che vuoi che le richieste di annunci vengano gestite in modo adatto agli utenti di età inferiore a quella del consenso. Questo impedisce anche la trasmissione dell'identificatore pubblicità, IDFA. - Se non imposti il criterio
tagForUnderAgeOfConsent
, indichi che non vuoi che le richieste di annunci vengano gestite in modo adatto agli utenti di età inferiore a quella del consenso digitale.
L'esempio seguente indica che vuoi che TFUA sia incluso nella richiesta di annuncio:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
I tag per attivare l'impostazione rivolta ai minori e tagForUnderAgeOfConsent
non devono essere entrambi impostati su true
.
In caso affermativo, l'impostazione destinata ai minori ha la precedenza.
Filtro dei contenuti degli annunci
Le app possono impostare una classificazione massima dei contenuti degli annunci per tutte le richieste di annunci utilizzando la
proprietà maxAdContentRating
di GADRequestConfiguration
. Questa impostazione si applica a tutte le richieste di annunci future per il resto della sessione. I valori possibili per questa proprietà si basano sulle classificazioni delle etichette per contenuti digitali e devono essere una delle seguenti costanti:
GADMaxAdContentRatingGeneral
GADMaxAdContentRatingParentalGuidance
GADMaxAdContentRatingTeen
GADMaxAdContentRatingMatureAudience
Il seguente codice configura tutte le richieste di annunci per specificare che i contenuti dell'annuncio restituiti devono corrispondere a una designazione di Etichetta contenuti digitali non superiore a GADMaxAdContentRatingGeneral
.
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Trattamento della privacy dei publisher (beta)
L'
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 la proprietà
publisherPrivacyPersonalizationState
GADRequestConfiguration
. Quando si utilizza questa funzionalità, un parametro
del trattamento della privacy del publisher (PPT) viene incluso 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. Il seguente codice disattiva la personalizzazione degli annunci per tutte le richieste di annunci:
Swift
GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
.disabled
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
GADPublisherPrivacyPersonalizationStateDisabled;
GAMRequest
L'oggetto GAMRequest
raccoglie le informazioni di targeting
da inviare con una richiesta di annuncio.
URL contenuti
Quando richiedono un annuncio, le app possono trasmettere l'URL dei contenuti che pubblicano. In questo modo il targeting per parole chiave può abbinare l'annuncio ai contenuti.
Ad esempio, se la tua app richiede un annuncio mentre mostra contenuti di
https://www.example.com
, puoi trasmettere questo URL per scegliere come target parole chiave pertinenti:
Swift
let request = GAMRequest()
request.contentURL = "https://www.example.com"
Objective-C
GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";
Targeting personalizzato
Dopo aver configurato le coppie chiave-valore nell'interfaccia utente di Ad Manager, imposta il targeting personalizzato con le coppie chiave-valore in una richiesta di annuncio. Gli elementi pubblicitari che hanno come target queste coppie chiave sono idonei a essere pubblicati per quella richiesta di annuncio. Per scegliere come target più valori per una chiave, inserisci i valori come stringa separata da virgole.
Swift
let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];
Objective-C
GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};
Sicurezza del brand (beta)
Le app che mostrano contenuti dinamici destinati a diversi segmenti di pubblico possono fornire un breve elenco di URL tramite la proprietà neighboringContentURLs
. Gli URL di contenuti
confinanti sono diversi dalla proprietà contentURL
in quanto vengono utilizzati
solo per la sicurezza del brand.
Supponiamo che la tua app mostri contenuti di quattro URL in un feed che contiene anche annunci. Puoi richiedere annunci con una classificazione dei contenuti simile a quella degli URL indicati trasmettendoli in questo modo:
Swift
let request = GAMRequest()
request.neighboringContentURLs =
["https://www.example1.com", "https://www.example2.com",
"https://www.example3.com", "https://www.example4.com"]
Objective-C
GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
@[@"https://www.example1.com", @"https://www.example2.com",
@"https://www.example3.com", @"https://www.example4.com"];
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 altre impostazioni di pubblicazione degli annunci basate sul pubblico su tutti i dispositivi.
L'impostazione del PPID viene eseguita tramite GAMRequest
:
Swift
let request = GAMRequest()
request.publisherProvidedID = "AB123456789"
Objective-C
GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";
Guarda l'esempio di PPID di Ad Manager per un'implementazione degli identificatori forniti dal publisher (PPID) nell'app demo dell'API iOS:
Indicatori forniti dal publisher
Puoi inviare dati sul pubblico e contestuali 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 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, basati sugli interessi (Tassonomia del pubblico IAB 1.1) e dati contestuali (Tassonomia dei contenuti IAB 2.2).
Swift
let extras = GADExtras()
extras.additionalParameters = [
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
"IAB_AUDIENCE_1_1": [6, 284],
// Set the content to sedan, station wagon and SUV automotive values.
"IAB_CONTENT_2_2": [4, 5, 6]
]
let request = GAMRequest()()
request.register(extras)
Objective-C
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
@"IAB_AUDIENCE_1_1":@[@6, @284],
// Set the content to sedan, station wagon and SUV automotive values.
@"IAB_CONTENT_2_2":@[@4,@5,@6]
};
GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];
Domande frequenti
- Quale targeting viene utilizzato quando un annuncio si aggiorna automaticamente?
- All'aggiornamento dell'annuncio, l'oggetto
GAMRequest
specificato in precedenza viene nuovamente utilizzato per il targeting. Per impostare un nuovo targeting, richiama esplicitamenteloadRequest
suGAMBannerView
con un nuovo oggettoGAMRequest
. - Come faccio a trasmettere parametri di targeting aggiuntivi alle reti di mediazione?
- Consulta Mediazione per scoprire come inviare il targeting alle reti di mediazione.