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 4.8.2 ou ultérieure du SDK IMA pour tvOS.
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, inclure des frameworks et configurer son adaptateur de signaux sécurisés dans votre application.
Le SDK IMA pour tvOS initialise automatiquement chaque adaptateur de signaux sécurisés, sans 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 IMASecureSignals contenant vos données personnalisées encodées sous forme de chaîne. Ajoutez ensuite l'objet IMASecureSignals à votre requête d'annonce en appelant l'attribut IMAAdsRequest.secureSignals.
Voici des exemples en Objective-C et en Swift:
Objective-C
BasicExample/ViewController.m
...
- (void)requestAds {
// Create an ad display container for ad rendering.
IMAAdDisplayContainer *adDisplayContainer =
[[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
viewController:self
companionSlots:nil];
// Create an ad request with our ad tag, display container, and optional user context.
IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
adDisplayContainer:adDisplayContainer
contentPlayhead:self.contentPlayhead
userContext:nil];
IMASecureSignals *signals =
[[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
request.secureSignals = signals;
[self.adsLoader requestAdsWithRequest:request];
}
...
Swift
BasicExample/ViewController.swift
...
private func requestAds() {
// Create ad display container for ad rendering.
let adDisplayContainer = IMAAdDisplayContainer(
adContainer: videoView, viewController: self, companionSlots: nil)
// Create an ad request with our ad tag, display container, and optional user context.
let request = IMAAdsRequest(
adTagUrl: ViewController.testAppAdTagURL,
adDisplayContainer: adDisplayContainer,
contentPlayhead: contentPlayhead,
userContext: nil)
let signals = IMASecureSignals(customData: "My encoded signal string")
request.secureSignals = signals
adsLoader.requestAds(with: request)
}
...