Cette page a été traduite par l'API Cloud Translation.

Ciblage

Ce guide explique comment fournir des informations de ciblage à une demande d'annonce.

Prérequis

Suivez les instructions de la section Premiers pas.

`RequestConfiguration`

RequestConfiguration est une structure qui collecte les informations de ciblage à appliquer globalement via la fonction globale SetRequestConfiguration().

Pour mettre à jour la configuration de la requête, commencez par obtenir la configuration actuelle, apportez les modifications souhaitées, puis définissez-la comme suit :

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Paramètre "Contenu destiné aux enfants"

Aux fins de la loi COPPA (Children's Online Privacy Protection Act), il existe un paramètre appelé "Ajouter une balise pour signaler un traitement adapté aux contenus destinés aux enfants". En définissant ce tag, vous certifiez que cette notification est correcte et que vous êtes autorisé à agir au nom du propriétaire de l'application. Vous comprenez que toute utilisation abusive de ce paramètre peut entraîner la clôture de votre compte Google.

En tant que développeur d'applications, vous pouvez indiquer à Google que vous souhaitez que votre contenu soit considéré comme destiné aux enfants lorsque vous envoyez une demande d'annonce. Si vous indiquez que vous souhaitez que Google traite votre contenu comme destiné aux enfants, nous prenons des mesures pour désactiver la publicité ciblée par centres d'intérêt et les annonces de remarketing pour cette demande d'annonce.

Ce paramètre peut être configuré en attribuant le membre tag_for_child_directed_treatment de la structure RequestConfiguration à l'une des valeurs énumérées suivantes :

Attribuez RequestConfiguration::tag_for_child_directed_treatment à RequestConfiguration::kChildDirectedTreatmentTrue pour indiquer que vous souhaitez que votre contenu soit considéré comme destiné aux enfants aux fins de la loi COPPA.
Attribuez RequestConfiguration::tag_for_child_directed_treatment à RequestConfiguration::kChildDirectedTreatmentFalse pour indiquer que vous ne souhaitez pas que votre contenu soit considéré comme destiné aux enfants aux fins de la loi COPPA.
Attribuez RequestConfiguration::tag_for_child_directed_treatment à RequestConfiguration::kChildDirectedTreatmentUnspecified si vous ne souhaitez pas indiquer comment vous voulez que votre contenu soit traité conformément à la loi COPPA dans les demandes d'annonces.

L'exemple suivant indique que vous souhaitez que votre contenu soit traité comme étant destiné aux enfants aux fins de la loi COPPA :

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

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

En définissant ce tag, vous certifiez que cette notification est correcte et que vous êtes autorisé à agir au nom du propriétaire de l'application. Vous comprenez que l'utilisation abusive de ce paramètre peut entraîner la résiliation de votre compte Google.

Utilisateurs n'ayant pas atteint l'âge minimal requis

Vous pouvez marquer vos demandes d'annonces de sorte qu'elles soient traitées comme étant destinées à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette fonctionnalité vise à vous aider à respecter le Règlement général sur la protection des données (RGPD). Notez que le RGPD peut inclure d'autres obligations légales. Veuillez consulter les instructions de l'Union européenne et contacter votre conseiller juridique. N'oubliez pas que les outils Google sont conçus pour simplifier la conformité et ne dispensent aucun éditeur de ses obligations envers la loi. Découvrez comment le RGPD affecte les éditeurs.

Lorsque vous utilisez cette fonctionnalité, un paramètre "Tag For Users under the Age of Consent in Europe" (TFUA, balise pour les utilisateurs n'ayant pas atteint l'âge de consentement en Europe) est inclus dans la demande d'annonce. Il désactive la publicité personnalisée (y compris le remarketing) pour toutes les demandes d'annonces. Il désactive également les demandes adressées aux fournisseurs d'annonces tiers (les pixels de mesure des performances des annonces et les ad servers tiers, par exemple).

Comme pour les paramètres destinés aux enfants, il existe un membre dans RequestConfiguration pour configurer le paramètre TFUA : tag_for_under_age_of_consent, qui peut être configuré avec les valeurs énumérées suivantes :

Attribuez RequestConfiguration::tag_for_under_age_of_consent à RequestConfiguration::kUnderAgeOfConsentTrue pour indiquer que vous souhaitez que la demande d'annonce soit traitée comme étant destinée à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement.
Attribuez RequestConfiguration::tag_for_under_age_of_consent à RequestConfiguration::kUnderAgeOfConsentFalse pour indiquer que vous ne souhaitez pas que la demande d'annonce soit traitée pour les utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement.
Attribuez RequestConfiguration::tag_for_under_age_of_consent à RequestConfiguration::kUnderAgeOfConsentUnspecified pour indiquer que vous n'avez pas précisé si la demande d'annonce doit être traitée comme étant destinée à des utilisateurs de l'Espace économique européen (EEE) n'ayant pas atteint l'âge de consentement.

L'exemple suivant indique que vous souhaitez inclure TFUA dans vos demandes d'annonces :

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

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Vous ne devez pas définir simultanément sur "true" les tags permettant d'activer le paramètre "Contenu destiné aux enfants" et "Utilisateurs n'ayant pas atteint l'âge légal". Si tel est le cas, le paramètre "Contenu destiné aux enfants" est prioritaire.

Filtrage du contenu des annonces

Les applications peuvent définir une classification maximale du contenu des annonces pour leurs demandes d'annonces via RequestConfiguration::max_ad_content_rating field. Les annonces AdMob renvoyées lorsque ce paramètre est configuré ont une classification du contenu égale ou inférieure à ce niveau. Les valeurs possibles pour ce paramètre sont basées sur les classifications des libellés de contenu numérique et doivent être l'une des valeurs énumérées suivantes :

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

Le code suivant configure une structure RequestConfiguration pour spécifier que le contenu d'annonce renvoyé doit correspondre à un libellé de contenu numérique ne dépassant pas la désignation 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'objet AdRequest collecte les informations de ciblage à envoyer avec une demande d'annonce.

URL de contenu

Lorsqu'elles demandent une annonce, les applications peuvent transmettre l'URL du contenu qu'elles diffusent. Cela permet au ciblage par mots clés de faire correspondre l'annonce au contenu.

Par exemple, si votre application demande une annonce tout en affichant du contenu provenant de https://www.example.com, vous pouvez transmettre cette URL pour cibler les mots clés pertinents :

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();