Targeting

Il targeting ti consente di fornire informazioni sul contesto e sul pubblico a Google Mobile Ads SDK for React Native per mostrare annunci pertinenti ai tuoi utenti.

Puoi configurare il targeting ai seguenti livelli:

  • Configurazione globale delle richieste: applica le impostazioni a tutte le richieste di annunci nella tua app, inclusi i trattamenti per bambini e adolescenti, le classificazioni massime dei contenuti degli annunci, i trattamenti per la privacy dei publisher e gli ID dispositivo di test.
  • Targeting per richiesta: personalizza le singole richieste di annunci utilizzando gli oggetti delle richieste di annunci, inclusi gli URL dei contenuti e le informazioni extra della rete.

Questa guida spiega come fornire informazioni di targeting a Google Mobile Ads SDK for React Native.

Prerequisiti

Prima di continuare, configura Google Mobile Ads SDK for React Native.

Imposta la configurazione della richiesta

L'oggetto RequestConfiguration raccoglie le informazioni di targeting applicate a livello globale a ogni richiesta di annuncio.

Per applicare le impostazioni di targeting della prima richiesta di annuncio, imposta la proprietà requestConfiguration quando chiami il metodo initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

Sostituisci TEST_DEVICE_HASHED_ID con un ID dispositivo di test sottoposto ad hashing. Questo ID specifica un dispositivo che deve ricevere annunci di prova.

Per aggiornare le impostazioni di targeting dopo aver inizializzato Google Mobile Ads SDK for React Native, chiama il metodo setRequestConfiguration. Il metodo setRequestConfiguration sostituisce una configurazione esistente e ha effetto sulle richieste di annunci successive.

L'esempio seguente modifica un oggetto RequestConfiguration con impostazioni di targeting aggiornate e applica le impostazioni alle richieste di annunci:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Imposta il trattamento in base all'età

Per aiutarti a gestire la conformità alle normative sulla privacy vigenti relative a bambini e adolescenti, Google Mobile Ads SDK for React Native fornisce un'impostazione per il trattamento in base all'età. L'impostazione del trattamento in base all'età ti consente di indicare se Google Mobile Ads SDK for React Native deve applicare protezioni specifiche per la pubblicazione di annunci per bambini, adolescenti o un'età non specificata.

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

L'esempio seguente indica che le richieste di annunci devono essere soggette al trattamento in base all'età dei minori:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

Per indicare il trattamento per adolescenti o per un'età non specificata, sostituisci l'impostazione AgeRestrictedTreatment.CHILD con quanto segue:

Quando utilizzi questa impostazione, Google Mobile Ads SDK for React Native include un parametro tfat nelle richieste di annunci. Rivolgiti al tuo consulente legale per determinare il trattamento in base all'età minima richiesta per la tua base utenti in base agli obblighi legali e normativi. Per saperne di più, consulta Applica un tag a una richiesta di annuncio da un'app per il trattamento con limiti di età.

Filtra i contenuti degli annunci

La classificazione massima dei contenuti degli annunci ti consente di controllare i contenuti degli annunci mostrati agli utenti. Puoi impostare una classificazione massima dei contenuti per garantire la conformità alle norme della piattaforma.

Puoi impostare una classificazione massima dei contenuti degli annunci per le richieste di annunci nella tua app utilizzando la proprietà maxAdContentRating nell'oggetto RequestConfiguration. Dopo aver configurato questa impostazione, gli annunci restituiti avranno una classificazione dei contenuti pari o inferiore a quella impostata. I valori possibili per questa impostazione si basano sulle classificazioni delle etichette contenuti digitali e devono essere una delle seguenti costanti:

L'esempio seguente configura un oggetto RequestConfiguration per specificare che i contenuti dell'annuncio restituiti devono corrispondere a un'etichetta contenuti digitali non superiore alla costante G:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

Per maggiori dettagli, consulta le seguenti sezioni:

(Facoltativo) Imposta l'API PPT (beta)

L'API Publisher Privacy Treatment (PPT) ti consente di indicare se disattivare la personalizzazione degli annunci per tutte le richieste di annunci utilizzando la proprietà publisherPrivacyPersonalizationState nell'oggetto RequestConfiguration. Quando utilizzi questa funzionalità, Google Mobile Ads SDK for React Native include un parametro Publisher Privacy Treatment (PPT) in tutte le richieste di annunci per il resto della sessione.

Per impostazione predefinita, le richieste di annunci a Google determinano la pubblicazione di annunci personalizzati. L'esempio seguente disattiva la personalizzazione degli annunci per tutte le richieste di annunci:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

Imposta l'oggetto AdRequest

L'oggetto AdRequest raccoglie le informazioni di targeting inviate con una richiesta di annuncio.

A differenza della configurazione globale impostata con il metodo setRequestConfiguration, l'oggetto AdRequest viene passato al metodo load di una classe di formato dell'annuncio, ad esempio InterstitialAd.load per gli annunci interstitial o BannerAd.load per gli annunci banner.

Aggiungi informazioni extra della rete

Per passare parametri specifici della rete a Google Mobile Ads SDK for React Native, ad esempio i parametri per gli annunci comprimibili, utilizza la proprietà extras.

L'esempio seguente imposta una chiave di parametro aggiuntiva di collapsible con un valore di bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

Fornisci un URL dei contenuti

Per fornire un URL dei contenuti per gli annunci con targeting basato sui contenuti e la sicurezza del brand, aggiungi la proprietà contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

L'URL dei contenuti deve contenere fino a 512 caratteri.