Omówienie interfejsu Protected Audience API

Aukcje reklam na urządzeniu, które pozwalają wyświetlać reklamy remarketingowe i niestandardowe grupy odbiorców bez konieczności korzystania z funkcji śledzenia przez inne firmy w różnych witrynach.

Dla kogo jest ten artykuł?

W tym artykule znajdziesz podstawowe informacje o interfejsie Protected Audience API oraz ale nie wdając się w szczegóły techniczne.

Sprawdź słowniczek, w którym znajdziesz terminy używane w różnych językach dokumentacja Protected Audience API. Na końcu tego artykułu dowiesz się, jak: angażować użytkowników i przekazywać opinie.

Czym jest interfejs Protected Audience API?

Protected Audience API to Piaskownica prywatności do obsługi remarketingu i niestandardowych list odbiorców. inne firmy nie mogą śledzić zachowania użytkowników w różnych witrynach.

Interfejs Protected Audience API umożliwia przeglądarce wybór trafnych reklam na aukcjach na urządzeniu odwiedzonych wcześniej stron internetowych.

Protected Audience API to pierwszy eksperyment, który zostanie zaimplementowany w Chromium Rodzina ofert pakietowych TURTLEDOVE. różnica między Protected Audience API a TURTLEDOVE dotyczy głównie rozdzielenia rolę kupującego i sprzedawcy na urządzeniu. W sekcjach poniżej wyjaśniamy, Protected Audience API działa.

Interfejs Protected Audience API za minutę

Więcej informacji o interfejsie Protected Audience API znajdziesz w Przewodnik dla programistów 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 wykorzystuje grupy zainteresowań, aby umożliwić witrynom wyświetlać użytkownikom trafne reklamy.

Na przykład, gdy 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 grupie zainteresowań. Jeśli żądanie zostanie zrealizowane, przeglądarka zarejestruje:

  • Nazwa grupy zainteresowań, na przykład „rowery-niestandardowe”.
  • Właściciel grupy zainteresowań, na przykład „https://dsp.example”.
  • Informacje o konfiguracji grupy zainteresowań, które umożliwiają przeglądarce dostęp kod określania stawek, kod reklamy i dane w czasie rzeczywistym, jeśli właściciel grupy jest zaproszony do stawki w aukcji reklam.
.

Później, gdy użytkownik odwiedzi witrynę z dostępną przestrzenią reklamową, sprzedawca przestrzeni reklamowej (dostawcy platformy SSP lub witryna) może wykorzystać Protected Audience API do przeprowadzenia aukcji reklam w celu wybrania najbardziej odpowiednich reklam. które mają być wyświetlane użytkownikowi. Sprzedawca wywołuje navigator.runAdAuction() , która zapewnia listę właścicieli grup zainteresowań zaproszonych do ustalania stawek.

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

Kod ustalania stawek jest pobierany z adresu URL podanego w tagu grupy zainteresowań konfiguracji. Ten kod dostarcza dane o grupie zainteresowań oraz informacji od sprzedawcy oraz danych kontekstowych na temat i w przeglądarce.

Każda grupa zainteresowań określająca stawkę jest nazywana kupującym.

Gdy przeglądarka wywołuje funkcję, by przeprowadzić aukcję reklam, kod każdego kupującego ustala stawkę na podstawie danych w czasie rzeczywistym dostarczanych przez Usługa kluczy i wartości w Protected Audience API Następnie sprzedawca otrzymuje te stawki, jak również dane należące do sprzedawcy w czasie rzeczywistym i otrzymuje wyniki za każdym razem, stawkę. Aukcję wygrywa stawka z najwyższym wynikiem.

Zwycięska reklama jest wyświetlana w chroniona ramka. URL kreacji jest określony w stawce, a źródło musi być zgodne z listy podanej w konfiguracji grupy zainteresowań.

Sprzedawca może zgłosić wynik aukcji (reportResult()), a kupujący – mówią o swoich wygranych (reportWin()).

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

Dlaczego potrzebujemy interfejsu Protected Audience API?

Poznanie zainteresowań użytkowników może zwiększyć trafność reklam niż tylko ich wybór. reklam opartych na treści witryny (kierowanie kontekstowe) lub za pomocą informacji. dostarczane przez użytkownika do witryny, w której wyświetla się reklama (kierowanie na dane własne).

