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

Completa la guida Guida introduttiva.

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 l'SDK Mobile Ads.

Impostazione rivolta ai minori

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 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 destinati ai minori ai sensi del 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 destinati 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.

Il seguente esempio indica che vuoi che i tuoi contenuti vengano trattati come destinati ai bambini 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 del fatto che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Puoi contrassegnare le tue richieste di annuncio 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). 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 i publisher dalle obbligazioni previste dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza 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, incluso il remarketing, per quella specifica richiesta di annuncio. Inoltre, disattiva le richieste a fornitori di annunci di terze parti, come i pixel di monitoraggio 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 nell'oggetto GADMobileAds.requestConfiguration e passando true.

  • Imposta tagForUnderAgeOfConsent su true per indicare che vuoi che le richieste di annuncio vengano gestite in modo adatto agli utenti sotto l'età del consenso. In questo modo, viene impedita anche la trasmissione dell'identificatore pubblicità, IDFA.
  • Se non imposti tagForUnderAgeOfConsent, le richieste di annuncio non verranno 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 relativa ai contenuti destinati ai bambini e tagForUnderAgeOfConsent non devono essere entrambi impostati su true. Se lo fossero, l'impostazione Rivolta ai minori avrà la precedenza.

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 future richieste di annunci 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.

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 si utilizza 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;

GADRequest

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

Aggiungere contenuti aggiuntivi delle emittenti

I dati aggiuntivi della rete sono dettagli extra 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 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 = 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 viene aggiornato automaticamente?
Al momento dell'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 la sezione Mediazione per scoprire come inviare il targeting alle reti di mediazione.