Topics API: przewodnik po integracji

Interfejs Topics API na Androida został zaprojektowany do obsługi reklam opartych na zainteresowaniach bez korzystania z identyfikatorów w różnych aplikacjach.

Reklamodawcy starają się wyświetlać trafne reklamy związane z zainteresowaniami użytkowników. Jeśli np. użytkownik jest zainteresowany informacjami o gotowaniu, reklamy związane z gotowaniem mogą być dla niego bardziej trafne niż reklamy niezwiązane z jego zainteresowaniami.

Reklamy oparte na zainteresowaniach to forma reklam spersonalizowanych, w których reklamy są wybierane na podstawie zainteresowań użytkownika. Dzięki Piaskownicy prywatności na Androida zainteresowania te są określane na podstawie aplikacji, z których użytkownik korzystał. Różni się to od reklam kontekstowych, które opierają się wyłącznie na zainteresowaniach powiązanych z aktualnie oglądanymi treściami. Reklamy oparte na zainteresowaniach umożliwiają wyświetlanie w aplikacjach reklam, które są trafniejsze i atrakcyjniejsze niż reklamy kontekstowe.

Reklamy oparte na zainteresowaniach zazwyczaj obejmują komunikację między aplikacjami, sprzedawcami i kupującymi. Ten przewodnik jest przeznaczony dla wszystkich tych podmiotów, w tym sieci i technologii reklamowych, które działają zarówno jako kupujący, jak i sprzedawca.

Interfejs Topics API określa przybliżone sygnały o zainteresowaniach na urządzeniu na podstawie tego, jak użytkownik korzysta z aplikacji. Sygnały te, nazywane tematami, są udostępniane reklamodawcom, aby umożliwić obsługę reklam opartych na zainteresowaniach bez konieczności śledzenia poszczególnych użytkowników w różnych aplikacjach.

W przypadku wdrażania reklam opartych na zainteresowaniach za pomocą interfejsu Topics API należy wziąć pod uwagę ważne kwestie ogólne:

  • Na urządzeniu przetwarzane są dane dotyczące zainteresowań użytkownika: informacje o tym, jakie aplikacje są na nim zainstalowane, nie opuszczają urządzenia, a prywatność jest chroniona. Odnosi się to do powszechnie używanego modelu wysyłania i przetwarzania danych użytkownika z różnych aplikacji poza urządzeniem, na serwerach technologii reklamowych. Niektóre rodzaje przetwarzania danych nadal będą przechowywane na serwerach technologii reklamowych, np. wykorzystywanie sygnałów dostarczanych przez interfejs Topics API na potrzeby modeli personalizacji i optymalizacji wyboru reklam.

  • Kupujący i reklamodawcy polegają na stronie sprzedawcy: aby uzyskiwać tematy, aplikacje i pakiety SDK przeznaczone dla sprzedawców muszą mieć określony zasięg, będąc obserwatorem interfejsu Topics API przez co najmniej 1 epokę.

Terminologia

  • Reklamodawca: firma, która wchodzi w interakcję z użytkownikami za pomocą kupowania zasobów reklamowych.
  • Wydawca: firma sprzedająca zasoby reklamowe dostępne obok swoich treści.
  • Kupujący (lub po stronie kupującego): firma z branży technologii reklamowych, która ułatwia reklamodawcom kupowanie zasobów reklamowych.
  • Sprzedawca: firma z branży technologii reklamowych, która ułatwia wydawcom sprzedaż zasobów reklamowych.
  • Sieć: firma z branży technologii reklamowych, która pełni zarówno funkcję kupującego, jak i sprzedawcy.
  • Posiadane i obsługiwane: firma, która jest wydawcą, sprzedawcą i kupującym.

Gole

Jeśli reklamy oparte na zainteresowaniach są istotne dla Twojej firmy, musisz mieć wersję interfejsu Topics API działającą w kontekście zastosowań Twojej aplikacji. Pozwoli nam to uzyskać Twoją opinię i ułatwić Ci kształtowanie interfejsu API. Chcemy umożliwić Ci odblokowywanie projektów i procesów programistycznych, by mieć dostęp do tematów, gdy wprowadzimy wersję beta.

Obecnie planowanie integracji z Piaskownicą prywatności w wersji przedpremierowej na Androida dla programistów obejmuje możliwość:

Dla wszystkich technologii reklamowych

  • Przejrzyj taksonomię tematów i prześlij opinię na temat uwzględnionych tematów.
  • Eksperymentuj z przykładowymi aplikacjami za pomocą interfejsu Topics API, aby zobaczyć, jakie dane dotyczące tematów są zwracane przez klasyfikator na urządzeniu.
  • Zaktualizuj przepływy aplikacji i pakietu SDK, aby zacząć wywoływać interfejs Topics API.
  • Aby zacząć wysyłać tematy w żądaniach reklamy, zaktualizuj protokoły.
  • Zarejestruj swoje technologie reklamowe w Piaskownicy prywatności.

Dla technologii reklamowych sprzedawanych po stronie sprzedaży

  • Zostań obserwatorem, aby wdrożyć interfejs Topics API. Topics API to nowy sygnał, dlatego aby zacząć go wywoływać, musisz zaktualizować pakiet SDK. Aby spójnie pobierać tematy, aplikacje muszą wywoływać interfejs API co najmniej raz na okres. Uzyskanie maksymalnej liczby tematów (3 tematy) do wysłania w żądaniach reklamy może potrwać do 4 epoek.
  • Uwzględnij w żądaniach reklamy informacje z interfejsu Topics API. W przypadku każdego żądania reklamy zacznij udostępniać dane interfejsu Topics API partnerom po stronie zakupu. Interfejs Topics API uzupełnia inne sygnały (np. sygnały kontekstowe), aby pomóc w wyborze reklamy dla danego użytkownika.
  • Współpracuj nad protokołem udostępniania tematów partnerom po stronie zakupu. Interfejs Topics API wymaga, aby każdy pakiet SDK działał z partnerami odbierającymi przychody w celu uzgodnienia sposobu udostępniania danych interfejsu Topics API.

Technologie reklamowe po stronie kupującego

  • Skontaktuj się z partnerami w zakresie sprzedaży, aby potwierdzić, że chcą obserwować tematy i poszerzać zasięg kampanii. Aby otrzymywać tematy, dostawcy usług sprzedaży muszą wywoływać interfejs Topics API co najmniej raz na okres.
  • Nawiąż współpracę nad protokołem odbioru tematów od partnerów. Topics to nowy sygnał, który będzie udostępniany przez partnerów po stronie sprzedaży w ramach żądania reklamy. Konsumenci po stronie kupującego muszą dopilnować, aby współpracowali ze swoimi partnerami w zakresie udostępniania tematów.
  • Uwzględnienie tematów w modelach określania stawek i modelach optymalizacji. Interfejs Topics API ma uzupełniać inne sygnały, np. kontekstowe, aby pomagać w znajdowaniu reklam odpowiednich dla użytkownika.

Wymagania wstępne i konfiguracja

Deweloperzy aplikacji, sprzedawcy i kupujący powinni wykonać te czynności, aby przygotować się do korzystania z interfejsu Topics API.

zapoznać się z interfejsem API,

  1. Zacznij od zapoznania się z ofertą projektowania, aby zapoznać się z interfejsem Topics API i jego możliwościami.
  2. Informacje o tym, jak uwzględnić kod i wywołania interfejsu API, których potrzebujesz w swoich zastosowaniach, znajdziesz w przewodniku dla programistów.
  3. Przejrzyj mapę kategorii i określ, jakie tematy znajdują się na liście.
  4. Prześlij opinię dotyczącą propozycji projektu lub dokumentacji.
  5. Zarejestruj się, aby otrzymywać najnowsze informacje o interfejsie Topics API Dzięki temu będziesz na bieżąco z nowymi funkcjami, które zostaną wprowadzone w kolejnych wersjach.

Konfigurowanie i testowanie przykładowej aplikacji

  1. Postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować Piaskownicę prywatności za pomocą pakietu SDK do Androida w Android Studio.
  2. Aby zapoznać się z pobieraniem tematów na urządzenie, utwórz rozwidlenie i uruchom kod w wersji Java lub Kotlin przykładowej aplikacji.
  3. Podczas testowania eksperymentuj z informacjami o aplikacji dotyczącymi nazwy i opisu, aby zmienić tematy, które będą zwracane przez klasyfikator na urządzeniu.
  4. Gdy zapoznasz się już z interfejsem API klienta i klasyfikacją na urządzeniu, skorzystaj z przykładowej aplikacji jako przykładu, aby pokierować własną integracją.

Wskazówka: dokładnie zapoznaj się z przydatnością danych dotyczących tematów zwracanych dla Twojej aplikacji. Zastanów się, jak można ulepszyć klasyfikację lub taksonomię, i prześlij opinię, jeśli masz jakieś sugestie dotyczące ulepszenia taksonomii.