Tradycyjnie platformy reklamowe poznają zainteresowania użytkowników, śledząc ich i ich zachowania w różnych witrynach. Przeglądarki muszą umożliwiać wybór platform reklamowych odpowiednich reklam, dzięki czemu wydawcy treści mogą uzyskiwać przychody z reklam bez konieczności przechodzenia do wielu witryn śledzenie konwersji.

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

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 przez włączanie i wyłączanie ustawienia najwyższego poziomu w chrome://settings/adPrivacy Podczas testów wstępnych użytkownicy mogą zrezygnować z interfejsu Protected Audience API za pomocą Ustawienia Piaskownicy prywatności.

Chrome planuje umożliwić użytkownikom przeglądanie listy grup zainteresowań i zarządzanie nią do których zostali dodani na wszystkich odwiedzonych przez nich stronach. Podobnie jak w przypadku prywatności technologie piaskownicy, ustawienia użytkownika mogą ewoluować w odpowiedzi na opinie użytkowników, organy regulacyjne.

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 do zarządzania Protected Audience API i powiązane dane.

Osoby wywołujące interfejs API nie mają dostępu do członkostwa w grupie, gdy użytkownicy przeglądają w trybie incognito. a członkostwo jest usuwane, gdy użytkownik wyczyści dane 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ęć

Chcesz dowiedzieć się więcej o terminologii dotyczącej Protected Audience API? Zapoznaj się z Glosariusz Piaskownicy prywatności.

Co to jest grupa zainteresowań?

Grupa zainteresowań Protected Audience API reprezentuje grupę osób o wspólnych zainteresowaniach. odpowiadające liście remarketingowej.

Każda grupa zainteresowań w ramach Protected Audience API ma właściciela. Różne typy właścicieli mogą tworzyć: grupy zainteresowań i zastosowania w różnych sytuacjach.

Właściciel prosi przeglądarkę użytkownika o dodanie członkostwa w wybranej grupie zainteresowań przez funkcję JavaScript navigator.joinAdInterestGroup(), która zapewnia takie jak dane o reklamach dopasowanych do danej grupy zainteresowań oraz adres URL dla kodu JavaScript używanego do ustalania stawek. Dane grupy zainteresowań (takie jak reklamy) mogą być , a grupę zainteresowań można włączyć na maksymalnie 30 dni.

Typy grup zainteresowań

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

Właściciel Przykład Zainteresowanie Przykład Przypadki użycia
Reklamodawca Producent rowerów Produkty Osoby, które wyświetliły strony produktów dla określonej kategorii rowerów. remarketing wśród osób, którzy weszli wcześniej w interakcję z marką.
Wydawca Witryna z wiadomościami Treść Osoby, które czytają o jeździe na rowerze Wydawcy mogą wykorzystywać dane własne, aby umożliwić reklamodawcom aby kupować reklamy, które będą przydatne dla czytelników w witrynie. O należąca do wydawcy grupa zainteresowań może umożliwić wydawcom gdy przeglądają inne strony. Wydawcy mogą mieć możliwość pobierają opłaty za możliwość wyświetlania reklam określonym segmentom ich z całego świata.
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ń i nią zarządzać osób, które ich zdaniem są na rynku zainteresowanym produktem z określonej kategorii. Ta grupa zainteresowań można wykorzystać do reklamowania produktów na stronach oferujących produkty z danej kategorii (oraz z firmą zajmującą się technologiami reklamowymi).

Chrome zezwala na do 1000 grup zainteresowań na właściciela i do 1000 grup zainteresowań właścicieli. Ograniczenia te służą jako bariery, a nie podczas normalnego działania.

Kim jest kupujący?

W 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ła w imieniu samego siebie.
  • Platforma DSP: działająca w imieniu reklamodawców.
  • Właściciel grupy zainteresowań: pracuje dla wielu reklamodawców.

Nabywcy mają 3 zadania:

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

Te zadania są realizowane automatycznie za pomocą uruchamianego kodu dostarczonego przez kupującego podczas aukcji reklam w ramach Protected Audience API.

Gdy kupujący poprosi w przeglądarce użytkownika o dodanie grupy zainteresowań do grup, do których należy (poprzez wywołanie metody navigator.joinAdInterestGroup()) kupujący udostępnia przeglądarce:

  • Adres URL kodu określania stawek, który będzie używany, gdy sprzedawca przeprowadzi aukcję reklam.
  • Potencjalnie adresy URL kreacji reklamowych na potrzeby grupy zainteresowań. (Można dodać adresy URL reklam później z aktualizacją).
  • listę kluczy danych objętych zapytaniem oraz adres URL usługi kluczy/wartości kupującego. aby włączyć kod określania stawek i uzyskiwać dane w czasie rzeczywistym podczas aukcji.

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

