Dowiedz się, jak aktualizować dane o odbiorcach, konfigurując adres URL aktualizacji dla grupy zainteresowań Protected Audience API. Zapoznaj się z przewodnikiem dla programistów, aby poznać pełny cykl życia interfejsu Protected Audience API, oraz z wyjaśnieniem dotyczącym interfejsu Protected Audience API, aby dowiedzieć się, jak przeglądarki rejestrują grupy zainteresowań.
Nie jesteś deweloperem? Zapoznaj się z omówieniem interfejsu Protected Audience API.
Grupy zainteresowań Protected Audience API
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.
Właściciele grup zainteresowań występują w roli kupujących na aukcji reklam z interfejsem Protected Audience API. Informacja o przynależności do grupy zainteresowań jest zapisywana przez przeglądarkę na urządzeniu użytkownika i nie jest udostępniana dostawcy przeglądarki ani nikomu innemu.
Funkcje interfejsu API
Przykład użycia
Oto przykład z przewodnika dotyczącego definiowania danych o odbiorcach, który pokazuje, jak utworzyć grupę zainteresowań i poprosić przeglądarkę o dołączenie do niej.
const interestGroup = {
owner: 'https://dsp.example',
name: 'custom-bikes',
biddingLogicUrl: ...,
biddingWasmHelperUrl: ...,
updateUrl: ...,
trustedBiddingSignalsUrl: ...,
trustedBiddingSignalsKeys: ['key1', 'key2'],
userBiddingSignals: {...},
ads: [bikeAd1, bikeAd2, bikeAd3],
adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};
navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);
updateUrl udostępnia adres URL, który zwraca JSON do aktualizowania atrybutów grupy zainteresowań. Musi mieć to samo pochodzenie co tag owner.
Aktualizowanie atrybutów
updateUrl określa serwer internetowy, który zwraca JSON określający właściwości grupy zainteresowań, odpowiadające obiektowi grupy zainteresowań przekazanemu do joinAdInterestGroup().
Umożliwia to właścicielowi grupy okresowe aktualizowanie atrybutów grupy zainteresowań. W obecnej implementacji można zmienić te atrybuty:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Wszystkie pola, które nie są określone w pliku JSON, nie zostaną zastąpione – aktualizowane są tylko pola określone w pliku JSON. Wywołanie navigator.joinAdInterestGroup() zastępuje natomiast każdą istniejącą grupę zainteresowań.
Aktualizacje są wykonywane w miarę możliwości i mogą się nie udać w tych sytuacjach:
- Limit czasu żądania sieciowego (obecnie 30 sekund).
- Inny błąd sieci.
- Błąd analizy JSON.
Aktualizacje są ograniczone do maksymalnie 1 na dzień.
Aktualizacje można anulować, jeśli na ich przeprowadzenie poświęcono zbyt dużo czasu, ale nie nakłada to żadnych ograniczeń szybkości na anulowane (pozostałe) aktualizacje. Aktualizacje, które nie powiodły się z powodu błędów sieci, są ponawiane po godzinie, a aktualizacje, które nie powiodły się z powodu utraty połączenia z internetem, są ponawiane natychmiast po ponownym nawiązaniu połączenia.
Aktualizacje ręczne
Aktualizacje grup zainteresowań należących do źródła bieżącej ramki można wywoływać ręcznie za pomocą funkcji navigator.updateAdInterestGroups().
Ograniczanie częstotliwości zapobiega zbyt częstym aktualizacjom: powtarzane wywołania funkcji navigator.updateAdInterestGroups() nie przynoszą żadnego efektu, dopóki nie upłynie okres ograniczenia częstotliwości (obecnie 1 dzień).
Limit szybkości zostanie zresetowany, jeśli funkcja navigator.joinAdInterestGroup() zostanie ponownie wywołana w przypadku tej samej grupy zainteresowań owner i name.
Aktualizacje automatyczne
Wszystkie grupy zainteresowań załadowane na potrzeby aukcji są aktualizowane automatycznie po jej zakończeniu, z zastosowaniem tych samych limitów częstotliwości co w przypadku aktualizacji ręcznych.
W przypadku każdego właściciela, którego co najmniej jedna grupa zainteresowań bierze udział w aukcji, wywołanie funkcji navigator.updateAdInterestGroups() następuje z elementu iframe, którego pochodzenie jest zgodne z pochodzeniem tego właściciela.
Wszystkie odwołania do interfejsu Protected Audience API
Dostępne są przewodniki po interfejsach API:
- Przewodnik dla programistów dotyczący interfejsu Protected Audience API.
- Przewodnik dla kupujących reklamę po grupach zainteresowań i generowaniu stawek w ramach Protected Audience API.
- Przewodnik po aukcjach reklam w ramach Protected Audience API
- Przewodnik po raportowaniu wyników aukcji.
- Sprawdzone metody dotyczące opóźnienia aukcji reklam w ramach Protected Audience API
- Rozwiązywanie problemów z chronioną grupą odbiorców
Wyjaśnienie interfejsu Protected Audience API zawiera też szczegółowe informacje o obsłudze i ograniczeniach funkcji.