Dowiedz się, jak aktualizować dane o odbiorcach, konfigurując adres URL aktualizacji dla grupy zainteresowań interfejsu Protected Audience API. Przeczytaj przewodnik dla programistów, aby poznać cały cykl życia interfejsu Protected Audience API, i zapoznaj się z wyjaśnieniem interfejsu Protected Audience API, aby uzyskać szczegółową propozycję rejestrowania grup zainteresowań.
Nie jesteś programistą? Więcej informacji znajdziesz w artykule Omówienie interfejsu Protected Audience API.
Grupy zainteresowań interfejsu Protected Audience API
Grupa zainteresowań interfejsu Protected Audience API to grupa osób o wspólnych zainteresowaniach odpowiadająca liście remarketingowej. Każda grupa zainteresowań interfejsu Protected Audience API ma właściciela.
Właściciele grup zainteresowań to kupujący w aukcji reklam Protected Audience API. Członkostwo w grupie zainteresowań jest przechowywane przez przeglądarkę, na urządzeniu użytkownika i nie jest udostępniane dostawcy przeglądarki ani nikomu innemu.
Funkcje interfejsu API
Przykład użycia
Oto przykład z przewodnika pokazujący, jak definiować dane o odbiorcach. Zawiera on informacje o tym, jak utworzyć grupę zainteresowań i poprosić przeglądarkę o dołączenie do grupy.
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 zawiera adres URL, który zwraca plik JSON do aktualizowania atrybutów grupy zainteresowań. Musi mieć to samo źródło co owner.
Zaktualizuj atrybuty
updateUrl określa serwer WWW, który zwraca JSON definiujący właściwości grupy zainteresowań, odpowiadające obiektowi grupy zainteresowań przekazanym do joinAdInterestGroup().
Dzięki temu właściciel grupy może okresowo aktualizować jej atrybuty. W ramach obecnej implementacji można zmieniać te atrybuty:
biddingLogicUrlbiddingWasmHelperUrltrustedBiddingSignalsUrltrustedBiddingSignalsKeysadspriority
Pole, które nie jest określone w pliku JSON, nie zostanie zastąpione (zaktualizowane są tylko pola określone w pliku JSON), natomiast wywołanie navigator.joinAdInterestGroup() zastępuje dotychczasową grupę zainteresowań.
Aktualizacje są wykonywane w miarę możliwości i mogą zakończyć się niepowodzeniem w tych sytuacjach:
- Limit czasu żądania sieciowego (obecnie 30 sekund).
- Inna awaria sieci.
- Błąd analizy JSON.
Częstotliwość aktualizacji jest ograniczona do maksymalnie jednego dziennie.
Aktualizacje można anulować, jeśli aktualizacja zajmuje zbyt dużo czasu. Nie powoduje to jednak ograniczenia częstotliwości anulowanych (pozostałych) aktualizacji. Aktualizacje, które nie powiodły się z powodu błędów sieci, są ponawiane po upływie godziny, a aktualizacje, które nie powiodły się z powodu rozłączenia z internetem, są ponawiane natychmiast po ponownym połączeniu.
Aktualizacje ręczne
Aktualizacje grup zainteresowań należących do źródła bieżącej ramki można aktywować ręcznie za pomocą funkcji navigator.updateAdInterestGroups().
Ograniczenie liczby żądań zapobiega zbyt częstym aktualizacjom: powtarzające się wywołania navigator.updateAdInterestGroups() nie wykonują żadnych działań, dopóki nie minie okres limitu liczby żądań (obecnie 1 dzień).
Limit stawki zostanie zresetowane, jeśli funkcja navigator.joinAdInterestGroup() zostanie ponownie wywołana dla tej samej grupy zainteresowań owner i name.
Automatyczne aktualizacje
Wszystkie grupy zainteresowań wczytane w ramach aukcji są aktualizowane automatycznie po jej zakończeniu, z uwzględnieniem takich samych limitów stawki jak w przypadku aktualizacji ręcznych.
W przypadku każdego właściciela z co najmniej 1 grupą zainteresowań biorącą udział w aukcji wygląda to tak, jakby funkcja navigator.updateAdInterestGroups() była wywoływana z elementu iframe, którego źródło pasuje do tego właściciela.
Wszystkie materiały 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.