Poznaj specyfikację funkcji Real-time Curation
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Google wysyła SegmentRequest
na podstawie żądań reklam pasujących do Twoich docelowych zasobów reklamowych do integracji z funkcją selektywnego udostępniania w czasie rzeczywistym. Obiekt SegmentRequest zawiera sygnały kontekstowe lub bezpieczne, których możesz użyć do określenia, które z Twoich segmentów mają zastosowanie do danych zasobów reklamowych w SegmentResponse.
Funkcja Real-time Curation obsługuje obiekty SegmentRequest i SegmentResponse wysyłane w formacie JSON.
Ten przewodnik to materiał referencyjny dotyczący protokołu Real-time Curation, który pomoże Ci w integracji.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Opis witryny. Pole site jest wypełniane, jeśli treści obsługiwane przez reklamy to witryna, a nie aplikacja inna niż przeglądarka.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Opis aplikacji. Pole app jest wypełniane, jeśli treści obsługiwane przez reklamy są aplikacją inną niż przeglądarka, a nie witryną.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Opis urządzenia użytkownika.
segment_request_id
ciąg znaków
Unikalny identyfikator używany do identyfikowania żądania segmentu niezależnie od wszystkich innych żądań segmentów.
Wyświetlenia
Atrybut
Typ
Opis
id
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Unikalny identyfikator tego wyświetlenia w kontekście żądania segmentu. Wartość zaczyna się od 1 i zwiększa się do n w przypadku n wyświetleń.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. To pole jest wypełniane, jeśli wyświetlenie jest oferowane jako możliwość reklamowa banera.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. To pole jest wypełniane, jeśli wyświetlenie jest oferowane jako możliwość reklamowa wideo.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Szerokość w pikselach niezależnych od urządzenia (DIPS).
h
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Wysokość w pikselach niezależnych od urządzenia (DIPS).
pos
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Pozycja reklamy na ekranie. Więcej informacji o możliwych pozycjach miejsc docelowych znajdziesz w tym artykule w AdCOM 1.0.
Wideo
Atrybut
Typ
Opis
w
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Szerokość odtwarzacza wideo w pikselach niezależnych od urządzenia (DIPS).
h
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Wysokość odtwarzacza wideo w pikselach niezależnych od urządzenia (DIPS).
pos
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Pozycja reklamy na ekranie. Więcej informacji o możliwych pozycjach miejsc docelowych znajdziesz w tym artykule w AdCOM 1.0.
ImpExt
Atrybut
Typ
Opis
gpid
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Opisuje globalny identyfikator miejsca docelowego. Unikalny, trwały identyfikator określony przez wydawcę, który jest spójny na wszystkich ścieżkach dostaw dla każdej jednostki reklamowej na stronie. Przeczytaj ten artykuł.
Witryna
Atrybut
Typ
Opis
page
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Adres URL strony, na której wyświetlono reklamę.
mobile
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Wskazuje, czy witryna została zaprogramowana tak, aby optymalizować układ podczas wyświetlania na urządzeniach mobilnych (0 = nie, 1 = tak).
Aplikacja
Atrybut
Typ
Opis
bundle
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Identyfikator aplikacji na konkretnej platformie, który ma być unikalny dla aplikacji. Na Androidzie pole bundle to nazwa pakietu. W przypadku iOS jest to identyfikator numeryczny.
Wydawca
Atrybut
Typ
Opis
id
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Identyfikator wydawcy zdefiniowany przez sufiks kodu wydawcy w kodzie usługi internetowej. Na przykład wydawca, którego kod usługi internetowej to ca-pub-123, będzie miał identyfikator ustawiony na pub-123.
Użytkownik
Atrybut
Typ
Opis
consent
ciąg znaków
Ciąg tekstowy zgody w ramach Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych (TCF) w wersji 2 zakodowany w formacie base64 bezpiecznym dla internetu, pobrany z platformy do zarządzania zgodą użytkowników IAB (CMP) wydawcy. Pole consent jest wypełniane, jeśli wydawca zintegrował się z platformą CMP w celu stosowania zasad TCF w wersji 2, a ta platforma CMP wskazuje, że RODO ma zastosowanie do żądania reklamy, i podaje prawidłowy ciąg tekstowy dotyczący zgody. Szczegółowe informacje o dostawcach wymienionych w ciągu tekstowym dotyczącym zgody znajdziesz na globalnej liście dostawców IAB: vendor-list.consensu.org/v2/vendor-list.json.
Obsługiwane tylko w przypadku partnerów wyboru bezpiecznych sygnałów. instancje z rozszerzonym identyfikatorem; W przypadku selektywnego doboru zasobów pole eids zawiera dane udostępnione przez wydawcę, np. bezpieczne sygnały.
EID
Atrybut
Typ
Opis
source
ciąg znaków
Obsługiwane tylko w przypadku partnerów wyboru bezpiecznych sygnałów. Źródło lub dostawca technologii odpowiedzialny za zbiór uwzględnionych danych. Wyrażona jako domena najwyższego poziomu.
Obsługiwane tylko w przypadku partnerów wyboru bezpiecznych sygnałów. Tablica obiektów UID z danego źródła.
Użytkownik (UID)
Atrybut
Typ
Opis
id
ciąg znaków
Obsługiwane tylko w przypadku partnerów wyboru bezpiecznych sygnałów. Identyfikator. W przypadku selekcjonowania pole id jest bezpiecznym sygnałem. Więcej informacji o bezpiecznych sygnałach znajdziesz w artykule Udostępnianie bezpiecznych sygnałów licytującym i partnerom wyboru w Centrum pomocy Ad Managera.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Lokalizacja urządzenia użytkownika.
devicetype
int
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Ogólny typ urządzenia. Więcej informacji o możliwych typach urządzeń znajdziesz w tym artykule w AdCOM 1.0.
os
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. System operacyjny urządzenia (np. „iOS”).
make
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Marka urządzenia (np. „Apple”).
Geo
Atrybut
Typ
Opis
country
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Kraj zgodny ze standardem ISO-3166-1 Alpha-3.
region
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Kod regionu zgodny ze standardem ISO-3166-2; w przypadku Stanów Zjednoczonych jest to 2-literowy kod stanu.
metro
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Kod obszaru miejskiego Google znaleziony w pliku geo-table.csv.
city
ciąg znaków
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Miasto z kodem ONZ dla lokalizacji handlowych i transportowych.
Identyfikator segmentu. Identyfikator powinien być zgodny z wartością curatorDataSegmentId znalezioną w nazwie segmentu w zasobie curators.dataSegments interfejsu Marketplace API.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2026-03-31 UTC."],[],[]]
