Omówienie interfejsu Protected Audience API

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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 artykuł?

W tym artykule omawiamy podstawy interfejsu Protected Audience API i wyjaśniamy niektóre pojęcia, ale nie podajemy zbyt wielu szczegółów technicznych.

• Jeśli zajmujesz się reklamą lub technologią reklamową, poznasz zasady 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 chronionych list odbiorców znajdziesz w słowniczku. Na końcu tego artykułu znajdziesz informacje o tym, jak uzyskiwać i przekazywać opinie.

Czym jest interfejs Protected Audience API?

Interfejs Protected Audience API to technologia Piaskownicy prywatności, która umożliwia wyświetlanie reklam remarketingowych i reklam kierowanych na niestandardowe listy odbiorców. Została zaprojektowana tak, aby firmy zewnętrzne nie mogły śledzić aktywności 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 jest pierwszym eksperymentem wdrożonym 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ą istotne 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 żądanie zostało wykonane, 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 ustalania stawek.

Kod ustalania 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 chronionych danych o odbiorcach. Następnie sprzedawca otrzymuje te stawki, a także 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 ograniczeniami. Adres URL kreacji reklamy jest określony w stawce, a źródło musi pasować do jednego z źródeł 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 w przypadku list odbiorców chronionych.

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 reklamowe, 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 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 grupie, gdy użytkownicy przeglądają treści w trybie incognito. Członkostwo jest usuwane, gdy użytkownicy usuwają dane witryny.

Czy mogę zrezygnować z korzystania z interfejsu Protected Audience API?

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

Kluczowych pojęć

Chcesz dowiedzieć się więcej o terminologii związanej z Protected Audience? Zapoznaj się z glosariuszem 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 umożliwia tworzenie maksymalnie 1000 grup zainteresowań na właściciela i maksymalnie 1000 właścicieli grup zainteresowań. Te limity są przeznaczone jako barierki ochronne, a nie do stosowania w ramach zwykłej obsługi.

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?

Wiele stron może prowadzić aukcję, aby sprzedać miejsce reklamowe.

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 zadania:

• 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 elementach roboczych 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 aukcję reklamy przez wywołanie funkcji JavaScript navigator.runAdAuction().

Jak przebiega aukcja reklam w interfejsie Protected Audience API?

Na diagramie poniżej 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 grupy odbiorców chronionych w witrynie, która sprzedaje miejsce na reklamę (np. witryna z wiadomościami). Sprzedawca wybiera kupujących, którzy wezmą udział 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, np. o 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 jest ustawiona flaga 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 z zasobnikiem jest dostępny od wersji M114.
6. Aukcja jest raportowana sprzedawcy i kupującym, którzy wygrali aukcję.

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

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

Usługa klucz-wartość interfejsu Protected Audience API 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 zachowaniu prywatności. Więcej informacji o usłudze Protected Audience API Key/Value oraz innych usługach Protected Audience API 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 Protected Audience API. Usługa kluczy/wartości odpowiada wartością dla każdego klucza.

Kod usługi klucza/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 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 klucz-wartość sprzedawcy zostanie zapytana o adres URL renderowania kreacji.

Do wstępnego testowania używany jest model „przynieś własny serwer”. W długim okresie firmy z branży technologii reklamowych będą musiały używać usług klucza/wartości 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 otwartych usług klucz-wartość ani zaufanych środowisk wykonywania do czasu, gdy ciasteczka innych firm zostaną wycofane. Zanim wprowadzimy tę zmianę, powiadomimy deweloperów z wyprzedzeniem, aby mogli rozpocząć testowanie i wdrażanie.

Jak dane własne są używane w ramach aukcji z listą odbiorców chronionych?

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 chronioną listą odbiorców reklamodawca może używać danych własnych do określania przynależności do grupy odbiorców opartej na zainteresowaniach, a także przekazywać dane do grupy odbiorców 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ń może ustawić w konfiguracji grupy zainteresowań 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 te dane. 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 API oraz demo Protected Audience API, które zawiera podstawowe informacje o wdrażaniu interfejsu Protected Audience API. 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 dyskusyjnej Improving Web Advertising Business Group.
• Pomoc dla deweloperów: możesz zadawać pytania na temat wdrażania i sprawdzonych metod lub dołączyć do dyskusji w repozytorium pomocy dla deweloperów Piaskownicy prywatności.
• Obecna implementacja: jeśli masz pytania dotyczące implementacji Protected Audience w Chrome, zgłoś błąd w Chromium.