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

Z tej strony dowiesz się, jak tworzyć, testować i skalować implementację w środowisku produkcyjnym za pomocą interfejsu Topics API.

Implementacja backendu Topics

Implementacja backendu zależy od tego, jak chcesz używać tematów obliczonych w przeglądarce. Zalecamy, aby rozwiązania związane z technologiami reklamowymi wykorzystywały tematy jako dodatkowy sygnał 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 tematów jako dodatkowego sygnału

Dane dotyczące tematów możesz analizować razem z innymi sygnałami, np. adresami URL, słowami kluczowymi i innymi metadanymi, jako dodatkowy sygnał dotyczący Twoich odbiorców.

Jak wyjaśniliśmy w artykule Maksymalizowanie trafności reklam po wycofaniu plików cookie innych firm, istnieje kilka sposobów na wykorzystanie interfejsu Topics do wyświetlania trafnych reklam. Niektóre z nich obejmują tworzenie list odbiorców za pomocą Topics, natomiast inne sugerują korzystanie z tematów jako jednego z sygnałów do trenowania systemów uczących się, które posłużą do określania dodatkowych zainteresowań odbiorców, a nawet do optymalizowania logiki ustalania stawek.

Kompiluj i wdróż

  1. Zbierz tematy, obserwując użytkowników w środowisku produkcyjnym (szacowany czas implementacji: około tygodnia):
    • Zapoznaj się z dostępnymi opcjami: jak wywoływać Topics z nagłówkami HTTP lub iframe i JavaScript.
    • Określ domenę elementu iframe, który będzie wywoływać interfejs Topics API.
    • Utwórz rozwiązanie, korzystając z prezentacji w nagłówku lub prezentacji JavaScript jako odniesienia do kodu.
    • Integrowanie interfejsu Topics z kodem, który wydawcy umieszcza w swoich witrynach (np. element iframe reklamy). Pamiętaj, aby wywoływać tematy z umieszczonego źródła.
    • Aby zacząć obserwować tematy użytkowników, umieść najnowszą wersję skryptu w swoich witrynach produkcyjnych. Zalecamy, aby najpierw przetestować implementację na własnych witrynach, które mają niewielką liczbę miesięcznych wizyt. Na tym etapie zalecamy umieszczenie nowego rozwiązania opartego na tematach w co najmniej 5 witrynach.
    • Na tym etapie interfejs API powinien zwracać pustą tablicę. Dzieje się tak, ponieważ ten użytkownik nie zaobserwował jeszcze żadnych tematów. Zanim zaczną się pojawiać tematy użytkowników, może minąć do 3 tygodni.
    • Przeprowadź testy funkcjonalne i weryfikację. Rozwiązanie możesz przetestować ręcznie lub automatycznie. Na przykład:
      • Otwórz przeglądarkę przy użyciu flag i ustaw epokę na 15 sekund, aby przeglądarka szybciej przeliczyła tematy.
      • Odwiedź strony, na których jest umieszczony Twój skrypt.
      • Sprawdź, czy skrypt wykrywa tematy na stronie chrome://topics-internals/.
      • Sprawdź, jakie wyniki możesz uzyskać.
  2. Używanie danych z Tematów razem z innymi sygnałami kontekstowymi (np. adresami URL, metadanymi itp.). (szacowany czas: około 3 dni).
    • Po 3 tygodniach od opublikowania skryptu powinien nastąpić u niektórych użytkowników tematy. W tej chwili możesz używać danych Topics jako dodatkowego sygnału.
    • Gdy zaczniesz otrzymywać niepustą listę tematów, możesz wysłać ją do backendu razem z innymi sygnałami kontekstowymi.

Wdróż w witrynach docelowych

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

  • Wywołuje interfejs Topics API.
  • W tym kontrolowanym środowisku można obserwować tematy.
  • Można uzyskiwać dostęp do tematów (interfejs API zwraca zaobserwowane tematy u użytkownika).

Wybieranie witryn docelowych

Przed wdrożeniem rozwiązania w witrynach wydawców zalecamy przetestowanie go w kontrolowanym środowisku w witrynach należących do Ciebie. Zalecamy wybranie witryn docelowych w ten sposób:

  • Odnotowuje ona niewielką liczbę wizyt miesięcznie (mniej niż milion wizyt miesięcznie): należy zacząć od wdrożenia interfejsu API na małej grupie odbiorców.
  • Witryna należy do Ciebie i kontroluje ją: w razie potrzeby możesz szybko wyłączyć implementację bez konieczności zatwierdzania.
  • Strona nie jest kluczowa dla firmy: zacznij od witryn docelowych o niskim ryzyku.
  • Maksymalnie 5 witryn: na razie nie potrzebujesz aż tak dużego ruchu ani tak dużej widoczności.
  • Witryny docelowe o różnej tematyce: wybierz witryny reprezentujące różne kategorie (np. jedną o sporcie, kolejną z wiadomościami, a jeszcze jedną o jedzeniu i napojach). Możesz użyć wewnętrznego narzędzia do tematów w Chrome, aby zweryfikować domeny i sposób, w jaki są one klasyfikowane przez klasyfikator Topics oparty na uczeniu maszynowym.

