Omówienie interfejsu Topics API for Mobile

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Dowiedz się więcej o interfejsie Topics API na Androida i o sposobach jego implementacji. Możesz też od razu przejść do tematów wdrażania.

Jak działa interfejs Topics API

Interfejs Topics API może służyć do obserwowania tematów, które wydają się interesować użytkownika, i dostępu do nich na podstawie jego aktywności. Interfejs Topics API może następnie udostępniać wywołującym go podmiotom (np. platformom reklamowym) tematy interesujące użytkownika, ale bez ujawniania dodatkowych informacji o jego aktywności.

Kluczowych pojęć

• Temat to interesujący użytkownika temat, który jest zrozumiały dla człowieka i należy do taksonomii tematów.
• Wywołujący to element, np. aplikacja, zewnętrzny pakiet SDK, witryna lub usługa, który wysyła żądanie do interfejsu Topics API w celu obserwowania zainteresowań użytkownika lub uzyskania do nich dostępu.
• Temat jest obserwowany przez wywołującego, jeśli w ciągu ostatnich 3 okresów obserwacji wywołujący wysłał żądanie do interfejsu Topics API z powiązanej z tym tematem strony internetowej lub aplikacji.
• Epoka to okres obliczania tematu, który domyślnie wynosi tydzień.
• Taksonomia to hierarchiczna lista kategorii, która obejmuje m.in. takie kategorie jak /Arts & Entertainment/Music & Audio/Soul & R&B i /Business & Industrial/Business Services/Corporate Events.
• Tematy są wyodrębniane za pomocą modelu klasyfikatora, który przypisuje aktywność użytkownika do 0 lub więcej tematów.

Podstawowe kroki w ramach interfejsu Topics API

Cykl życia interfejsu Topics API składa się z 3 głównych kroków:

• Obserwuj aktywność użytkowników, np. gdy otwierają stronę internetową https://cats.example/tabby/index.html lub pobierają aplikację cats.
• Wyodrębnianie tematów na podstawie aktywności użytkownika, np. /Pets & Animals/Pets/Cats.
• Dostęp do tematów, które zostały wcześniej zaobserwowane u użytkownika, np. jako sygnał do wyboru odpowiednich reklam (np. promocji karmy dla kotów).

Obserwowanie tematów

Osoby dzwoniące mogą uzyskać dostęp tylko do tematów, które obserwowały. Wywołujący obserwuje temat, gdy wysyła żądanie do interfejsu Topics API z kontekstu powiązanego z tym tematem. Aby zilustrować tę koncepcję, rozważ ten uproszczony przykład.

• Załóżmy, że są 2 programy wywołujące interfejs Topics API: A i B.
• Istnieją 2 konteksty:
  • Greenhouse, np. aplikacja o nazwie Greenhouse lub witryna greenhouse.example powiązana z tematem Home & Garden.
  • Ćwiczenia tenisowe, np. aplikacja o nazwie „Ćwiczenia tenisowe” lub witryna tennis.example powiązana z tematem Sports/Tennis.
• Zarówno rozmówca A, jak i B są obecni w kontekście Greenhouse.
• W kontekście ćwiczeń tenisowych występuje tylko rozmówca B.
• Dla uproszczenia przyjmijmy, że przed okresem 1 nie zaobserwowano żadnych tematów dotyczących tego użytkownika.
• Użytkownik otwiera aplikację Greenhouse, a wywołujące funkcje A i B wywołują interfejs Topics API, aby zarejestrować wizytę użytkownika na stronie lub w aplikacji (aby dowiedzieć się, jak wywołać interfejs Topics API, zapoznaj się z przewodnikiem implementacji w sekcji Następne kroki). Ten rekord (nazwa hosta lub dane aplikacji) jest później używany do określania tematów, które Cię interesują. Interfejs Topics API później oznaczy temat Home & Garden jako obserwowany przez obie wywołujące go strony A i B.
• Użytkownik otwiera aplikację Ćwiczenia tenisowe. Tylko wywołujący B wysyła żądanie do interfejsu Topics API. Interfejs Topics API później oznaczy temat Sports/Tennis jako obserwowany przez wywołującego B.
• Pod koniec epoki interfejs Topics API odświeża listę najpopularniejszych tematów użytkownika i określa wywołania, które zaobserwowały te tematy na podstawie aktywności użytkownika.
• Później, gdy wywołujący B wykona kolejne wywołanie interfejsu Topics API, może otrzymać temat Home & Garden lub Sports/Tennis (lub z 5% prawdopodobieństwo losowy temat) dla tego użytkownika w tablicy odpowiedzi.
• Użytkownik A ma dostęp tylko do tematu Home & Garden, ponieważ nigdy nie obserwował tematu Sports/Tennis. Oznacza to, że usługa zewnętrzna będzie wiedzieć o tematach zainteresowań użytkownika tylko w określonym kontekście (aplikacji lub witryny), w którym się one pojawiają.

