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 API bezpiecznych sygnałów 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, przeczytaj artykuł Udostępnianie bezpiecznych sygnałów licytującym.
Korzystanie z zewnętrznego dostawcy sygnałów
Aby korzystać z bezpiecznych sygnałów, musisz wdrożyć w aplikacji klasę adaptera kolektora sygnałów, która będzie zbierać sygnały, kodować je i przekazywać do pakietu IMA SDK.
Postępuj zgodnie z instrukcjami zewnętrznego dostawcy, aby skonfigurować u niego konto, dodać zależności kompilacji, i skonfigurować adapter bezpiecznych sygnałów w aplikacji.
Pakiet IMA SDK na Androida automatycznie inicjuje każdy adapter bezpiecznych sygnałów bez konieczności wprowadzania dodatkowych zmian w kodzie.
Oto przykład, jak możesz dodać adapter bezpiecznych sygnałów 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 Ad Managerze.
W przypadku każdego żądania strumienia wykonaj te czynności:
- Utwórz obiekt
SecureSignalszawierający zakodowane dane niestandardowe w postaci ciągu tekstowego. - Dodaj obiekt
SecureSignalsdo żądania strumienia, wywołując metodęstreamRequest.setSecureSignals():
app/src/main/java/com/example/project name/SampleAdsWrapper.java
public void requestAndPlayAds() {
adsLoader.addAdErrorListener(this);
adsLoader.addAdsLoadedListener(this);
StreamRequest request = buildStreamRequest();
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
request.setFormat(StreamFormat.HLS);
adsLoader.requestStream(request);
}