Les signaux sécurisés sont des données encodées collectées sur l'appareil client et partagées avec certains enchérisseurs. Ce guide explique comment collecter et envoyer des signaux sécurisés à Google Ad Manager à l'aide du SDK IMA.
L'API Secure Signals nécessite la version 3.29.0 ou ultérieure du SDK IMA pour Android.
Pour sélectionner des signaux et des enchérisseurs, et activer le partage de signaux sécurisés, consultez Partager des signaux sécurisés avec les enchérisseurs.
Utiliser un fournisseur de signaux tiers
Pour utiliser des signaux sécurisés, vous devez déployer une classe d'adaptateur de collecteur de signaux dans votre application afin de collecter les signaux, de les encoder et de les transmettre au SDK IMA.
Suivez les instructions de votre fournisseur tiers pour configurer un compte, ajouter des dépendances de compilation et configurer son adaptateur de signaux sécurisés dans votre application.
Le SDK IMA pour Android initialise automatiquement chaque adaptateur de signaux sécurisés, sans qu'il soit nécessaire d'apporter d'autres modifications à votre code.
Voici un exemple d'ajout d'un adaptateur de signaux sécurisés à votre projet :
Envoyer des données personnalisées
En plus d'utiliser un fournisseur de signaux tiers, vous pouvez également collecter, encoder et envoyer des signaux avec des données personnalisées. Avant de pouvoir envoyer des signaux sécurisés avec des données personnalisées, vous devez activer les signaux personnalisés dans Ad Manager.
Pour chaque demande d'annonce, procédez comme suit :
- Créez un objet
SecureSignalscontenant vos données personnalisées encodées sous forme de chaîne. - Ajoutez l'objet
SecureSignalsà votre demande d'annonce en appelant la méthodeadsRequest.setSecureSignals():
private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
SecureSignals signal = SecureSignals.create(secureSignalsString);
adsRequest.setSecureSignals(signal);
}