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

Scarica API Demo

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

Imposta il trattamento in base all'età

Per aiutarti a gestire la conformità alle normative sulla privacy applicabili relative a bambini e adolescenti, Google Mobile Ads SDK fornisce un'impostazione di trattamento in base all'età. L'impostazione di 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 annunci. Consulta il tuo consulente legale per determinare il trattamento in base all'età applicabile per i tuoi utenti in base agli obblighi legali e normativi. Per saperne di più, consulta l'articolo Codifica una richiesta di annuncio per il trattamento in base all'età.

Puoi impostare il trattamento in base all'età con la proprietà ageRestrictedTreatment su GADRequestConfiguration.

Imposta il gruppo sperimentale per i bambini

L'esempio seguente indica che le richieste di annunci devono essere soggette al trattamento "bambini":

// Indicates that ad requests should have child age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .child
RequestConfigurationSnippets.swift

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

Imposta il trattamento per gli adolescenti

L'esempio seguente indica che le richieste di annunci devono essere soggette al trattamento "adolescenti":

// Indicates that ad requests should have teen age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .teen
RequestConfigurationSnippets.swift

// Indicates that ad requests should have teen age treatment.
GADMobileAds.sharedInstance.requestConfiguration.ageRestrictedTreatment =
    GADAgeRestrictedTreatmentTeen;
RequestConfigurationSnippets.m

Imposta nessun gruppo sperimentale specifico in base all'età

L'esempio seguente indica che le richieste di annunci non devono essere soggette a nessun trattamento specifico in base all'età:

// Indicates that ad requests should have unspecified age treatment.
MobileAds.shared.requestConfiguration.ageRestrictedTreatment = .unspecified
RequestConfigurationSnippets.swift

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

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

L'impostazione di trattamento in base all'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 in base all'età:

Informazioni sulle interazioni del trattamento in base all'età con TFCD e TFUA

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

Impostazione per siti o servizi rivolti ai minori

Ai sensi 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 per quella 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 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 sensi del COPPA.
• Non impostare tagForChildDirectedTreatment se non vuoi indicare come vuoi che i tuoi contenuti vengano trattati ai sensi del COPPA.

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

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Se imposti questo tag, dichiari che la presente notifica è accurata e che disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Riconosci che l'utilizzo illecito di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Utenti sotto l'età del consenso digitale

È possibile contrassegnare le richieste di annunci in modo da ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) sotto l'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 l'ottemperanza alle norme e non esonerano i publisher dalle obbligazioni previste dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando utilizzi questa funzionalità, nella richiesta di annuncio viene incluso un parametro TFUA (tag per utenti sotto l'età del consenso digitale in Europa). 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 sotto l'età del consenso digitale. 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 sotto l'età del consenso digitale.

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

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

I tag per attivare l'impostazione per contenuti rivolti ai minori e tagForUnderAgeOfConsent non devono essere entrambi impostati su true contemporaneamente. 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;

Trattamento della privacy del publisher (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 utilizzi questa funzionalità, nella richiesta di annuncio 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 determinano la pubblicazione di 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;

GAMRequest

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

Aggiungi extra di 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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

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 questi valori chiave sono quindi idonei a essere pubblicati per questa richiesta di annuncio. Per scegliere come target più valori per una chiave, inserisci i valori come stringa separata da virgole.

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

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 contenuti da 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:

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Identificatori forniti dal publisher

Puoi impostare un identificatore fornito dal publisher (PPID) da utilizzare per la quota limite, la segmentazione del pubblico, il targeting per pubblico, la rotazione degli annunci sequenziale e altri controlli di pubblicazione degli annunci basati sul pubblico su tutti i dispositivi.

L'impostazione del PPID viene eseguita tramite GAMRequest:

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

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

Per un'implementazione degli identificatori forniti dal publisher (PPID) nell'app iOS API Demo, consulta l'esempio di PPID di Ad Manager:

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 annunci. Con PPS, puoi utilizzare i dati utente per migliorare la monetizzazione programmatica comunicando le caratteristiche del tuo 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).

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)

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?

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 passare parametri di targeting aggiuntivi alle reti di mediazione?

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