Paramètres des annonces limitées et des identifiants first party

Les annonces limitées permettent aux applications de diffuser des annonces lorsque vos utilisateurs n'acceptent pas de partager des données à caractère personnel. Le mode "Annonces limitées" arrête la collecte, le partage et l'utilisation de données à caractère personnel pour la sélection des annonces. Si vos utilisateurs choisissent de ne pas partager de données à caractère personnel, cette fonctionnalité permet de continuer à diffuser des annonces.

Ce guide explique comment utiliser les paramètres d'annonces limitées dans votre application et comment faire correspondre le comportement de l'application aux paramètres généraux de votre réseau Google Ad Manager.

Configurer les paramètres d'annonces limitées du client

La version 23.0.0 de la bibliothèque d'accès programmatique introduit la propriété forceLimitedAds et supprime la propriété allowStorage. Cette propriété se trouve dans la ConsentSettings classe.

À partir de la version 23.0.0, la bibliothèque d'accès programmatique lit les données du Transparency and Consent Framework (TCF) de l'appareil pour déterminer si l'utilisateur a consenti au stockage local. Auparavant, votre application était responsable de la détermination du consentement au stockage. Votre application doit toujours transmettre les paramètres gdpr= et gdpr_consent= dans l'URL du tag d'emplacement publicitaire.

Si la détermination automatique basée sur le TCF ne suffit pas, définissez directement la forceLimitedAds propriété dans votre application. Pour en savoir plus, consultez Intégration du TCF de l'IAB Europe pour les éditeurs. Définir la propriété forceLimitedAds sur la valeur true empêche la bibliothèque d'accès programmatique de stocker ou d'envoyer des identifiants utilisateur dans le nonce envoyé au serveur. Définir la propriété forceLimitedAds sur la valeur true revient à ajouter le paramètre ltd=1 à l'URL de la demande d'annonce dans les SDK IMA (Interactive Media Ads). Pour en savoir plus sur les annonces limitées, consultez ltd (Annonces limitées). Lorsque vous définissez la propriété forceLimitedAds sur la valeur true, la bibliothèque d'accès programmatique inclut le paramètre ltd=1 dans le nonce.

Pour conserver le comportement actuel dans votre application, vous devrez peut-être modifier votre implémentation, même si vous n'aviez pas défini la propriété allowStorage auparavant. La propriété allowStorage était définie par défaut sur la valeur false, ce qui activait les annonces limitées. La propriété forceLimitedAds est définie par défaut sur la false valeur, ce qui n'active pas les annonces limitées.

Mettre à jour l'implémentation de la bibliothèque d'accès programmatique pour la détermination basée sur le TCF

La bibliothèque d'accès programmatique pour Android nécessite une action lors de la mise à jour vers la version 23.0.0, qui permet à la bibliothèque d'accès programmatique de lire les données du TCF de l'appareil pour déterminer le consentement utilisateur pour le stockage local. Cette version ajoute également la propriété forceLimitedAds et supprime la propriété allowStorage. Ne mettez à jour votre application pour utiliser la propriété forceLimitedAds que si l'activation des annonces limitées basée sur le TCF ne répond pas aux exigences de votre application. Pour en savoir plus sur la détermination basée sur le TCF, consultez Intégration du TCF de l'IAB Europe pour les éditeurs.

Faire correspondre les paramètres généraux de Google Ad Manager

Si vous modifiez les paramètres Ad Manager Annonces limitées programmatiques ou Identifiants first party pour les annonces dans les applications, utilisez ces nouvelles API pour faire correspondre les paramètres dans Ad Manager. Si vous n'utilisez pas les API, la bibliothèque d'accès programmatique peut inclure les identifiants dans le nonce utilisé dans la demande d'annonce au serveur. Toutefois, Ad Manager peut supprimer les signaux en fonction des paramètres définis dans Ad Manager.

Les API sont les suivantes :

  • disableLimitedAdsStorage - désactive les identifiants dédiés uniquement à la détection du trafic incorrect et l'utilisation du stockage local pour les annonces limitées. Si vous avez modifié le paramètre Annonces limitées programmatiques dans Ad Manager sous Admin > Paramètres généraux, utilisez cette API pour désactiver l'utilisation du stockage local pour les annonces limitées dans la bibliothèque d'accès programmatique. Notez que ce paramètre ne s'applique pas aux annonces non limitées.
  • disableFirstPartyIdentifiers : désactive les identifiants first party utilisés pour la sélection des annonces. Si vous avez modifié le paramètre Identifiants first party pour les annonces dans les applications dans Ad Manager sous Admin > Paramètres généraux, utilisez cette API pour désactiver ces identifiants dans la bibliothèque d'accès programmatique. Notez que ce paramètre ne s'applique pas à l'utilisation d'identifiants et du stockage local pour la détection du trafic incorrect.

L'exemple suivant gère la confidentialité des utilisateurs et la consommation des données dans une implémentation de la bibliothèque d'accès programmatique :

ConsentSettings consentSettings = ConsentSettings.builder()
            .directedForChildOrUnknownAge(false)
            .build();
// PAL Android version 23.0.0 introduces
// `ConsentSettings.forceLimitedAds` and removes `ConsentSettings.allowStorage`.
// Best practice is to not set `forceLimitedAds` to allow PAL to automatically
// determine whether limited ads applies based on the TCF data.
// To enable limited ads regardless of the TCF determination, set the
// `forceLimitedAds` property to a `true` value.

GoogleAdManagerSettings adManagerSettings = GoogleAdManagerSettings.builder()
            // Add this line if the "Programmatic limited ads" toggle is turned
            // off in Ad Manager.
            .disableLimitedAdsStorage(true)
            // Add this line if the
            // "First party identifiers for ads on app" toggle is turned
            // off in Ad Manager.
            .disableFirstPartyIdentifiers(true)
            .build();

nonceLoader = new NonceLoader(this, consentSettings, adManagerSettings);