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

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

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ą.
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

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 tak, aby obsługiwać zewnętrzne pakiety SDK do wyświetlania reklam, 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ą służyć do uzupełniania informacji kontekstowych związanych z aplikacją, która chce wyświetlić reklamę. Można je też łączyć, aby wybrać odpowiednią reklamę dla użytkownika.

W kontekście interfejsu Topics API kupujący i reklamodawcy zależą od stron sprzedających. Strony sprzedawców mają szeroką obecność w aplikacjach wydawcy i obserwują tematy użytkowników, a potem udostępniają je kupującym, aby pomóc im w wybieraniu trafniejszych reklam. Aby otrzymywać tematy, aplikacje i pakiety SDK po stronie sprzedawcy muszą stworzyć ślad, będąc obserwatorem interfejsu Topics API przez co najmniej 1 epochę.

Przykłady kodu, które pokazują, jak skonfigurować możliwość pobierania tematów do reklam opartych na zainteresowaniach, znajdziesz w przewodniku po interfejsie Topics API.

Integracja z tematami według typu działalności

Włącz reklamy oparte na zainteresowaniach (IBA) za pomocą interfejsu Topics API. Aby zintegrować interfejs Topics API i przygotować się do jego uruchomienia, wykonaj czynności odpowiednie do typu Twojej firmy zajmującej się technologiami reklamowymi.

Dla wszystkich dostawców technologii reklamowych

Dla dostawców technologii reklamowych po stronie sprzedawcy

  • Aby tworzyć ślad interfejsu Topics API, użyj funkcji obserwatora. Interfejs Topics API udostępnia nowy sygnał, więc aby zacząć wywoływać ten interfejs API, musisz zaktualizować pakiet SDK. Aby konsekwentnie pobierać tematy, pakiet SDK musi wywoływać interfejs API z aplikacji wydawcy co najmniej raz na erę. Wygenerowanie maksymalnej liczby tematów (3 tematy) do wysłania z żądaniami reklam zajmuje do 4 epoch.
  • W żądaniach reklamy uwzględnij informacje z interfejsu Topics API. Zacznij udostępniać dane z interfejsu Topics API partnerom po stronie zakupu w przypadku każdego żądania reklamy. Interfejs Topics API ma uzupełniać inne sygnały (np. sygnały kontekstowe), aby pomagać w wybieraniu odpowiedniej reklamy dla danego użytkownika.
  • Współpracuj nad protokołem udostępniania tematów partnerom po stronie kupującego. Interfejs Topics API wymaga, aby każdy SDK współpracował z partnerami na dalszych etapach, aby uzgodnić sposób udostępniania danych z interfejsu Topics API.

Dla dostawców technologii reklamowych 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 po stronie sprzedawcy muszą wywoływać interfejs Topics API co najmniej raz na erę.
  • Współpracuj nad protokołem odbierania tematów od partnerów po stronie sprzedawcy. Topics to nowy sygnał, który będzie udostępniany przez partnerów po stronie sprzedawcy w ramach żądania reklamy. Użytkownicy po stronie kupującego muszą współpracować ze swoimi partnerami w dółnym łańcuchu dostawy, aby ustalić sposób udostępniania tematów.
  • uwzględniać tematy w modelach określania stawek i optymalizacji; Interfejs Topics API ma uzupełniać inne sygnały, np. kontekstowe, aby pomagać w wybieraniu odpowiednich reklam dla danego użytkownika.

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 funkcja Topics używa nazw aplikacji i pakietów, aby przypisywać aplikacjom interesujące tematy. W przyszłości może to obejmować też inne informacje, np. opis aplikacji.

Klasyfikator tematów

Tematy zainteresowań pochodzą z modelu klasyfikatora, który jest trenowany na podstawie publicznie dostępnych informacji o aplikacji.

  • Gdy model klasyfikatora jest używany do wnioskowania w celu obliczenia 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 oznaczone przez algorytmy 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 treści 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 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. Taksonomia jest publicznie dostępna 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, więc 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 dotyczące Androida w praktyce

Załóżmy, że użytkownik ma na urządzeniu zainstalowane 7 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 wygląda tak:

Aplikacja Klasyfikacja tematów 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
F 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 danej epoce.

Najpopularniejsze tematy Osoby dzwoniące, które mogą dowiedzieć się więcej na dany temat
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 2. tygodniu, jeśli użytkownik wywoła interfejs API z dowolnej aplikacji, zwrócona lista tematów będzie zawierać tylko te tematy, w przypadku których użytkownik znajduje się w kolumnie „Callers that can learn about the topic” (Użytkownicy, którzy mogą dowiedzieć się o danym temacie) w przypadku danego tematu w danej aplikacji w danej epoce.

  • Okno historyczne uwzględniane w obliczeniach tematów dostępnych dla każdego wywołującego to 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 reklam, które wywołują interfejs Topics API, tematy powiązane z tą aplikacją nie są uwzględniane w zbiorze tematów dostępnych dla pakietów SDK reklam.
  • 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 o szczegóły dotyczące implementacji.

Jeśli aplikacja nie jest używana wystarczająco często, aby platforma mogła wywnioskować 5 tematów, może ona rozważyć opcje takie jak losowe generowanie pozostałych tematów.

Szyfrowanie zwracanych tematów

Zarejestrowane platformy technologiczne reklam, które wywołują interfejs Topics API, muszą też udostępnić klucze szyfrowania, aby zapewnić, że zwrócone tematy będą czytelne tylko dla wywołującego.

Piaskownica prywatności pobiera te klucze z punktu końcowego udostępnionego przez dostawcę technologii reklamowych . 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, które muszą podjąć obecne i nowo zarejestrowane firmy technologiczne zajmujące się reklamami, znajdziesz w przewodniku dotyczącym 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.