REST Resource: curators.curatedPackages

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 (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Pola
name

string

Identyfikator. Unikalna nazwa zasobu wybranego pakietu. Format: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Wymagane. Wyświetlana nazwa przypisana do wybranego pakietu przez kuratora. Można go użyć do filtrowania odpowiedzi metody curatedPackages.list.

description

string

Opcjonalnie: Opis wybranego pakietu podany przez kuratora.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy został utworzony wyselekcjonowany pakiet. Można go użyć do filtrowania odpowiedzi metody curatedPackages.list.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy pakiet wyselekcjonowany został ostatnio zaktualizowany. Można go użyć do filtrowania odpowiedzi metody curatedPackages.list.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

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

state

enum (State)

Tylko dane wyjściowe. Stan wybranego pakietu. Można go użyć do filtrowania odpowiedzi metody curatedPackages.list.

accessSettings

object (AccessControlSettings)

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

object (PackageTargeting)

Opcjonalnie: Kryteria kierowania dla wybranego pakietu.

curationFeeVisibility

enum (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

object (Money)

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

millipercentOfMediaFee

string (int64 format)

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[]

string

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 mediaPlanners.list. Obecnie na liście dozwolonych może znajdować się tylko 1 media planner(ka).

Format: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Kryteria kierowania w przypadku pakietów wyselekcjonowanych i pakietów aukcji.

Zapis JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Pola
includedDeviceTypes[]

enum (DeviceType)

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

enum (Environment)

Opcjonalnie: Środowisko, na które chcesz kierować reklamy. Jeśli nie zostanie określone, kierowanie będzie obejmować wszystkie środowiska.

includedCreativeFormat

enum (CreativeFormat)

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

enum (AcceleratedMobilePageType)

Opcjonalnie: Typ docelowej przyspieszonej strony mobilnej. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od stanu AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

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[]

enum (NativeInventoryType)

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[]

enum (OpenMeasurementType)

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[]

enum (RestrictedCategory)

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

enum (RewardedType)

Opcjonalnie: Docelowy typ reklamy z nagrodą. Jeśli nie skonfigurujesz tego ustawienia, zasoby reklamowe będą kierowane niezależnie od typu nagrody.

videoTargeting

object (PackageVideoTargeting)

Opcjonalnie: Kryteria kierowania dotyczące filmów.

minimumPredictedViewabilityPercentage

string (int64 format)

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

object (StringTargetingDimension)

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[]

object (AdSize)

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 PIXEL i INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

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

string (int64 format)

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

object (CriteriaTargeting)

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

object (CriteriaTargeting)

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[]

string

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: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Opcjonalnie: Informacje o kierowaniu na miejsca docelowe, np. adres URL, aplikacje mobilne.

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

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 (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Pola
includedMimeTypes[]

enum (VideoMimeType)

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

enum (MaximumVideoAdDuration)

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[]

enum (PositionType)

Opcjonalnie: Typy pozycji docelowych reklam wideo. Jeśli pole jest puste, zasoby reklamowe będą kierowane niezależnie od typu pozycji reklamy wideo.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

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

object (VideoPlcmtTargeting)

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[]

enum (PlaybackMethod)

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

string (int64 format)

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

object (VideoPlayerSizeTargeting)

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 (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Pola
selectionType

enum (SelectionType)

Wymagane. Typ wyboru listy miejsc docelowych wideo.

videoPlcmtTypes[]

enum (VideoPlcmtType)

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

string (int64 format)

Wymagane. Minimalna szerokość odtwarzacza wideo w pikselach.

minimumHeight

string (int64 format)

Wymagane. Minimalna wysokość odtwarzacza wideo w pikselach.

StringTargetingDimension

Kierowanie ogólne z wartościami ciągu znaków.

Zapis JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Pola
selectionType

enum (SelectionType)

Wymagane. Sposób kierowania elementów na tej liście.

values[]

string

Wymagane. Określone wartości.

AdSize

Reprezentuje rozmiar pojedynczego boksu reklamowego lub kreacji.

Zapis JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Pola
width

string (int64 format)

Szerokość boksu reklamowego w pikselach. To pole będzie widoczne tylko wtedy, gdy typ rozmiaru to PIXEL.

height

string (int64 format)

Wysokość boksu reklamowego w pikselach. To pole będzie widoczne tylko wtedy, gdy typ rozmiaru to PIXEL.

type

enum (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[]

string (int64 format)

Lista identyfikatorów numerycznych, które mają zostać uwzględnione.

excludedCriteriaIds[]

string (int64 format)

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 (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Pola
uriTargeting

object (StringTargetingDimension)

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

object (StringTargetingDimension)

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[]

string (int64 format)

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 (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Pola
audienceTargeting

object (TaxonomyTargeting)

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

object (TaxonomyTargeting)

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

object (StringTargetingDimension)

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[]

string

Opcjonalnie: Lista identyfikatorów taksonomii treści, na które kierowane są reklamy.

excludedTaxonomyIds[]

string

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

activate

Aktywuje istniejący wyselekcjonowany pakiet.

create

Tworzy nowy pakiet wyselekcjonowany.

deactivate

Dezaktywuje istniejący wyselekcjonowany pakiet.

get

Pobiera wybrany pakiet na podstawie nazwy zasobu.

list

Wyświetla listę wyselekcjonowanych pakietów należących do określonego kuratora.

patch

Aktualizuje istniejący pakiet wyselekcjonowany.