Omówienie interfejsu Protected Audience API

Aukcje reklam na urządzeniu, aby wyświetlać remarketing i niestandardowe listy odbiorców bez śledzenia w różnych witrynach.

Dla kogo jest ten artykuł?

W tym artykule omówiono podstawy interfejsu Protected Audience API i wyjaśniliśmy kilka podstawowych koncepcji, ale nie zagłębiamy się w szczegółach technicznych.

Terminy używane w dokumentacji Protected Audience API znajdziesz w słowniczku. Z tego artykułu dowiesz się, jak angażować użytkowników i dzielić się opiniami.

Czym jest interfejs Protected Audience API?

Protected Audience API to technologia Piaskownicy prywatności, która służy do obsługi remarketingu i niestandardowych list odbiorców. Została ona zaprojektowana w taki sposób, aby firmy zewnętrzne nie mogły śledzić działań użytkowników w różnych witrynach.

Protected Audience API umożliwia przeglądarkom przeprowadzanie aukcji na urządzeniu wybieranie trafnych reklam ze stron, które użytkownik wcześniej odwiedził.

Protected Audience API to pierwszy eksperyment, który został wdrożony w Chromium w ramach rodziny ofert pakietowych TURTLEDOVE. Różnica między Protected Audience a TURTLEDOVE głównie wynika z oddzielenia roli kupującego i sprzedawcy na urządzeniu. W sekcjach poniżej wyjaśniamy, jak działa interfejs Protected Audience API.

Protected Audience API za minutę

Bardziej szczegółowe informacje o interfejsie Protected Audience API znajdziesz w przewodniku dla programistów dotyczącym tego interfejsu.

Omówienie każdego etapu cyklu życia interfejsu Protected Audience API
Cykl życia interfejsu Protected Audience API.

Protected Audience API wykorzystuje grupy zainteresowań, aby umożliwić witrynom wyświetlanie reklam odpowiednich dla użytkowników.

Gdy na przykład użytkownik odwiedza witrynę, która chce reklamować swoje produkty, właściciel grupy zainteresowań (np. platforma DSP) może poprosić przeglądarkę użytkownika o dodanie członkostwa w tej grupie. Jeśli żądanie zostanie zrealizowane, przeglądarka zarejestruje:

  • Nazwa grupy zainteresowań, np. „rowery na zamówienie”.
  • Właściciel grupy zainteresowań: na przykład „https://dsp.example”.
  • informacje o konfiguracji grupy zainteresowań, dzięki którym przeglądarka ma dostęp do kodu ustalania stawek, kodu reklamy i danych w czasie rzeczywistym, jeśli jej właściciel jest zaproszony do udziału w aukcji reklam;

Później, gdy użytkownik wejdzie na stronę z dostępną przestrzenią reklamową, sprzedawca przestrzeni reklamowej (dostawca platformy sprzedażowej (SSP) lub sama witryna) może skorzystać z funkcji Protected Audience API, aby wziąć udział w aukcji reklam i wybrać najbardziej odpowiednie reklamy do wyświetlenia użytkownikowi. Sprzedawca wywołuje funkcję navigator.runAdAuction(), która podaje listę właścicieli grup zainteresowań zaproszonych do ustalania stawek.

Stawki można określać tylko w przypadku grup zainteresowań, do których należy przeglądarka, a ich właścicieli zostali zaproszeni do ustalania stawek.

Kod ustalania stawek jest pobierany z adresu URL podanego w konfiguracji grupy zainteresowań. Kod ten dostarcza dane o grupie zainteresowań i informacje od sprzedawcy, a także dane kontekstowe o stronie i z przeglądarki.

Każda grupa zainteresowań, dla której określono stawkę, jest nazywana kupującym.