Wyodrębnianie tematów

Na podstawie aktywności użytkownika funkcja Topics określa tematy, które go interesują. Tematy są wybierane z wstępnie zdefiniowanej taksonomii dostępnej na licencji open source. Raz na epokę Topics odświeża 5 najpopularniejszych tematów użytkownika oraz wywołania, które je obserwowały w trakcie tej ery. Model klasyfikatora tematów wywodzi tematy z aktywności użytkowników: nazwy hosta w przypadku wizyty na stronie internetowej oraz informacje o aplikacji na Androidzie.

Osoba dzwoniąca ma dostęp do tematów zainteresowań użytkownika

Interfejs API zwraca tylko tematy, które zostały zaobserwowane przez wywołującego w ciągu ostatnich 3 okresów. Do wywołującego mogą zostać zwrócone maksymalnie 3 tematy: po jednym temacie z każdej z 3 ostatnich epok (jeśli wywołujący obserwował tematy w tej epoce). Zwrócone tematy mogą być używane przez wywołującego do uzupełnienia informacji kontekstowych i mogą być łączone, aby znaleźć bardziej odpowiednią reklamę dla użytkownika.

Epochs

Interfejs Topics API musi zapewniać aktualność tematów zainteresowań. Tematy są określane na podstawie aktywności użytkownika w okresie zwanym „epoką”, który domyślnie wynosi 1 tydzień. Każdy użytkownik ma swoje własne epoki (epoki są „na użytkownika”), a czas początkowy jest losowy.

W każdej epoce interfejs Topics API oblicza 5 najpopularniejszych tematów użytkownika i określa, którzy wywołujący je odnotowali, korzystając z informacji na urządzeniu. Temat na potrzeby każdej epoki jest losowo wybierany spośród 5 najpopularniejszych tematów użytkownika w danym okresie. Aby jeszcze bardziej zwiększyć ochronę prywatności i zapewnić, że wszystkie tematy będą reprezentowane, istnieje 5% szansa, że temat zostanie wybrany losowo spośród wszystkich możliwych tematów w taksonomii zainteresowań.

Tematy dotyczące Androida w praktyce

Interfejs Topics API na Androida został zaprojektowany z myślą o obsłudze pakietów SDK do wyświetlania reklam innych firm, które zwykle działają w wielu aplikacjach. Topics udostępnia wywołującym tematy reklamowe o wysokiej szczegółowości na podstawie korzystania przez użytkownika z aplikacji, bez korzystania z identyfikatorów międzyaplikacyjnych. Tematy te mogą być uzupełnieniem wszelkich informacji kontekstowych związanych z aplikacją, w której ma się wyświetlać reklama. Można je łączyć, aby ułatwić wybranie reklamy odpowiedniej dla użytkownika.

W kontekście interfejsu Topics API kupujący i reklamodawcy zależą od strony sprzedającej. To strona sprzedawcy jest często obecna w aplikacjach wydawcy i przygląda się tematom użytkowników, a następnie udostępnia je kupującym, by pomóc im wybrać trafniejsze reklamy. Aby otrzymywać tematy, aplikacje dla sprzedawców i pakiety SDK muszą mieć ślady, będąc obserwatorem interfejsu Topics API przez co najmniej 1 epokę.

