Omówienie interfejsu Protected Audience API

Aukcje reklam na urządzeniu, aby wyświetlać reklamy remarketingowe i kierowane na niestandardowe listy odbiorców bez śledzenia użytkowników w różnych witrynach przez firmy zewnętrzne.

Dla kogo jest przeznaczony ten dokument?

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

• Jeśli pracujesz w branży reklamowej lub technologii reklamowych, otrzymasz ogólny opis działania Protected Audience.
• Jeśli jesteś programistą lub inżynierem oprogramowania, w przewodniku dla programistów Protected Audience API znajdziesz więcej szczegółowych informacji technicznych na temat tego interfejsu. Zapoznaj się z najnowszym stanem funkcji Protected Audience, które są w trakcie opracowywania.

Terminy używane w dokumentacji dotyczącej list odbiorców chronionych znajdziesz w słowniczku. W końcu tego dokumentu znajdziesz informacje o tym, jak uzyskiwać i udostępniać opinie.

Czym jest interfejs Protected Audience API?

Interfejs Protected Audience API to technologia Piaskownica prywatności służąca do wyświetlania reklam remarketingowych i reklam kierowanych na niestandardowe listy odbiorców. Została zaprojektowana tak, aby firmy 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, aby wybierać trafne reklamy z witryn, które użytkownik wcześniej odwiedził.

Interfejs Protected Audience API to pierwszy eksperyment, który zostanie zaimplementowany w Chromium w ramach rodziny propozycji TURTLEDOVE. Różnica między Protected Audience a TURTLEDOVE dotyczy przede wszystkim rozdzielenia ról kupującego i sprzedającego reklamy na urządzeniu. W następnych sekcjach opisujemy, jak działa interfejs Protected Audience API.

Protected Audience API w 1 minucie

Szczegółowe informacje o interfejsie Protected Audience API znajdziesz w przewodniku dla programistów.

Interfejs Protected Audience API korzysta z grup zainteresowań, aby umożliwić witrynom wyświetlanie reklam, które są trafne dla użytkowników.

Jeśli 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 zrealizowana, przeglądarka rejestruje:

• 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 ustalania stawek, kodu reklamy i danych w czasie rzeczywistym, jeśli właściciel grupy jest zaproszony do określania stawek w aukcji reklam.

