Testowanie, wdrażanie i skalowanie rozwiązania opartego na Topics

Na tej stronie dowiesz się, jak tworzyć, testować i skalować wdrożenie w środowisku produkcyjnym za pomocą interfejsu Topics API.

Implementacja backendu interfejsu Topics API

Implementacja backendu zależy od tego, jak chcesz używać tematów obliczonych w przeglądarce. Zalecamy, aby rozwiązania technologii reklamowych używały interfejsu Topics jako dodatkowego sygnału IBA.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Używanie interfejsu Topics jako dodatkowego sygnału

Dane o tematach mogą być traktowane jako dodatkowy sygnał dotyczący Twoich odbiorców, obok innych sygnałów, takich jak adresy URL, słowa kluczowe czy inne metadane.

Jak wyjaśniono w artykule Zwiększanie trafności reklam po wycofaniu plików cookie innych firm, istnieje kilka sposobów wykorzystania interfejsu Topics do wyświetlania trafnych reklam. Niektóre z nich obejmują wykorzystanie interfejsu Topics do tworzenia list odbiorców, a inne sugerują używanie go jako jednego z sygnałów do trenowania modeli uczenia maszynowego, które będą wykorzystywane do wyodrębniania dodatkowych zainteresowań odbiorców lub nawet do optymalizacji logiki określania stawek.

Tworzenie i wdrażanie

  1. Zbieraj tematy, obserwując użytkowników w środowisku produkcyjnym (szacowany czas wdrożenia: około tygodnia):
    • Poznaj dostępne opcje: wywoływanie interfejsu Topics API za pomocą nagłówków HTTP lub elementu iframe i JavaScriptu.
    • Określ domenę elementu iframe, który będzie wywoływać interfejs Topics API.
    • Zbuduj rozwiązanie, korzystając z wersji demonstracyjnej nagłówka lub wersji demonstracyjnej JavaScript jako odniesienia do kodu.
    • Zintegruj interfejs Topics z kodem, który wydawcy umieszczają w swoich witrynach (np. z ramką iframe reklamy). Upewnij się, że wywołujesz tematy z osadzenia.
    • Aby zacząć obserwować tematy użytkowników, umieść najnowszą wersję skryptu w swoich witrynach produkcyjnych. Zalecamy, aby najpierw przetestować wdrożenie w swoich witrynach, które mają niewielką liczbę wizyt miesięcznie. Na tym etapie zalecamy wdrożenie nowego rozwiązania opartego na tematach w co najmniej 5 witrynach.
    • W tym momencie interfejs API powinien zwrócić pustą tablicę jako wynik. Dzieje się tak, ponieważ nie zaobserwowano jeszcze żadnych tematów, które interesują użytkownika. Może minąć do 3 tygodni, zanim zaczniesz otrzymywać tematy użytkowników.
    • Przeprowadź testy funkcjonalne i walidację. Rozwiązanie możesz przetestować ręcznie lub automatycznie. Na przykład:
      • Otwórz przeglądarkę z flagami i ustaw epokę na 15 sekund, aby przeglądarka szybciej przeliczała tematy.
      • Odwiedź witryny, w których umieszczony jest Twój skrypt.
      • Sprawdź, czy skrypt obserwuje tematy w przypadku domeny chrome://topics-internals/.
      • Sprawdź, jakich wyników możesz się spodziewać.
  2. Używaj danych interfejsu Topics razem z innymi sygnałami kontekstowymi (np. adresami URL, metadanymi itp.). (szacowany czas: około 3 dni).
    • Po 3 tygodniach od wdrożenia skrypt powinien już obserwować tematy niektórych użytkowników. Od tego momentu możesz używać danych z interfejsu Topics jako dodatkowego sygnału.
    • Gdy zaczniesz otrzymywać niepustą listę tematów, możesz wysłać ją do backendu wraz z innymi sygnałami kontekstowymi.

Wdrażanie w wybranych witrynach

Po zintegrowaniu wywołania Topics ze skryptem upewnij się, że jest ono osadzone w witrynach produkcyjnych, aby przeprowadzić pierwszy test. Sprawdź, czy implementacja działa zgodnie z oczekiwaniami:

  • Wywoływany jest interfejs Topics API.
  • Tematy można obserwować w tym kontrolowanym środowisku.
  • Tematy mogą być dostępne (interfejs API zwraca zaobserwowane tematy użytkownika).

Wybierz witryny docelowe

Zanim wdrożysz rozwiązanie w witrynach wydawców, zalecamy przetestowanie go w kontrolowanym środowisku, w witrynach, które należą do Ciebie. Zalecamy wybieranie docelowych witryn w ten sposób:

  • Witryna ma niewielką liczbę wizyt miesięcznie (mniej niż około 1 milion wizyt miesięcznie): zacznij od wdrożenia interfejsu API w przypadku niewielkiej grupy odbiorców.
  • Jesteś właścicielem witryny i masz nad nią kontrolę: w razie potrzeby możesz szybko wyłączyć wdrożenie bez konieczności uzyskiwania skomplikowanych zatwierdzeń.
  • Witryna nie ma kluczowego znaczenia dla firmy: zacznij od witryn docelowych o niskim ryzyku.
  • Łącznie nie więcej niż 5 witryn: na razie nie potrzebujesz tak dużego ruchu ani zasięgu.
  • Witryny docelowe reprezentują różne tematy: wybierz witryny reprezentujące różne kategorie (np. jedną o sporcie, drugą o wiadomościach, a trzecią o jedzeniu i napojach). Możesz użyć wewnętrznego narzędzia do obsługi tematów w Chrome, aby sprawdzić domeny i sposób ich klasyfikacji przez klasyfikator uczenia maszynowego Topics.

