Interfejs Topics API na urządzenia mobilne: omówienie

Dowiedz się więcej o interfejsie Topics API na Androidzie i o krokach związanych z jego wdrażaniem. Możesz też od razu przejść do wdrażania tematów.

Jak działa interfejs Topics API

Interfejsu Topics API można używać do obserwowania tematów, które mogą zainteresować 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 zainteresowań 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 podmiot, 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 wygenerował on żądanie do interfejsu Topics API z witryny lub aplikacji powiązanej z tym tematem.
  • Epoka to okres obliczania tematu, który domyślnie wynosi tydzień.
  • Taksonomia to hierarchiczna lista kategorii, która zawiera na przykład takie kategorie jak /Arts & Entertainment/Music & Audio/Soul & R&B i /Business & Industrial/Business Services/Corporate Events.
  • Tematy są wywnioskowane za pomocą modelu klasyfikatora, który przypisuje aktywność użytkownika do 0 lub więcej tematów.

Podstawowe kroki w interfejsie 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 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 dzwoniąca osoba A, jak i B są obecne 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 wywołania 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 najważniejsze tematy 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% szanse temat losowy) 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 strona trzecia dowie się o temacie zainteresowania użytkownika tylko w określonym kontekście (aplikacji lub witryny), w którym się on znajduje.
Diagram pokazujący, że interfejs Topics API oznacza tematy jako obserwowane tylko wtedy, gdy wywołujący ma obecność w kontekście.
Interfejs Topics API oznacza tematy obserwowane tylko przez wywołujących, którzy mają obecność w kontekście tych tematów. Osoby dzwoniące będą mieć dostęp tylko do tematów, które obserwowały.

Wyodrębnianie tematów

