Targeting

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

Prerequisiti

• Completa la sezione Inizia.

RequestConfiguration

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

Per aggiornare la configurazione della richiesta, devi prima ottenere la configurazione attuale, eseguire gli aggiornamenti desiderati e impostarla come segue:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Impostazione destinata 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, confermi che la presente notifica è accurata e di avere 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 Google tratti i tuoi contenuti come destinati ai minori, Google disattiva gli annunci per l'IBA (pubblicità basata sugli interessi) 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 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 destinati ai minori ai sensi del COPPA.
• Assegna RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified se non vuoi indicare come vorresti che i tuoi contenuti venissero trattati nelle richieste di annunci ai sensi del COPPA.

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);

Se imposti questo tag, dichiari che la presente notifica è accurata e di avere 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.

Nota: per le app del programma Per la famiglia impostate come app rivolte principalmente ai minori e per gli utenti che hanno eseguito l'accesso ad Account Google gestiti con Family Link tutti i contenuti vengono automaticamente trattati come destinati ai minori per tutte le richieste di annunci.

Utenti di età inferiore a quella del consenso digitale

Puoi contrassegnare le richieste di annunci per ricevere il trattamento per gli utenti al di sotto dell'età del consenso digitale nello Spazio economico europeo (SEE). Questa funzionalità è pensata per facilitare la conformità al Regolamento generale sulla protezione dei dati (GDPR). Tieni presente che il GDPR potrebbe prevedere altri obblighi di legge. Consulta la 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 dalle obbligazioni previste dalla legge. Scopri di più su come il GDPR influisce sui publisher.

Quando utilizzi questa funzionalità, nella richiesta di annuncio viene incluso un tag per utenti di età inferiore all'età del consenso digitale (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 per le impostazioni rivolte ai minori, in RequestConfiguration è presente un membro per configurare il 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 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 per gli utenti nello Spazio economico europeo (SEE) di età inferiore a quella del consenso digitale.

L'esempio seguente indica che vuoi che 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 Rivolta ai minori e Utenti sotto l'età del consenso non devono essere entrambi impostati su true. In tal caso, 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 questo è configurato hanno una classificazione dei contenuti pari o inferiore a questo livello. I possibili valori si basano su classificazioni di etichette per contenuti digitali e devono essere uno dei seguenti valori enumerati:

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

Il seguente codice configura uno struct RequestConfiguration per specificare che il contenuto dell'annuncio restituito deve corrispondere a una designazione di etichetta per i 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 potrebbero 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();