Przewodnik integracji tematów dla platform SSP

W ramach Piaskownicy prywatności Chrome zaproponował(a) Topics API, API. Tematy Interfejs API udostępnia zewnętrzne elementy wywołujące na stronie internetowej (w tym dostawców technologii reklamowych) dzięki reklamom o dużej ziarnistości tematy które może zainteresować użytkownika strony. Te tematy mogą uzupełniają informacje kontekstowe bieżącej strony.

Reklamy displayowe i W przypadku usług Video 360 i Google Ads Topics API to cenny sygnał z innymi sygnałami do wyświetlania reklam opartych na zainteresowaniach. korzystając z plików cookie innych firm. Więcej informacji Informacje o reklamach displayowych Podejście Video 360 i Google Ads do reklam opartych na zainteresowaniach. Google zachęca platformy SSP do umieszczania w prośbach tematów z wykorzystaniem tematów, aby na temat trafności zasobów reklamowych wydawcy.

W tym przewodniku znajdziesz czynności, które należy wykonać, aby platformy SSP mogły przeprowadzić integrację z i testowanie ich za pomocą Display &Video 360 Usługa Video 360 i Google Ads lub dowolne uczestniczących w programie dostawców technologii reklamowych.

Informacje ogólne

Zanim zapoznasz się z interfejsem Topics API, w przewodniku dla programistów Topics API w Chrome. Od października 2023 r. Chrome wymaga rejestracji użytkowników wywołujących aplikacje APis z Piaskownicy prywatności, w tym z interfejsem Topics. Więcej informacji i najnowsze aktualizacje znajdziesz na stronie Stan interfejsu Topic API w Chrome. i Najnowsze aktualizacje interfejsu Topics API.

Metody uzyskiwania dostępu do tematów

Oto podsumowanie najczęstszych metod uzyskiwania dostępu do Topics. Jeśli te metody nie działają w Twojej konfiguracji, DV360 zachęca do skontaktowania się z zespołem Chrome, korzystając z sugerowanych kanałów opisanych na stronie stanu interfejsu Topic API w Chrome.

Implementacja bezpośrednia

Platformy SSP mogą wysyłać żądania tematów do tematów na stronach partnerów wydawców za pomocą JavaScriptu (dokumentacja) lub nagłówki (dokumentacja).

Korzystanie z modułu wstępnego ustalania stawek

Platformy SSP, które uczestniczą w Prebid, mogą odwoływać się do parametru Dokumentacja przed ustaleniem stawki aby dowiedzieć się, jak otrzymywać Topics API za pomocą w module topicsFpdModule. Wydawcy muszą uwzględnić ten moduł w ostatecznym pakiecie przed ustaleniem stawki, DV360 zachęca do kontaktu ze swoimi wydawcami, aby uwzględnić ten wymóg.

Korzystanie z Prebid w wersji 8.9.0 lub nowszej

Prebid w ramach Prebid 8.9.0 i nowszych modułów udostępnia nową funkcję które umożliwiają wywoływanie tematów w wychodzących pytaniach o stawkę [informacje o wersji]. Dokumentacja dotycząca wstępnego określania stawek wskazuje, jak uwzględnić tematy Obserwuj-przeglądanie w odpowiedzi serwera. Tematy są dostępne w sekcji „Sec-Browsing-Topics” nagłówek z żądania fetch(). Może być konieczne przeniesienie tematów z nagłówka przez platformy SSP na pytanie o stawkę przed wysłaniem do DV360. Ponieważ wydawcy muszą mieć wdrożony podstawowy pakiet 8.9.0 lub nowszy pod kątem dostępności tej funkcji, , by sprawdzić, czy partnerzy wydawców o tym wiedzą.

Korzystanie z Otwartego ustalania stawek

platformy SSP, które uczestniczą w Otwartym ustalaniu stawek; możesz zapoznać się z dokumentacją Authorized Buyer. aby otrzymywać od Google tematy w pytaniach o stawkę za pomocą protokołu OpenRTB.

Przekazywanie tematów do DV360 i Google Ads

W poprzedniej sekcji przedstawiliśmy opcje uzyskiwania dostępu do Topics. Po uzyskaniu dostępu do tematów możesz udostępniać je w z kupującymi na DSP. Tematy w tej sekcji: jak je przekazywać do DV360 i Google Ads. DV360 i Google Ads wymagają, aby Topics: w obiekcie user.data w obiekcie OpenRTBRequest. Dowiedz się, jak przekazywać identyfikatory segmentów w taksonomiach konkretnych dostawców za pomocą kodu JSON

Przykład

Odpowiedź interfejsu Chrome Topics API zwrócona przez interfejs document.browsingTopics():

[
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 351
  },
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 163
  },
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 59
  }
]

Plik JSON (OpenRTBRequest):

{
  ...
  "user": {
    "data": [
      {
        "ext": {
          "segtax": 601,
          "segclass": "classifier_v1"
        },
        "segment": [
          { "id": "351" },
          { "id": "163" },
          { "id": "59" }
        ]
      }
    ]
  }
}

W poprzednim przykładzie funkcja taxonomy_version oznacza, że taksonomia_v2 mapowanie i zgody na określone zastosowania ich danych. Ze względu na taksonomię identyfikatory tematów odpowiadają następującym Tematy:

Identyfikator tematu Wartość tematu
351 /Sztuka i Rozrywka/komiksy i Animacja
163 /Finanse/Ubezpieczenia/Ubezpieczenia turystyczne
59 /Samochody i Pojazdy/Pojazdy kolekcjonerskie