Topics określa interesujące tematy na podstawie aktywności użytkownika. 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łujących je żądań. Model klasyfikatora Tematy wywodzi tematy z aktywności użytkowników: nazwy hosta w przypadku wizyty w witrynie 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 były obserwowane przez wywołującego w ciągu ostatnich 3 okresów. Do wywołującego można zwrócić maksymalnie 3 tematy: po jednym temacie z każdej z 3 ostatnich epok (jeśli wywołujący obserwował tematy w danej 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 dbać o to, aby tematy zainteresowań były aktualne. Tematy są określane na podstawie aktywności użytkownika w okresie zwanym „epoką”, który domyślnie wynosi tydzień. Każdy użytkownik ma swoje 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 użytkownicy obserwowali te tematy, 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 na Androidzie w praktyce

Interfejs Topics API na Androidzie został zaprojektowany tak, aby obsługiwać pakiety SDK do wyświetlania reklam innych firm, które zwykle działają w wielu aplikacjach. Interfejs Topics udostępnia wywołującym go podmiotom przybliżone tematy reklamowe, które mogą zainteresować użytkownika, na podstawie jego aktywności w aplikacjach. Nie korzysta przy tym z identyfikatorów aplikacji. Tematy te mogą uzupełniać informacje kontekstowe związane z aplikacją, która chce wyświetlać reklamę, i można je łączyć, aby pomóc w wybraniu odpowiedniej reklamy dla użytkownika.

W kontekście interfejsu Topics API kupujący i reklamodawcy są zależni od sprzedaży. To po stronie sprzedawcy występuje szeroka obecność w aplikacjach wydawcy i obserwuje on tematy, które interesują użytkowników. Następnie udostępnia te tematy kupującym, aby pomóc im wybierać trafniejsze reklamy. Aby uzyskać tematy, aplikacje i pakiety SDK po stronie sprzedawcy muszą utworzyć profil, obserwując interfejs Topics API przez co najmniej 1 epokę.

Przykłady kodu pokazujące, jak skonfigurować możliwość pobierania tematów na potrzeby reklam opartych na zainteresowaniach, znajdziesz w przewodniku po implementacji interfejsu Topics API.

Integracja tematów według typu firmy

Włączanie reklam opartych na zainteresowaniach za pomocą interfejsu Topics API. Aby zintegrować interfejs Topics API i przygotować się do jego wdrożenia, wykonaj czynności odpowiednie dla Twojego rodzaju działalności w branży technologii reklamowych.

W przypadku wszystkich dostawców technologii reklamowych

Dla dostawców technologii reklamowych po stronie sprzedawcy

  • Zostań obserwatorem, aby utworzyć ślad interfejsu Topics API. Interfejs Topics API udostępnia nowy sygnał, więc musisz zaktualizować pakiet SDK, aby zacząć wywoływać ten interfejs. Aby stale pobierać tematy, pakiet SDK musi wywoływać interfejs API z aplikacji wydawcy co najmniej raz na epokę. Osiągnięcie maksymalnej liczby tematów (3 tematy) do wysyłania z żądaniami reklam zajmuje do 4 epok.
  • W żądaniach reklamy uwzględniaj 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 ma uzupełniać inne sygnały (np. sygnały kontekstowe), aby pomagać w znajdowaniu odpowiednich reklam dla danego użytkownika.
  • Współpracuj z partnerami po stronie kupujących nad protokołem udostępniania tematów. Interfejs Topics API wymaga, aby każdy pakiet SDK współpracował z partnerami niższego szczebla w celu uzgodnienia sposobu udostępniania danych interfejsu Topics API.

Dla dostawców technologii reklamowych po stronie kupującego

  • Skontaktuj się z partnerami po stronie sprzedaży, aby potwierdzić ich plany dotyczące obserwowania tematów i ustalenia zasięgu. Aby otrzymywać tematy, dostawcy po stronie sprzedaży muszą wywoływać interfejs Topics API co najmniej raz na epokę.
  • Współpracuj z partnerami po stronie sprzedaży nad protokołem odbierania tematów. Tematy to nowy sygnał, który będzie udostępniany przez partnerów po stronie sprzedaży w ramach żądania reklamy. Kupujący muszą współpracować z partnerami wyższego szczebla, aby ustalić, w jaki sposób będą udostępniane tematy.
  • Uwzględniaj tematy w modelach określania stawek i optymalizacji. Interfejs Topics API ma uzupełniać inne sygnały, np. kontekstowe, aby pomagać w znalezieniu odpowiedniej reklamy dla odwiedzającego.

Jak interfejs API wnioskuje o tematach aplikacji

W przypadku Androida interfejs Topics API określa tematy dla aplikacji na podstawie informacji o niej za pomocą modelu klasyfikacji. W obecnej implementacji interfejs Topics używa nazw aplikacji i pakietów do przypisywania aplikacji tematów, które mogą Cię interesować, ale w przyszłości może to zostać rozszerzone o inne informacje, takie jak opis aplikacji.

Klasyfikator tematów

Tematy zainteresowań są określane na podstawie modelu klasyfikatora, który jest trenowany na publicznie dostępnych informacjach o aplikacjach.

  • Gdy model klasyfikatora jest używany do wnioskowania w celu obliczenia tematów dla danej epoki, zestaw używanych sygnałów pozostaje na urządzeniu. Ten zestaw sygnałów może obejmować zainstalowane lub ostatnio używane aplikacje, a w przyszłości może zostać rozszerzony o inne sygnały.
  • Model V5 został wytrenowany przez Google na podstawie 540 tys. informacji o aplikacjach dostępnych publicznie w sklepach z aplikacjami, takich jak Sklep Google Play, które zostały oznaczone przez ludzi, oraz 17 mln informacji oznaczonych przez modele ML. Model wykorzystuje nazwy aplikacji i nazwy pakietów jako sygnały wejściowe. Deweloperzy mogą go bezpłatnie testować i sprawdzać, do jakich kategorii jest klasyfikowana ich aplikacja.
  • Aplikacja może być przypisana do więcej niż 1 tematu lub do żadnego tematu albo może nie być dodana do historii tematów użytkownika. Jeśli aplikacja jest powiązana z więcej niż 1 tematem w taksonomii, liczba wybranych tematów dla tej aplikacji zostanie ograniczona do 3 najważniejszych.

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

Taksonomia

Tematy są wybierane ze wstępnie zdefiniowanej taksonomii open source. Taksonomia jest dostępna publicznie i może ulec zmianie. Sugestie można przesyłać za pomocą przycisku opinii u góry tej strony. Ta taksonomia jest tworzona przez ludzi, dzięki czemu nie zawiera tematów wrażliwych. Będzie ona dostosowana do kategorii reklam, które mogą się wyświetlać w aplikacjach mobilnych na Androida.

Tematy na Androidzie w praktyce

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

Aplikacja Klasyfikacja tematyczna Pakiet SDK technologii reklamowych
A T1, T5 ad-sdk1, ad-sdk2
B T2 ad-sdk2
C T3, T6 ad-sdk3, ad-sdk4
D T1, T4 ad-sdk1
E T5 ad-sdk4, ad-sdk5
P T6 ad-sdk2, ad-sdk3, ad-sdk4
G T7 ad-sdk2

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

Najważniejszy temat Dzwoniący, którzy mogą dowiedzieć się więcej o temacie
T1 ad-sdk1, ad-sdk2
T2 ad-sdk2
T3 ad-sdk3, ad-sdk4
T4 ad-sdk1
T5 ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

W drugim tygodniu, jeśli rozmówca w dowolnej aplikacji wywoła interfejs API, zwrócona lista tematów będzie zawierać tylko te tematy, w przypadku których rozmówca znajduje się w kolumnie „Rozmówcy, którzy mogą dowiedzieć się więcej o temacie” dla danej aplikacji i danej epoki.

  • Okno historii uwzględnione w obliczeniach tematów dostępnych dla każdego dzwoniącego obejmuje 3 epoki (czyli 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 do reklam, które wywołują interfejs Topics API, tematy powiązane z tą aplikacją nie są uwzględniane w puli tematów dostępnych dla pakietów SDK do reklam.
  • Aplikacja może też deklaratywnie zrezygnować z interfejsu Topics API. Tematy powiązane z aplikacjami, które zrezygnowały z udziału w programie, nie będą uwzględniane w cotygodniowym obliczaniu tematów. Ten dokument zostanie zaktualizowany o szczegóły dotyczące implementacji.

Jeśli korzystanie z aplikacji jest niewystarczające, aby platforma mogła wywnioskować 5 tematów, może ona rozważyć opcje takie jak losowe wygenerowanie pozostałych tematów.

Szyfrowanie zwracanych tematów

Zarejestrowane platformy technologii reklamowych, które wywołują interfejs Topics API, muszą też udostępniać klucze szyfrowania, aby zwrócone tematy były czytelne tylko dla wywołującego.

Piaskownica prywatności pobierze te klucze z punktu końcowego udostępnionego przez firmę z branży technologii reklamowych . Zalecamy regularne aktualizowanie kluczy, ale nie rzadziej niż co 6 miesięcy.

W trakcie procesu rejestracji Piaskownica prywatności poprosi dostawców technologii reklamowych o potwierdzenie dostępności udostępnianego przez nich punktu końcowego. Więcej informacji o działaniach wymaganych od obecnych i nowo zarejestrowanych dostawców technologii reklamowych znajdziesz w przewodniku po rejestracji.

Dalsze kroki

Sprawdź szczegóły implementacji i przykłady kodu, które umożliwiają obserwowanie i dostęp do tematów.
Dowiedz się, jak użytkownicy i deweloperzy mogą zarządzać interfejsem Topics API i dostosowywać go do swoich potrzeb i preferencji.

Zobacz też

Zapoznaj się z naszymi materiałami, aby lepiej zrozumieć interfejs Topics API na Androida.