REST Resource: curators.curatedPackages

Resource: CuratedPackage

Mewakili paket inventaris pilihan yang dibuat dan dikelola oleh Pengelola.

Representasi 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.
}
Kolom
name

string

ID. Nama resource unik untuk paket pilihan. Format: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Wajib. Nama tampilan yang ditetapkan ke paket seleksi oleh kurator. Dapat digunakan untuk memfilter respons metode curatedPackages.list.

description

string

Opsional. Deskripsi paket seleksi, yang diberikan oleh kurator.

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat paket pilihan dibuat. Dapat digunakan untuk memfilter respons metode curatedPackages.list.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat paket pilihan terakhir diperbarui. Dapat digunakan untuk memfilter respons metode curatedPackages.list.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

Opsional. CPM minimum yang harus diajukan oleh pembeli untuk berpartisipasi dalam lelang inventaris di paket pilihan ini. Dapat digunakan untuk memfilter respons metode curatedPackages.list.

state

enum (State)

Hanya output. Status paket pilihan. Dapat digunakan untuk memfilter respons metode curatedPackages.list.

accessSettings

object (AccessControlSettings)

Wajib. Setelan untuk mengontrol akses ke paket pilihan.

Akses ke paket pilihan ini dibatasi untuk Media Planner yang telah masuk daftar yang diizinkan dan kreator. Pembeli dan bidder tidak dapat masuk daftar yang diizinkan atau memiliki akses langsung ke resource ini.

targeting

object (PackageTargeting)

Opsional. Kriteria penargetan untuk paket pilihan.

curationFeeVisibility

enum (CurationFeeVisibility)

Opsional. Tidak dapat diubah. Visibilitas biaya paket seleksi dan biaya segmen data gabungan (total biaya seleksi).

Biaya yang dibayarkan kepada kurator untuk paket ini. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
feeCpm

object (Money)

Opsional. Biaya CPM yang dikenakan oleh pengelola kepada pembeli yang menggunakan paket pilihan ini. Dapat digunakan untuk memfilter respons metode curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

Opsional. Biaya akan ditagih sebagai persentase dari biaya tayangan, yang dinyatakan dalam mili-persen. Misalnya, 1% direpresentasikan sebagai 1000.

Akhir kolom yang saling eksklusif.

Negara Bagian

Status paket pilihan.

Enum
STATE_UNSPECIFIED Nilai default.
ACTIVE Paket pilihan aktif.
INACTIVE Paket pilihan tidak aktif.

AccessControlSettings

Setelan untuk mengontrol akses ke paket pilihan.

Representasi JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Kolom
allowlistedMediaPlanners[]

string

Wajib. Tidak dapat diubah. Daftar perencana media yang secara eksplisit diberi akses ke paket pilihan. Media planner yang memenuhi syarat dapat ditemukan dalam metode mediaPlanners.list. Saat ini, hanya satu Media Planner yang dapat dimasukkan ke daftar yang diizinkan.

Format: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Kriteria penargetan untuk paket pilihan dan lelang.

Representasi 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)
  }
}
Kolom
includedDeviceTypes[]

enum (DeviceType)

Opsional. Daftar jenis perangkat yang disertakan untuk ditargetkan. Jika kosong, semua jenis perangkat akan ditargetkan.

includedEnvironment

enum (Environment)

Opsional. Lingkungan yang akan ditargetkan. Jika tidak ditentukan, semua lingkungan akan ditargetkan.

includedCreativeFormat

enum (CreativeFormat)

Opsional. Format materi iklan yang akan ditargetkan. Jika tidak ditetapkan, semua jenis markup materi iklan akan ditargetkan.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

Opsional. Jenis accelerated mobile page yang ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari status AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

Opsional. Daftar status penjual resmi yang ditargetkan dan disertakan. Jika kosong, inventaris akan ditargetkan terlepas dari status penjual.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

Opsional. Jenis inventaris native yang ditargetkan. Jika kosong, inventaris akan ditargetkan terlepas dari jenis inventaris native.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

Opsional. Daftar jenis pengukuran terbuka yang ditargetkan. Jika kosong, inventaris akan ditargetkan terlepas dari dukungan Pengukuran Terbuka.

