Questa pagina è stata tradotta dall'API Cloud Translation.

Targeting

Questa guida spiega come fornire informazioni sul targeting a una richiesta di annuncio.

Prerequisiti

Completa la sezione Inizia.

`RequestConfiguration`

RequestConfiguration è uno struct che raccoglie informazioni sul targeting per applicata a livello globale tramite la funzione globale SetRequestConfiguration().

Per aggiornare la configurazione della richiesta, devi prima ottenere la configurazione attuale, eseguire gli aggiornamenti desiderati e impostarli come segue:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Impostazione destinata ai minori

Ai sensi del Children's Online Privacy Protection Act (COPPA), esiste un'impostazione chiamata "tag per il trattamento per siti o servizi destinati ai minori". 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.

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, adotteremo misure per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing per quella richiesta di annuncio.

L'impostazione può essere configurata assegnando tag_for_child_directed_treatment membro di RequestConfiguration struct per uno dei seguenti valori enumerati:

Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentTrue per indicare che vuoi i tuoi contenuti trattati come destinati ai minori ai sensi del COPPA.
Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::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 a RequestConfiguration::kChildDirectedTreatmentUnspecifiedse non vuoi per indicare come vorresti che i tuoi contenuti venissero trattati in conformità al COPPA nei richieste di annunci.

L'esempio seguente indica che vuoi che i tuoi contenuti vengano trattati come contenuti destinati ai minori ai fini della legge 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, 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 del consenso digitale

Puoi contrassegnare le richieste di annunci per ricevere il trattamento per gli utenti residenti in Europa Spazio economico (SEE) di età inferiore a quella del consenso digitale. Questa funzionalità è pensata per aiutare Favorire il rispetto del Regolamento generale sulla protezione dei dati (GDPR) (GDPR). Tieni presente che potresti avere altre obbligazioni legali ai sensi del GDPR. Rivedi le dell'Unione Europea e rivolgersi a un consulente legale. Non dimenticare di apporre ricorda che gli strumenti di Google sono progettati per favorire la conformità e non esonerano i publisher dagli obblighi stabiliti dalla legge. Ulteriori informazioni su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, nella richiesta di annunci viene incluso un parametro Tag per utenti sotto l'età del consenso in Europa (TFUA). Questo parametro disabilita 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 monitoraggio degli annunci e gli ad server di terze parti.

Come per le impostazioni rivolte ai minori, è presente un membro in RequestConfiguration per configurare il parametro TFUA: tag_for_under_age_of_consent, che potrebbe essere configurato con i seguenti valori enumerati:

Assegna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentTrue per indicare che vuoi che la richiesta di annuncio riceva il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso.
Assegna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentFalse per indicare che la richiesta di annuncio non deve essere trattata per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso.
Assegna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentUnspecified per indicare che non hanno specificato se la richiesta di annuncio deve ricevere un trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale.

Il seguente esempio indica che vuoi che TFUA sia incluso 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 Per bambini e ragazzi e Utenti di età inferiore all'età minima per il consenso non devono essere entrambi impostati su true contemporaneamente. In tal caso, il servizio dell'impostazione ha la precedenza.

Filtro dei contenuti degli annunci

Le app possono impostare una classificazione massima dei contenuti degli annunci per le loro richieste di annunci tramite la RequestConfiguration::max_ad_content_rating field. Gli annunci AdMob restituiti quando questa impostazione è configurata hanno una classificazione dei contenuti pari o inferiore a questo livello. I possibili valori per questo campo si basano sulle classificazioni delle etichette dei contenuti digitali e devono essere uno dei seguenti valori enumerati:

RequestConfiguration::kMaxAdContentRatingG
RequestConfiguration::kMaxAdContentRatingPG
RequestConfiguration::kMaxAdContentRatingT
RequestConfiguration::kMaxAdContentRatingMA

Il codice seguente configura una struttura RequestConfiguration per specificare che i contenuti dell'annuncio restituiti devono corrispondere a una designazione dell'etichetta 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 le informazioni di targeting da inviare con una richiesta di annuncio.

URL contenuti

Quando richiedono un annuncio, le app potrebbero 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 passare 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();