Targeting

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

Scarica la demo dell'API

Prerequisiti

Completa la guida Introduzione.

GADRequestConfiguration

GADRequestConfiguration è un oggetto che raccoglie le informazioni sul targeting da applicare a livello globale tramite la GADMobileAds istanza condivisa. È possibile accedervi con il seguente codice:

Swift

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Impostazione per i 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 per quella richiesta di annuncio. Le opzioni di impostazione sono i 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 destinati ai minori ai sensi del COPPA.
• Non impostare tagForChildDirectedTreatment se non vuoi indicare come vuoi che i tuoi contenuti vengano trattati in base al COPPA.

L'esempio seguente indica che vuoi che i tuoi contenuti vengano considerati rivolti ai bambini ai sensi del COPPA:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Se imposti questo tag, certifichi che questa notifica è accurata e che hai l'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 minima richiesta nel tuo paese

Puoi contrassegnare le richieste di annunci in modo da ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella minima richiesta nel proprio paese. Questa funzionalità è pensata per agevolare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che potresti avere altre obligations legali ai sensi del GDPR. Consulta le indicazioni dell'Unione Europea e rivolgiti a un consulente legale. Tieni presente che 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 si utilizza questa funzionalità, in tutte le richieste di annunci future verrà incluso un parametro Tag per utenti sotto l'età del consenso in Europa (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso 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 sull'oggetto GADMobileAds.requestConfiguration e passando 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 del consenso. Inoltre, impedisce 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 richiesta nel tuo paese.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

I tag per attivare l'impostazione Destinato ai bambini e tagForUnderAgeOfConsent non devono essere impostati contemporaneamente su true. Se lo sono, l'impostazione Rivolta 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à garantire 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 retitrati devono corrispondere a una designazione dell'etichetta di contenuti digitali non superiore GADMaxAdContentRatingGeneral.

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

.

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (beta)

L' 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 si utilizza questa funzionalità, un parametro di trattamento per la 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

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Nota: per le richieste di annunci con più indicatori della privacy dell'utente, 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 sul 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 consente di associare l'annuncio ai contenuti.

Ad esempio, se la tua app richiede un annuncio mentre mostra contenuti di https://www.example.com, puoi passare 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 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 la 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 segmenti di pubblico diversi possono fornire un breve elenco 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 i contenuti di quattro URL in un feed che contiene anche annunci. Puoi richiedere annunci con una classificazione dei contenuti simile a quella di questi URL passandoli nel seguente 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: 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 Informazioni sugli identificatori forniti dai publisher.

L'impostazione del PPID viene eseguita tramite GAMRequest:

Swift

let request = GAMRequest()
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 di demo dell'API per 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 dati utente per migliorare la monetizzazione programmatica comunicando le caratteristiche del tuo segmento di pubblico agli offerenti in tutti i tipi di transazioni, utilizzando tassonomie standard, senza dover condividere gli identificatori utente. Le caratteristiche del 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 = 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 viene aggiornato automaticamente?

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

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.