includedRestrictedCategories[]

enum (RestrictedCategory)

Opsional. Daftar kategori yang dibatasi yang ditargetkan. Jika kosong, inventaris akan ditargetkan terlepas dari kategori yang dibatasi.

includedRewardedType

enum (RewardedType)

Opsional. Jenis reward yang ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari jenis reward.

videoTargeting

object (PackageVideoTargeting)

Opsional. Kriteria penargetan khusus video.

minimumPredictedViewabilityPercentage

string (int64 format)

Opsional. Persentase visibilitas minimum yang diprediksi dan ditargetkan.

Nilai ini harus berupa kelipatan 10 antara 10 dan 90 (inklusif). Misalnya, 10 valid, tetapi 0, 15, dan 100 tidak valid. Nilai 10 berarti konfigurasi hanya akan cocok dengan slot iklan yang kami prediksi memiliki visibilitas minimal 10%.

Nilai yang tidak ditetapkan menunjukkan bahwa inventaris akan ditargetkan terlepas dari visibilitas yang diprediksi.

languageTargeting

object (StringTargetingDimension)

Opsional. Bahasa yang akan ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan tanpa mempertimbangkan bahasa. Lihat https://developers.google.com/google-ads/api/data/codes-formats#languages untuk mengetahui daftar kode bahasa yang didukung.

includedAdSizes[]

object (AdSize)

Opsional. Daftar ukuran iklan yang akan ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari ukuran iklannya.

Paket pilihan mendukung ukuran iklan PIXEL dan INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

Opsional. Penayang yang ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari penayang. Penayang diidentifikasi berdasarkan ID penayang mereka dari ads.txt/app-ads.txt. Lihat https://iabtechlab.com/ads-txt/ dan https://iabtechlab.com/app-ads-txt/ untuk mengetahui detail selengkapnya.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

Opsional. Target rasio klik-tayang minimum yang diprediksi, dengan rentang nilai [10, 10000] (0,01% - 10%). Nilai 50 berarti konfigurasi hanya akan cocok dengan slot iklan yang kami prediksi memiliki rasio klik-tayang minimal 0,05%.

Nilai yang tidak ditetapkan menunjukkan bahwa inventaris akan ditargetkan terlepas dari prediksi rasio klik-tayang.

verticalTargeting

object (CriteriaTargeting)

Opsional. Vertical yang disertakan atau dikecualikan sebagaimana ditentukan dalam https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari vertikalnya.

geoTargeting

object (CriteriaTargeting)

Opsional. ID kriteria geografis yang akan disertakan atau dikecualikan seperti yang ditentukan di https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari wilayah geografisnya.

includedDataSegments[]

string

Opsional. Segmen data aktif yang akan ditarget. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari segmen data. Format: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Opsional. Informasi penargetan penempatan, misalnya, URL, aplikasi seluler.

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

Opsional. Sinyal yang diberikan penayang untuk ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari sinyal yang diberikan penayang.

DeviceType

Jenis umum perangkat yang akan ditargetkan.

Enum
DEVICE_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
DEVICE_TYPE_PERSONAL_COMPUTER Menargetkan komputer desktop atau laptop.
DEVICE_TYPE_CONNECTED_TV Menargetkan TV yang terhubung: perangkat yang melakukan streaming konten TV, termasuk smart TV, konsol game, dan dekoder/perangkat streaming.
DEVICE_TYPE_PHONE Menargetkan perangkat seluler kelas atas.
DEVICE_TYPE_TABLET Menargetkan perangkat tablet.

Lingkungan

Lingkungan yang akan ditargetkan.

Enum
ENVIRONMENT_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
ENVIRONMENT_SITE Menargetkan inventaris yang dirender dalam situs yang didukung iklan.
ENVIRONMENT_APP Menargetkan inventaris dalam aplikasi seluler.

CreativeFormat

Format materi iklan yang dapat ditarget.

Enum
CREATIVE_FORMAT_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
CREATIVE_FORMAT_DISPLAY Menarget slot iklan yang ditujukan untuk materi iklan Display HTML.
CREATIVE_FORMAT_VIDEO Menargetkan slot iklan yang ditujukan untuk materi iklan video.
CREATIVE_FORMAT_AUDIO Menargetkan slot iklan yang ditujukan untuk materi iklan audio.

