Targeting

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

Prerequisiti

RequestConfiguration

RequestConfiguration è uno struct che raccoglie informazioni di 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 rivolta ai minori

Ai fini del Children's Online Privacy Protection Act (COPPA), è disponibile un'impostazione chiamata "tag per il trattamento per siti o servizi destinati ai minori". Se imposti questo tag, dichiari che questa notifica è accurata e disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Riconosci che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Quando eseguono una richiesta di annuncio, gli sviluppatori di app possono indicare se vogliono che Google tratti i loro contenuti come rivolti ai minori. Se indichi che vuoi che Google tratti i tuoi contenuti come rivolti ai minori, adottiamo misure per disabilitare gli annunci di inventario locale e di remarketing per tale richiesta di annuncio.

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 a RequestConfiguration::kChildDirectedTreatmentTrue per indicare che vuoi che i tuoi contenuti vengano considerati come rivolti ai minori ai sensi della legge 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 della legge COPPA.
  • Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecifiedse non vuoi indicare in che modo 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 sensi 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, dichiari che la notifica è accurata e disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Riconosci che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Puoi contrassegnare le 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 il rispetto del Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che potresti avere altri obblighi di legge 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 l'ottemperanza alle norme e non alleggeriscono alcun editore dai suoi obblighi di legge. Scopri di più su come il GDPR influisce sui publisher.

Quando utilizzi questa funzionalità, nella richiesta di annunci viene incluso un parametro Tag Per utenti di età inferiore a quella del consenso digitale in Europa (TFUA). Questo parametro disattiva la pubblicità personalizzata, incluso 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, 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) che non hanno raggiunto l'età 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 dello Spazio economico europeo (SEE) sotto l'età del consenso.
  • Assegna RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentUnspecified per indicare che non hai specificato se la richiesta di annuncio deve essere trattata per gli utenti dello Spazio economico europeo (SEE) sotto l'età del consenso.

L'esempio seguente indica che vuoi includere il formato TFUA nelle richieste di annuncio:

  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 abilitare l'impostazione rivolta ai minori e gli utenti sotto l'età del consenso non devono essere entrambi impostati su true. In caso affermativo, 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 richieste di annunci tramite RequestConfiguration::max_ad_content_rating field. Gli annunci AdMob restituiti quando sono configurati hanno una classificazione dei contenuti pari o inferiore a questo livello. I valori possibili sono basati su classificazioni di etichette contenuti digitali e devono essere uno dei seguenti valori enumerati:

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

Il codice riportato di seguito configura una struttura RequestConfiguration per specificare che il contenuto dell'annuncio restituito deve 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 vengono richiesti annunci, le app potrebbero trasmettere l'URL dei contenuti pubblicati. Ciò consente di abbinare il targeting per parole chiave all'annuncio con i 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();