L'URL de transparence des annonces vous permet de personnaliser l' AdChoices qui s'affiche dans certaines annonces. Par défaut, cette icône s'affiche auprès de vos utilisateurs via une expérience de transparence et de contrôle des annonces (TCA) générée par Google, qui inclut des informations telles que l'annonceur et l'annonce elle-même.
Vous pouvez obtenir l'URL de transparence des annonces en envoyant une demande d'annonce au SDK Google Mobile Ads et en recevant une réponse contenant l'URL de transparence des annonces. Une fois que vous avez reçu l'URL dans votre application, vous pouvez intégrer une icône personnalisée qui peut respecter la conception de vos annonces et présenter votre propre expérience de TCA à vos utilisateurs.
Cette page explique comment demander, analyser et valider l'URL de transparence des annonces.
Prérequis
Avant de continuer, assurez-vous d'avoir effectué les opérations suivantes :
- Configurez des annonces natives dans votre application. Pour en savoir plus sur les annonces natives, consultez À propos des annonces natives.
- Demandez l'accès à cette fonctionnalité sur la liste d'autorisation. Pour demander l'accès, contactez votre responsable de compte.
- Si vous n'y avez pas accès, vos réponses ne renvoient pas l'URL de transparence des annonces, et l'icône par défaut s'affiche comme prévu.
Demander l'URL
Pour que GMA Next-Gen SDK vous renvoie l'URL de transparence des annonces, ajoutez un paramètre de requête supplémentaire dans vos demandes d'annonces natives. Ce paramètre indique que votre application est prête à gérer une icône personnalisée.
Dans votre requête, vous devez ajouter la clé "ad_transparency_url_requested" avec
la valeur "1" à votre bundle d'extras réseau. Pour en savoir plus sur les extras réseau,
consultez
setGoogleExtrasBundle
.
L'exemple suivant définit cette clé et cette valeur pour demander l'URL de transparence des annonces :
Java
private void loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation.
Bundle extras = new Bundle();
extras.putString("ad_transparency_url_requested", "1");
NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
}
Kotlin
private fun loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation
val extras = Bundle()
extras.putString("ad_transparency_url_requested", "1");
val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
}
Remplacez AD_UNIT_ID par l'ID de votre bloc d'annonces. Par exemple, ca-app-pub-3940256099942544/2247696110 pour les annonces natives.
Analyser l'URL
Une fois que vous avez demandé l'URL, vous recevez une réponse d'annonce contenant l'URL de transparence des annonces dans l'objet d'informations sur la réponse. Pour en savoir plus sur l'objet d'informations sur la réponse, consultez Informations sur la réponse.
Vous pouvez accéder à l'URL de transparence des annonces dans la clé "ad_transparency_url"
à partir des extras de la réponse. L'exemple suivant obtient l'URL de transparence des annonces dans l'objet d'informations sur la réponse :
Java
nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");
Kotlin
nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")
Valider l'URL
Pour tester et valider l'URL de transparence des annonces, vérifiez que l'icône par défaut fournie par Google ne s'affiche pas dans votre annonce native, mais que votre icône personnalisée s'affiche. Cliquez sur l'icône pour afficher l'expérience de TCA.
Vérifiez également que l'URL de transparence des annonces s'affiche dans les extras de la réponse dans votre objet d'informations sur la réponse. Si l'URL de transparence des annonces ne s'affiche pas, l'icône Google par défaut s'affiche à la place de votre icône personnalisée. Voici un exemple d'URL de transparence des annonces :
https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID