Ce guide explique comment fournir des informations de ciblage dans une demande d'annonce. Pour une par exemple, téléchargez l'application de démonstration de l'API Android.
Télécharger la démonstration de l'API
Conditions préalables
- Suivez le guide de démarrage.
RequestConfiguration
RequestConfiguration
est un objet qui collecte des informations de ciblage à appliquer au niveau mondial via
un MobileAds
statique.
Pour mettre à jour la configuration de la requête, obtenez un compilateur à partir de la effectuer les mises à jour souhaitées, puis définissez-les comme suit:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Paramètre destiné aux enfants
Aux fins de la loi Children's Online Privacy Protection Act (loi COPPA), il existe un paramètre appelé "tag pour signaler un traitement adapté aux contenus destinés aux enfants". En définissant cette balise, vous certifiez que cette notification est exacte et 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. de votre compte Google.
En tant que développeur d'applications, vous pouvez indiquer si vous souhaitez que Google traite vos lorsque vous envoyez une demande d'annonce. Si vous indiquez que souhaitez que Google considère votre contenu comme étant destiné aux enfants, nous prenons 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 utilisé avec toutes les versions du SDK des services Google Play
à RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)
:
Appeler
setTagForChildDirectedTreatment
avecTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE
pour indiquer que vous souhaitez le contenu traité comme étant destiné aux enfants aux fins de la loi COPPA. Cela permet d'éviter la transmission de l'identifiant publicitaire Android (AAID).Appeler
setTagForChildDirectedTreatment
avecTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE
pour indiquer que vous ne souhaitez pas le contenu traité comme étant destiné aux enfants aux fins de la loi COPPA.Appeler
setTagForChildDirectedTreatment
avecTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED
si vous ne souhaitez pas préciser la manière dont vous aimeriez que votre contenu soit traité par rapport à la loi COPPA dans les demandes d'annonces.
L'exemple suivant indique que vous souhaitez que votre contenu soit traité comme destiné aux enfants conformément à la loi COPPA:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
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 aux utilisateurs du domaine suivant : dans l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette fonctionnalité est visant à vous aider à respecter les Règles générales Règlement sur la protection des données (RGPD). Notez que vous pouvez avoir d'autres en vertu du RGPD. Consulter les directives de l'Union européenne et consulter votre propre conseiller juridique. Notez que les outils Google sont conçus pour faciliter de conformité et ne dispensent aucun éditeur de ses obligations en vertu des la loi. En savoir plus sur l'impact du RGPD sur les éditeurs
Lorsque vous utilisez cette fonctionnalité, une balise pour les utilisateurs n'ayant pas atteint l'âge minimal requis en Europe (TFUA) est inclus dans la demande d'annonce. Ce paramètre désactive de la publicité personnalisée (y compris le remarketing) pour toutes les demandes d'annonces. Il y a aussi désactive les demandes adressées à des fournisseurs d'annonces tiers, comme les pixels de mesure des annonces des ad servers tiers.
Comme pour les contenus destinés aux enfants, il existe une méthode
RequestConfiguration.Builder
pour définir le paramètre TFUA:
setTagForUnderAgeOfConsent()
,
avec les options suivantes.
Appeler le
setTagForUnderAgeOfConsent()
avecTAG_FOR_UNDER_AGE_OF_CONSENT_TRUE
pour indiquer que vous souhaitez que la demande d'annonce soit traitée pour les utilisateurs situés dans dans l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis. Cette opération empêche la transmission de l'identifiant publicitaire Android (AAID).Appeler le
setTagForUnderAgeOfConsent()
avecTAG_FOR_UNDER_AGE_OF_CONSENT_FALSE
pour indiquer que vous souhaitez que la demande d'annonce ne soit pas traitée pour les utilisateurs. n'ayant pas atteint l'âge minimal requis dans l'Espace économique européen (EEE).Appeler
setTagForUnderAgeOfConsent()
avecTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED
pour indiquer que vous n'avez pas spécifie si la demande d'annonce doit être traitée pour les utilisateurs du dans l'Espace économique européen (EEE) n'ayant pas atteint l'âge minimal requis.
L'exemple suivant indique que vous souhaitez inclure le tag TFUA dans vos demandes d'annonces:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Les tags permettant d'activer le paramètre Destiné aux enfants
et setTagForUnderAgeOfConsent()
ne doivent pas être tous les deux définis sur true
en même temps.
Si c'est le cas, le paramètre destiné aux contenus destinés aux enfants prévaut.
Filtrage du contenu des annonces
Pour respecter les Règles Google Play relatives aux annonces inappropriées incluant les offres associées dans une annonce, toutes les annonces et leurs Les offres affichées dans votre application doivent être en adéquation avec le contenu note de votre application, même si le contenu en lui-même est conforme aux Règles de Google Play.
Des outils tels que la classification maximale du contenu des annonces peuvent vous aider à mieux contrôler le contenu des annonces diffusées auprès de vos utilisateurs. Vous pouvez définir la classification maximale du contenu sur pour vous aider à respecter les règles de la plate-forme.
Les applications peuvent définir la classification maximale du contenu des annonces pour leurs demandes d'annonces à l'aide de la
setMaxAdContentRating
. Lorsque cette option est configurée, les annonces AdMob affichent une classification du contenu égale ou égale à
en dessous de ce niveau. Les valeurs possibles de cet extra réseau sont basées sur
classification de libellés de contenu numérique, et doit correspondre à l'une des
chaînes:
MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA
Le code suivant configure un objet RequestConfiguration
pour spécifier que
le contenu d'annonce renvoyé doit correspondre à une désignation de libellé de contenu numérique non
supérieure à G
:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Consultez les articles suivants :
Définition de la classification maximale du contenu pour chaque annonce demande
Définir la classification maximale du contenu des annonces pour une application compte
Traitement de la confidentialité pour les éditeurs (bêta)
La
Traitement de la confidentialité des éditeurs
L'API (PPT) est un outil facultatif qui permet aux applications d'indiquer s'il faut désactiver les annonces
pour toutes les demandes d'annonces
setPublisherPrivacyPersonalizationState()
.
Lorsque vous utilisez cette fonctionnalité, un paramètre de traitement de la confidentialité de l'éditeur (PPT) est
seront incluses dans toutes les futures demandes d'annonces jusqu'à la fin de la session.
Par défaut, les demandes d'annonces envoyées à Google reçoivent des annonces personnalisées. Les éléments suivants : désactive la personnalisation des annonces pour toutes les demandes d'annonces:
Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
var requestConfiguration = MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
Demande d'annonce
L'objet AdManagerAdRequest
collecte le ciblage
à envoyer avec une demande d'annonce.
Ciblage personnalisé
Vous pouvez transmettre des paires clé-valeur personnalisées pour cibler des campagnes Google Ad Manager (ligne
) à AdManagerAdRequest.Builder.addCustomTargeting()
:
Java
// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build();
Kotlin
// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
.addCustomTargeting("age", "25")
.build()
Vous pouvez transmettre plusieurs valeurs pour une clé sous la forme d'une liste de chaînes. Par exemple, pour cibler les personnes d'une vingtaine d'années et non plus seulement les 25 ans.
.addCustomTargeting("age", Arrays.asList("24", "25", "26"))
Consultez l'exemple de ciblage personnalisé Ad Manager. pour découvrir comment implémenter le ciblage personnalisé dans l'application de démonstration de l'API Android.
Exclusions de catégories
Vous pouvez ajouter un niveau d'exclusion de catégories au niveau de l'espace publicitaire à une demande à l'aide de la méthode
addCategoryExclusion()
fournie par AdManagerAdRequest.Builder
:
Java
// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build();
Kotlin
// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
.addCategoryExclusion("automobile")
.addCategoryExclusion("boat")
.build()
Consultez l'exemple d'exclusion de catégories dans Ad Manager. pour découvrir l'implémentation des exclusions de catégories dans l'application de démonstration de l'API Android.
Identifiants fournis par l'éditeur
Vous pouvez définir un identifiant fourni par l'éditeur (PPID) à utiliser pour la limitation de la fréquence d'exposition, la segmentation et le ciblage de l'audience, la rotation séquentielle des annonces des commandes de diffusion d'annonces basées sur l'audience sur les différents appareils.
Voici un exemple de configuration du PPID:
Java
AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build();
Kotlin
var adRequest = AdManagerAdRequest.Builder()
.setPublisherProvidedId("AB123456789")
.build()
Consultez l'exemple de PPID Ad Manager. pour implémenter les identifiants fournis par l'éditeur (PPID) dans le Application de démonstration des API
Signaux fournis par l'éditeur
Vous pouvez envoyer des données d'audience et contextuelles signaux fournis par l'éditeur (PPS) dans les demandes d'annonces. Avec les PPS, vous pouvez utiliser vos données utilisateur pour améliorer la monétisation programmatique en communiquant les caractéristiques de votre audience tous les enchérisseurs types de transactions, en utilisant les taxonomies standards, sans qu'il soit nécessaire de partager les identifiants utilisateur. Votre audience peuvent inclure des données comportementales et basées sur les centres d'intérêt (Audience de l'IAB Taxonomie 1.1) et de ciblage contextuel (Taxonomie de contenu de l'IAB 2.2).
Java
Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build()
Kotlin
val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))
val request = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
URL de contenu
Afin de fournir une URL de contenu pour les annonces ciblées sur le contenu et la brand safety, vous pouvez appeler
setContentUrl()
lors de la création d'un AdManagerAdRequest
:
Java
AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();
Kotlin
val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()
Brand safety (bêta)
Les applications qui affichent du contenu dynamique destiné à différentes audiences ne sont
être en mesure de fournir une courte liste d'URL à l'aide de la méthode
setNeighboringContentUrls()
lors de la création d'un AdManagerAdRequest
:
Java
ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build();
Kotlin
var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
"https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
.setNeighboringContentUrls(urls)
.build()
.setNeighboringContentUrls()
diffère de .setContentUrl()
, car il ne s'agit
utilisées pour la brand safety.