Kto przeprowadza aukcję reklam?

Wiele podmiotów może wziąć udział w aukcji dotyczącej sprzedaży przestrzeni reklamowej.

Na przykład:

  • Wydawca treści: samoczynnie hostujący treści reklamy w swojej witrynie.
  • Platforma dostawców (SSP): współpraca z wydawcą i świadczenie innych usług.
  • Skrypt firmy zewnętrznej: działa 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 spełniają wymagania.
  • Logika aukcji: uruchamianie kodu JavaScript w worklety do obliczania docelowego wyniku dla każdej stawki.
  • Zgłosić wynik aukcji.

Te zadania są realizowane automatycznie za pomocą kodu dostarczonego przez sprzedawcę podczas inicjowania reklamy aukcji przez wywołanie funkcji JavaScript navigator.runAdAuction().

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

Poniższy diagram przedstawia każdy etap aukcji reklam w ramach Protected Audience API:

6 etapów aukcji reklam w ramach Protected Audience API
Etapy 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 stronie urządzenia, aby wybrać reklamę. Aby chronić prywatność, uruchamiany jest cały kod aukcji reklam od sprzedawcy i kupujących w izolowanych workletach JavaScriptu, które nie mogą komunikować się ze światem zewnętrznym.

Sprzedawca (wydawca lub platforma dostawcy) zainicjuje aukcję reklam z użyciem Protected Audience API w witrynie, która sprzedaje przestrzeń reklamową (np. ). Sprzedawca wybiera kupujących do udziału w aukcji, wskazuje, jaka przestrzeń jest na sprzedaż, i podaje dodatkowe kryteria reklamy. Każdy kupujący właściciel grupy zainteresowań.

Sprzedawca podaje przeglądarce kod do oceny stawek, w tym wartość każdej z nich, kreację reklamy i inne dane zwracane przez każdego kupującego. Podczas aukcji ustalanie stawek na podstawie kodu od kupujących, a kod oceny stawek od sprzedawcy może otrzymywać dane ze swojego Usługi kluczy i wartości. Po wybraniu reklamy wyświetlane (w ramce w celu zachowania prywatności), sprzedawca i zwycięzca aukcji mogą zgłosić wynik aukcji.

  1. Użytkownik odwiedza witrynę, w której wyświetlane są reklamy.
  2. Kod sprzedawcy rozpoczyna aukcję. Sprzedawca określa, która przestrzeń reklamowa na sprzedaż i kto może ustalać stawki, a także metodę ich ustalania.
  3. Kod zaproszonego kupującego jest uruchamiany, by wygenerować stawkę, adres URL odpowiedniej reklamy kreacji i innych danych. Skrypt określania stawek może wysyłać zapytania o dane w czasie rzeczywistym, np. pozostały budżet kampanii reklamowej, z kolumny Klucz/wartość kupującego usługi.
  4. Kod sprzedawcy podaje ocenę w przypadku każdej stawki i wybiera zwycięzcę. Ta logika wykorzystuje wartość stawki oraz inne dane, by zwrócić atrakcyjność stawki i odrzucić reklamę, która lepszej niż zwycięskiej reklamy kontekstowej. Sprzedawca może użyć własnej Usługa kluczy-wartości na potrzeby danych w czasie rzeczywistym. Przed rozpoczyna się aukcja, sprzedawca znajduje najlepszą reklamę kontekstową dostępną boks reklamowy.
  5. Zwycięska reklama jest zwracana jako obiekt konfiguracji ramki ogrodzonej, gdy w konfiguracji aukcji jest ustawiona flaga resolveToConfig. Konfiguracja ta służy do przechodzenia między ramką zabezpieczoną do kreacji reklamy, przy czym adres URL kreacji jest ukryty zarówno dla sprzedawcy, jak i dla wydawcy. Jeśli flaga resolveToConfig jest ustawiona na false lub nie została przekazana, zwycięska reklama jest zwracana jako nieprzezroczysta reklama URN, której można użyć do renderowania reklamy w elemencie iframe. Obiekt konfiguracji ramki zabezpieczonej jest dostępny od wersji M114.
  6. Aukcja jest zgłaszana sprzedawcy i zwycięskiemu kupującym.

Mechanizm raportowania utraty kupujących jest w trakcie dyskusji.

Czym jest usługa kluczy/wartości interfejsu Protected Audience API?