Testy funkcjonalne i weryfikacja

Podczas wywoływania interfejsu Topics API w tym ograniczonym środowisku możesz spodziewać się tych wyników:

  • Pusta tablica tematów [], jeśli w ciągu ostatnich 7 dni jest to pierwsze wywołanie na tym urządzeniu, w przypadku tej witryny i wywołującego.

  • Lista od 0 do 3 tematów reprezentujących zainteresowania użytkownika. Po 7 dniach obserwacji powinna do Ciebie dotrzeć:

    • Jeden temat wybrany spośród 5 najpopularniejszych tematów użytkownika, obliczony na podstawie nazw hostów stron, na których wywołujący interfejs API zaobserwował tematy w danym tygodniu.

  • Dokładnie taka sama odpowiedź API jak w przypadku wszystkich poprzednich wywołań interfejsu Topics API. W przypadku tego samego elementu wywołującego, użytkownika i witryny najwyższego poziomu interfejs API będzie zwracać te same tematy przez cały okres. Pomaga to uniknąć ujawniania zbyt wielu zainteresowań użytkownika. Więcej informacji znajdziesz w GitHubie.

  • Nowy temat zastępujący jeden z 3 starych tematów, jeśli wywołujesz interfejs Topics API po 4 tygodniach obserwacji.

  • Jeśli w ciągu ostatnich 3 tygodni lub dłuższego okresu nie zaobserwowano tematów użytkownika, interfejs Topics API ponownie zwróci pustą tablicę [].

Zbieraj dane o skuteczności, aby ocenić wygodę użytkowania:

  • Należy mierzyć czas działania wywołań JavaScript interfejsu Topics API w elemencie iframe z innego źródła, aby wykorzystać go w przyszłych analizach wydajności.
  • Czas potrzebny na utworzenie elementu iframe i tematów postMessage() po otrzymaniu tematów.

Więcej informacji znajdziesz w sekcji Pomoc.

Skalowanie do środowiska produkcyjnego

Na tym etapie powinna być już przeprowadzona weryfikacja interfejsu Topics w kontrolowanym środowisku (w niektórych należących do Ciebie witrynach). Jeśli wszystko działa zgodnie z oczekiwaniami, możesz rozszerzyć tę implementację. wdrażać ten sam kod w większej liczbie docelowych witryn, Dzięki temu będziesz mieć możliwość obserwowania większej liczby użytkowników, zbierania większej ilości danych o tematach i lepiej poznawać swoich odbiorców.

Oto podsumowanie kroków, które musisz wykonać, aby wdrożyć model w środowisku produkcyjnym:

  1. Przetestuj rozwiązanie oparte na tematach na większej ilości ruchu.
    • Dodaj ramkę iframe do większej liczby witryn, których jesteś właścicielem, i które mają większą liczbę wizyt, a następnie wykonaj instrukcje poniżej, aby przeprowadzić testy obciążenia.
  2. Wdróż rozwiązanie w witrynach wydawców.
    • Gdy Twoje rozwiązanie będzie działać prawidłowo w środowisku testowym, nawiąż współpracę z wydawcami, aby zintegrować ramkę iframe z ich witrynami. Może to być na przykład konieczność zaktualizowania biblioteki, która zawiera Twój element iframe.
  3. Przetwarzanie i wykorzystywanie danych o tematach (szacowany czas: około 4 tygodni).
    • uwzględniać dane o tematach jako dodatkowy sygnał obok innych danych;
    • Znajdź partnerów do testowania określania stawek w czasie rzeczywistym.
    • Przeprowadzaj testy przydatności, w których tematy będą dodatkowym sygnałem do innych danych.

Testowanie obciążenia

Aby mieć pewność, że Twój system poradzi sobie z ruchem, zalecamy przeprowadzenie testów obciążeniowych przed wdrożeniem rozwiązania opartego na tematach w witrynach wydawców.

  1. Wdrażaj je stopniowo w większej liczbie witryn docelowych, których jesteś właścicielem, zwłaszcza tych, które generują większy ruch.
  2. Przeprowadź testy obciążeniowe danych o tematach zgodnie z oczekiwanym ruchem.
    • Musisz wysłać informacje o temacie z elementu iframe do backendu. Umożliwia to dalsze przetwarzanie wyników interfejsu Topics API i używanie ich jako dodatkowego sygnału, który pomaga wybierać reklamy lepiej dopasowane do użytkownika. W miarę jak coraz więcej witryn będzie zawierać Twój kod do osadzania, liczba wywołań backendu będzie się znacznie zwiększać. Sprawdź, czy backend może obsługiwać dużą liczbę wywołań z elementu iframe.
    • Skonfiguruj zbieranie wskaźników i dzienników na potrzeby analizy.
  3. Zaraz po wdrożeniu interfejsu Topics API sprawdź swoje dane, aby wykryć poważne problemy użytkowników. Regularnie sprawdzaj swoje dane.
  4. W przypadku zakłóceń lub nieoczekiwanego zachowania wycofaj wdrożenie i przeanalizuj logi, aby zrozumieć i rozwiązać problem.

Zobacz też

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