Gdy przeglądarka wywołuje funkcję uruchamiającą aukcję reklam, kod każdego kupującego generuje stawkę za pomocą danych w czasie rzeczywistym dostarczanych przez usługę klucz-wartość w ramach Protected Audience API. Następnie sprzedawca otrzymuje te stawki, a także należące do niego dane w czasie rzeczywistym i ocenia każdą stawkę. Aukcję wygrywa stawka z najwyższym wynikiem.

Zwycięska reklama wyświetla się w ramce otoczonej ramką. Adres URL kreacji jest określony w stawce, a źródło musi być zgodne z adresem na liście podanej w konfiguracji grupy zainteresowań.

Sprzedawca może zgłaszać wynik aukcji (reportResult()), a kupujący – swoje wygrane (reportWin()).

Dowiedz się więcej o raportach aukcji na potrzeby chronionych odbiorców.

Dlaczego potrzebujemy interfejsu Protected Audience API?

Wiedza na temat zainteresowań użytkowników pozwala tworzyć trafniejsze reklamy niż tylko dobieranie ich na podstawie treści witryny (kierowanie kontekstowe) lub na podstawie informacji przekazywanych przez użytkowników witryny, w której wyświetla się reklama (kierowanie na podstawie danych własnych).

Dawniej platformy reklamowe poznają zainteresowania użytkowników, śledząc ich zachowanie w witrynach. Przeglądarki muszą umożliwiać platformom reklamowym wybieranie trafnych reklam, by wydawcy treści mogli uzyskiwać przychody z reklam bez śledzenia w witrynach.

Protected Audience API ma na celu przeniesienie platformy internetowej do stanu, w którym przeglądarka użytkownika na urządzeniu – a nie reklamodawca czy platforma technologii reklamowych – przechowuje informacje o tym, czym interesuje się dana osoba.

Jak mogę wypróbować interfejs Protected Audience API?

  • Informacje o tym, jak używać interfejsu API i testować lokalnie, znajdziesz w przewodniku dla programistów Protected Audience API.

  • Protected-audience-demo.web.app zawiera instrukcję podstawowego wdrożenia Protected Audience API w witrynach reklamodawców i wydawców. Film demonstracyjny w ramach Protected Audience pokazuje, jak działa ten kod, oraz pokazuje, jak używać Narzędzi deweloperskich w Chrome do debugowania.

Jaka konfiguracja przeglądarki jest dostępna?

Użytkownicy mogą dostosować swój udział w okresach próbnych Piaskownicy prywatności w Chrome, włączając lub wyłączając ustawienie najwyższego poziomu w sekcji chrome://settings/adPrivacy. Podczas wstępnych testów użytkownicy mogą zrezygnować z interfejsu Protected Audience API w ustawieniach Piaskownicy prywatności.

Chrome planuje umożliwić użytkownikom przeglądanie listy grup zainteresowań, do których zostali dodani w odwiedzonych witrynach, oraz zarządzanie nią. Podobnie jak w przypadku technologii Piaskownicy prywatności, ustawienia użytkowników mogą się zmieniać na podstawie opinii użytkowników, organów regulacyjnych i innych osób.

W miarę postępów interfejsu Protected Audience API będziemy aktualizować ustawienia dostępne w Chrome na podstawie testów i opinii. W przyszłości wprowadzimy bardziej szczegółowe ustawienia służące do zarządzania Protected Audience API i powiązanymi danymi.

Osoby wywołujące interfejs API nie mają dostępu do członkostwa w grupie, gdy użytkownicy korzystają z przeglądarki w trybie incognito, a członkostwo jest usuwane, gdy użytkownik wyczyści dane swojej witryny.

Czy mogę zrezygnować z interfejsu Protected Audience API?

Dowiedz się, jak zablokować dostęp do interfejsu Protected Audience API jako właściciel witryny lub użytkownik indywidualny.

Kluczowych pojęć

Szukasz więcej informacji o terminologii Protected Audience? Zapoznaj się z słowniczkiem Piaskownicy prywatności.

Co to jest grupa zainteresowań?

Grupa zainteresowań interfejsu Protected Audience API to grupa osób o wspólnych zainteresowaniach, odpowiadająca liście remarketingowej.