Gdy później użytkownik odwiedzi witrynę z dostępną przestrzenią reklamową, sprzedawca tej przestrzeni (dostawca 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 licytowania.

Stawki mogą być podawane tylko przez grupy zainteresowań, których członkiem jest przeglądarka i których właściciele zostali zaproszeni do określania stawek.

Kod określania stawek jest pobierany z adresu URL podanego w konfiguracji grupy zainteresowań. Ten kod udostępnia 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 podaje stawkę, jest nazywana kupującym.

Gdy przeglądarka wywołuje funkcję, aby przeprowadzić aukcję reklam, kod każdego kupującego generuje stawkę za pomocą danych w czasie rzeczywistym udostępnianych przez usługę kluczy i wartości Protected Audience. Następnie sprzedawca otrzymuje te stawki oraz dane w czasie rzeczywistym, które mu przysługują, i przypisuje każdej stawce odpowiednią wartość. Stawka z najwyższym wynikiem wygrywa aukcję.

Wygrana reklama wyświetla się w ramce z ograniczeniem. 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 przez konfigurację grupy zainteresowań.

Sprzedawca może podać wynik aukcji (reportResult()), a kupujący mogą podać swoje wygrane (reportWin()).

Dowiedz się więcej o raportach aukcji Protected Audience.

Dlaczego potrzebujemy interfejsu Protected Audience API?

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

Platformy reklamowe tradycyjnie zdobywały informacje o interesach użytkowników, śledząc ich zachowania w różnych witrynach. Przeglądarki muszą umożliwiać platformom reklamowym wybieranie odpowiednich reklam, aby wydawcy treści mogli uzyskiwać przychody z reklam bez śledzenia między witrynami.

Interfejs Protected Audience API ma na celu doprowadzenie platformy internetowej do stanu, w którym przeglądarka użytkownika na jego urządzeniu, a nie reklamodawca czy platformy technologiczne reklam, będzie przechowywać informacje o tym, czym dana osoba się interesuje.

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

• Przewodnik dla deweloperów Protected Audience API zawiera informacje o używaniu interfejsu API i testowaniu lokalnym.

• protected-audience-demo.web.app zawiera instrukcje podstawowego wdrożenia Protected Audience w witrynach reklamodawcy i wydawcy. Film instruktażowy Protected Audience pokazuje, jak działa ten kod, oraz jak używać narzędzi deweloperskich w Chrome do debugowania.

Jaka konfiguracja przeglądarki jest dostępna?

Użytkownicy mogą dostosować swoje uczestnictwo 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, korzystając z ustawień Piaskownicy prywatności.

Chrome umożliwi użytkownikom wyświetlanie listy grup zainteresowań, do których zostali dodani, oraz zarządzanie nią. Podobnie jak w przypadku technologii Piaskownicy prywatności ustawienia użytkownika mogą się zmieniać pod wpływem opinii użytkowników, organów regulacyjnych i innych osób.

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

Interfejsy API nie mają dostępu do członkostwa w grupach, gdy użytkownicy przeglądają treści w trybie incognito. Członkostwo jest usuwane, gdy użytkownicy usuwają 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 interfejsem Protected Audience? Zapoznaj się z słownikiem Piaskownicy prywatności.

Czym jest grupa zainteresowań?

Grupa zainteresowań Protected Audience API to grupa osób o wspólnym zainteresowaniu, odpowiadająca 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ń do różnych zastosowań.

Właściciel prosi przeglądarkę użytkownika o dodanie go do grupy zainteresowań, wywołując funkcję JavaScript navigator.joinAdInterestGroup(), podając informacje takie jak dane o reklamach istotnych dla grupy zainteresowań oraz adres URL kodu JavaScript używanego do określania stawek. Dane grupy odbiorców o podobnych zainteresowaniach (np. reklamy) można aktualizować, a grupę można włączyć na okres do 30 dni.

Typy grup zainteresowań

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

Chrome zezwala na maksymalnie 1000 grup zainteresowań na właściciela i na maksymalnie 1000 właścicieli grup zainteresowań. Te limity są jak poręcze, których nie należy dotykać 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 ustala stawki w aukcji reklam.

Na przykład:

• Reklamodawca: działa w swojej sprawie.
• Platforma DSP: działa na rzecz reklamodawców.
• Właściciel grupy zainteresowań: działa na rzecz wielu reklamodawców.

Kupujący mają 3 zadania:

• Wybierz, czy chcesz wziąć udział w aukcji.
• Wybierz reklamy i oblicz stawkę.
• Wyświetl wynik aukcji.

Te zadania są wykonywane automatycznie w ramach kodu dostarczonego przez kupującego, który jest uruchamiany podczas aukcji reklamy w Protected Audience API.

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

• Adres URL kodu określania stawek, który będzie używany, gdy sprzedawca przeprowadzi aukcję reklam.
• Możliwe, że będą to adresy URL kreacji reklam dla grupy zainteresowań. (adresy URL reklam mogą zostać dodane później w ramach aktualizacji).
• Lista kluczy danych, które mają być zapytane, oraz adres URL usługi klucz-wartość kupującego, aby umożliwić kodom ustalania stawek uzyskiwanie danych w czasie rzeczywistym podczas aukcji.

Kod kupującego może też zawierać funkcję reportWin(), która przekazuje informacje o wyniku aukcji.

Kto przeprowadza aukcję reklam?

Aukcje na potrzeby sprzedaży miejsca na reklamę mogą prowadzić różne podmioty.

Na przykład:

• Wydawca treści: podmiot, który w swojej witrynie hostuje treści reklamowe.
• Platforma dostawców reklam: współpraca z wydawcą i świadczenie innych usług.
• Skrypt firmy zewnętrznej: działa w imieniu wydawcy, aby umożliwić udział w aukcjach reklam.

W interfejsie Protected Audience API sprzedawca miejsca reklamowego ma 3 obowiązki:

• Wdrażanie zasad wydawcy: określanie, którzy kupujący i które stawki kwalifikują się do wyświetlania reklam.
• Wykonywanie logiki aukcji: kod JavaScript jest uruchamiany w workletach w celu obliczenia wyniku atrakcyjności dla każdej stawki.
• Wyświetl wynik aukcji.

Te zadania są wykonywane automatycznie w kodzie dostarczonym przez sprzedawcę, gdy inicjuje on aukcję reklamy przez wywołanie funkcji JavaScript navigator.runAdAuction().

Jak działa aukcja reklam w interfejsie Protected Audience API?

Na poniższym diagramie przedstawiono poszczególne etapy aukcji reklamy w ramach interfejsu 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 od sprzedawcy i kupujących jest uruchamiany w odizolowanych elementach roboczych JavaScriptu, które nie mogą komunikować się ze światem zewnętrznym.

Sprzedawca (wydawca lub platforma po stronie podaży) inicjuje aukcję reklamy w ramach Protected Audience w witrynie, która sprzedaje przestrzeń reklamową (np. witryna z wiadomościami). Sprzedawca wybiera kupujących, którzy będą uczestniczyć w aukcji, wskazuje, jaka przestrzeń jest na sprzedaż, oraz podaje dodatkowe kryteria reklamy. Każdy kupujący jest właścicielem grupy zainteresowań.

Sprzedawca udostępnia przeglądarce kod do oceny stawek, który zawiera wartość każdej stawki, URL kreacji reklamy i inne dane zwracane przez każdego kupującego. Podczas aukcji kod licytowania kupujących i kod określania wartości ofert sprzedawcy mogą otrzymywać dane z usług klucz-wartość. Gdy reklama zostanie wybrana i wyświetlona (w ramce zabezpieczonej w celu zachowania prywatności), sprzedawca i wygrywający 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ż, kto może licytować, a także metodę oceniania stawek.
3. Kod zaproszonego kupującego jest wykonywany w celu wygenerowania stawki, adresu URL odpowiedniej kreacji reklamy i innych danych. Skrypt ustalania 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 korzysta z wartości stawki i innych danych, aby zwrócić wartość pożądania 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 danych w czasie rzeczywistym. Przed rozpoczęciem aukcji sprzedawca znajduje najlepszą reklamę kontekstową dla dostępnego boksu reklamowego.
5. Zwycięska reklama jest zwracana jako obiekt konfiguracji ramki ograniczonej, gdy w konfiguracji aukcji ustawiono flagę resolveToConfig. Konfiguracja służy do przechodzenia z ramki wydzielonej do kreacji reklamy, a adres URL kreacji jest ukryty zarówno przed sprzedawcą, jak i wydawcą. Jeśli flaga resolveToConfig ma wartość false lub nie jest przekazywana, reklama zwycięska jest zwracana jako nieprzezroczysty URN, który można wykorzystać do renderowania reklamy w ramce iframe. Obiekt konfiguracji klatki odizolowanej jest dostępny od wersji M114.
6. Aukcja jest raportowana sprzedawcy i kupującym, którzy wygrali.

Mechanizm zgłaszania utraty kupujących jest w trakcie opracowywania.

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

Usługa Protected Audience API Key/Value umożliwia zespołom ds. technologii reklamowych wysyłanie zapytań o dane w czasie rzeczywistym, gdy kupujący określa stawkę, oraz umożliwia sprzedawcom ocenianie reklam przy jednoczesnym zachowaniu prywatności. Więcej informacji o usłudze Protected Audience API Key/Value oraz innych usługach znajdziesz w artykule Usługi Protected Audience API.

Usługa klucz-wartość jest wdrażana w ramach własnej infrastruktury chmurowej dostawcy technologii reklamowych i działa w zaufanym środowisku wykonania. Żądanie wysłane do usługi kluczy/wartości nie może spowodować rejestrowania na poziomie zdarzenia ani mieć innych efektó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 niej własnej logiki niestandardowej.

Kupujący lub sprzedający udostępnia listę „kluczy”, aby określić dane, których potrzebuje od usługi kluczy/wartości interfejsu Protected Audience API. Usługa kluczy/wartości 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ć deweloperzy Chrome i Androida.

Więcej informacji o usłudze kluczy/wartości w Protected Audience API znajdziesz w opisie interfejsu API i opisie modelu zaufania.

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

Kupujący lub sprzedawca w ramach aukcji reklam mogą potrzebować dostępu do danych w czasie rzeczywistym. Na przykład kupujący może chcieć obliczyć pozostały budżet w kampanii reklamowej, a sprzedawca może być zobowiązany do sprawdzenia kreacji reklam 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 URL usługi klucz-wartość i klucze, które mają być wysyłane do usługi podczas aukcji. Podobnie, gdy sprzedawca przeprowadza aukcję reklam, wywołując funkcję navigator.runAdAuction(), podaje adres URL swojej usługi par klucz-wartość. Usługa klucza/wartości sprzedawcy zostanie zapytana o adres URL renderowania kreacji.

Do wstępnego testowania używany jest model „przynieś własny serwer”. W długim okresie dostawcy technologii reklamowych będą musieli używać usług klucz-wartość interfejsu Protected Audience API, które są dostępne w ramach zaufanych środowisk wykonania, do pobierania danych w czasie rzeczywistym.

Aby zapewnić ekosystemowi wystarczająco dużo czasu na przetestowanie, nie wymagamy korzystania z usług klucz-wartość na licencji open source ani z zaufanych środowisk wykonywania do czasu, gdy ciasteczka innych firm zostaną wycofane. Zanim wprowadzimy tę zmianę, powiadomimy deweloperów o tym z odpowiednim wyprzedzeniem, aby mogli rozpocząć testowanie i wdrażanie.

Jak dane własne są używane w ramach aukcji Protected Audience?

Dane własne to dane o użytkownikach należące do witryny. Jeśli np. użytkownik w witrynie reklamodawcy lub wydawcy poda swój ulubiony kolor, będzie on traktowany jako dane własne.

W aukcji z zabezpieczonymi danymi o odbiorcach reklamodawca może używać danych własnych do określania przynależności do grupy odbiorców o tych samych zainteresowaniach, a także przekazywać dane do tej grupy jako userBiddingSignals. Dane własne reklamodawcy będą dostępne tylko dla kupujących na etapie generowania stawek, a nie dla sprzedawców.

Jeśli np. reklamodawca zna ulubiony kolor użytkownika, po dodaniu go do grupy zainteresowań w konfiguracji grupy zainteresowań można ustawić wartość 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, ustawiając sygnały w konfiguracji aukcji podczas inicjowania aukcji. Może też kontrolować, kto otrzymuje dane własne. 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 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 jak je formatować.

Ten 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.

Programiści

Jeśli chcesz zacząć korzystać z interfejsu Protected Audience API, przeczytaj artykuł Eksperymentuj i ucz się.

Opublikowaliśmy przewodnik dla programistów dotyczący interfejsu Protected Audience API oraz udostępniliśmy demo Protected Audience API, które zawiera podstawowe informacje o wdrażaniu tego interfejsu. Film z prezentacją Protected Audience API zawiera omówienie działania kodu demonstracyjnego i wskazówki dotyczące korzystania z narzędzia Chrome DevTools do debugowania interfejsu Protected Audience API.

Zaangażowanie i przesyłanie opinii

• GitHub przeczytaj informacje, zadawaj pytania i obserwuj dyskusję.
• Ogłoszenia: dołącz do listy mailingowej Protected Audience API lub przeglądaj wcześniejsze ogłoszenia.
• W3C: omawiaj przypadki użycia w branży w grupie biznesowej „Improving Web Advertising”.
• Pomoc dla deweloperów: zadawaj pytania dotyczące implementacji i sprawdzonych metod lub dołącz do dyskusji na repozytorium Piaskownicy prywatności dla deweloperów.
• Obecna implementacja: jeśli masz pytania dotyczące implementacji Protected Audience w Chrome, zgłoś błąd w Chromium.