Omówienie interfejsu Protected Audience API

Aukcje reklam na urządzeniu, które umożliwiają wyświetlanie reklam remarketingowych i reklam kierowanych na niestandardowe grupy odbiorców bez śledzenia użytkowników w witrynach przez firmy zewnętrzne.

Dla kogo jest ten dokument?

Ten dokument zawiera podstawowe informacje o interfejsie Protected Audience API i wyjaśnia niektóre podstawowe koncepcje, ale nie zawiera wielu szczegółów technicznych.

Terminy używane w dokumentacji Protected Audience znajdziesz w słowniczku. Na końcu tego dokumentu znajdziesz informacje o tym, jak przesłać opinię.

Czym jest interfejs Protected Audience API?

Interfejs Protected Audience API to technologia Piaskownicy prywatności, która umożliwia obsługę remarketingu i niestandardowych przypadków użycia list odbiorców. Została zaprojektowana tak, aby podmioty zewnętrzne nie mogły śledzić zachowań użytkowników w różnych witrynach.

Interfejs Protected Audience API umożliwia przeglądarce przeprowadzanie aukcji na urządzeniu w celu wybierania trafnych reklam z witryn, które użytkownik odwiedził wcześniej.

Interfejs Protected Audience API to pierwszy eksperyment wdrożony w Chromium w ramach rodziny propozycji TURTLEDOVE. Różnica między Protected Audience a TURTLEDOVE dotyczy przede wszystkim rozdzielenia ról kupującego i sprzedawcy reklam na urządzeniu. W kolejnych sekcjach wyjaśniamy, jak działa interfejs Protected Audience API.

Interfejs Protected Audience API w minutę

Szczegółowe informacje o interfejsie Protected Audience API znajdziesz w przewodniku dla programistów korzystających z interfejsu Protected Audience API.

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

Interfejs Protected Audience API korzysta z grup zainteresowań, aby umożliwić witrynom wyświetlanie reklam trafnych 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ć przeglądarkę użytkownika o dodanie go do tej grupy. Jeśli prośba zostanie rozpatrzona pozytywnie, przeglądarka zapisze:

  • Nazwa grupy zainteresowań, np. „custom-bikes”.
  • Właściciel grupy zainteresowań, np. „https://dsp.example”.
  • Informacje o konfiguracji grupy zainteresowań, aby umożliwić przeglądarce dostęp do kodu licytowania, kodu reklamy i danych w czasie rzeczywistym, jeśli właściciel grupy zostanie zaproszony do licytowania w aukcji reklam.

Gdy później użytkownik odwiedzi witrynę z dostępną przestrzenią reklamową, sprzedawca tej przestrzeni (platforma dostawców reklam (SSP) lub sama witryna) może użyć Protected Audience do przeprowadzenia aukcji reklam, aby wybrać najbardziej odpowiednie reklamy do wyświetlenia użytkownikowi. Sprzedawca wywołuje funkcję navigator.runAdAuction(), która udostępnia listę właścicieli grup zainteresowań zaproszonych do składania stawek.

Stawki mogą być podawane tylko przez grupy zainteresowań, do których należy przeglądarka, a których właściciele zostali zaproszeni do ustalania stawek.

Kod określania stawek jest pobierany z adresu URL podanego w konfiguracji grupy zainteresowań. Ten kod zawiera dane o grupie zainteresowań i informacje od sprzedawcy, a także dane kontekstowe o stronie i z przeglądarki.

Każda grupa zainteresowań, która przesyła stawkę, jest nazywana kupującym.

Gdy przeglądarka wywołuje funkcję, aby przeprowadzić aukcję reklam, kod każdego kupującego generuje stawkę przy użyciu danych w czasie rzeczywistym dostarczonych przez usługę klucz/wartość Protected Audience. Następnie sprzedawca otrzymuje te stawki oraz dane w czasie rzeczywistym i ocenia każdą z nich. Aukcję wygrywa stawka z najwyższym wynikiem.

