- Zasób: CuratedPackage
- Stan
- AccessControlSettings
- PackageTargeting
- DeviceType
- środowisko.
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- Typ
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- Metody
Zasób: CuratedPackage
Reprezentuje wyselekcjonowany pakiet zasobów reklamowych utworzony przez selekcjonera i przez niego zarządzany.
| Zapis JSON |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| Pola | |
|---|---|
name |
Identyfikator. Unikalna nazwa zasobu wybranego pakietu. Format: |
displayName |
Wymagane. Wyświetlana nazwa przypisana do wybranego pakietu przez kuratora. Można go użyć do filtrowania odpowiedzi metody |
description |
Opcjonalnie: Opis wybranego pakietu podany przez kuratora. |
createTime |
Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy został utworzony wyselekcjonowany pakiet. Można go użyć do filtrowania odpowiedzi metody Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
updateTime |
Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy pakiet wyselekcjonowany został ostatnio zaktualizowany. Można go użyć do filtrowania odpowiedzi metody Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: |
floorPriceCpm |
Opcjonalnie: Minimalna stawka CPM, jaką kupujący musi zaoferować, aby wziąć udział w aukcjach dotyczących zasobów reklamowych w tym wyselekcjonowanym pakiecie. Można go użyć do filtrowania odpowiedzi metody |
state |
Tylko dane wyjściowe. Stan wybranego pakietu. Można go użyć do filtrowania odpowiedzi metody |
accessSettings |
Wymagane. Ustawienia kontroli dostępu do wyselekcjonowanego pakietu. Dostęp do tego wyselekcjonowanego pakietu mają tylko twórca i media plannerzy znajdujący się na liście dozwolonych. Kupujący i licytujący nie mogą zostać dodani do listy dozwolonych ani mieć bezpośredniego dostępu do tego zasobu. |
targeting |
Opcjonalnie: Kryteria kierowania dla wybranego pakietu. |
curationFeeVisibility |
Opcjonalnie: Wartość niezmienna. Widoczność łącznej opłaty za pakiet wyboru i segment danych (łączna opłata za wybór). |
| Opłata wypłacana kuratorowi za ten pakiet. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól: | |
feeCpm |
Opcjonalnie: Opłata CPM naliczana przez kuratora kupującym, którzy korzystają z tego wyselekcjonowanego pakietu. Można go użyć do filtrowania odpowiedzi metody |
millipercentOfMediaFee |
Opcjonalnie: Opłata będzie naliczana jako procent kosztu wyświetlenia, wyrażony w miliprocentach. Na przykład 1% jest reprezentowany jako 1000. |
| Koniec pól wykluczających się wzajemnie. | |
Stan
Stan wybranego pakietu.
| Wartości w polu enum | |
|---|---|
STATE_UNSPECIFIED |
Wartość domyślna. |
ACTIVE |
Wybrany pakiet jest aktywny. |
INACTIVE |
Wybrany pakiet jest nieaktywny. |
AccessControlSettings
Ustawienia kontroli dostępu do wyselekcjonowanego pakietu.
| Zapis JSON |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| Pola | |
|---|---|
allowlistedMediaPlanners[] |
Wymagane. Wartość niezmienna. Lista media plannerów, którym wyraźnie przyznano dostęp do wybranego pakietu. Kwalifikujące się media plany znajdziesz w metodzie Format: |
PackageTargeting
Kryteria kierowania w przypadku pakietów wyselekcjonowanych i pakietów aukcji.
| Zapis JSON |
|---|
{ "includedDeviceTypes": [ enum ( |
| Pola | |
|---|---|
includedDeviceTypes[] |
Opcjonalnie: Lista typów urządzeń, na które ma być kierowana reklama. Jeśli nie wybierzesz żadnego, kierowanie będzie obejmować wszystkie typy urządzeń. |
includedEnvironment |
Opcjonalnie: Środowisko, na które chcesz kierować reklamy. Jeśli nie zostanie określone, kierowanie będzie obejmować wszystkie środowiska. |
includedCreativeFormat |
Opcjonalnie: Format kreacji, na który ma być ustawione kierowanie. Jeśli nie zostanie ustawiony, kierowanie będzie obejmować wszystkie typy znaczników kreacji. |
includedAcceleratedMobilePageType |
Opcjonalnie: Typ docelowej przyspieszonej strony mobilnej. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od stanu AMP. |
includedAuthorizedSellerStatuses[] |
Opcjonalnie: Uwzględniona lista docelowych stanów autoryzowanego sprzedawcy. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od stanu sprzedawcy. |
includedNativeInventoryTypes[] |
Opcjonalnie: Docelowe typy natywnych zasobów reklamowych. Jeśli to pole jest puste, kierowanie na zasoby reklamowe będzie się odbywać niezależnie od typu natywnych zasobów reklamowych. |
includedOpenMeasurementTypes[] |
Opcjonalnie: Lista docelowych typów Open Measurement. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od obsługi Open Measurement. |
includedRestrictedCategories[] |
Opcjonalnie: Lista docelowych kategorii objętych ograniczeniami. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od kategorii objętych ograniczeniami. |
includedRewardedType |
Opcjonalnie: Docelowy typ reklamy z nagrodą. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od typu nagrody. |
videoTargeting |
Opcjonalnie: Kryteria kierowania dotyczące filmów. |
minimumPredictedViewabilityPercentage |
Opcjonalnie: Docelowy minimalny prognozowany procent widoczności. Ta wartość musi być wielokrotnością liczby 10 z zakresu od 10 do 90 (włącznie). Na przykład 10 jest prawidłową wartością, ale 0, 15 i 100 już nie. Wartość 10 oznacza, że konfiguracja będzie pasować tylko do boksów reklamowych, dla których przewidujemy co najmniej 10% widoczności. Nieustawiona wartość oznacza, że zasoby reklamowe będą kierowane niezależnie od przewidywanej widoczności. |
languageTargeting |
Opcjonalnie: Języki, na które chcesz kierować reklamy. Jeśli nie zostanie ustawiony, zasoby reklamowe będą kierowane niezależnie od języka. Listę obsługiwanych kodów języków znajdziesz na stronie https://developers.google.com/google-ads/api/data/codes-formats#languages. |
includedAdSizes[] |
Opcjonalnie: Lista rozmiarów reklam, na które chcesz kierować reklamy. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą objęte kierowaniem niezależnie od rozmiaru reklamy. Wybrane pakiety obsługują rozmiary reklam |
publisherTargeting |
Opcjonalnie: Wydawcy, na których kierowane są reklamy. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od wydawcy. Wydawcy są identyfikowani na podstawie identyfikatora wydawcy z pliku ads.txt lub app-ads.txt. Więcej informacji znajdziesz na stronach https://iabtechlab.com/ads-txt/ i https://iabtechlab.com/app-ads-txt/. |
minimumPredictedClickThroughRatePercentageMillis |
Opcjonalnie: Docelowy minimalny prognozowany współczynnik klikalności, którego wartości mieszczą się w zakresie [10, 10000] (0,01%–10%). Wartość 50 oznacza, że konfiguracja będzie pasować tylko do boksów reklamowych, w przypadku których przewidujemy współczynnik klikalności na poziomie co najmniej 0,05%. Nieustawiona wartość oznacza, że zasoby reklamowe będą kierowane niezależnie od przewidywanego współczynnika klikalności. |
verticalTargeting |
Opcjonalnie: Uwzględnione lub wykluczone branże zgodnie z definicją na stronie https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Jeśli nie zostanie ustawiona, zasoby reklamowe będą kierowane niezależnie od branży. |
geoTargeting |
Opcjonalnie: Identyfikatory kryteriów geograficznych, które mają zostać uwzględnione lub wykluczone, zgodnie z definicją na stronie https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od lokalizacji geograficznej. |
includedDataSegments[] |
Opcjonalnie: Aktywne segmenty danych, na które chcesz kierować reklamy. Jeśli nie jest skonfigurowana, zasoby reklamowe będą kierowane niezależnie od segmentów danych. Format: |
placementTargeting |
Opcjonalnie: Informacje o kierowaniu na miejsca docelowe, np. adres URL, aplikacje mobilne. |
publisherProvidedSignalsTargeting |
Opcjonalnie: Sygnały dostarczane przez wydawcę, na które ma być kierowana reklama. Jeśli nie ustawisz tej opcji, zasoby reklamowe będą kierowane niezależnie od sygnałów dostarczanych przez wydawcę. |
DeviceType
Ogólny typ urządzenia, na które chcesz kierować reklamy.
| Wartości w polu enum | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
DEVICE_TYPE_PERSONAL_COMPUTER |
Kieruje reklamy na komputery stacjonarne i laptopy. |
DEVICE_TYPE_CONNECTED_TV |
Kieruje reklamy na urządzenia CTV, czyli urządzenia, które odtwarzają treści telewizyjne, np. telewizory smart TV, konsole do gier i urządzenia do transmisji strumieniowej. |
DEVICE_TYPE_PHONE |
Kieruje reklamy na zaawansowane urządzenia mobilne. |
DEVICE_TYPE_TABLET |
Kierowanie na tablety. |
Środowisko
Środowisko, na które chcesz kierować reklamy.
| Wartości w polu enum | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
ENVIRONMENT_SITE |
Kieruje reklamy na zasoby reklamowe renderowane w witrynie z reklamami. |
ENVIRONMENT_APP |
Kierowanie na zasoby reklamowe w aplikacji mobilnej. |
CreativeFormat
Format kreacji, na który można kierować reklamy.
| Wartości w polu enum | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
CREATIVE_FORMAT_DISPLAY |
Kieruje reklamy na boksy reklamowe przeznaczone na kreacje displayowe HTML. |
CREATIVE_FORMAT_VIDEO |
Kieruje reklamy na boksy reklamowe przeznaczone na kreacje wideo. |
CREATIVE_FORMAT_AUDIO |
Kieruje reklamy na boksy reklamowe przeznaczone na kreacje audio. |
AcceleratedMobilePageType
Typ implementacji przyspieszonych stron mobilnych (AMP), na który chcesz kierować reklamy.
| Wartości w polu enum | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
Kieruje reklamy na zasoby reklamowe na standardowych stronach internetowych, które nie korzystają z platformy AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
Kieruje reklamy na zasoby reklamowe na stronach utworzonych przy użyciu podstawowej platformy AMP HTML. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
Kieruje reklamy na zasoby reklamowe na stronach korzystających z formatu relacji w technologii AMP (STAMP), który jest zoptymalizowany pod kątem marketingu narracyjnego (np. interaktywnych reklam pełnoekranowych). |
AuthorizedSellerStatus
Reprezentuje relację między wydawcą a sprzedawcą zadeklarowaną w pliku ads.txt lub app-ads.txt.
| Wartości w polu enum | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
AUTHORIZED_SELLER_STATUS_DIRECT |
Kieruje reklamy na zasoby reklamowe, w przypadku których sprzedawca jest zadeklarowany jako „DIRECT”. Oznacza to, że wydawca (właściciel treści) bezpośrednio kontroluje konto sprzedawcy i ma bezpośrednią umowę biznesową z systemem reklamowym dotyczącą tego konta. |
AUTHORIZED_SELLER_STATUS_RESELLER |
Kieruje reklamy na zasoby reklamowe, w przypadku których sprzedawca jest zadeklarowany jako „RESELLER”. Oznacza to, że wydawca upoważnił inny podmiot do zarządzania podanym kontem sprzedawcy i odsprzedaży jego przestrzeni reklamowej. |
NativeInventoryType
Reprezentuje typ renderowania kreacji obsługiwany przez boks reklamowy, zwłaszcza w odniesieniu do reklam natywnych.
| Wartości w polu enum | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
Kieruje reklamy na boksy reklamowe, które akceptują i renderują tylko reklamy natywne. |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
Kieruje reklamy na boksy reklamowe, które akceptują i renderują reklamy natywne lub banery reklamowe. |
OpenMeasurementType
Typ interfejsu Open Measurement Interface Definition (OMID), na który chcesz kierować reklamy.
| Wartości w polu enum | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
Kieruje reklamy na zasoby reklamowe, które obsługują standard Open Measurement Interface Definition (OMID) w wersji 1. |
RestrictedCategory
Reprezentuje konkretne kategorie reklam, których kierowanie jest ograniczone przez zasady.
| Wartości w polu enum | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
RESTRICTED_CATEGORY_ALCOHOL |
Kieruje reklamy na zasoby reklamowe, w których wydawca zezwala na reklamy alkoholu. |
RESTRICTED_CATEGORY_GAMBLING |
Kieruje reklamy na zasoby reklamowe, w których wydawca zezwala na wyświetlanie reklam hazardu. |
RewardedType
Definiuje kryteria kierowania na podstawie tego, czy zasoby reklamowe oferują użytkownikowi nagrodę za obejrzenie reklamy.
| Wartości w polu enum | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
REWARDED_TYPE_NON_REWARDED |
Kieruje reklamy na zasoby reklamowe, które NIE oferują użytkownikowi wyraźnej nagrody za obejrzenie reklamy lub interakcję z nią. |
REWARDED_TYPE_REWARDED |
Kieruje reklamy na zasoby reklamowe, które oferują użytkownikowi nagrodę w zamian za obejrzenie reklamy lub interakcję z nią. |
PackageVideoTargeting
Kryteria kierowania dotyczące filmów.
| Zapis JSON |
|---|
{ "includedMimeTypes": [ enum ( |
| Pola | |
|---|---|
includedMimeTypes[] |
Opcjonalnie: Lista docelowych typów MIME reklam wideo, które korzystają z ciągów typów MIME opublikowanych przez IANA (https://www.iana.org/assignments/media-types/media-types.xhtml)). Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od typu MIME filmu. |
includedMaximumAdDurationTargeting |
Opcjonalnie: Docelowy maksymalny czas trwania reklamy wideo. Jeśli nie ustawisz tej opcji, zasoby reklamowe będą kierowane niezależnie od maksymalnego czasu trwania reklamy wideo. |
includedPositionTypes[] |
Opcjonalnie: Typy pozycji docelowych reklam wideo. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od typu pozycji reklamy wideo. |
includedContentDeliveryMethod |
Opcjonalnie: Metoda wyświetlania filmu docelowego. Jeśli nie ustawisz tej opcji, zasoby reklamowe będą kierowane niezależnie od metody wyświetlania wideo. |
plcmtTargeting |
Opcjonalnie: Docelowe typy miejsc docelowych reklam wideo. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od typu miejsca docelowego wideo. |
includedPlaybackMethods[] |
Opcjonalnie: Lista metod odtwarzania filmów, na które kierowane są reklamy. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od metody odtwarzania filmu. |
minimumPredictedCompletionRatePercentage |
Opcjonalnie: Docelowy minimalny prognozowany współczynnik realizacji. Ta wartość musi być wielokrotnością liczby 10 z zakresu od 10 do 90 (włącznie). Na przykład 10 jest prawidłową wartością, ale 0, 15 i 100 już nie. Wartość 10 oznacza, że konfiguracja będzie pasować tylko do boksów reklamowych, w przypadku których przewidujemy współczynnik pełnych obejrzeń na poziomie co najmniej 10%. Nieustawiona wartość oznacza, że zasoby reklamowe będą kierowane niezależnie od przewidywanego współczynnika pełnych obejrzeń. |
includedPlayerSizeTargeting |
Opcjonalnie: Rozmiar odtwarzacza wideo, na który kierowana jest reklama. Jeśli nie skonfigurujesz tego ustawienia, kierowanie na zasoby reklamowe będzie się odbywać niezależnie od rozmiaru odtwarzacza wideo. |
VideoMimeType
Typy MIME filmów, na które chcesz kierować reklamy.
| Wartości w polu enum | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
VIDEO_MIME_TYPE_THREEGPP |
Format kontenera 3GPP używany w telefonach 3G. |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
Kontener MPEG-4, zwykle z kodekiem H.264. |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH. |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (używany w reklamach VPAID). |
VIDEO_MIME_TYPE_WEBM |
Kontener WebM z kodekiem VP9. |
MaximumVideoAdDuration
Górny limit czasu trwania kreacji reklamy wideo, na którą chcesz kierować reklamy. Wartości typu wyliczeniowego definiują grupy, a wybranie wartości oznacza, że czas trwania kreacji musi być krótszy lub równy określonemu czasowi.
| Wartości w polu enum | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
Dotyczy reklam wideo o czasie trwania do 15 sekund (0 < czas trwania <= 15 s). |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
Dotyczy reklam wideo o czasie trwania do 20 sekund (0 < czas trwania <= 20 s). |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
Dotyczy reklam wideo o czasie trwania do 30 sekund (0 < czas trwania <= 30 s). |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
Dotyczy reklam wideo o czasie trwania do 60 sekund (0 < czas trwania <= 60 s). |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
Dotyczy reklam wideo o długości do 90 sekund (0 < czas trwania <= 90 s). |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
Dotyczy reklam wideo o czasie trwania do 120 sekund (0 < czas trwania <= 120 s). |
PositionType
Pozycja reklamy w filmie, na którą można kierować reklamy.
| Wartości w polu enum | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
POSITION_TYPE_MIDROLL |
Reklama jest odtwarzana w środku treści wideo. |
POSITION_TYPE_POSTROLL |
Reklama jest odtwarzana po treści wideo. |
POSITION_TYPE_PREROLL |
Reklama jest odtwarzana przed treścią wideo. |
ContentDeliveryMethod
Kryteria kierowania oparte na metodzie dostarczania treści wideo.
| Wartości w polu enum | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
CONTENT_DELIVERY_METHOD_STREAMING |
Kieruje reklamy na treści wideo transmitowane na żywo. |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
Kieruje reklamy na treści wideo, które są przesyłane przyrostowo zgodnie z wymaganiami odtwarzacza klienta. |
VideoPlcmtTargeting
Definiuje kryteria kierowania na podstawie typu miejsca docelowego wideo, często odpowiadającego polu „plcmt” w IAB OpenRTB.
| Zapis JSON |
|---|
{ "selectionType": enum ( |
| Pola | |
|---|---|
selectionType |
Wymagane. Typ wyboru listy miejsc docelowych wideo. |
videoPlcmtTypes[] |
Wymagane. Lista typów docelowych miejsc docelowych wideo. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od typu miejsca docelowego wideo. |
SelectionType
Typ wyliczeniowy możliwych typów wyboru używanych przez wymiary kierowania.
| Wartości w polu enum | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
Nieokreślony typ wyboru. Nie należy używać. |
SELECTION_TYPE_INCLUDE |
Wartości w wymiarze kierowania są uwzględniane. |
SELECTION_TYPE_EXCLUDE |
Wartości w wymiarze kierowania są wykluczone. |
VideoPlcmtType
Reprezentuje typ miejsca docelowego wideo zgodnie ze standardami OpenRTB.
| Wartości w polu enum | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
Wartość domyślna. Nie należy go używać w specyfikacjach kierowania. |
INSTREAM |
Reklamy przed filmem, w trakcie filmu i po filmie, które są odtwarzane przed, w trakcie lub po strumieniowej transmisji treści wideo, której zażądał konsument. W reklamach wideo typu In-Stream dźwięk musi być domyślnie włączony przy uruchamianiu odtwarzacza lub musi istnieć wyraźna intencja użytkownika, aby obejrzeć treści wideo. Odtwarzacz może być otoczony innymi treściami, ale to treści wideo muszą być celem wizyty użytkownika. Powinien on pozostać główną treścią na stronie i jedynym widocznym odtwarzaczem, który może odtwarzać dźwięk. Jeśli odtwarzacz zostanie przekształcony w pływający/przyklejony, kolejne wywołania reklamy powinny dokładnie przekazywać zaktualizowany rozmiar odtwarzacza. |
ACCOMPANYING_CONTENT |
Reklamy przed filmem, w trakcie filmu i po filmie, które są wyświetlane przed strumieniową transmisją treści wideo, w jej trakcie lub po jej zakończeniu. Odtwarzacz wideo wczytuje się i odtwarza przed akapitami tekstu lub treściami graficznymi, między nimi lub po nich, a odtwarzanie rozpoczyna się dopiero po wejściu w widoczny obszar. Odtwarzanie treści towarzyszących powinno rozpocząć się dopiero po wejściu do widocznego obszaru. Może on zostać przekształcony w pływający/przyklejony odtwarzacz, gdy użytkownik przewinie stronę. |
INTERSTITIAL |
reklamy wideo wyświetlane bez treści wideo; Podczas odtwarzania musi być najważniejszym elementem strony i zajmować większość widocznego obszaru. Nie może też znikać z widoku podczas przewijania. Może to być w miejscach docelowych, takich jak filmy w aplikacji lub pokazy slajdów. |
NO_CONTENT |
Reklamy wideo wyświetlane bez strumieniowych treści wideo. Mogą to być miejsca docelowe, takie jak pokazy slajdów, natywne kanały, treści lub reklamy przyklejone/pływające. |
PlaybackMethod
Metoda odtwarzania, na którą chcesz kierować reklamy.
| Wartości w polu enum | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
Nieokreślona metoda odtwarzania reklamy wideo. Nie należy używać. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
Odtwarzanie rozpoczyna się automatycznie po wczytaniu strony lub treści. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
Odtwarzanie rozpoczyna się automatycznie po wczytaniu strony lub treści, ale z wyłączonym dźwiękiem. |
PLAYBACK_METHOD_CLICK_TO_PLAY |
Odtwarzanie jest inicjowane przez działanie użytkownika (np. kliknięcie przycisku odtwarzania). |
VideoPlayerSizeTargeting
Określa rozmiar odtwarzacza, na który można kierować reklamy. Zarówno szerokość, jak i wysokość muszą mieć wartości różne od zera.
| Zapis JSON |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| Pola | |
|---|---|
minimumWidth |
Wymagane. Minimalna szerokość odtwarzacza wideo w pikselach. |
minimumHeight |
Wymagane. Minimalna wysokość odtwarzacza wideo w pikselach. |
StringTargetingDimension
Kierowanie ogólne z wartościami ciągu znaków.
| Zapis JSON |
|---|
{
"selectionType": enum ( |
| Pola | |
|---|---|
selectionType |
Wymagane. Sposób kierowania elementów na tej liście. |
values[] |
Wymagane. Określone wartości. |
AdSize
Reprezentuje rozmiar pojedynczego boksu reklamowego lub kreacji.
| Zapis JSON |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| Pola | |
|---|---|
width |
Szerokość boksu reklamowego w pikselach. To pole będzie widoczne tylko wtedy, gdy typ rozmiaru to |
height |
Wysokość boksu reklamowego w pikselach. To pole będzie widoczne tylko wtedy, gdy typ rozmiaru to |
type |
Typ rozmiaru boksu reklamowego. |
Typ
Reprezentuje różne typy rozmiarów boksów reklamowych i kreacji.
| Wartości w polu enum | |
|---|---|
TYPE_UNSPECIFIED |
Obiekt zastępczy dla niezdefiniowanego typu rozmiaru. |
PIXEL |
Boks reklamowy o rozmiarze określonym przez wysokość i szerokość w pikselach. |
INTERSTITIAL |
Specjalny rozmiar opisujący boks reklamy pełnoekranowej. |
NATIVE |
Reklamy natywne (mobilne) renderowane przez wydawcę. |
FLUID |
Rozmiar płynny (elastyczny) może być automatycznie zmieniany wraz ze zmianą środowiska zewnętrznego. |
CriteriaTargeting
Kierowanie ogólne używane do kierowania na wymiary, które zawierają listę uwzględnionych i wykluczonych identyfikatorów numerycznych. Nie można tego filtrować za pomocą składni filtra listy.
| Zapis JSON |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| Pola | |
|---|---|
targetedCriteriaIds[] |
Lista identyfikatorów numerycznych, które mają zostać uwzględnione. |
excludedCriteriaIds[] |
Lista identyfikatorów numerycznych do wykluczenia. |
PackagePlacementTargeting
Reprezentuje kierowanie na miejsca, w których mogą się wyświetlać reklamy, np. na określone witryny lub aplikacje mobilne. Różne typy kierowania na miejsca docelowe będą połączone operatorem logicznym LUB.
| Zapis JSON |
|---|
{ "uriTargeting": { object ( |
| Pola | |
|---|---|
uriTargeting |
Opcjonalnie: Lista adresów URL, na które kierowane są reklamy, lub adresów wykluczonych. Domeny powinny mieć usunięty protokół http/https (np. google.com) i mogą zawierać maksymalnie 5 ścieżek na adres URL. |
mobileAppTargeting |
Opcjonalnie: Lista identyfikatorów aplikacji mobilnych, które należą do wydawców i są objęte kierowaniem lub wykluczone. Obecnie obsługiwane są tylko aplikacje na Androida i Apple. Identyfikator aplikacji na Androida, np. com.google.android.apps.maps, znajdziesz w adresie URL Sklepu Google Play. Identyfikator aplikacji na iOS (który jest liczbą) znajdziesz na końcu adresu URL sklepu iTunes. Aplikacje mobilne własne są uwzględnione lub wykluczone. |
includedMobileAppCategoryTargeting[] |
Opcjonalnie: Lista kategorii aplikacji mobilnych, na które kierowane są reklamy. |
PackagePublisherProvidedSignalsTargeting
Reprezentuje kierowanie na sygnały dostarczane przez wydawcę. Różne typy sygnałów dostarczanych przez wydawcę będą połączone logicznym operatorem LUB.
| Zapis JSON |
|---|
{ "audienceTargeting": { object ( |
| Pola | |
|---|---|
audienceTargeting |
Opcjonalnie: Lista identyfikatorów odbiorców, na których kierowane są reklamy lub którzy są wykluczeni. Na podstawie taksonomii odbiorców IAB w wersji 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) |
contentTargeting |
Opcjonalnie: Lista docelowych lub wykluczonych identyfikatorów Content ID. Na podstawie taksonomii treści IAB w wersji 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) |
videoAndAudioSignalsTargeting |
Opcjonalnie: Lista identyfikatorów kierowanych i wykluczonych sygnałów wideo i audio. Są to dodatkowe sygnały obsługiwane przez sygnały dostarczane przez wydawcę. |
TaxonomyTargeting
Definiuje kryteria kierowania na potrzeby obsługi przestrzeni identyfikatorów taksonomii odbiorców i treści IAB.
| Zapis JSON |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| Pola | |
|---|---|
targetedTaxonomyIds[] |
Opcjonalnie: Lista identyfikatorów taksonomii treści, na które kierowane są reklamy. |
excludedTaxonomyIds[] |
Opcjonalnie: Lista identyfikatorów taksonomii wykluczonych treści. |
CurationFeeVisibility
Widoczność łącznej opłaty za pakiet wyboru i opłat za segment danych (łączna opłata za wybór). Opłaty są zawsze widoczne dla twórcy pakietu.
| Wartości w polu enum | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
Widoczność łącznej opłaty za wybór nie została określona. |
DISCLOSED |
Łączna opłata za wybór jest widoczna dla wszystkich kupujących. Jeśli nie zostanie ustawiona, jest to wartość domyślna. |
NON_DISCLOSED |
Łączna opłata za wybór nie jest widoczna dla wszystkich kupujących. |
Metody |
|
|---|---|
|
Aktywuje istniejący wyselekcjonowany pakiet. |
|
Tworzy nowy pakiet wyselekcjonowany. |
|
Dezaktywuje istniejący wyselekcjonowany pakiet. |
|
Pobiera wybrany pakiet na podstawie nazwy zasobu. |
|
Wyświetla listę wyselekcjonowanych pakietów należących do określonego kuratora. |
|
Aktualizuje istniejący pakiet wyselekcjonowany. |