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

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 su true 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 su false 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 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. 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.

Punto chiave: questo parametro tagForUnderAgeOfConsent non viene inoltrato agli adattatori di mediazione della rete pubblicitaria. È tua responsabilità garantire che ogni rete pubblicitaria di terze parti nella tua app pubblichi annunci adatti a utenti di età inferiore a quella del consenso digitale prevista dal 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 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.

Punto chiave: le impostazioni del filtro per la classificazione dei contenuti specificate tramite l'SDK sostituiscono qualsiasi impostazione configurata utilizzando l' Ad Manager UI.

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;

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

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"];

Punto chiave: solo i primi quattro URL vengono utilizzati dall'SDK. Tutte le altre vengono ignorate.

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.

Nota: questa funzionalità non è disponibile per tutti i publisher. Consulta Informazioni sugli identificatori forniti dall'editore per i dettagli.

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:

Swift Objective-C

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 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.