Targeting


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

Prerequisiti

RequestConfiguration

RequestConfiguration è una struct 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 attuale, esegui gli aggiornamenti che preferisci 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 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, Google disattiva la pubblicità basata sugli interessi e gli annunci di remarketing per quella richiesta di annuncio.

L'impostazione può essere configurata assegnando il membro tag_for_child_directed_treatment della struttura 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 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 fini della legge COPPA.
  • Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecifiedse non vuoi indicare come vorresti 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 destinati ai bambini 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 è accurata e che disponi dell'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.

Puoi contrassegnare le richieste di annunci in modo che vengano trattate come destinate agli utenti dello Spazio economico europeo (SEE) che non hanno ancora raggiunto l'età del consenso digitale. Questa funzionalità è pensata per facilitare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Tieni 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 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 si utilizza questa funzionalità, nella richiesta di annunci viene incluso un parametro Tag For Users under the Age of Consent in Europe (TFUA). Questo parametro disattiva la pubblicità personalizzata, compreso il remarketing, per tutte le richieste di annuncio. 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, 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 dello Spazio economico europeo (SEE) sotto l'età del consenso.
  • 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 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 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 Rivolta ai minori e Utenti al di sotto dell'età del consenso non devono essere entrambi impostati su true contemporaneamente. In caso di conflitto, l'impostazione rivolta ai minori 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 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 di contenuti digitali e devono essere uno dei seguenti valori enumerati:

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

Il seguente codice configura una struttura RequestConfiguration per specificare che i contenuti dell'annuncio restituiti devono corrispondere a una designazione di 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 durante la visualizzazione di 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();