Zapoznaj się z przewodnikiem po implementacji interfejsu Topics API. ).

Integracja tematów według typu działalności

Włącz reklamy oparte na zainteresowaniach (reklamy oparte na zainteresowaniach) za pomocą interfejsu Topics API. Postępuj zgodnie z instrukcjami zależnie od rodzaju działalności, w której prowadzisz technologie reklamowe, aby zintegrować interfejs Topics API i przygotować się do wprowadzenia kampanii.

Dla wszystkich technologii reklamowych

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

Technologie reklamowe dla Sprzedawców

• Zostań obserwatorem, aby ustalić zasięg interfejsu Topics API. Interfejs Topics API dostarcza nowy sygnał, więc aby zacząć go wywoływać, musisz zaktualizować pakiet SDK. Aby konsekwentnie pobierać tematy, pakiet SDK musi wywoływać interfejs API z aplikacji wydawcy co najmniej raz na erę. Aby uzyskać maksymalną liczbę tematów (3 tematów), które można wysłać wraz z żądaniami reklamy, potrzeba maksymalnie 4 epoków.
• W żądaniach reklamy uwzględnij informacje z interfejsu Topics API. Zacznij udostępniać dane interfejsu Topics API partnerom po stronie zakupu w przypadku każdego żądania reklamy. Interfejs Topics API planuje uzupełnienie innych sygnałów (np. sygnałów kontekstowych), aby ułatwić znalezienie odpowiedniej 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 współpracował z partnerami podrzędnymi, aby uzgodnić sposób udostępniania danych interfejsu Topics API.

Technologie reklamowe po stronie kupującego

• Skontaktuj się z partnerami po stronie sprzedawcy, aby potwierdzić ich plany dotyczące obserwowania tematów i ustalania śladu. Aby otrzymywać tematy, dostawcy usług dla sprzedawców muszą wywoływać interfejs Topics API co najmniej raz w każdej epoce.
• Współpracuj nad protokołem do otrzymywania tematów od partnerów SSP. Topics to nowy sygnał, który będzie udostępniany przez partnerów po stronie sprzedawcy w ramach żądania reklamy. Klienci po stronie kupującego będą musieli współpracować ze swoimi partnerami nadrzędnymi w kwestii sposobu udostępniania tematów.
• uwzględniać tematy w modelach określania stawek i optymalizacji; Interfejs Topics API ma uzupełniać inne sygnały, np. sygnały kontekstowe, aby pomagać użytkownikowi w znalezieniu odpowiedniej reklamy.

Jak interfejs API wykrywa tematy aplikacji

Na Androidzie interfejs Topics API określa tematy aplikacji na podstawie informacji o niej, korzystając z modelu klasyfikatora. W obecnej implementacji interfejs Topics API używa nazw aplikacji i pakietów do przypisywania aplikacji interesujących Cię tematów. Później można to rozszerzyć, aby uwzględnić inne informacje, np. opis aplikacji.

Klasyfikator tematów

Tematy zainteresowań pochodzą z modelu klasyfikatora trenowanego na podstawie publicznie dostępnych informacji o aplikacji.

• Gdy model klasyfikatora jest używany do wnioskowania do obliczania tematów w danej epoce, zestaw użytych sygnałów pozostaje na urządzeniu. Ten zestaw sygnałów może obejmować zainstalowane lub ostatnio używane aplikacje. Może on zostać później rozszerzony o inne sygnały.
• Model V5 został przeszkolony przez Google na podstawie 540 tys. publicznie dostępnych informacji o aplikacjach z sklepów z aplikacjami, takich jak Sklep Google Play, które zostały opatrzone etykietami przez ludzi, oraz 17 mln publicznie dostępnych informacji o aplikacjach, które zostały opatrzone etykietami przez systemy AI. Model wykorzystuje nazwy aplikacji i nazwy pakietów jako sygnały wejściowe. Jest on bezpłatnie dostępny dla deweloperów aplikacji, którzy mogą go testować i sprawdzać, do jakich tematów klasyfikuje ich aplikacja.
• Aplikacja może być przypisana do więcej niż 1 treści, do żadnej lub nie być dodana do historii tematów użytkownika. Jeśli aplikacja jest powiązana z większą liczbą tematów w taksonomii, liczba wybranych dla niej tematów zostanie ograniczona do 3 najpopularniejszych.

