Targeting

Seleziona la piattaforma: Android iOS Unity Flutter Android (legacy)

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 per iOS in Swift o Objective-C.

Scarica la demo dell'API

Prerequisiti

Prima di continuare, configura Google Mobile Ads SDK.

GADRequestConfiguration

GADRequestConfiguration è un oggetto che raccoglie le informazioni di targeting da applicare a livello globale tramite l'istanza condivisa GADMobileAds. Puoi accedervi con il seguente codice:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Per assicurarti che tutte le richieste di annunci applichino le modifiche alla configurazione della richiesta, imposta la configurazione della richiesta prima di inizializzare Google Mobile Ads SDK.

Imposta il trattamento in base all'età

Per aiutarti a gestire la conformità alle normative sulla privacy vigenti relative a bambini e adolescenti, Google Mobile Ads SDK fornisce un'impostazione per il trattamento in base all'età. L'impostazione del trattamento in base all'età ti consente di indicare se Google Mobile Ads SDK deve applicare protezioni specifiche per la pubblicazione di annunci per bambini, adolescenti o un'età non specificata.

Puoi impostare il trattamento in base all'età con la proprietà ageRestrictedTreatment su GADRequestConfiguration.

L'esempio seguente indica che le richieste di annunci devono essere soggette al trattamento in base all'età dei minori:

Swift

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

Per indicare il trattamento per adolescenti o per età non specificata, sostituisci l'impostazione .child con quanto segue:

• .teen
• .unspecified

Objective-C

// Indicates that ad requests should have child age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentChild;
RequestConfigurationSnippets.m

Per indicare il trattamento per adolescenti o per età non specificata, sostituisci l'impostazione GADAgeRestrictedTreatmentChild con quanto segue:

• GADAgeRestrictedTreatmentTeen
• GADAgeRestrictedTreatmentUnspecified

Quando utilizzi l'impostazione, Google Mobile Ads SDK include un parametro tfat nelle richieste di annunci. Consulta il tuo consulente legale per determinare il trattamento in base all'età minima richiesta per la tua base utenti in base agli obblighi legali e normativi. Per saperne di più, consulta Applica un tag a una richiesta di annuncio da un'app per il trattamento con limiti di età.

Esegui la migrazione al trattamento in base all'età da TFCD e TFUA

L'impostazione di trattamento in base all'età sostituisce le proprietà ritirate tagForChildDirectedTreatment (TFCD) e tagForUnderAgeOfConsent (TFUA).

La tabella seguente mostra le impostazioni tagForChildDirectedTreatment e tagForUnderAgeOfConsent e i relativi equivalenti per il trattamento in base all'età:

TFCD

tagForChildDirectedTreatment	Trattamento dati sull'età
tagForChildDirectedTreatment = true	GADAgeRestrictedTreatmentChild
tagForChildDirectedTreatment = false	GADAgeRestrictedTreatmentUnspecified
Nessun valore assegnato a tagForChildDirectedTreatment	GADAgeRestrictedTreatmentUnspecified
Nessun equivalente	GADAgeRestrictedTreatmentTeen

TFUA

tagForUnderAgeOfConsent	Trattamento dati sull'età
tagForUnderAgeOfConsent = true	GADAgeRestrictedTreatmentChild
tagForUnderAgeOfConsent = false	GADAgeRestrictedTreatmentUnspecified
Nessun valore assegnato a tagForUnderAgeOfConsent	GADAgeRestrictedTreatmentUnspecified
Nessun equivalente	GADAgeRestrictedTreatmentTeen

Informazioni sulle interazioni del trattamento in base all'età con TFCD e TFUA

Se utilizzi l'impostazione di trattamento in base all'età e le impostazioni TFCD o TFUA, Google applica il trattamento più conservativo.

Nota: per gli utenti che hanno eseguito l'accesso agli Account Google gestiti con Family Link, tutti i contenuti vengono trattati automaticamente come destinati ai minori per tutte le richieste di annunci.

Inoltra il trattamento dei dati in base all'età con Mediazione AdMob

Se imposti il trattamento in base all'età utilizzando Google Mobile Ads SDK, gli adattatori di mediazione inoltrano l'indicatore del trattamento in base all'età agli SDK di terze parti mediati.

La tabella seguente elenca le versioni dell'adattatore di mediazione che supportano l'inoltro dell'indicatore di trattamento per utenti minorenni all'SDK di terze parti mediato:

Nome dell'adattatore di mediazione	Versione minima supportata
AppLovin	13.6.3.0
BidMachine	3.6.1.1
Bigo	5.2.1.0
Chartboost	9.12.0.1
DTExchange (Fyber)	8.4.7.1
i-mobile	2.3.4.7
InMobi	11.2.0.1
IronSource	9.4.1.0.1
Liftoff Monetize (Vungle)	7.7.2.1
LY Ads (Line Ads)	3.0.1.1
maio	2.2.1.2
Meta (Facebook)	6.21.1.1
Mintegral	8.1.3.1
Moloco	4.6.1.1
MyTarget	5.43.0.0
Pangle	7.9.1.1.1
PubMatic	5.1.0.1
Verve	3.8.1.1

