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 vous 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 auprès de lui, 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 aucune modification supplémentaire de 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, créez un objet SecureSignals contenant vos données personnalisées encodées sous forme de chaîne. Ajoutez ensuite l'objet SecureSignals à votre requête d'annonce en appelant adsRequest.setSecureSignals().
Voici un exemple en Java:
app/src/main/java/com/example/nom du projet/MainActivity.java
...
private void requestAds(String adTagUrl) {
// Create the ads request.
AdsRequest request = sdkFactory.createAdsRequest();
request.setAdTagUrl(adTagUrl);
request.setContentProgressProvider(
() -> {
if (videoPlayer.getDuration() <= 0) {
return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
}
return new VideoProgressUpdate(
videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
});
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
adsLoader.requestAds(request);
}
...