Poznaj specyfikację funkcji Real-time Curation

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.

SegmentRequest

Atrybut Typ Opis
imp Tablica Imp Obsługiwane tylko w przypadku partnerów zajmujących się kuratorowaniem kontekstowym. Reprezentuje oferowane możliwości wyświetlania.
site Obszar 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.
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 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ń.
banner Banner 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.
video Film 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.
ext ImpExt Zawiera rozszerzenia obiektu Imp.

Baner

Atrybut Typ Opis
w int 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.
eids Tablica EID 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.
uids Tablica UID 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.

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

SegmentResponse

Atrybut Typ Opis
segment Tablica Segment Deskryptor segmentu.

Segment

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