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 omawiamy podstawy interfejsu Protected Audience API i wyjaśniamy kilka podstawowych koncepcji, jednak nie udostępniamy zbyt wielu szczegółów 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 przesyłać opinie.

Czym jest interfejs Protected Audience API?

Protected Audience API to technologia Piaskownicy prywatności, która umożliwia remarketing i obsługę niestandardowych list odbiorców. Dzięki niej firmy zewnętrzne nie mogą śledzić działań użytkowników w różnych witrynach.

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

Protected Audience API to pierwszy eksperyment 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: zobacz większą wersję.

Protected Audience API wykorzystuje grupy zainteresowań, aby umożliwić witrynom wyświetlanie reklam odpowiednich dla ich 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ć jego przeglądarkę 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 właściciel grupy jest zaproszony do udziału w aukcji reklam.

Gdy później użytkownik wejdzie na stronę z dostępną przestrzenią reklamową, sprzedawca przestrzeni reklamowej (dostawca SSP lub sama witryna) może uruchomić aukcję reklam w ramach Protected Audience API, aby wybrać najbardziej odpowiednie reklamy do wyświetlenia użytkownikowi. Sprzedawca wywołuje funkcję navigator.runAdAuction(), która podaje listę właścicieli grupy zainteresowań, którzy zostali zaproszeni do ustalania stawek.

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

Kod ustalania stawek jest pobierany z adresu URL podanego w konfiguracji grupy zainteresowań. Zawiera on 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 jest określona stawka, 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ść Protected Audience API. Następnie sprzedawca otrzymuje te stawki oraz dane w czasie rzeczywistym należące do sprzedawcy i wyniki każdej stawki. Aukcję wygrywa stawka z najwyższym wynikiem.

Zwycięska reklama jest wyświetlana w ramce otoczonej ogrodzeniem. 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 raportować wyniki aukcji (reportResult()), a kupujący – zgłaszać wygrane (reportWin()).

Dowiedz się więcej o raportach aukcji w ramach Protected Audience API.

Dlaczego potrzebujemy interfejsu Protected Audience API?

Zrozumienie zainteresowań użytkowników może pozwolić na tworzenie trafniejszych reklam niż dobieranie ich na podstawie treści witryny (kierowanie kontekstowe) lub wykorzystanie informacji przekazanych przez użytkownika witryny, w której reklama się wyświetla (kierowanie na podstawie danych własnych).

Tradycyjnie platformy reklamowe poznają zainteresowania użytkowników, śledząc ich zachowania w różnych witrynach. Przeglądarki muszą umożliwiać platformom reklamowym wybieranie trafnych reklam, aby 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?

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 chrome://settings/adPrivacy. Podczas wstępnych testów użytkownicy mogą zrezygnować z korzystania z interfejsu Protected Audience API za pomocą ustawień Piaskownicy prywatności.

W Chrome planujemy umożliwić użytkownikom przeglądanie listy grup zainteresowań, do których zostali dodani w odwiedzonych witrynach, oraz zarządzanie nią. Ustawienia użytkowników, podobnie jak w przypadku technologii Piaskownicy prywatności, mogą się zmieniać w zależności od opinii użytkowników, organów regulacyjnych i innych podmiotów.

W miarę postępów interfejsu Protected Audience API zaktualizujemy ustawienia dostępne w Chrome na podstawie testów i opinii. W przyszłości zaoferujemy bardziej szczegółowe ustawienia zarządzania ochroną odbiorców 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 możesz blokować dostęp do interfejsu Protected Audience API jako właściciel witryny lub użytkownik indywidualny.

Kluczowe pojęcia

Szukasz więcej informacji na temat terminologii w ramach Protected Audience API? Więcej informacji znajdziesz w słowniczku Piaskownicy prywatności.

Co to jest grupa zainteresowań?

Grupa zainteresowań interfejsu Protected Audience API obejmuje grupę osób o wspólnych zainteresowaniach. Odpowiada ona liście remarketingowej.

Każda grupa zainteresowań interfejsu Protected Audience API ma właściciela. Różni właściciele tworzą różne rodzaje grup zainteresowań o odmiennych zastosowaniach.

