Dowiedz się, jak aktualizować dane o odbiorcach, konfigurując adres URL aktualizacji pod kątem grupy zainteresowań Protected Audience API. Przeczytaj przewodnik dla programistów, aby poznać pełny cykl życia interfejsu Protected Audience API, i zapoznaj się z wyjaśnieniem na temat tego, jak przeglądarki rejestrują grupy zainteresowań.
Nie jesteś programistą? Zapoznaj się z omówieniem interfejsu Protected Audience API.
Grupy zainteresowań Protected Audience API
Grupa zainteresowań w Protected Audience API reprezentuje grupę osób o wspólnych zainteresowaniach, co odpowiada liście remarketingowej. Każda grupa zainteresowań w ramach Protected Audience API ma swojego właściciela.
Właściciele grup zainteresowań działają jako kupujący w aukcji reklam w ramach Protected Audience API. Przynależność do grupy zainteresowań jest przechowywana przez przeglądarkę oraz na urządzeniu użytkownika i nie jest udostępniana dostawcy przeglądarki ani żadnym innym osobom.
Funkcje interfejsu API
Przykład użycia
Oto przykład z przewodnika, który wyjaśnia, jak definiować dane o odbiorcach. 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 kod JSON, aby zaktualizować atrybuty grupy zainteresowań. Musi mieć to samo pochodzenie co owner.
Zaktualizuj atrybuty
updateUrl określa serwer WWW, który zwraca właściwości grupy zainteresowań w formacie JSON, odpowiadającym obiektowi grupy zainteresowań przekazanemu do joinAdInterestGroup().
Dzięki temu właściciel grupy może okresowo aktualizować atrybuty grupy zainteresowań. W bieżącej implementacji można zmienić następujące atrybuty:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Żadne pola nieokreślone w pliku JSON nie zostaną zastąpione – aktualizowane są tylko pola określone w pliku JSON, podczas gdy wywołanie navigator.joinAdInterestGroup() powoduje zastąpienie istniejącej grupy zainteresowań.
Aktualizacje są wykonywane w najlepszy możliwy sposób i mogą zakończyć się niepowodzeniem w tych sytuacjach:
- Limit czasu żądania sieciowego (obecnie 30 sekund).
- Inny błąd sieci.
- Błąd analizy JSON.
Liczba aktualizacji jest ograniczona do maksymalnie 1 dziennie.
Aktualizacje można anulować, jeśli z powodu zbyt długiego czasu ich aktualizowanie jest spóźnione. Nie spowoduje to jednak ograniczenia częstotliwości przesyłania anulowanych (pozostałych) aktualizacji. 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 odłączenia od internetu, są ponawiane natychmiast po ponownym połączeniu.
Aktualizacje ręczne
Aktualizacje grup zainteresowań należących do punktu początkowego bieżącej ramki można aktywować ręcznie za pomocą elementu navigator.updateAdInterestGroups().
Dzięki ograniczaniu liczby żądań aktualizacje nie będą się zbyt często aktualizować: powtarzające się wywołania z numerem navigator.updateAdInterestGroups() nie wykonują żadnych działań, dopóki nie upłynie limit liczby żądań (obecnie 1 dzień).
Limit liczby żądań jest resetowany, jeśli funkcja navigator.joinAdInterestGroup() zostanie ponownie wywołana dla tej samej grupy zainteresowań owner i name.
Aktualizacje automatyczne
Wszystkie grupy zainteresowań wczytane na aukcji są aktualizowane automatycznie po jej zakończeniu, z zastrzeżeniem tych samych limitów stawek co w przypadku ręcznych aktualizacji.
W przypadku każdego właściciela z co najmniej 1 grupą zainteresowań biorących udział w aukcji funkcja navigator.updateAdInterestGroups() jest wywoływana tak, jakby element navigator.updateAdInterestGroups() był wywoływany z elementu iframe, którego źródło pasuje do tego właściciela.
Wszystkie pliki referencyjne 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.