Pierwsze kroki z bezpiecznymi sygnałami

Wybierz platformę: HTML5 Android iOS tvOS

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 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 adaptera bezpiecznych sygnałów do projektu:

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 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 reklamy, wywołując metodę adsRequest.setSecureSignals():

private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
  SecureSignals signal = SecureSignals.create(secureSignalsString);
  adsRequest.setSecureSignals(signal);
}