Poznaj specyfikację funkcji Real-time Curation

Google wysyła do integracji z funkcją selektywnego doboru w czasie rzeczywistym SegmentRequest na podstawie żądań reklam pasujących do Twoich docelowych zasobów reklamowych. Obiekt SegmentRequest dostarcza sygnały kontekstowe lub bezpieczne sygnały, których możesz użyć do określenia, które z Twoich segmentów mają zastosowanie do danych zasobów reklamowych w obiekcie SegmentResponse. Funkcja Real-time Curation obsługuje obiekty SegmentRequest i SegmentResponse przesyłane w formacie JSON.

Ten przewodnik to materiał referencyjny dotyczący protokołu selekcjonowania w czasie rzeczywistym, który pomoże Ci w integracji.

SegmentRequest

Atrybut Typ Opis
site Witryna

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ądania.
app Aplikacja

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.
pub Wydawca

Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym.

Opis wydawcy.
user Użytkownik Opis użytkownika przeglądającego treści wydawcy, który zainicjował żądanie segmentu.
device Urządzenie

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.

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ę.

Promująca aplikację

Atrybut Typ Opis
bundle ciąg znaków

Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym.

Identyfikator aplikacji na konkretną platformę, 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 użytkownika w ramach Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2 zakodowany w formacie base64, który można bezpiecznie stosować w internecie. Ciąg ten jest pobierany z platformy CMP IAB wydawcy.

Pole consent jest wypełniane, jeśli wydawca przeprowadził integrację z platformą CMP zgodną z zasadami TCF w wersji 2, a ta platforma 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 na przetwarzanie danych znajdziesz na globalnej liście dostawców IAB: vendor-list.consensu.org/v2/vendor-list.json.
eids EID tablica

Obsługiwane tylko w przypadku partnerów wyboru bezpiecznych sygnałów.

instancje z rozszerzonym identyfikatorem;

W sekcji Selekcja pole eids zawiera dane udostępniane 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.
uids UID array

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 Ad Managerze.

Urządzenie

Atrybut Typ Opis
geo Dane geograficzne

Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym.

Lokalizacja urządzenia użytkownika.

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 metropolitalnego Google znaleziony w pliku geo-table.csv.

SegmentResponse

Atrybut Typ Opis
segment Segment tablica Deskryptor segmentu.

Segment

Atrybut Typ Opis
segment_id ciąg znaków Identyfikator segmentu. Identyfikator powinien być zgodny z wartością curatorDataSegmentId w nazwie segmentu w zasobie curators.dataSegments interfejsu Marketplace API.