Pierwsze kroki z bezpiecznymi sygnałami

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 strumienia wykonaj te czynności:

  1. Utwórz obiekt SecureSignals zawierający zakodowane dane niestandardowe w postaci ciągu tekstowego.
  2. Dodaj obiekt SecureSignals do żą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);
  }