Questa guida spiega come fornire informazioni di targeting a una richiesta di annuncio.
Prerequisiti
- Completa la pagina Inizia.
RequestConfiguration
RequestConfiguration
è uno struct che raccoglie informazioni sul targeting da
applicare a livello globale tramite la funzione globale SetRequestConfiguration()
.
Per aggiornare la configurazione della richiesta, ottieni prima una configurazione attuale, esegui gli aggiornamenti desiderati e impostala come segue:
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
Impostazione Rivolto ai minori
Ai fini del Children's Online Privacy Protection Act (COPPA), è presente un'impostazione chiamata "tag per il trattamento per siti o servizi destinati ai minori". Se imposti questo tag, dichiari che la presente notifica è accurata e di avere l'autorizzazione ad agire per conto del proprietario dell'app. Sei consapevole che l'utilizzo scorretto di questa impostazione può comportare la chiusura del tuo Account Google.
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. Se indichi che vuoi che Google tratti i tuoi contenuti come destinati ai minori, adottiamo le misure necessarie per disattivare gli annunci per la pubblicità basata sugli interessi e il remarketing per la richiesta di annuncio in questione.
L'impostazione può essere configurata assegnando il
membro tag_for_child_directed_treatment
dello struct RequestConfiguration
a
uno dei seguenti valori enumerati:
- Assegna
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentTrue
per indicare che vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai sensi del COPPA. - Assegna
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentFalse
per indicare che non vuoi che i tuoi contenuti vengano trattati come destinati ai minori ai sensi del COPPA. - Assegna
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentUnspecified
se non vuoi indicare come vuoi che vengano trattati i tuoi contenuti in relazione al COPPA nelle richieste di annunci.
L'esempio seguente indica che i tuoi contenuti devono essere trattati come destinati ai minori ai sensi del COPPA:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_child_directed_treatment = firebase::RequestConfiguration::kChildDirectedTreatmentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
Se imposti questo tag, dichiari che questa notifica è accurata e che hai l'autorizzazione ad agire per conto del proprietario dell'app. Sei consapevole che l'utilizzo scorretto di questa impostazione può comportare la chiusura del tuo Account Google.
Utenti di età inferiore a quella del consenso digitale
Puoi contrassegnare le tue richieste di annunci per ricevere il trattamento per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE). Questa funzionalità è pensata per facilitare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che potresti avere altri obblighi di legge ai sensi del GDPR. Consulta le linee guida dell'Unione Europea e rivolgiti a un consulente legale. Ricorda che gli strumenti di Google sono studiati per favorire la conformità alle norme e non esonerano i publisher dalle obbligazioni previste dalla legge. Scopri di più su come il GDPR influisce sui publisher.
Quando si utilizza questa funzionalità, nella richiesta di annuncio viene incluso un tag per gli utenti di età inferiore all'età del consenso digitale (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per tutte le richieste di annunci. 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.
Come per le impostazioni rivolte ai minori, esiste un membro in RequestConfiguration per
configurare il parametro TFUA: tag_for_under_age_of_consent
, che può essere
configurato con i seguenti valori enumerati:
- Assegna
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentTrue
per indicare che vuoi che la richiesta di annuncio venga trattata per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE). - Assegna
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentFalse
per indicare che vuoi che la richiesta di annuncio non riceva il trattamento per gli utenti di età inferiore all'età del consenso digitale nello Spazio economico europeo (SEE). - Assegna
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentUnspecified
per indicare che non hai specificato se la richiesta di annuncio deve ricevere un trattamento per utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE).
L'esempio seguente indica che vuoi includere TFUA nelle tue richieste di annunci:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.tag_for_under_age_of_consent = firebase::RequestConfiguration::kUnderAgeOfConsentTrue; firebase::gma::SetRequestConfiguration(request_configuration);
I tag per attivare l'impostazione Contenuti destinati ai minori e Utenti sotto l'età del consenso non devono essere entrambi impostati su true. Se lo fosse, l'impostazione "Destinato ai minori" ha la precedenza.
Filtro dei contenuti degli annunci
Le app possono impostare una classificazione massima dei contenuti degli annunci per le proprie richieste di annunci tramite l'RequestConfiguration::max_ad_content_rating field
. Gli annunci AdMob restituiti se questa funzione è configurata hanno una classificazione dei contenuti pari o inferiore a quel livello. I valori possibili si basano sulle classificazioni delle etichette contenuti digitali e devono essere in uno dei seguenti valori enumerati:
RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA
Il seguente codice configura uno struct RequestConfiguration
per specificare che il contenuto dell'annuncio restituito deve corrispondere a una designazione di etichetta per contenuti digitali non superiore a G:
firebase::gma::RequestConfiguration request_configuration = firebase::gma::GetRequestConfiguration(); request_configuration.max_ad_content_rating = firebase::RequestConfiguration::kMaxAdContentRatingG; firebase::gma::SetRequestConfiguration(request_configuration);
AdRequest
L'oggetto AdRequest
raccoglie informazioni di targeting da inviare con una richiesta di annuncio.
URL contenuti
Quando richiedi un annuncio, le app possono trasmettere l'URL dei contenuti che pubblicano. Ciò consente al targeting per parole chiave di abbinare l'annuncio al contenuto.
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:
// AdRequest with content URL: firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com"); // AdRequest without content URL: firebase::admob::AdRequest ad_request();