Aby lepiej zrozumieć działanie modelu klasyfikatora, możesz przetestować, jak różne dane aplikacji wpływają na klasyfikację, korzystając z klasyfikatora tematów Androida w Colab.

Taksonomia

Tematy są wybierane z wstępnie zdefiniowanej taksonomii open source. Mapa kategorii jest dostępna publicznie i może ulec zmianie. Sugerować zmiany możesz za pomocą przycisku opinii u góry tej strony. Ta taksonomia jest tworzona przez ludzi, aby wrażliwe tematy nie były uwzględniane w taksonomii. Będzie on dostosowany do kategorii reklam, które mogą być wyświetlane w aplikacjach mobilnych na urządzeniach z Androidem.

Tematy dotyczące Androida w praktyce

Załóżmy, że użytkownik ma na urządzeniu 7 zainstalowanych aplikacji: A, B, C, D, E, F i G. Załóżmy, że klasyfikacja tematów aplikacji i pakietów SDK technologii reklamowych w tych aplikacjach jest taka:

Koniec pierwszego tygodnia: interfejs Topics API generuje 5 najpopularniejszych tematów użytkownika w danej epoce.

W 2. tygodniu, jeśli użytkownik dowolnej aplikacji wywoła interfejs API, zwrócona lista tematów będzie zawierać tylko te tematy, w przypadku których użytkownik znajduje się w kolumnie „Użytkownicy, którzy mogą dowiedzieć się więcej o danym temacie” w przypadku tego tematu w danej aplikacji w danej epoce.

• Okno historii uwzględniane przy obliczaniu tematów dostępnych dla każdego wywołującego to 3 epoki (lub 3 tygodnie).
• Używane są tylko tematy powiązane z aplikacjami, które wywołują interfejs Topics API za pomocą pakietów SDK reklam. Oznacza to, że jeśli aplikacja nie zawiera żadnych pakietów SDK reklam, które wywołują interfejs Topics API, tematy powiązane z tą aplikacją nie będą uwzględniane w puli tematów, do których te pakiety mogą uzyskać dostęp.
• Aplikacja może też deklaratywnie zrezygnować z interfejsu Topics API. Tematy powiązane z aplikacją, która została wyłączona, nie będą uwzględniane w cotygodniowym obliczeniu tematów. Ten dokument zostanie zaktualizowany, aby uwzględnić powiązane szczegóły implementacji.

Jeśli wykorzystanie aplikacji nie jest wystarczające, aby platforma mogła określić 5 tematów, platforma może rozważyć inne opcje, takie jak losowe generowanie pozostałych tematów.

Szyfrowanie zwróconych tematów

Zarejestrowane platformy technologii reklamowych, które wywołują interfejs Topics API, muszą też przekazywać kluczy szyfrowania, aby zapewnić, że zwrócone tematy będą dostępne do odczytu tylko .

Piaskownica prywatności pobiera te klucze z punktu końcowego udostępnionego przez firmę zajmującą się technologiami reklamowymi. Zalecamy regularne aktualizowanie kluczy, ale nie rzadziej niż co 6 miesięcy.

Piaskownica prywatności poprosi dostawców technologii reklamowych o potwierdzenie dostępności udostępnionego przez nich punktu końcowego podczas procesu rejestracji. Więcej informacji o działaniach wymaganych od obecnych i nowych zarejestrowanych dostawców technologii reklamowych znajdziesz w przewodniku dotyczącym rejestracji.

Dalsze kroki

See also

Check out our resources to better understand the Topics API on Android.

• Check out Topics sample apps, collab and walkthrough videos.
• See how users and developers can control the API.
• Check out the support resources to ask questions, engage and share feedback.