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 sygnały dotyczące odbiorców, 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 zawiera informacje o protokole selekcjonowania w czasie rzeczywistym, które pomogą 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 nieprzeznaczona do przeglądarek.
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 to aplikacja inna niż przeglądarka, a nie witryna.
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Opis urządzenia użytkownika.
segment_request_id
tekst
Unikalny identyfikator używany do identyfikowania żądania segmentu niezależnie od wszystkich innych żądań segmentów.
Wyświetlenia
Atrybut
Typ
Opis
id
tekst
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ść wyświetlenia reklamy banerowej.
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
tekst
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ł.
Lokalizacja
Atrybut
Typ
Opis
page
tekst
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
tekst
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
tekst
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
id
tekst
Identyfikator użytkownika Google.
buyeruid
tekst
Hostowane dane klientów na potrzeby dopasowania przesłane za pomocą usługi dopasowywania plików cookie. Domyślnie jest on określony w bezpiecznym dla sieci kodowaniu base64 bez dopełnienia. Możesz opcjonalnie skonfigurować to pole tak, aby było wypełniane bez kodowania. W tym celu skontaktuj się z menedżerem konta.
consent
tekst
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 CMP IAB 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 zajmujących się selekcjonowaniem list odbiorców. instancje z rozszerzonym identyfikatorem; W przypadku selektywnego doboru zasobów pole eids zawiera dane udostępniane przez wydawcę, np. bezpieczne sygnały.
EID
Atrybut
Typ
Opis
source
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się selekcjonowaniem list odbiorcó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 zajmujących się selekcjonowaniem list odbiorców. Tablica obiektów UID z danego źródła.
Użytkownik (UID)
Atrybut
Typ
Opis
id
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się selekcjonowaniem list odbiorców. Identyfikator. W przypadku wyboru 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 specyfikacji AdCOM 1.0.
os
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. System operacyjny urządzenia (np. „iOS”).
make
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Marka urządzenia (np. „Apple”).
ifa
tekst
Niezaszyfrowany identyfikator wyświetlania reklam na urządzeniu (niezaszyfrowany). W protokole Google do selektywnego wyświetlania reklam w czasie rzeczywistym jest to zazwyczaj 36-znakowy identyfikator UUID, w którym identyfikatory Androida są zapisywane małymi literami, a identyfikatory IDFA – wielkimi. W przypadku urządzeń Samsung są to 32-znakowe wartości alfanumeryczne.
Geo
Atrybut
Typ
Opis
country
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Kraj w formacie ISO-3166-1 Alpha-3.
region
tekst
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
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Kod obszaru miejskiego Google znaleziony w pliku geo-table.csv.
city
tekst
Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Miasto z użyciem kodu 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-09-23 UTC."],[],[]]