Targeting

Seleziona la piattaforma: Android iOS Unity Flutter

Questa guida spiega come fornire informazioni sul 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.

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 GADMobileAds condivisa. 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 delle richieste, imposta la configurazione delle richieste prima di inizializzare Google Mobile Ads SDK.

Imposta il trattamento dell'età

Per aiutarti a gestire la conformità alle normative sulla privacy vigenti relative a bambini e adolescenti, Google Mobile Ads SDK fornisce un'impostazione di trattamento dell'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 degli annunci per bambini o adolescenti. Quando utilizzi l'impostazione, Google Mobile Ads SDK include un parametro tfat nelle richieste di annuncio. Consulta il tuo consulente legale per determinare l'età minima richiesta applicabile ai tuoi utenti in base ai tuoi obblighi legali e normativi.

Puoi impostare il trattamento dell'età con la proprietà ageRestrictedTreatment su GADRequestConfiguration.

Impostare il trattamento in base all'età dei minori

L'esempio seguente indica che le richieste di annunci devono ricevere il trattamento per età dei minori:

Swift

// Indicate that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child

Objective-C

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

Impostare il trattamento per adolescenti

L'esempio seguente indica che le richieste di annunci devono essere trattate come richieste di annunci per adolescenti:

Swift

// Indicate that ad requests should have teenage treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen

Objective-C

// Indicate that ad requests should have teenage treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentTeen;

Imposta nessun gruppo sperimentale specifico per l'età

L'esempio seguente indica che le richieste di annunci non devono ricevere un trattamento specifico in base all'età:

Swift

// Indicate that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified

Objective-C

// Indicate that ad requests should have unspecified age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment = GADAgeRestrictedTreatmentUnspecified;

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

L'impostazione del trattamento per età sostituisce le proprietà ritirate tagForChildDirectedTreatment (TFCD) e tagForUnderAgeOfConsent (TFUA).

La tabella seguente mostra le impostazioni tagForChildDirectedTreatment e tagForUnderAgeOfConsent e i relativi equivalenti di trattamento dell'età:

TFCD

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

TFUA

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

Comprendere le interazioni del trattamento in base all'età con TFCD e TFUA

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

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

Impostazione rivolta ai minori

Avviso: la proprietà tagForChildDirectedTreatment è stata ritirata. In alternativa, imposta 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 rivolti ai minori quando esegui una richiesta di annuncio. Quando indichi che vuoi che Google tratti i tuoi contenuti come rivolti ai minori, Google adotta misure per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing nella richiesta di annuncio. Le opzioni di impostazione sono le seguenti:

• Imposta tagForChildDirectedTreatment su true per indicare che vuoi che i tuoi contenuti vengano trattati come rivolti ai minori ai sensi della legge COPPA. Ciò impedisce 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 della legge COPPA.
• Non impostare tagForChildDirectedTreatment se non vuoi indicare come vorresti che i tuoi contenuti vengano trattati in relazione al COPPA.

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Se imposti questo tag, certifichi che questa notifica è accurata e che 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

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

Puoi contrassegnare le richieste di annunci in modo che vengano trattate come destinate agli utenti dello Spazio economico europeo (SEE) che non hanno ancora raggiunto l'età del consenso digitale. Questa funzionalità è pensata 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 le indicazioni dell'Unione Europea e rivolgiti a un consulente legale. Tieni presente che gli strumenti di Google sono progettati per facilitare la conformità e non esonerano alcun publisher dalle obbligazioni previste 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 For Users under the Age of Consent in Europe (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 sotto l'età del consenso digitale. In questo modo, viene impedita anche la trasmissione dell'identificatore pubblicità, IDFA.
• Se non imposti tagForUnderAgeOfConsent, indichi che non vuoi che le richieste di annuncio vengano gestite in modo adatto agli utenti sotto l'età del consenso.

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

Swift

MobileAds.shared.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. Se lo fossero, l'impostazione Rivolta ai minori avrà la precedenza.

Nota importante: 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 adatti agli utenti sotto l'età 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 annuncio 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 una designazione dell'etichetta dei contenuti digitali non superiore a GADMaxAdContentRatingGeneral.

Punto chiave: le impostazioni del filtro della classificazione dei contenuti specificate tramite l'SDK sostituiscono qualsiasi impostazione configurata utilizzando l'interfaccia utente di Ad Manager.

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 annuncio utilizzando la proprietà publisherPrivacyPersonalizationState di GADRequestConfiguration. Quando utilizzi questa funzionalità, in tutte le richieste di annunci future per il resto della sessione viene incluso un parametro di trattamento della privacy dell'editore (PPT).

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 della privacy degli utenti, avrà la precedenza l'indicatore più restrittivo. Per esempi specifici, consulta la documentazione dell'API Publisher Privacy Treatment.

GAMRequest

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

Aggiungere 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 collapsible con un valore di bottom su 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 durante la visualizzazione di contenuti di https://www.example.com, puoi trasmettere questo URL per scegliere come target parole chiave pertinenti:

Swift

let request = AdManagerRequest()
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 i valori chiave in una richiesta di annuncio. Gli elementi pubblicitari che hanno come target queste coppie chiave-valore sono quindi idonei a essere pubblicati per tale richiesta di annuncio. Per indirizzare più valori per una chiave, inserisci i valori come stringa separata da virgole.

Swift

let request = AdManagerRequest()
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 segmenti di pubblico diversi possono fornire un elenco breve di URL tramite la proprietà neighboringContentURLs. Gli URL dei contenuti adiacenti differiscono 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 passandoli nel seguente modo:

Swift

let request = AdManagerRequest()
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"];

Punto chiave: l'SDK utilizza solo i primi quattro URL. Tutti gli altri vengono ignorati.

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 l'articolo Informazioni sugli identificatori forniti dai publisher.

L'impostazione del PPID viene eseguita tramite GAMRequest:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Consulta l'esempio di PPID di Ad Manager per un'implementazione degli identificatori forniti dal publisher (PPID) nell'app demo dell'API iOS:

Swift Objective-C

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 tuoi dati utente per migliorare la monetizzazione programmatica comunicando le caratteristiche del tuo segmento di pubblico agli offerenti in tutti i tipi di transazione, utilizzando tassonomie standard, senza la necessità di 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).

Swift

let extras = Extras()
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 = AdManagerRequest()
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 viene aggiornato automaticamente?

Al momento dell'aggiornamento dell'annuncio, l'oggetto GAMRequest specificato in precedenza viene utilizzato di nuovo per il targeting. Per impostare un nuovo targeting, chiama esplicitamente loadRequest su GAMBannerView con un nuovo oggetto GAMRequest.

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

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