Zwycięska reklama jest wyświetlana w izolowanej ramce. Adres URL kreacji reklamy jest określony w stawce, a źródło musi być zgodne z jednym z adresów na liście podanej w konfiguracji grupy zainteresowań.

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

Dowiedz się więcej o raportach z aukcji z użyciem Protected Audience API.

Dlaczego potrzebujemy interfejsu Protected Audience API?

Zrozumienie zainteresowań użytkowników może umożliwić wyświetlanie bardziej trafnych reklam niż tylko wybieranie reklam na podstawie treści witryny (kierowanie kontekstowe) lub na podstawie informacji podanych przez użytkownika w witrynie, w której wyświetla się reklama (kierowanie na podstawie danych własnych).

Tradycyjnie platformy reklamowe poznawały zainteresowania użytkowników, śledząc ich zachowania w różnych witrynach. Przeglądarki potrzebują sposobu, aby umożliwić platformom reklamowym wybieranie trafnych reklam, dzięki czemu wydawcy treści mogą uzyskiwać przychody z reklam bez śledzenia w różnych witrynach.

Interfejs Protected Audience API ma na celu zbliżenie platformy internetowej do stanu, w którym to przeglądarka użytkownika na jego urządzeniu, a nie reklamodawca czy platformy technologii reklamowych, przechowuje informacje o tym, co interesuje daną osobę.

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

Jakie konfiguracje przeglądarki są dostępne?

Użytkownicy mogą dostosowywać swój udział w testach Piaskownicy prywatności w Chrome, włączając lub wyłączając ustawienie najwyższego poziomu w chrome://settings/adPrivacy. W początkowej fazie testów użytkownicy mogą zrezygnować z interfejsu Protected Audience API w ustawieniach Piaskownicy prywatności.

Chrome planuje umożliwić użytkownikom wyświetlanie listy grup zainteresowań, do których zostali dodani w różnych odwiedzanych witrynach, i zarządzanie nią. Podobnie jak w przypadku technologii Piaskownicy prywatności, ustawienia użytkownika mogą się zmieniać w zależności od opinii użytkowników, organów regulacyjnych i innych podmiotów.

W miarę rozwoju interfejsu Protected Audience API będziemy aktualizować dostępne w Chrome ustawienia na podstawie testów i opinii. W przyszłości udostępnimy bardziej szczegółowe ustawienia do zarządzania interfejsem Protected Audience API i powiązanymi z nim danymi.

Wywołujący interfejs API nie mają dostępu do członkostwa w grupach, gdy użytkownicy przeglądają internet w trybie incognito, a członkostwo jest usuwane, gdy użytkownicy wyczyszczą dane witryny.

Czy mogę zrezygnować z używania interfejsu Protected Audience API?

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

Kluczowych pojęć

Chcesz dowiedzieć się więcej o terminologii związanej z Protected Audience? Zapoznaj się z słowniczkiem Piaskownicy prywatności.

Czym jest grupa interesu?

Grupa zainteresowań Protected Audience API to grupa osób o wspólnych zainteresowaniach, która odpowiada liście remarketingowej.

Każda grupa zainteresowań Protected Audience API ma właściciela. Różni właściciele będą tworzyć różne typy grup zainteresowań o różnych zastosowaniach.

Właściciel witryny prosi przeglądarkę użytkownika o dodanie go do grupy zainteresowań, wywołując funkcję JavaScriptu navigator.joinAdInterestGroup() i podając informacje takie jak dane o reklamach odpowiednich dla grupy zainteresowań oraz adres URL JavaScriptu używanego w licytowaniu. Dane grupy zainteresowań (np. reklamy) można aktualizować, a grupę zainteresowań można włączyć na maksymalnie 30 dni.

Typy grup zainteresowań

Tabela poniżej zawiera przykłady różnych typów grup zainteresowań Protected Audience API i ich właścicieli.

