Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Targeting

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

Prerequisiti

Completa la procedura Inizia.

`RequestConfiguration`

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

Per aggiornare la configurazione della richiesta, recupera 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 rivolta 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". Se imposti questo tag, certifichi che questa notifica contiene informazioni accurate e che sei autorizzato ad agire per conto del proprietario dell'app. Sei consapevole del fatto 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 rivolti ai minori quando esegui una richiesta di annuncio. Se indichi che vuoi che Google tratti i tuoi contenuti come rivolti ai minori, adottiamo misure per disattivare la pubblicità basata sugli interessi e gli annunci di remarketing nella richiesta di annuncio.

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

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

Il seguente esempio indica che vuoi che i tuoi contenuti vengano trattati come rivolti ai minori ai fini 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, certifichi che questa notifica contiene informazioni accurate e che sei autorizzato ad agire per conto del proprietario dell'app. Sei consapevole del fatto che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Utenti di età inferiore a quella minima richiesta nel tuo paese

È possibile contrassegnare le richieste di annunci in modo da ricevere il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella minima richiesta nel proprio paese. 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. Ricorda che gli strumenti di Google sono progettati per facilitare la conformità e non esonerano i publisher da eventuali obblighi di legge. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, nella richiesta di annunci viene incluso un parametro Tag For Users under the Età del consenso digitale in Europe (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 per il trattamento per siti o servizi rivolti ai minori, in RequestConfiguration è presente un membro per la configurazione del 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 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 minima richiesta nel proprio paese.
Assegna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentFalse per indicare che non vuoi che la richiesta di annuncio riceva il trattamento per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella minima richiesta nel proprio paese.
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 per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella minima richiesta nel proprio paese.

Il seguente esempio indica che vuoi che il parametro TFUA sia incluso nelle 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 il trattamento per siti o servizi destinati ai minori e per gli utenti di età inferiore a quella minima richiesta nel tuo paese non devono essere entrambi impostati su true. 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 le richieste di annunci tramite il RequestConfiguration::max_ad_content_rating field. Gli annunci AdMob restituiti quando questa opzione è configurata hanno una classificazione dei contenuti pari o inferiore a questo livello. I valori possibili 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 seguente codice configura una struct RequestConfiguration per specificare che i contenuti degli annunci restituiti devono corrispondere a una designazione di etichetta dei 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 sul 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 da https://www.example.com, puoi trasmettere questo URL per scegliere come target le 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();