Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Targeting

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

Prerequisiti

Completa la sezione Inizia.

`RequestConfiguration`

RequestConfiguration è una struttura che raccoglie le informazioni di targeting da applicare a livello globale tramite la funzione globale SetRequestConfiguration().

Per aggiornare la configurazione della richiesta, ottieni prima la configurazione corrente, 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 per i contenuti destinati ai minori

Ai fini del Children's Online Privacy Protection Act (COPPA), esiste un'impostazione denominata "tag per il trattamento per siti o servizi destinati ai minori". Impostando questo tag, dichiari che la presente comunicazione è 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.

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 le misure necessarie per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing per la richiesta di annuncio in questione.

L'impostazione può essere configurata assegnando il membro tag_for_child_directed_treatment della struct RequestConfiguration a uno dei seguenti valori di enumerazione:

Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::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 a RequestConfiguration::kChildDirectedTreatmentFalse per indicare che non vuoi che i tuoi contenuti vengano trattati come rivolti ai minori ai sensi del COPPA.
Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified se non vuoi indicare in che modo vuoi che i tuoi contenuti vengano trattati in relazione al COPPA nelle richieste di annunci.

L'esempio seguente indica che vuoi che i tuoi contenuti vengano 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);

Impostando questo tag, dichiari che la presente comunicazione è 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 di età inferiore a quella del consenso digitale

Puoi contrassegnare le tue richieste di annunci perché ricevano il trattamento previsto per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE). Questa funzionalità è pensata per facilitare il rispetto del Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che il GDPR potrebbe prevedere altri obblighi di legge. 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 dagli obblighi stabiliti dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando utilizzi questa funzionalità, nella richiesta di annuncio viene incluso un parametro Tag per utenti di età inferiore a quella del consenso digitale in Europa (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per tutte le richieste di annunci. 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.

Come per le impostazioni rivolte ai minori, RequestConfiguration include un membro per la configurazione del parametro TFUA: tag_for_under_age_of_consent, che può essere configurato con i seguenti valori di enumerazione:

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

Il seguente esempio indica che vuoi includere il parametro 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 per i contenuti destinati ai minori e per gli utenti che non hanno raggiunto l'età del consenso digitale non devono essere entrambi impostati su true. In caso contrario, l'impostazione per i contenuti destinati ai minori avrà la precedenza.

Filtro dei contenuti degli annunci

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

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

Il seguente codice configura una struttura RequestConfiguration per specificare che i contenuti degli annunci restituiti devono corrispondere a un'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 possono 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 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();