Właściciel Przykład Zainteresowanie Przykład Przypadki użycia
Reklamodawca Producent rowerów Produkty Użytkownicy, którzy wyświetlili strony produktów z określonej kategorii rowerów. Remarketing do osób, które wcześniej weszły w interakcję z marką.
Wydawca Witryna informacyjna Treść osoby czytające o kolarstwie; Wydawcy mogą używać danych własnych, aby umożliwić reklamodawcom kupowanie reklam, które są trafne dla czytelników ich witryny. Grupa zainteresowań należąca do wydawcy może umożliwiać wydawcom to samo, nawet gdy użytkownicy przeglądają inne witryny. Wydawcy mogą pobierać opłaty za możliwość wyświetlania reklam określonym segmentom odbiorców.
Technologia reklamowa (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 są zainteresowane daną kategorią produktów, i zarządzać tą grupą. Ta grupa zainteresowań może być następnie wykorzystywana do reklamowania produktów w witrynach, które sprzedają produkty z tej kategorii (i współpracują z firmą technologiczną zajmującą się reklamami).

Chrome zezwala na maksymalnie 1000 grup zainteresowań na właściciela i maksymalnie 1000 właścicieli grup zainteresowań. Te limity mają charakter ochronny i nie powinny być osiągane podczas normalnej pracy.

Kim jest kupujący?

W interfejsie Protected Audience API kupujący to podmiot, który jest właścicielem grupy zainteresowań i licytuje w aukcji reklam.

Na przykład:

  • Reklamodawca: działa we własnym imieniu.
  • Platforma DSP: działa w imieniu reklamodawców.
  • Właściciel grupy zainteresowań: współpracuje z wieloma reklamodawcami.

Kupujący mają 3 zadania:

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

Te zadania są wykonywane automatycznie w kodzie dostarczonym przez kupującego, który jest uruchamiany podczas aukcji reklamowej z użyciem Protected Audience API.

Gdy kupujący prosi przeglądarkę użytkownika o dodanie grupy zainteresowań do grup, których jest członkiem (wywołując funkcję JavaScript navigator.joinAdInterestGroup()), przekazuje jej:

  • Adres URL kodu określania stawek, który będzie używany, gdy sprzedawca przeprowadzi aukcję reklam.
  • Potencjalnie adresy URL kreacji reklamowych dla grupy odbiorców o podobnych zainteresowaniach. (Adresy URL reklam można dodać później w ramach aktualizacji).
  • Lista kluczy danych, o które chcesz wysłać zapytanie, oraz adres URL usługi klucz/wartość kupującego, aby umożliwić kodowi ustalania stawek uzyskiwanie danych w czasie rzeczywistym podczas aukcji.

Kod kupującego może też zawierać funkcję reportWin() do raportowania wyniku aukcji.

Kto przeprowadza aukcję reklam?

Aukcję sprzedaży miejsca na reklamę może przeprowadzić wiele podmiotów.

Na przykład:

  • Wydawca treści: działa we własnym imieniu, aby hostować treści reklamowe w swojej witrynie.
  • Platforma dostawców reklam (SSP): współpracuje z wydawcą i świadczy inne usługi.
  • Skrypt firmy zewnętrznej: działa w imieniu wydawcy, aby umożliwić mu udział w aukcjach reklam.

W przypadku interfejsu Protected Audience API sprzedawca miejsca na reklamę ma 3 zadania:

  • Wymuszanie reguł wydawcy: określanie, którzy kupujący i które stawki są kwalifikowane.
  • Uruchamianie logiki aukcji: kod JavaScript uruchamiany w workletach w celu obliczenia wyniku atrakcyjności każdej stawki.
  • zgłaszać wynik aukcji;

Te zadania są wykonywane automatycznie w kodzie dostarczonym przez sprzedawcę, gdy rozpoczyna on aukcję reklamową, wywołując funkcję JavaScriptu navigator.runAdAuction().

Jak przebiega aukcja reklam z użyciem interfejsu Protected Audience API?

Poniższy diagram przedstawia poszczególne etapy aukcji reklamowej z użyciem Protected Audience API:

6 etapów aukcji reklamowej z użyciem Protected Audience API
Etapy aukcji reklam z Protected Audience API

W interfejsie Protected Audience API aukcja reklam to zbiór małych programów w JavaScript, które przeglądarka uruchamia na urządzeniu użytkownika, aby wybrać reklamę. Aby chronić prywatność, cały kod aukcji reklam od sprzedawcy i kupujących jest uruchamiany w izolowanych workletach JavaScript, które nie mogą komunikować się ze światem zewnętrznym.

Sprzedawca (wydawca lub platforma po stronie sprzedaży) rozpoczyna aukcję reklamową Protected Audience w witrynie, która sprzedaje przestrzeń reklamową (np. w witrynie z wiadomościami). Sprzedawca wybiera kupujących, którzy wezmą udział w aukcji, określa, jaka przestrzeń reklamowa jest na sprzedaż, i podaje dodatkowe kryteria dotyczące reklamy. Każdy kupujący jest właścicielem grupy zainteresowań.

Sprzedawca udostępnia przeglądarce kod do oceniania stawek, który zawiera wartość każdej stawki, adres URL kreacji reklamowej i inne dane zwracane przez każdego kupującego. Podczas aukcji kod licytowania od kupujących i kod oceny ofert od sprzedawcy mogą otrzymywać dane z usług klucz/wartość. Gdy reklama zostanie wybrana i wyświetlona (w ramce ograniczonej, aby zachować prywatność), sprzedawca i kupujący, który wygrał aukcję, mogą zgłosić jej wynik.

  1. Użytkownik odwiedza witrynę, w której wyświetlają się reklamy.
  2. Kod sprzedawcy rozpoczyna aukcję. Sprzedawca określa, która przestrzeń reklamowa jest na sprzedaż, kto może licytować oraz metodę oceny tych stawek.
  3. Kod zaproszonego kupującego jest wykonywany w celu wygenerowania stawki, adresu URL odpowiedniego kreacji reklamy i innych danych. Skrypt określania stawek może wysyłać zapytania o dane w czasie rzeczywistym, takie jak pozostały budżet kampanii reklamowej, do usługi klucz/wartość kupującego.
  4. Kod sprzedawcy ocenia każdą stawkę i wybiera zwycięzcę. Ta logika wykorzystuje wartość stawki i inne dane, aby określić atrakcyjność stawki i odrzucić reklamę, która nie może pokonać zwycięskiej reklamy kontekstowej. Sprzedawca może używać własnej usługi klucz/wartość do przesyłania danych w czasie rzeczywistym. Zanim rozpocznie się aukcja, sprzedawca znajduje najlepszą reklamę kontekstową dla dostępnego boksu reklamowego.
  5. Zwycięska reklama jest zwracana jako obiekt konfiguracji ramki z ograniczeniami, gdy w konfiguracji aukcji ustawiona jest flaga resolveToConfig. Konfiguracja służy do przekierowania do kreacji reklamy w ramce ograniczonej, a adres URL kreacji jest ukryty zarówno przed sprzedawcą, jak i wydawcą. Jeśli flaga resolveToConfig ma wartość false lub nie została przekazana, zwycięska reklama jest zwracana jako nieprzezroczysty URN, którego można użyć do renderowania reklamy w ramce iframe. Obiekt konfiguracji ramki ograniczonej jest dostępny od wersji M114.
  6. Informacja o aukcji jest przekazywana sprzedawcy i kupującym, którzy wygrali.

Mechanizm raportowania dotyczący kupujących, którzy zrezygnowali z zakupu, jest w trakcie omawiania.

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

Usługa klucz/wartość interfejsu Protected Audience API umożliwia platformom reklamowym wysyłanie zapytań o dane w czasie rzeczywistym, gdy kupujący składa ofertę, a sprzedawcom – ocenianie reklam przy zachowaniu prywatności. Więcej informacji o usłudze klucz/wartość Protected Audience API i innych usługach znajdziesz w artykule Usługi Protected Audience API.

Usługa klucz/wartość jest wdrażana we własnej infrastrukturze chmurowej dostawcy technologii reklamowych i działa w zaufanym środowisku wykonawczym. Żądanie do usługi klucz/wartość nie może powodować rejestrowania na poziomie zdarzenia ani mieć innych efektów ubocznych. Usługa klucz-wartość będzie też obsługiwać funkcje zdefiniowane przez użytkownika, które umożliwiają platformom reklamowym wykonywanie własnej logiki niestandardowej w ramach tej usługi.

Kupujący lub sprzedawca podaje listę „kluczy”, aby określić dane, których potrzebuje z usługi klucz/wartość interfejsu Protected Audience API. Usługa klucz/wartość odpowiada wartością dla każdego klucza.

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

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

Jak dane w czasie rzeczywistym są uwzględniane w aukcjach?

Kupujący lub sprzedawca biorący udział w aukcji reklamowej mogą potrzebować dostępu do danych w czasie rzeczywistym. Na przykład kupujący mogą chcieć obliczyć pozostały budżet w kampanii reklamowej, a sprzedawca może być zobowiązany do sprawdzenia kreacji reklamowych pod kątem zgodności z zasadami wydawcy.

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 funkcję navigator.joinAdInterestGroup(), podaje adres URL usługi klucz/wartość i określa klucze, o które usługa ma wysyłać zapytania podczas aukcji. Podobnie, gdy sprzedawca przeprowadza aukcję reklam, wywołując funkcję navigator.runAdAuction(), podaje adres URL usługi klucz/wartość. Usługa klucz/wartość sprzedawcy zostanie zapytana o adres URL renderowania kreacji.

Do wstępnych testów używany jest model „Przynieś własny serwer”. W dłuższej perspektywie dostawcy technologii reklamowych będą musieli używać usług klucz/wartość Protected Audience API o otwartym kodzie źródłowym działających w zaufanych środowiskach wykonawczych do pobierania danych w czasie rzeczywistym.

Aby zapewnić ekosystemowi wystarczająco dużo czasu na testy, nie planujemy wymagać korzystania z usług klucz/wartość o otwartym kodzie źródłowym ani z zaufanych środowisk wykonawczych do czasu, aż po wycofaniu plików cookie innych firm. Zanim wprowadzimy tę zmianę, powiadomimy deweloperów z wyprzedzeniem, aby mogli rozpocząć testowanie i wdrażanie.

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

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

Na aukcji Protected Audience reklamodawca może używać danych własnych do określania przynależności do grupy zainteresowań, a także przekazywać dane do grupy zainteresowań jako userBiddingSignals. Dane własne reklamodawcy będą dostępne dla kupujących tylko na etapie generowania stawki, a nie dla sprzedawców.

Jeśli np. reklamodawca zna ulubiony kolor użytkownika, wartość można ustawić w konfiguracji grupy zainteresowań jako userBiddingSignals, gdy użytkownik zostanie dodany do grupy zainteresowań:

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, ustawiając sygnały w konfiguracji aukcji podczas jej inicjowania, i określać, kto ma otrzymywać te dane. Gdy wydawca przekaże dane własne jako auctionSignals, będą 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 gdy są przekazywane jako perBuyerSignals, są dostępne 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 jakim formacie.

Poniższy przykład pokazuje, jak wydawca może przekazywać dane własne różnym uczestnikom 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

Szczegółowe informacje o interfejsie Protected Audience API znajdziesz w przewodniku dla programistów korzystających z interfejsu Protected Audience API.

Programiści

Jeśli chcesz zacząć korzystać z interfejsu Protected Audience API, przeczytaj artykuł Eksperymentowanie i udział.

Przygotowaliśmy przewodnik dla deweloperów interfejsu APIdemonstrację interfejsu Protected Audience API, która zawiera opis podstawowego wdrożenia tego interfejsu. W filmie demonstracyjnym dotyczącym interfejsu Protected Audience API wyjaśniamy, jak działa kod demonstracyjny, i pokazujemy, jak używać Narzędzi deweloperskich w Chrome do debugowania interfejsu Protected Audience API.

Angażowanie się i przesyłanie opinii