AcceleratedMobilePageType

Jenis penerapan Accelerated Mobile Pages (AMP) yang akan ditargetkan.

Enum
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP Menargetkan inventaris di halaman web standar yang tidak menggunakan framework AMP apa pun.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Menargetkan inventaris di halaman yang dibuat menggunakan framework AMP HTML inti.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Menargetkan inventaris di halaman yang menggunakan format Cerita AMP (STAMP), yang dioptimalkan untuk penceritaan visual (misalnya, pengalaman layar penuh yang dapat diketuk).

AuthorizedSellerStatus

Menunjukkan hubungan antara penayang dan penjual seperti yang dinyatakan dalam file ads.txt atau app-ads.txt.

Enum
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
AUTHORIZED_SELLER_STATUS_DIRECT Menargetkan inventaris yang penjualnya dinyatakan sebagai 'DIRECT'. Hal ini menunjukkan bahwa penayang (pemilik konten) mengontrol secara langsung akun penjual dan memiliki kontrak bisnis langsung dengan sistem periklanan untuk akun ini.
AUTHORIZED_SELLER_STATUS_RESELLER Menargetkan inventaris yang penjualnya dinyatakan sebagai 'RESELLER'. Hal ini menunjukkan bahwa penayang telah mengizinkan entitas lain untuk mengoperasikan akun penjual yang tercantum dan menjual kembali ruang iklannya.

NativeInventoryType

Menunjukkan jenis rendering materi iklan yang didukung slot iklan, khususnya terkait iklan native.

Enum
NATIVE_INVENTORY_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Menargetkan slot iklan yang hanya menerima dan merender iklan native.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Menargetkan slot iklan yang menerima dan merender iklan native atau banner.

OpenMeasurementType

Jenis Open Measurement Interface Definition (OMID) yang akan ditargetkan.

Enum
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
OPEN_MEASUREMENT_TYPE_OMID_V1 Menargetkan inventaris yang mendukung Open Measurement Interface Definition (OMID) v1.

RestrictedCategory

Menunjukkan kategori iklan tertentu yang dibatasi oleh kebijakan untuk ditargetkan.

Enum
RESTRICTED_CATEGORY_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
RESTRICTED_CATEGORY_ALCOHOL Menarget inventaris tempat iklan alkohol diizinkan oleh penayang.
RESTRICTED_CATEGORY_GAMBLING Menargetkan inventaris tempat iklan perjudian diizinkan oleh penayang.

RewardedType

Menentukan kriteria penargetan berdasarkan apakah inventaris iklan menawarkan reward kepada pengguna karena melihat iklan.

Enum
REWARDED_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
REWARDED_TYPE_NON_REWARDED Menargetkan inventaris yang TIDAK menawarkan reward eksplisit kepada pengguna karena telah menonton atau berinteraksi dengan iklan.
REWARDED_TYPE_REWARDED Menargetkan inventaris yang menawarkan reward kepada pengguna sebagai imbalan karena telah menonton atau berinteraksi dengan iklan.

PackageVideoTargeting

Kriteria penargetan khusus video.

Representasi JSON
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Kolom
includedMimeTypes[]

enum (VideoMimeType)