Każda grupa zainteresowań interfejsu Protected Audience API ma właściciela. Różni właściciele tworzą różne typy grup zainteresowań w odmiennych przypadkach użycia.

Właściciel prosi przeglądarkę użytkownika o dodanie członkostwa w jego grupie zainteresowań przez wywołanie funkcji JavaScript navigator.joinAdInterestGroup() i podanie informacji takich jak dane o reklamach związanych z tą grupą zainteresowań oraz adres URL JavaScriptu używanego do określania stawek. Dane o grupach zainteresowań (np. reklamy) można aktualizować, a grupę zainteresowań można włączyć przez maksymalnie 30 dni.

Typy grup zainteresowań

W tabeli poniżej znajdziesz przykłady różnych typów grup zainteresowań i właścicieli należących do interfejsu Protected Audience API.

Właściciel Przykład Zainteresowanie Przykład Przykłady zastosowań
Reklamodawca Producent rowerów Produkty Osoby, które przeglądały strony produktów konkretnej kategorii rowerów. Remarketing wśród użytkowników, którzy weszli wcześniej w interakcję z marką
Wydawca Witryna z wiadomościami treści Osoby, które czytały o rowerach. Wydawcy mogą korzystać z danych własnych, aby umożliwić reklamodawcom kupowanie reklam przydatnych dla czytelników w ich witrynach. Grupa zainteresowań należąca do wydawcy może pozwolić wydawcom robić to samo, nawet gdy przeglądają inne witryny. Wydawcy mogą pobierać opłaty za wyświetlanie reklam określonym segmentom odbiorców.
Technologie reklamowe (procesor) DSP Kategoria produktów Osoby, które wykazały zainteresowanie sprzętem rowerowym. Firma z branży technologii reklamowych może utworzyć grupę zainteresowań osób, które jej zdaniem szukają produktów z określonej kategorii, i nią zarządzać. Tę grupę zainteresowań można następnie wykorzystać do reklamowania produktów w witrynach, które sprzedają produkty z tej kategorii (i które współpracują z firmą z branży technologii reklamowych).

Chrome umożliwia utworzenie do 1000 grup zainteresowań na właściciela i do 1000 właścicieli grup zainteresowań. Ograniczenia te mają charakter barierowy i nie należy ich przekraczać w trakcie zwykłego działania.

Kim jest kupujący?

W interfejsie Protected Audience API kupujący to strona, która jest właścicielem grupy zainteresowań i ustala stawki w aukcji reklam.

Na przykład:

  • Reklamodawca: działanie w imieniu własnym.
  • Platforma DSP: działanie w imieniu reklamodawców.
  • Właściciel grupy zainteresowań: pracuje dla wielu reklamodawców.

Kupujący mają 3 prace:

  • Zdecyduj, czy chcesz brać udział w aukcji.
  • Wybierz reklamy i oblicz stawkę.
  • Raportowanie wyniku aukcji

Zadania te są wykonywane w sposób zautomatyzowany w kodzie dostarczonym przez kupującego, który uruchamia się podczas aukcji reklam w ramach Protected Audience API.

Gdy kupujący prosi przeglądarkę użytkownika o dodanie grupy zainteresowań do grup, do których należy (przez wywołanie funkcji JavaScript navigator.joinAdInterestGroup()), udostępnia przeglądarce:

  • Adres URL kodu ustalania stawek, który będzie używany, gdy sprzedawca przeprowadzi aukcję reklam.
  • Potencjalnie adresy URL kreacji reklamowych należących do grupy zainteresowań. (Adresy URL reklam można dodać później po aktualizacji).
  • Lista kluczy danych, których dotyczy zapytanie, oraz adres URL usługi kluczy/wartości kupującego, aby umożliwić kodowi ustalania stawek pobieranie danych w czasie rzeczywistym podczas aukcji.

Kod kupującego może też zawierać funkcję reportWin(), która zgłasza wynik aukcji.