Impostazione per i contenuti destinati ai minori

Avviso: la proprietà tagForChildDirectedTreatment è stata ritirata. Utilizza invece la proprietà ageRestrictedTreatment.

Ai fini del Children's Online Privacy Protection Act (COPPA), esiste 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 vuoi che Google tratti i tuoi contenuti come destinati ai minori, Google adotta le misure necessarie per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing per la richiesta di annuncio in questione. Le opzioni di impostazione sono le seguenti:

• Imposta tagForChildDirectedTreatment su 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à, IDFA.
• Imposta tagForChildDirectedTreatment su false per indicare che non vuoi che i tuoi contenuti vengano trattati come rivolti ai minori ai sensi del COPPA.
• Non impostare tagForChildDirectedTreatment se non vuoi indicare in che modo vuoi che i tuoi contenuti vengano trattati in relazione al COPPA.

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Impostando questo tag, dichiari che questa notifica è accurata e che disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Riconosci che l'utilizzo illecito di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Utenti di età inferiore a quella del consenso digitale

Avviso: la proprietà tagForUnderAgeOfConsent è stata ritirata. Imposta invece la proprietà ageRestrictedTreatment.

Puoi contrassegnare le richieste di annunci perché ricevano il trattamento previsto per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE). Questa funzionalità è pensata per facilitare il rispetto del Regolamento generale sulla protezione dei dati (GDPR). Potresti avere altri obblighi di legge ai sensi del GDPR. Consulta le linee guida dell'Unione Europea e rivolgiti a un consulente legale. 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 utilizzi questa funzionalità, in tutte le richieste di annunci future verrà incluso un parametro Tag per utenti di età inferiore a quella del consenso digitale in Europa (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per quella specifica richiesta di annuncio. 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.

L'impostazione può essere utilizzata con tutte le versioni di Google Mobile Ads SDK impostando la proprietà tagForUnderAgeOfConsent sull'oggetto GADMobileAds.requestConfiguration e passando true.

• Imposta tagForUnderAgeOfConsent su true per indicare che vuoi che le richieste di annunci vengano gestite in modo adatto agli utenti di età inferiore a quella del consenso digitale. In questo modo, viene impedita anche la trasmissione dell'identificatore pubblicità, IDFA.
• Se non imposti tagForUnderAgeOfConsent, significa che non vuoi che le richieste di annunci vengano gestite in modo adatto agli utenti di età inferiore a quella del consenso digitale.

Il seguente esempio indica che vuoi includere il parametro TFUA nella richiesta di annuncio:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

I tag per attivare l'impostazione per siti o servizi destinati ai minori e tagForUnderAgeOfConsent non devono essere entrambi impostati su true. In caso contrario, l'impostazione per i contenuti destinati ai minori avrà la precedenza.

Punto chiave :questo parametro tagForUnderAgeOfConsent non viene inoltrato agli adattatori di mediazione per le origini annuncio di terze parti. È tua responsabilità assicurarti che ogni rete pubblicitaria di terze parti nella tua app pubblichi annunci appropriati per gli utenti di età inferiore a quella del consenso digitale ai sensi del GDPR.

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 dei contenuti digitali e devono essere una delle seguenti costanti:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

Il seguente codice configura tutte le richieste di annunci in modo da specificare che i contenuti degli annunci restituiti devono corrispondere a un'etichetta contenuti digitali non superiore a GADMaxAdContentRatingGeneral.

Punto chiave: le impostazioni del filtro di classificazione dei contenuti specificate tramite l'SDK sostituiscono tutte le impostazioni configurate utilizzando la UI di AdMob.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

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 la proprietà publisherPrivacyPersonalizationState di GADRequestConfiguration. Quando utilizzi questa funzionalità, un parametro di trattamento della privacy del publisher (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:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Nota: per le richieste di annunci con più indicatori per la privacy degli utenti, avrà la precedenza l'indicatore più restrittivo. Per esempi specifici, consulta la documentazione dell'API Publisher Privacy Treatment.

GADRequest

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

Aggiungi informazioni extra della rete

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

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

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

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 = Request()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

Domande frequenti

Quale targeting viene utilizzato quando un annuncio si aggiorna automaticamente?

All'aggiornamento dell'annuncio, l'oggetto GADRequest specificato in precedenza viene utilizzato di nuovo per il targeting. Per impostare un nuovo targeting, chiama esplicitamente loadRequest su GADBannerView con un nuovo oggetto GADRequest.

Come faccio a trasmettere parametri di targeting aggiuntivi alle reti di mediazione?

Consulta Mediazione per scoprire come inviare il targeting alle reti di mediazione.