Targeting

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

Prerequisiti

  • Completa il passaggio Inizia.

RequestConfiguration

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

Per aggiornare la configurazione della richiesta, richiedi prima la configurazione attuale, esegui gli eventuali aggiornamenti desiderati e impostala nel seguente modo:

  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 la notifica è corretta e 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.

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 gli annunci IBA e il remarketing nella richiesta di annuncio.

L'impostazione può essere configurata assegnando il membro tag_for_child_directed_treatment dello struct di 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 siano 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::kChildDirectedTreatmentUnspecifiedse non vuoi indicare come vuoi che vengano trattati i tuoi contenuti in relazione al COPPA nelle richieste di annuncio.

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

Impostando questo tag, dichiari che la notifica è accurata e disponi dell'autorizzazione ad agire per conto del proprietario dell'app. Comprendi che l'abuso di questa impostazione potrebbe comportare la chiusura del tuo Account Google.

Puoi contrassegnare le richieste di annunci per ricevere un 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. Tieni presente che gli strumenti di Google sono studiati per favorire la conformità alle norme e non risentono di alcun editore specifico ai sensi delle sue leggi. Scopri di più su come il GDPR influisce sui publisher.

Quando si utilizza questa funzionalità, nella richiesta di annunci viene incluso un parametro per gli utenti sotto l'età 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 misurazione degli annunci e gli ad server di terze parti.

Come le impostazioni rivolte ai minori, nella richiesta di configurazione è 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) che non hanno superato 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 dello 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 per gli utenti di età inferiore a quella del consenso digitale nello Spazio economico europeo (SEE).

L'esempio seguente indica che vuoi che TFUA sia incluso 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 di età inferiore a quella del consenso digitale 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 loro richieste di annunci tramite il RequestConfiguration::max_ad_content_rating field. Gli annunci AdMob restituiti quando configurano questa funzionalità hanno una classificazione dei contenuti pari o inferiore a questo livello. I valori possibili per questo aggiornamento si basano sulle classificazioni delle etichette dei contenuti digitali e devono avere uno dei seguenti valori enumerati:

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

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

URL contenuti

Quando richiedono un annuncio, le app possono passare l'URL dei contenuti pubblicati. Ciò consente al targeting per parole chiave di 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();