Bezpieczne sygnały to zakodowane dane zbierane na urządzeniu klienta i udostępniane wybranym licytującym. Z tego przewodnika dowiesz się, jak zbierać i przesyłać bezpieczne sygnały do Google Ad Managera za pomocą pakietu IMA SDK.
Interfejs API secure signals wymaga pakietu IMA SDK na iOS w wersji 3.18.1 lub nowszej.
Aby wybrać sygnały i licytujących oraz włączyć udostępnianie bezpiecznych sygnałów, przeczytaj artykuł Udostępnianie licytującym bezpiecznych sygnałów.
Korzystanie z zewnętrznego dostawcy sygnałów
Aby korzystać z bezpiecznych sygnałów, musisz wdrożyć w aplikacji klasę adaptera do zbierania sygnałów, która będzie je zbierać, kodować i przekazywać do pakietu IMA SDK.
Postępuj zgodnie z instrukcjami zewnętrznego dostawcy, aby skonfigurować konto. Uwzględnij frameworki i skonfiguruj adapter bezpiecznych sygnałów w aplikacji.
Pakiet IMA SDK na iOS automatycznie inicjuje każdy adapter bezpiecznych sygnałów bez konieczności wprowadzania dodatkowych zmian w kodzie.
Oto przykład dodawania adaptera sygnałów bezpiecznych do projektu:
Wysyłanie danych niestandardowych
Oprócz korzystania z zewnętrznego dostawcy sygnałów możesz też zbierać, kodować i wysyłać sygnały z danymi niestandardowymi. Zanim zaczniesz wysyłać bezpieczne sygnały z danymi niestandardowymi, musisz włączyć sygnały niestandardowe w usłudze Ad Manager.
W przypadku każdego żądania reklamy utwórz obiekt IMASecureSignals zawierający zakodowane dane niestandardowe w postaci ciągu znaków. Następnie dodaj obiekt IMASecureSignals do żądania reklamy, wywołując atrybut IMAAdsRequest.secureSignals.
Oto przykłady w językach Objective-C i 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)
}
...