Implementowanie bezpiecznych sygnałów bez tagów GPT, GMA i pakietów IMA SDK

Google Ad Manager używa pakietu GPT SDK do zbierania i wysyłania bezpiecznych sygnałów w przypadku żądań reklam w internecie. W przypadku aplikacji mobilnych i zasobów reklamowych wideo do integracji z pakietami SDK do reklam mobilnych Google i IMA* zwykle wymagany jest adapter od dostawcy bezpiecznego sygnału lub Google Ad Managera.

Gdy jednak wydawcy muszą zarządzać własnymi żądaniami reklam i je tworzyć w przypadku aplikacji mobilnych lub filmów, zwłaszcza na urządzenia CTV, odpowiadają też za zbieranie i uwzględnianie w tych żądaniach bezpiecznych sygnałów.

* Więcej informacji znajdziesz w tej dokumentacji dla deweloperów:

• Pakiet IMA SDK na Androida
• Pakiet IMA SDK na iOS
• Pakiet IMA SDK do HTML5

Wymagania

1. Strukturyzowanie sygnałów w obiekcie JSON
2. Kodowanie obiektu JSON
3. Dołączanie zakodowanego sygnału do adresu URL żądania reklamy
4. (Opcjonalnie) Wdrażanie mechanizmu buforowania
5. Konfigurowanie udostępniania sygnałów w usłudze Google Ad Manager

Gdy wydawca tworzy własne żądanie reklamy, aby zbierać i uwzględniać w nim wybrane bezpieczne sygnały, musi wykonać te czynności:

1. Strukturyzowanie sygnałów w obiekcie JSON

Najpierw musisz zebrać dane bezpiecznego sygnału i sformatować je w obiekt JSON. Powinien on zawierać wszystkie sygnały, które chcesz wysłać. Bezpieczne sygnały mogą być:

• Wygenerowane przez firmę zewnętrzną: sygnały zdefiniowane przez zewnętrznego dostawcę. W obiekcie JSON określisz source (identyfikator dostawcy) i data (dane wyjściowe z biblioteki dostawcy) oraz ustawisz wartość isPubCreated na false.
• Utworzone przez wydawcę (niestandardowe): sygnały zdefiniowane przez wydawcę. W przypadku tych sygnałów source to kod sieci Google Ad Managera, data to sygnał niestandardowy, a wartość parametru isPubCreated to true.

Oto przykład, jak wyglądałby ten obiekt JSON:

Przykład

JSON, w tym 2 sygnały: jeden dostarczony przez zewnętrznego dostawcę sygnałów o nazwie SOURCE1 oraz drugi, niestandardowy bezpieczny sygnał wydawcy o nazwie 123, który jest nazwany po kodzie sieci wydawcy. Wartość DATA1 jest uzyskiwana z funkcji dostarczonej przez dostawcę sygnału SOURCE1, a wartość DATA2 – z funkcji utworzonej przez wydawcę:

 

{
  "signals": [
    {
      "source": "SOURCE1",
      "data": "DATA1",
      "isPubCreated": false
    },
    {
      "source": "123",
      "data": "DATA2",
      "isPubCreated": true
    }  ]
}

„source”: „SOURCE1” to sygnał wygenerowany przez zewnętrzną usługę

• source to source_id zewnętrznego dostawcy tożsamości (podany przez dostawcę podczas rejestracji, np. „liveramp.com”, „uidapi.com”, „pubcid.org”).
• data to dane wyjściowe z biblioteki dostawcy sygnałów i główny ładunek sygnału.
• Atrybut isPubCreated ma wartość false.

„source”: „123” to niestandardowe bezpieczne sygnały utworzone przez wydawcę

• source to kod sieci (network code) wydawcy.
• data to sygnał utworzony przez wydawcę, który licytujący powinien być w stanie zdekodować. Przed wysłaniem sygnałów do Google należy je zaciemnić.
• Atrybut isPubCreated ma wartość true (prawda).

Wydawcy mogą przekształcać obiekty w ciągi znaków na różne sposoby, w zależności od swoich potrzeb i możliwości. Jedną z popularnych metod jest JSON.stringify(), czyli funkcja zaprojektowana specjalnie do serializowania obiektu JavaScript do ciągu JSON. Ten ciąg znaków to dokładna, tekstowa reprezentacja danych gotowa do przesłania.

Po JSON.stringify()
{"signals":[{"source":"SOURCE1","data":"DATA1","isPubCreated":false},{"source":"123","data":"DATA2","isPubCreated":true}]}