Opsional. Daftar jenis MIME video yang ditargetkan menggunakan string jenis MIME yang dipublikasikan IANA (https://www.iana.org/assignments/media-types/media-types.xhtml). Jika kosong, inventaris akan ditargetkan terlepas dari jenis MIME video.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

Opsional. Durasi iklan video maksimum yang ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari durasi iklan video maksimum.

includedPositionTypes[]

enum (PositionType)

Opsional. Jenis posisi iklan video yang ditargetkan. Jika kosong, inventaris akan ditargetkan terlepas dari jenis posisi iklan video.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

Opsional. Metode penayangan video yang ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari metode penayangan video.

plcmtTargeting

object (VideoPlcmtTargeting)

Opsional. Jenis plcmt video yang ditargetkan. Jika tidak ditetapkan, inventaris akan ditargetkan terlepas dari jenis plcmt video.

includedPlaybackMethods[]

enum (PlaybackMethod)

Opsional. Daftar metode pemutaran video yang ditargetkan. Jika kosong, inventaris akan ditargetkan terlepas dari metode pemutaran video.

minimumPredictedCompletionRatePercentage

string (int64 format)

Opsional. Persentase rasio penyelesaian minimum yang diprediksi dan ditargetkan.

Nilai ini harus berupa kelipatan 10 antara 10 dan 90 (inklusif). Misalnya, 10 valid, tetapi 0, 15, dan 100 tidak valid. Nilai 10 berarti konfigurasi hanya akan cocok dengan slot iklan yang kami prediksi memiliki rasio penyelesaian minimal 10%.

Nilai yang tidak ditetapkan menunjukkan bahwa inventaris akan ditargetkan terlepas dari rasio penyelesaian yang diprediksi.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

Opsional. Ukuran pemutar video yang ditargetkan. Jika tidak disetel, inventaris akan ditargetkan terlepas dari ukuran pemutar video.

VideoMimeType

Jenis MIME video yang akan ditargetkan.

Enum
VIDEO_MIME_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
VIDEO_MIME_TYPE_THREEGPP Format penampung 3GPP yang digunakan di ponsel 3G.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 Penampung MPEG-4 biasanya dengan codec H.264.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (digunakan untuk iklan VPAID).
VIDEO_MIME_TYPE_WEBM Penampung WebM dengan asumsi codec VP9.

MaximumVideoAdDuration

Batas atas durasi materi iklan video yang akan ditarget. Nilai enum menentukan bucket, dan memilih nilai berarti durasi materi iklan harus kurang dari atau sama dengan waktu yang ditentukan.

Enum
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS Berlaku untuk iklan video dengan durasi hingga 15 detik (0 < durasi <= 15 dtk).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS Berlaku untuk iklan video dengan durasi hingga 20 detik (0 < durasi <= 20 dtk).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS Berlaku untuk iklan video dengan durasi hingga 30 detik (0 < durasi <= 30 dtk).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS Berlaku untuk iklan video dengan durasi hingga 60 detik (0 < durasi <= 60 dtk).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS Berlaku untuk iklan video dengan durasi hingga 90 detik (0 < durasi <= 90 dtk).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS Berlaku untuk iklan video dengan durasi hingga 120 detik (0 < durasi <= 120 dtk).

PositionType

Posisi iklan yang dapat ditarget dalam video.

Enum
POSITION_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
POSITION_TYPE_MIDROLL Iklan diputar di tengah konten video.
POSITION_TYPE_POSTROLL Iklan diputar setelah konten video.
POSITION_TYPE_PREROLL Iklan diputar sebelum konten video.

ContentDeliveryMethod

Kriteria penargetan berdasarkan metode penayangan konten video.

Enum
CONTENT_DELIVERY_METHOD_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
CONTENT_DELIVERY_METHOD_STREAMING Menargetkan konten video yang disiarkan secara live.
CONTENT_DELIVERY_METHOD_PROGRESSIVE Menargetkan konten video yang ditransfer secara bertahap sesuai kebutuhan pemutaran klien.

VideoPlcmtTargeting

Menentukan kriteria penargetan berdasarkan jenis penempatan video, yang sering kali sesuai dengan kolom 'plcmt' OpenRTB IAB.

Representasi JSON
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Kolom
selectionType

enum (SelectionType)

Wajib. Jenis pilihan untuk daftar penempatan video.

videoPlcmtTypes[]

enum (VideoPlcmtType)

Wajib. Daftar jenis penempatan video yang ditargetkan. Jika kosong, inventaris akan ditargetkan terlepas dari jenis plcmt video.

SelectionType

Enum untuk kemungkinan jenis pilihan yang digunakan oleh dimensi penargetan.

Enum
SELECTION_TYPE_UNSPECIFIED Jenis pilihan tidak ditentukan. Tidak boleh digunakan.
SELECTION_TYPE_INCLUDE Nilai dalam dimensi penargetan disertakan.
SELECTION_TYPE_EXCLUDE Nilai dalam dimensi penargetan dikecualikan.

VideoPlcmtType

Mewakili jenis penempatan video, sesuai dengan standar OpenRTB.

Enum
VIDEO_PLCMT_TYPE_UNSPECIFIED Nilai default. Tidak boleh digunakan dalam spesifikasi penargetan.
INSTREAM Iklan pre-roll, mid-roll, dan post-roll yang diputar sebelum, selama, atau setelah konten video streaming yang diminta konsumen. Video instream harus disetel ke “suara aktif” secara default saat pemutar dimulai, atau memiliki niat pengguna yang jelas untuk menonton konten video. Meskipun mungkin ada konten lain di sekitar pemutar, konten video harus menjadi fokus kunjungan pengguna. Video tersebut harus tetap menjadi konten utama di halaman dan satu-satunya pemutar video yang terlihat dan dapat memutar audio saat diputar. Jika pemutar dikonversi menjadi mengambang/statis, panggilan iklan berikutnya harus secara akurat menyampaikan ukuran pemutar yang diperbarui.
ACCOMPANYING_CONTENT Iklan pre-roll, mid-roll, dan post-roll yang diputar sebelum, selama, atau setelah konten video streaming. Pemutar video dimuat dan diputar sebelum, di antara, atau setelah paragraf teks atau konten grafis, dan mulai diputar hanya saat memasuki area pandang. Konten pengiring hanya boleh memulai pemutaran setelah memasuki area pandang. Pemutar ini dapat dikonversi menjadi pemutar mengambang/statis saat di-scroll keluar dari halaman.
INTERSTITIAL Iklan video yang diputar tanpa konten video. Selama pemutaran, iklan harus menjadi fokus utama halaman dan mengisi sebagian besar area tampilan serta tidak dapat di-scroll hingga tidak terlihat. Hal ini dapat dilakukan di penempatan seperti video dalam aplikasi atau slideshow.
NO_CONTENT Iklan video yang diputar tanpa konten video streaming. Iklan ini dapat berada di penempatan seperti slideshow, feed native, dalam konten, atau melekat/mengambang.

PlaybackMethod

Metode pemutaran yang akan ditargetkan.

Enum
PLAYBACK_METHOD_UNSPECIFIED Metode pemutaran video tidak ditentukan. Tidak boleh digunakan.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON Pemutaran dimulai secara otomatis saat halaman/konten dimuat.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF Pemutaran dimulai secara otomatis saat halaman/konten dimuat, tetapi dengan suara nonaktif.
PLAYBACK_METHOD_CLICK_TO_PLAY Pemutaran dimulai oleh tindakan pengguna (misalnya, mengklik tombol putar).

VideoPlayerSizeTargeting

Menunjukkan ukuran pemutar video yang dapat ditarget. Lebar dan tinggi harus ditetapkan ke nilai bukan nol.

Representasi JSON
{
  "minimumWidth": string,
  "minimumHeight": string
}
Kolom
minimumWidth

string (int64 format)

Wajib. Lebar minimum pemutar video dalam piksel.

minimumHeight

string (int64 format)

Wajib. Tinggi minimum pemutar video dalam piksel.

StringTargetingDimension

Penargetan umum dengan nilai string.

Representasi JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Kolom
selectionType

enum (SelectionType)

Wajib. Cara item dalam daftar ini harus ditargetkan.

values[]

string

Wajib. Nilai yang ditentukan.

AdSize

Menunjukkan ukuran satu slot iklan, atau materi iklan.

Representasi JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Kolom
width

string (int64 format)

Lebar slot iklan dalam piksel. Kolom ini hanya akan ada jika jenis ukuran adalah PIXEL.

height

string (int64 format)

Tinggi slot iklan dalam piksel. Kolom ini hanya akan ada jika jenis ukuran adalah PIXEL.

type

enum (Type)

Jenis ukuran slot iklan.

Jenis

Merepresentasikan berbagai jenis ukuran slot iklan/materi iklan.

Enum
TYPE_UNSPECIFIED Placeholder untuk jenis ukuran yang tidak ditentukan.
PIXEL Slot iklan dengan ukuran yang ditentukan berdasarkan tinggi dan lebar dalam piksel.
INTERSTITIAL Ukuran khusus untuk mendeskripsikan slot iklan interstisial.
NATIVE Iklan native (seluler) yang dirender oleh penayang.
FLUID Ukuran fleksibel (ukuran responsif) dapat diubah ukurannya secara otomatis dengan perubahan lingkungan luar.

CriteriaTargeting

Penargetan umum yang digunakan untuk dimensi penargetan yang berisi daftar ID numerik yang disertakan dan dikecualikan. Hal ini tidak dapat difilter menggunakan sintaksis filter daftar.

Representasi JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Kolom
targetedCriteriaIds[]

string (int64 format)

Daftar ID numerik yang akan disertakan.

excludedCriteriaIds[]

string (int64 format)

Daftar ID numerik yang akan dikecualikan.

PackagePlacementTargeting

Merepresentasikan penargetan tentang tempat iklan dapat muncul, misalnya, situs atau aplikasi seluler tertentu. Jenis penargetan penempatan yang berbeda akan digabungkan secara logis dengan operator OR.

Representasi JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Kolom
uriTargeting

object (StringTargetingDimension)

Opsional. Daftar URL yang ditargetkan atau dikecualikan. Domain harus menghapus http/https (misalnya, google.com), dan dapat berisi maksimal 5 jalur per URL.

mobileAppTargeting

object (StringTargetingDimension)

Opsional. Daftar ID aplikasi seluler yang ditargetkan atau dikecualikan yang dimiliki penayang. Saat ini, hanya aplikasi Android dan Apple yang didukung.

ID Aplikasi Android, misalnya, com.google.android.apps.maps, dapat ditemukan di URL Google Play Store. ID Aplikasi iOS (yang berupa angka) dapat ditemukan di akhir URL iTunes Store. Aplikasi seluler pihak pertama disertakan atau dikecualikan.

includedMobileAppCategoryTargeting[]

string (int64 format)

Opsional. Daftar kategori aplikasi seluler yang ditargetkan.

PackagePublisherProvidedSignalsTargeting

Mewakili penargetan tentang sinyal yang diberikan penayang. Jenis sinyal yang diberikan penayang yang berbeda akan dihubungkan secara logis dengan ATAU.

Representasi JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Kolom
audienceTargeting

object (TaxonomyTargeting)

Opsional. Daftar ID audiens yang ditargetkan atau dikecualikan. Berdasarkan Taksonomi Audiens IAB versi 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

Opsional. Daftar Content ID yang ditargetkan atau dikecualikan. Berdasarkan Taksonomi Konten IAB versi 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

Opsional. Daftar ID sinyal video dan audio yang ditargetkan dan dikecualikan. Sinyal ini adalah sinyal tambahan yang didukung oleh sinyal yang diberikan penayang.

TaxonomyTargeting

Menentukan kriteria penargetan untuk menangani ruang ID Taksonomi audiens dan konten IAB.

Representasi JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Kolom
targetedTaxonomyIds[]

string

Opsional. Daftar ID taksonomi konten yang ditargetkan.

excludedTaxonomyIds[]

string

Opsional. Daftar ID taksonomi konten yang dikecualikan.

CurationFeeVisibility

Visibilitas biaya paket seleksi dan biaya segmen data gabungan (total biaya seleksi). Biaya selalu terlihat oleh pembuat paket.

Enum
CURATION_FEE_VISIBILITY_UNSPECIFIED Visibilitas total biaya seleksi tidak ditentukan.
DISCLOSED Total biaya seleksi dapat dilihat oleh semua pembeli. Ini adalah nilai default jika tidak ditetapkan.
NON_DISCLOSED Total biaya seleksi tidak dapat dilihat oleh semua pembeli.

Metode

activate

Mengaktifkan paket pilihan yang ada.

create

Membuat paket pilihan baru.

deactivate

Menonaktifkan paket pilihan yang ada.

get

Mendapatkan paket pilihan berdasarkan nama resourcenya.

list

Mencantumkan paket pilihan yang dimiliki oleh kurator yang ditentukan.

patch

Memperbarui paket pilihan yang ada.