Kto przeprowadza aukcję reklam?

Istnieje wiele podmiotów, które mogą przeprowadzać aukcje dotyczące sprzedaży przestrzeni reklamowej.

Na przykład:

  • Wydawca treści: hostowanie treści reklamy w swojej witrynie.
  • Platforma dostawców reklam (SSP): współpraca z wydawcą i świadczenie innych usług.
  • Skrypt firmy zewnętrznej: działanie na zlecenie wydawcy, umożliwiające udział w aukcjach reklam.

W interfejsie Protected Audience API sprzedawca przestrzeni reklamowej ma 3 zadania:

  • Egzekwowanie reguł wydawcy: określanie, którzy kupujący i które stawki są odpowiednie.
  • Uruchom logikę aukcji: kod JavaScript jest uruchamiany w workletach, aby obliczyć wynik trafności dla każdej stawki.
  • Raportowanie wyniku aukcji

Zadania te są wykonywane w sposób zautomatyzowany w kodzie udostępnionym przez sprzedawcę, gdy inicjuje on aukcję reklam, wywołując funkcję JavaScript navigator.runAdAuction().

Jak przebiega aukcja reklam w ramach Protected Audience API?

Na diagramie poniżej widać każdy etap aukcji reklam w ramach Protected Audience API:

6 etapów aukcji reklam Protected Audience API
Etapy aukcji reklam w ramach ochrony odbiorców.

W interfejsie Protected Audience API aukcja reklam to zbiór małych programów JavaScript, które przeglądarka uruchamia na urządzeniu użytkownika, aby wybrać reklamę. Aby chronić prywatność, cały kod aukcji reklam pochodzący od sprzedawcy i kupujących jest uruchamiany w odizolowanych workletach JavaScriptu, które nie mają dostępu do informacji zewnętrznych.

Sprzedawca (wydawca lub platforma dostawców reklam) inicjuje aukcję reklam w ramach Protected Audience API w witrynie, która sprzedaje przestrzeń reklamową (np. w witrynie z wiadomościami). Sprzedawca wybiera kupujących do udziału w aukcji, wskazuje miejsce na sprzedaż i określa dodatkowe kryteria reklamy. Każdy kupujący jest właścicielem grupy zainteresowań.

Sprzedawca dostarcza przeglądarce kod służący do określania stawek, który obejmuje wartość każdej stawki, adres URL kreacji reklamy i inne dane zwracane przez każdego kupującego. Podczas aukcji kod ustalania stawek od kupujących i kod oceny stawki od sprzedawcy mogą otrzymywać dane z usług klucz/wartość. Po wybraniu i wyświetleniu reklamy (w ramce, która ma na celu ochronę prywatności), sprzedawca i zwycięski kupujący mogą zgłosić wynik aukcji.

  1. Użytkownik odwiedza witrynę, która wyświetla reklamy.
  2. Kod sprzedawcy uruchamia aukcję. Sprzedawca określa, która przestrzeń reklamowa jest na sprzedaż i kto może licytować, a także metodę oceny tych stawek.
  3. Kod zaproszonego kupującego jest uruchamiany, aby wygenerować stawkę, adres URL odpowiedniej kreacji reklamy i inne dane. Skrypt ustalania stawek może wysyłać zapytania o dane w czasie rzeczywistym, takie jak pozostały budżet kampanii reklamowej, z usługi kluczy/wartości kupującego.
  4. Kod sprzedawcy nadaje punkty każdej stawce i wybiera zwycięzcę. Ta logika wykorzystuje wartość stawki i inne dane, aby określić odpowiednią stawkę i odrzucić reklamę, która nie może pokonać zwycięskiej reklamy kontekstowej. Sprzedawca może używać własnej usługi kluczy/wartości do obsługi danych w czasie rzeczywistym. Przed rozpoczęciem aukcji sprzedawca znajduje najlepszą reklamę kontekstową dla dostępnego boksu reklamowego.
  5. Gdy w konfiguracji aukcji jest ustawiona flaga resolveToConfig, zwycięska reklama jest zwracana jako obiekt konfiguracji ramki ogrodzonej. Konfiguracja pozwala przejść do ograniczonej ramki do kreacji, a adres URL kreacji jest ukryty zarówno przed sprzedawcą, jak i wydawcy. Jeśli flaga resolveToConfig jest ustawiona na false lub nie jest przekazywana, zwycięska reklama jest zwracana jako nieprzezroczyste pole URN, które można wykorzystać do renderowania reklamy w elemencie iframe. Obiekt konfiguracji ramki chronionej jest dostępny od wersji M114.
  6. Informacje o aukcji są przekazywane sprzedawcy i kupującym, którzy wygrają.