2. Kodowanie obiektu JSON

Gdy uzyskasz ciąg json, musisz przekonwertować go na kodowanie Base64 z alfabetem bezpiecznym dla adresów URL i nazw plików, które można bezpiecznie dołączyć do adresu URL żądania reklamy w celu przesłania.

eyJzaWduYWxzIjpbeyJzb3VyY2UiOiJTT1VSQ0UxIiwiZGF0YSI6IkRBVEExIiwiaXNQdWJDcmVhdGVkIjpmYWxzZX0seyJzb3VyY2UiOiIxMjMiLCJkYXRhIjoiREFUQTIiLCJpc1B1YkNyZWF0ZWQiOnRydWV9XX0

3. Dołączanie zakodowanego sygnału do adresu URL żądania reklamy

Na koniec utwórz adres URL żądania reklamy i uwzględnij zakodowany ciąg znaków jako wartość parametru ssj. Parametr ssj został zaprojektowany specjalnie do przenoszenia tego utworzonego przez wydawcę obiektu JSON bezpiecznego sygnału.

Ostateczny adres URL będzie wyglądać podobnie do tego:

https://pubads.g.doubleclick.net/gampad/ads?iu=/12345678/video&description_url=...&ssj=your_Base64_encoded_string

4. (Opcjonalnie) Wdrażanie mechanizmu buforowania

W przypadku implementacji bezpiecznego sygnału po stronie serwera wdrożenie mechanizmu buforowania może zmniejszyć opóźnienie. Nie jest to wymagane, ale za wdrożenie i zarządzanie tym buforowaniem odpowiada wydawca. Wdrożenie wymaga wykonania tych czynności:

1. Wygeneruj sygnał: utwórz obiekt JSON bezpiecznego sygnału.
2. Przechowuj sygnał: wdróż mechanizm przechowywania zakodowanego ciągu sygnału (np. w pamięci podręcznej po stronie serwera, bazie danych lub lokalnej pamięci podręcznej na urządzeniu klienta). Wybór metody przechowywania należy do wydawcy.
3. Ustaw czas wygaśnięcia: określ rozsądny czas, przez który sygnał pozostanie ważny. Ten czas trwania powinien być wystarczająco długi, aby obejmować wiele żądań reklam, ale wystarczająco krótki, aby sygnał nie stał się nieaktualny.
4. Pobieranie i używanie: gdy potrzebne jest nowe żądanie reklamy, system najpierw sprawdza pamięć podręczną. Jeśli istnieje prawidłowy, niewygasły sygnał, jest on pobierany i dołączany do adresu URL żądania reklamy. Jeśli sygnał wygasł lub nie istnieje, generowany jest nowy sygnał, który jest używany, a następnie zapisywany w pamięci podręcznej do wykorzystania w przyszłości.

5. Konfigurowanie udostępniania sygnałów w usłudze Google Ad Manager

Na koniec w usłudze Google Ad Manager musisz się upewnić, że bezpieczne sygnały mogą być udostępniane licytującym i partnerom wyboru. Możesz to zrobić, wykonując opisane niżej czynności.

Uwaga: ten krok można wykonać przed zakończeniem prac związanych z integracją techniczną opisanych w krokach 1–4 lub po nim.

1. Zaloguj się w usłudze Google Ad Manager.
2. Kliknij kolejno Administracja, Ustawienia globalne i Ustawienia konta Ad Exchange.
3. Kliknij przełącznik, aby zaakceptować warunki korzystania z Udostępniania bezpiecznych sygnałów.

4. Kliknij kolejno Zasoby reklamowe i Bezpieczne sygnały.

   Upewnij się, że w przypadku odpowiednich sygnałów metoda wdrażania w kolumnie „Sposób wdrożenia integracji internetowej” jest ustawiona na „Wdrożenie przez wydawcę”.

   Uwaga: jeśli używasz też modułu UserID w Prebid do wysyłania tych samych sygnałów w żądaniach internetowych opartych na GPT, ta metoda będzie nadal działać zgodnie z oczekiwaniami.

5. Kliknij kolejno Wyświetlanie i Ustawienia na potrzeby kanałów popytu.

   Upewnij się, że bezpieczne sygnały mogą być wysyłane do wszystkich lub wybranych partnerów Authorized Buyers i Otwartego ustalania stawek.

Więcej informacji znajdziesz w artykule Udostępnianie bezpiecznych sygnałów licytującym i partnerom wyboru.