Testy funkcjonalne i weryfikacja

Podczas wywoływania interfejsu Topics API w takim ograniczonym środowisku możesz oczekiwać następujących wyników:

  • Pusty tablica tematów [] (jeśli jest to pierwsze wywołanie tego urządzenia) dla tej witryny i rozmówcy w ciągu ostatnich 7 dni.

  • Lista od 0 do 3 tematów reprezentujących zainteresowania tego użytkownika. Po 7 dniach obserwacji otrzymasz:

    • 1 temat wybrany spośród 5 najpopularniejszych tematów użytkownika, obliczony na podstawie nazw hosta stron, na których tematy zostały zaobserwowane przez wywołującego w tym tygodniu.

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

  • nowy temat zastępujący jeden z 3 starych, jeśli wywołujesz tematy po 4 tygodniach obserwacji.

  • Jeśli nie obserwujesz tematów tego użytkownika przez ostatnie 3 tygodnie lub dłużej, interfejs Topics API zwróci ponownie pustą tablicę [].

Zbieraj dane o wydajności, aby ocenić wrażenia użytkowników:

  • Czas wykonywania wywołań JavaScript interfejsu Topics API w ramach elementu iframe w innej domenie należy mierzyć, aby można było go wykorzystać w przyszłej analizie skuteczności.
  • Czas potrzebny na utworzenie iframe i tematów postMessage() po otrzymaniu tematów.

Rozwiązywanie problemów znajdziesz w sekcji pomocy.

Przejście do wersji produkcyjnej

Na tym etapie warto przetestować interfejs Topics w kontrolowanym środowisku (w niektórych Twoich witrynach). Jeśli wszystko działa zgodnie z oczekiwaniami, należy dostosować implementację. Wdróż ten sam kod na więcej witryn docelowych. Dzięki temu możesz obserwować więcej użytkowników, zbierać więcej danych dotyczących tematów i lepiej poznać swoich odbiorców.

Oto szczegółowe omówienie możliwości przejścia na wersję produkcyjną:

  1. Sprawdź swoje rozwiązanie oparte na tematach na większym ruchu.
    • Dodaj element iframe do większej liczby swoich witryn z większą liczbą wizyt i wykonaj podane niżej instrukcje, aby przetestować obciążenie.
  2. Wdrożyć rozwiązanie w witrynach wydawców.
    • Gdy rozwiązanie zacznie działać prawidłowo w Twoim środowisku testowym, współpracuj z wydawcami, aby zintegrować kod iframe z ich witrynami. Konieczne może być na przykład zaktualizowanie biblioteki zawierającej element iframe.
  3. Przetwarzanie i wykorzystywanie danych dotyczących tematów (szacowany czas: około 4 tygodni).
    • Uwzględnij dane dotyczące tematów jako dodatkowy sygnał do innych danych.
    • Źródłowymi partnerami testującymi określanie stawek w czasie rzeczywistym.
    • Przeprowadzaj testy narzędziowe, korzystając z tematów jako sygnałów sumujących się do innych danych.

Testowanie obciążenia

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

  1. Wdrażaj stopniowo w większej liczbie swoich witryn docelowych, zwłaszcza w przypadku witryn o dużym natężeniu ruchu.
  2. Przetestuj obciążenie danych dotyczących tematów w zależności od oczekiwanego natężenia ruchu.
    • Musisz wysłać informacje o temacie z ramki iframe do backendu. Dzięki temu możesz przetwarzać wyniki interfejsu Topics API i wykorzystywać je jako dodatkowy sygnał, który pomoże Ci wybrać reklamy bardziej dopasowane do użytkownika. W miarę jak coraz więcej witryn będzie używać Twojego kodu embed, liczba wywołań do Twojego backendu będzie się znacznie zwiększać. Sprawdź, czy backend może obsługiwać dużą liczbę wywołań z poziomu iframe.
    • Skonfiguruj zbieranie wskaźników i logi do analizy.
  3. Natychmiast po wdrożeniu interfejsu Topics API sprawdź wskaźniki, aby wykryć poważne problemy użytkowników. Regularnie sprawdzaj dane.
  4. W przypadku przerwania działania lub nieoczekiwanego zachowania cofnij wdrożenie i przeanalizuj logi, aby zrozumieć problem i go rozwiązać.

Zobacz też

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