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 wysyłać bezpieczne sygnały do Google Ad Managera za pomocą pakietu IMA SDK.
Interfejs Secure Signals API wymaga pakietu IMA SDK na Androida w wersji 3.29.0 lub nowszej.
Aby wybrać sygnały i licytujących oraz włączyć udostępnianie bezpiecznych sygnałów, zapoznaj się z artykułem Udostępnianie bezpiecznych sygnałów licytującym.
Korzystanie z usługi zewnętrznego dostawcy sygnałów
Aby korzystać z bezpiecznych sygnałów, musisz wdrożyć w aplikacji klasę adaptera modułu zbierającego sygnały, która będzie zbierać sygnały, kodować je i przekazywać do pakietu IMA SDK.
Aby skonfigurować konto u dostawcy zewnętrznego, postępuj zgodnie z jego instrukcjami. Następnie dodaj zależności kompilacji i skonfiguruj w aplikacji adapter bezpiecznych sygnałów.
Pakiet IMA SDK na Androida automatycznie inicjuje każdy adapter bezpiecznych sygnałów bez wprowadzania dodatkowych zmian w kodzie.
Oto przykład dodawania do projektu adaptera bezpiecznych sygnałów:
Wysyłanie danych niestandardowych
Oprócz korzystania z usług dostawcy sygnałów zewnętrznych 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 Ad Managerze.
W przypadku każdego żądania reklamy utwórz obiekt SecureSignals zawierający zakodowane dane niestandardowe w postaci ciągu znaków. Następnie dodaj obiekt SecureSignals do żądania reklamy, wywołując metodę adsRequest.setSecureSignals():
app/src/main/java/com/example/project name/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);
}
...