Właściciel prosi przeglądarkę użytkownika o dodanie członkostwa w grupie zainteresowań przez wywołanie funkcji JavaScript navigator.joinAdInterestGroup() i przekazanie informacji takich jak dane o reklamach odpowiednich dla danej grupy zainteresowań czy adresu URL JavaScriptu używanego do określania stawek. Dane o grupach zainteresowań (np. reklamy) można aktualizować, a grupę zainteresowań można włączać na maksymalnie 30 dni.

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 Przypadki użycia
Reklamodawca Producent rowerów Produkty Użytkownicy, którzy przeglądali strony produktów określonej kategorii rowerów. Remarketing kierowany do osób, które wcześniej weszły 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, które są przydatne dla czytelników w ich witrynach. Grupa zainteresowań należąca do wydawcy może pozwolić wydawcom na to samo, nawet gdy osoby te 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 produktów, i nią zarządzać. Tej grupy zainteresowań można następnie użyć do reklamowania produktów w witrynach, które sprzedają produkty z tej kategorii (i którzy współpracują z firmą zajmującą się technologiami reklamowymi).

Chrome umożliwia utworzenie do 1000 grup zainteresowań na właściciela i do 1000 grup zainteresowań. Ograniczenia te są tworzone jako bariery ochronne i nie można ich przekroczyć podczas 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 Twoim imieniu.
  • Platforma DSP: działająca dla reklamodawców.
  • Właściciel grupy zainteresowań: osoba pracująca dla wielu reklamodawców.

Nabywcy mają 3 zdania:

  • Zdecyduj, czy chcesz wziąć udział w aukcji.
  • Wybierz reklamy i oblicz stawkę.
  • Raportuj wynik aukcji.

Te zadania są wykonywane automatycznie w kodzie dostarczonym przez kupującego, który uruchamia się podczas aukcji reklam za pomocą interfejsu Protected Audience API.

Gdy kupujący prosi przeglądarkę użytkownika o dodanie grupy zainteresowań do grup, do których należy (wywołując funkcję JavaScriptu navigator.joinAdInterestGroup()), kupujący udostępnia przeglądarce: * adres URL na potrzeby kodu ustalania stawek, który będzie używany, gdy sprzedawca przeprowadzi aukcję reklam; * Ewentualnie adresy URL kreacji reklamowych należy do grupy zainteresowań. (Adresy URL reklam można dodać później w ramach aktualizacji). * Lista kluczy danych, których dotyczy zapytanie, oraz adres URL usługi klucz/wartość kupującego, który umożliwia kodowi ustalania stawek pobieranie danych w czasie rzeczywistym podczas aukcji.

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

Kto przeprowadza aukcję reklam?

Istnieje wiele podmiotów, które mogą organizować aukcję w celu sprzedaży przestrzeni reklamowej.

Na przykład:

  • Wydawca treści: hostuje treść reklamy w swojej witrynie.
  • Platforma dostawców reklam (SSP): współpraca z wydawcą i świadczenie innych usług.
  • Skrypt zewnętrzny: działanie w imieniu wydawcy, by umożliwić udział w aukcjach reklam.

Dzięki interfejsowi 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 uruchamia się w workletach, aby obliczać wynik optymalizacji każdej stawki.
  • Raportuj wynik aukcji.

Zadania te są wykonywane automatycznie w kodzie dostarczonym przez sprzedawcę w momencie, 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 przedstawiamy każdy etap aukcji reklam w ramach Protected Audience API: zobacz większą wersję.

6 etapów aukcji reklam w ramach Protected Audience API


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 JavaScript, które nie są w stanie komunikować się ze światem zewnętrznym.

Sprzedawca (wydawca lub platforma po stronie dostawców) inicjuje aukcję reklam w ramach Protected Audience API w witrynie sprzedającej 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 nabywca jest właścicielem grupy zainteresowań.