Omawiamy mechanizm zgłaszania przegranych kupujących.

Czym jest usługa klucz-wartość interfejsu Protected Audience API?

Usługa klucz/wartość interfejsu Protected Audience API umożliwia technikom reklamowym wysyłanie zapytań o dane w czasie rzeczywistym, gdy kupujący ustala stawkę, a sprzedawców – na ocenę reklam przy zachowaniu prywatności. Informacje o usłudze klucz-wartość w interfejsie Protected Audience API i innych znajdziesz w artykule Usługi interfejsu Protected Audience API.

Usługa klucz/wartość jest wdrożona w infrastrukturze chmury powiązanej z technologią reklamową, a usługa działa w zaufanym środowisku wykonawczym. Żądanie wysłane do usługi klucz/wartość nie może spowodować rejestrowania na poziomie zdarzenia ani mieć innych skutków ubocznych. Usługa klucz/wartość będzie też obsługiwać funkcje zdefiniowane przez użytkownika (UDF), które umożliwiają technikom reklamowym wykonywanie własnej logiki niestandardowej w ramach tej usługi.

Kupujący lub sprzedawca dostarcza listę „kluczy” służących do określania danych wymaganych z usługi Protected Audience API w usłudze klucz-wartość. Usługa klucz/wartość przekazuje wartość dla każdego klucza.

Kod usługi klucz/wartość interfejsu Protected Audience API jest teraz dostępny w repozytorium Piaskownicy prywatności na GitHubie. Z tej usługi mogą korzystać deweloperzy Chrome i Androida.

Więcej informacji o usłudze klucz/wartość interfejsu Protected Audience API znajdziesz w wyjaśnieniu interfejsu API i objaśnieniu modelu zaufania.

W jaki sposób dane w czasie rzeczywistym są uwzględniane w aukcjach?

Kupujący i sprzedawcy biorący udział w aukcji reklam mogą potrzebować dostępu do danych w czasie rzeczywistym. Na przykład kupujący mogą chcieć obliczyć pozostały budżet kampanii reklamowej, a sprzedawcy mogą być zmuszeni do sprawdzenia kreacji pod kątem zgodności z zasadami wydawców.

Aby spełnić wymagania dotyczące prywatności interfejsu Protected Audience API, dane w czasie rzeczywistym wymagane podczas aukcji reklam są dostarczane przez usługę klucz/wartość. Gdy każdy kupujący wywołuje usługę navigator.joinAdInterestGroup(), określa adres URL usługi klucza/wartości i określa klucze, które mają być wysyłane do usługi podczas aukcji. I podobnie, gdy sprzedawca przeprowadza aukcję reklam, wywołując funkcję navigator.runAdAuction(), i poda URL dla swojej usługi klucz/wartość. Do usługi klucza/wartości sprzedawcy zostanie wysłane zapytanie z URL-em renderowania kreacji.

Do początkowych testów używamy modelu „Przynieś własny serwer”. W dłuższej perspektywie do pobierania danych w czasie rzeczywistym technologie reklamowe będą musiały korzystać z usług klucza i wartości interfejsu Protected Audience API na licencji open source działających w zaufanych środowiskach wykonawczych.

