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 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 dodawania adaptera 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 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 swojego żądania reklamy wywołując adsRequest.setSecureSignals() metodę:

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