Sprzedawca przekazuje przeglądarce kod do oceny stawek, który obejmuje wartość każdej stawki, adres URL kreacji reklamowej i inne dane zwracane przez kupującego. Podczas aukcji kod określania stawek od kupujących i kod wyniku ustalania stawek od sprzedawcy mogą otrzymywać dane z usług klucz-wartość. Po wybraniu i wyświetleniu reklamy (w ramce w obrębie ogrodzenia, by chronić prywatność), sprzedawca i wygrywający kupujący mogą zgłosić wynik aukcji.

  1. Użytkownik odwiedza witrynę, która wyświetla reklamy.
  2. Kod sprzedawcy rozpoczyna aukcję. Sprzedawca określa, która przestrzeń reklamowa jest na sprzedaż i kto może ustalać stawki, a także sposób oceniania tych stawek.
  3. Uruchamia się kod zaproszonego kupującego, by wygenerować stawkę, adres URL odpowiedniej kreacji reklamy i inne dane. Skrypt ustalania stawek może wysyłać zapytania o dane dostępne w czasie rzeczywistym, takie jak pozostały budżet kampanii reklamowej, z usługi kluczy/wartości kupującego.
  4. Kod sprzedawcy przyznaje 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órej nie można pokonać kontekstową zwycięskią reklamą. 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 ustawiona jest flaga resolveToConfig, zwycięska reklama jest zwracana jako obiekt konfiguracji ramki ogrodzonej. Konfiguracja służy do przejścia między ogrodzoną ramką do kreacji, a jej adres URL 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 w postaci nieprzejrzystego parametru URN, którego można użyć do renderowania reklamy w elemencie iframe. Obiekt konfiguracji ramki ogrodzonej jest dostępny od wersji M114.
  6. Informacje o aukcji są przekazywane sprzedawcy i kupującym.

Omawiamy mechanizm zgłaszania utraconych 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ść interfejsu Protected Audience API i innych usługach znajdziesz w artykule Usługi Protected Audience API.

Usługa klucz/wartość jest wdrożona w infrastrukturze w chmurze danej technologii reklamowej i działa w zaufanym środowisku wykonawczym. Żądanie do usługi klucz/wartość nie może skutkować rejestrowaniem na poziomie zdarzenia ani powodować innych skutków ubocznych. Usługa klucz/wartość będzie też obsługiwać funkcje zdefiniowane przez użytkownika (UDF), które umożliwiają specjalistom ds. technologii reklamowych wykonywanie własnej niestandardowej logiki w usłudze klucz/wartość.

Kupujący lub sprzedawca dostarcza listę „kluczy” pozwalających określić dane, których wymaga usługa w usłudze Protected Audience API. Usługa klucz/wartość w odpowiedzi 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ć programiści Chrome i Androida.

Więcej informacji o usłudze klucz/wartość interfejsu Protected Audience API znajdziesz w objaś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 klucz-wartość 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 metodę navigator.runAdAuction(), przekazuje adres URL swojej usługi klucz/wartość. Wysłanie zapytania do usługi pary klucz-wartość sprzedawcy przy użyciu adresu URL renderowania kreacji.

Do testów wstępnych używany jest model „Przynieś własny serwer”. W dłuższej perspektywie technologie reklamowe będą pobierać dane w czasie rzeczywistym z usług open source interfejsu Protected Audience API, działających w zaufanych środowiskach wykonawczych.

Aby zapewnić dostateczną ilość czasu na testy w ekosystemie, nie będziemy wymagać korzystania z usług typu open source 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 testowania i wdrażania.

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

Dane własne to dane należące do witryny należące do użytkowników. Jeśli na przykład użytkownik określił ulubiony kolor w witrynie reklamodawcy lub wydawcy, kolor ten jest uznawany za dane własne.

W ramach aukcji w ramach Protected Audience API reklamodawca może na podstawie danych własnych określić członkostwo w grupie zainteresowań, a także przekazywać do niej dane jako userBiddingSignals. Dane własne od reklamodawcy będą dostępne tylko dla kupujących na etapie generowania stawek i nie będą dostępne dla sprzedawców.

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ć swoje dane własne, ustawiając sygnały w konfiguracji aukcji podczas inicjowania aukcji, i może kontrolować, kto będzie je otrzymywać. Gdy wydawca przekazuje dane własne jako auctionSignals, są one dostępne zarówno dla kupujących, jak i sprzedawców. Gdy dane są przekazywane jako sellerSignals, są dostępne tylko dla sprzedawcy, a przekazywane 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ępnić i jak je sformatować.

W tym przykładzie opisano sposób przekazywania danych własnych przez wydawcę 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 nim.

Opracowaliśmy przewodnik dla programistów po interfejsach API i stworzyliś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