Pierwsze kroki z bezpiecznymi sygnałami

Wybierz platformę: HTML5 Android iOS tvOS

Bezpieczne sygnały to zakodowane dane, które są 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, 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 modułu zbierającego sygnały, która będzie zbierać sygnały, kodować je i przekazywać do pakietu IMA SDK.

Postępuj zgodnie z instrukcjami dostawcy zewnętrznego, aby utworzyć u niego konto, dodać zależności kompilacji i skonfigurować 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 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 usłudze Ad Manager.

W przypadku każdego żądania reklamy wykonaj te czynności:

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