Aby zapewnić wystarczającą ilość czasu na testy ekosystemu, nie będziemy wymagać korzystania z usług typu open source typu klucz/wartość ani zaufanych środowisk wykonawczych do jakiegoś czasu po wycofaniu plików cookie innych firm. Przed tym przeniesieniem deweloperzy otrzymają powiadomienie o możliwości rozpoczęcia testów i wdrażania.

Jak wykorzystywane są dane własne w aukcji Protected Audience API?

Dane własne to informacje o użytkownikach, które są własnością witryny. Jeśli na przykład użytkownik określił swój ulubiony kolor w witrynie reklamodawcy lub wydawcy, kolor ten jest uznawany za dane własne.

W aukcji w ramach Protected Audience API reklamodawca może używać danych własnych do określania członkostwa w grupie zainteresowań reklam, a także przekazywać do niej dane jako userBiddingSignals. Dane własne reklamodawcy będą dostępne tylko dla kupujących na etapie generowania stawek. Sprzedawcy nie będą mieli do nich dostępu.

Jeśli na przykład reklamodawca zna ulubiony kolor użytkownika, po dodaniu użytkownika do grupy zainteresowań tę wartość można ustawić w konfiguracji grupy zainteresowań jako userBiddingSignals:

const interestGroup = {
  owner: 'https://example-buyer.com',
  name: 'running-shoes',
  userBiddingSignals: {
    favoriteColor: 'blue' // First-party data
  },
  // ...other interest group settings
};

navigator.joinAdInterestGroup(interestGroup, 3600);

Wydawca może też przekazywać dane własne, konfigurując sygnały w konfiguracji aukcji podczas inicjowania aukcji, i może decydować, kto będzie otrzymywać dane własne. Gdy wydawca przekazuje dane własne jako auctionSignals, są one dostępne zarówno dla kupujących, jak i dla sprzedawców. Dane przekazywane jako sellerSignals są dostępne tylko dla sprzedawcy, a po przekazaniu jako perBuyerSignals – tylko dla określonych kupujących. Wydawca może też przekazywać dane własne do aukcji komponentów. Wydawca i uczestnicy aukcji powinni wcześniej uzgodnić, jakie dane własne należy udostępniać i w jaki sposób powinny zostać sformatowane.

Ten przykład opisuje sposób, w jaki wydawca może przekazywać dane własne do różnych uczestników aukcji:

const auctionConfig = {
  seller: 'https://example-seller.com',
  auctionSignals: {
    favoriteColor: 'blue', // Both buyer and seller will receive this signal
  },
  sellerSignals: {
    favoriteIceCreamFlavor: 'chocolate', // Only the seller will receive this signal
  },
  perBuyerSignals: {
    'https://example-buyer.com': {
      favoriteDrink: 'tea', // Only a specific buyer will receive this signal
    },
  },
  // The same pattern applies to the component auction
  componentAuctions: [{
    seller: 'https://example-component-seller.com',
    auctionSignals: { ... },
    sellerSignals: { ... },
    perBuyerSignals { ... }
  }],
  // ...other auction settings
};

navigator.runAdAuction(auctionConfig);

Więcej informacji

Bardziej szczegółowe informacje o interfejsie Protected Audience API znajdziesz w przewodniku dla programistów dotyczącym tego interfejsu.

Deweloperzy

Jeśli chcesz zacząć korzystać z interfejsu Protected Audience API, przeczytaj artykuł o eksperymentach i uczestnictwie w programie.

Opracowaliśmy przewodnik dla programistów interfejsu API i opracowaliśmy prezentację interfejsu Protected Audience API, która zawiera omówienie podstawowego wdrożenia interfejsu Protected Audience API. Film z prezentacją Protected Audience API wyjaśnia, jak działa kod demonstracyjny, i pokazuje, jak używać Narzędzi deweloperskich w Chrome do debugowania interfejsu Protected Audience API.

Angażuj i dziel się opiniami