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 for iOS w wersji 3.18.1 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 zbierającego sygnały, 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ć platformy, i skonfigurować adapter bezpiecznych sygnałów w aplikacji.

Pakiet IMA SDK for iOS 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 strumienia wykonaj te czynności:

  1. Utwórz obiekt IMASecureSignals zawierający zakodowane dane niestandardowe w postaci ciągu tekstowego.
  2. Dodaj obiekt IMASecureSignals do żądania strumienia, ustawiając atrybut IMAStreamRequest.secureSignals:

Objective-C

IMASecureSignals *signals =
    [[IMASecureSignals alloc] initWithCustomData:@"ENCODED_SIGNAL_STRING"];
streamRequest.secureSignals = signals;

Swift

let signals = IMASecureSignals(customData: "ENCODED_SIGNAL_STRING")
streamRequest.secureSignals = signals