Usługa kluczy i wartości interfejsu Protected Audience API umożliwia technikom reklamowym wysyłanie zapytań o dane w czasie rzeczywistym, gdy kupujący ustala stawkę, a sprzedawcom – ocenianie reklam przy zachowaniu prywatności. Więcej informacji o usłudze kluczy i wartości interfejsu Protected Audience API oraz innych znajdziesz w artykule Usługi Protected Audience API.

Usługa klucz-wartość jest wdrożona w infrastrukturze chmury własnej technologii reklamowej, która działa w zaufanym środowisku wykonawczym. Żądanie do usługi klucz-wartość nie może powodować rejestrowania na poziomie zdarzenia ani powodować innych efektów ubocznych. Usługa kluczy/wartości obsługuje też funkcje zdefiniowane przez użytkownika (UDF), które pozwalają technikom reklamowym uruchamiać własną logikę w ramach usługi kluczy i wartości.

Kupujący lub sprzedawca podaje listę „kluczy” w celu określania wymaganych danych za pomocą usługi kluczy i wartości interfejsu Protected Audience API. Usługa kluczy/wartości w odpowiedzi przesyła wartość dla każdego klucza.

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

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

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

Kupujący lub sprzedawca biorący udział w aukcji reklam mogą potrzebować dostępu do danych w czasie rzeczywistym. i skalowalnych danych. Na przykład kupujący mogą obliczyć pozostały budżet kampanii reklamowej. sprzedawca może zostać poproszony o sprawdzenie kreacji pod kątem zgodności z zasadami wydawcy.

Aby spełnić wymagania dotyczące prywatności określone w interfejsie Protected Audience API, dane w czasie rzeczywistym wymagane podczas aukcji reklam są dostarczane przez usługę kluczy i wartości. Gdy każdy kupujący wywołuje metodę navigator.joinAdInterestGroup(), określa adres URL usługi kluczy/wartości i klucze, które będą 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 klucz-wartość. Usługa kluczy i wartości sprzedawcy zostanie przesłana w zapytaniu o adres URL renderowania kreacji.

Do testów początkowych służy model „przynieś własny serwer”. W dłuższej perspektywie do pobierania danych w czasie rzeczywistym specjaliści ds. technologii reklamowych będą musieli korzystać z usług kluczy i wartości interfejsu Protected Audience API na licencji open source, które działają w zaufanych środowiskach wykonawczych.

Aby zapewnić wystarczającą ilość czasu na testowanie ekosystemu, nie będziemy wymagać korzystania z usług kluczy i wartości open source ani zaufanych środowisk wykonawczych, dopóki nie nastąpi wycofanie plików cookie innych firm. Przed dokonaniem tej zmiany powiadomimy deweloperów o możliwości rozpoczęcia testowania i wdrażania nowych funkcji.

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

Dane własne to dane należące do witryny dotyczące użytkowników. Jeśli np. użytkownik określił ulubiony kolor w witrynie reklamodawcy lub wydawcy, jest on uważany za dane własne.

W aukcji z Protected Audience API reklamodawca może na podstawie swoich danych własnych określić przynależność do grupy zainteresowań związanych z reklamami, a także przekazywać dane do grupy zainteresowań jako userBiddingSignals. Dane własne od reklamodawcy będą dostępne tylko dla kupujących na etapie generowania stawki, a sprzedawcy nie.

Jeśli na przykład reklamodawca zna ulubiony kolor użytkownika, podczas dodawania użytkownika do grupy zainteresowań można ustawić wartość userBiddingSignals w konfiguracji 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ć swoje dane własne, ustawiając sygnały w konfiguracji aukcji podczas inicjowania aukcji, oraz decydować, kto będzie otrzymywać te dane. Gdy wydawca przekazuje dane własne w formacie auctionSignals, są one dostępne zarówno dla kupujących, jak i dla sprzedawców. Po przekazaniu danych jako sellerSignals są one dostępne tylko dla sprzedawcy, a gdy 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ć, które dane własne muszą zostać udostępnione i jak należy je sformatować.

Ten przykład opisuje, 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

Więcej informacji o interfejsie Protected Audience API znajdziesz w Przewodnik dla programistów interfejsu Protected Audience API.

Programiści

Jeśli chcesz zacząć korzystać z interfejsu Protected Audience API, przeczytaj eksperymentuj i bierz udział w testach.

Przygotowaliśmy przewodnik dla programistów interfejsu API i utworzyliśmy prezentację interfejsu Protected Audience API, która zawiera przewodnik po podstawowym wdrożeniu tego interfejsu. Film demonstracyjny 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 odbiorców i dziel się opiniami