Targeting

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.

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. È possibile accedervi con il seguente codice:

let requestConfiguration = MobileAds.shared.requestConfiguration

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.

Impostazione per siti o servizi rivolti ai minori

Ai fini del Children's Online Privacy Protection Act (COPPA), esiste un'impostazione denominata 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 fini 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 fini del COPPA.
• Non impostare tagForChildDirectedTreatment se non vuoi indicare come vuoi che i tuoi contenuti vengano trattati in relazione al COPPA.

Il seguente esempio indica che vuoi che i tuoi contenuti vengano trattati come rivolti ai minori ai fini del COPPA:

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Impostando questo tag, certifichi che questa notifica contiene informazioni accurate e che sei autorizzato 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.

Utenti di età inferiore a quella del consenso digitale

Puoi contrassegnare le richieste di annunci in modo che vengano trattate come destinate agli utenti dello Spazio economico europeo (SEE) di età inferiore all'età del consenso digitale. Questa funzionalità è pensata per agevolare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Va tenuto presente che potrebbero essere previste altre obbligazioni legali ai sensi del GDPR. Consulta le indicazioni dell'Unione Europea e rivolgiti a un consulente legale. Gli strumenti di Google sono studiati per favorire la conformità alle norme e non esonerano alcun publisher dalle obbligazioni previste dal diritto. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, un parametro Tag For Users under the Age of Consent in Europe (TFUA) verrà incluso in tutte le richieste di annunci future. 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 by setting the tagForUnderAgeOfConsent property on the GADMobileAds.requestConfiguration object and passing in true.

• Imposta tagForUnderAgeOfConsent su true per indicare che vuoi che le richieste di annunci vengano gestite in modo appropriato per gli utenti di età inferiore a quella minima richiesta nel proprio paese. In questo modo, viene impedita la trasmissione dell'identificatore pubblicità, IDFA.
• Se non imposti tagForUnderAgeOfConsent, indichi che non vuoi che le richieste di annunci vengano gestite in modo appropriato per gli utenti di età inferiore a quella minima richiesta nel proprio paese.

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

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

I tag per attivare l'impostazione rivolta ai minori child-directed setting 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 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 digitalie 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 di etichetta dei contenuti digitali non superiore a GADMaxAdContentRatingGeneral.

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

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 publisherPrivacyPersonalizationState proprietà di GADRequestConfiguration. Quando si utilizza questa funzionalità, nella richiesta di annunci viene incluso un parametro Publisher Privacy Treatment (PPT) per tutte le richieste di annunci future per il resto della sessione.

Per impostazione predefinita, le richieste di annunci a Google pubblicano annunci personalizzati. Il seguente codice disattiva la personalizzazione degli annunci per tutte le richieste di annunci:

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GADRequest

L'oggetto GADRequest 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 che sono specifici per una singola origine annuncio.

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

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

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 passare 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 da https://www.example.com, puoi passare questo URL per scegliere come target le parole chiave pertinenti:

let request = Request()
request.contentURL = "https://www.example.com"

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

Domande frequenti

Quale targeting viene utilizzato quando un annuncio si aggiorna automaticamente?

Quando un annuncio si aggiorna, 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 passare parametri di targeting aggiuntivi alle reti di mediazione?

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