REST Resource: advertisers.lineItems

Resource: LineItem

Satu item baris.

Representasi JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Kolom
name

string

Hanya output. Nama resource item baris.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki item baris.
campaignId

string (int64 format)

Hanya output. ID unik kampanye yang memiliki item baris.
insertionOrderId

string (int64 format)

Wajib. Tidak dapat diubah. ID unik perintah penyisipan tempat item baris berada.
lineItemId

string (int64 format)

Hanya output. ID unik item baris. Ditetapkan oleh sistem.
displayName

string

Wajib. Nama tampilan item baris.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.
lineItemType

enum (LineItemType)

Wajib. Tidak dapat diubah. Jenis item baris.
entityStatus

enum (EntityStatus)

Wajib. Mengontrol apakah item baris dapat membelanjakan anggarannya dan mengajukan bid pada inventaris.

  • Untuk metode lineItems.create, hanya ENTITY_STATUS_DRAFT yang diizinkan. Untuk mengaktifkan item baris, gunakan metode lineItems.patch dan perbarui status ke ENTITY_STATUS_ACTIVE setelah pembuatan.
  • Item baris tidak dapat diubah kembali ke status ENTITY_STATUS_DRAFT dari status lainnya.
  • Jika pesanan pemasangan induk item baris tidak aktif, item baris tidak dapat membelanjakan anggarannya meskipun statusnya sendiri adalah ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat item baris terakhir diperbarui. Ditetapkan oleh sistem.

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".
partnerCosts[]

object (PartnerCost)

Biaya partner yang terkait dengan item baris.

Jika tidak ada atau kosong dalam metode lineItems.create, item baris yang baru dibuat akan mewarisi biaya partner dari perintah penyisipan induknya.
flight

object (LineItemFlight)

Wajib. Waktu mulai dan berakhirnya periode tayang item baris.
budget

object (LineItemBudget)

Wajib. Setelan alokasi anggaran item baris.
pacing

object (Pacing)

Wajib. Setelan kecepatan pembelanjaan anggaran item baris.
frequencyCap

object (FrequencyCap)

Opsional. Wajib jika jenis item baris bukan LINE_ITEM_TYPE_DEMAND_GEN. Setelan batas frekuensi tayangan iklan item baris.

Kolom maxImpressions dalam objek setelan ini harus digunakan jika menetapkan batas terbatas.
partnerRevenueModel

object (PartnerRevenueModel)

Wajib. Setelan model pendapatan partner untuk item baris.
conversionCounting

object (ConversionCountingConfig)

Setelan tracking konversi item baris.
creativeIds[]

string (int64 format)

ID materi iklan yang dikaitkan dengan item baris.
bidStrategy

object (BiddingStrategy)

Wajib. Strategi bidding item baris.
integrationDetails

object (IntegrationDetails)

Detail integrasi item baris.
targetingExpansion

object (TargetingExpansionConfig)

Setelan penargetan yang dioptimalkan pada item baris.

Konfigurasi ini hanya berlaku untuk item baris display, video, atau audio yang menggunakan bidding otomatis dan menargetkan daftar audiens yang memenuhi syarat secara positif.
warningMessages[]

enum (LineItemWarningMessage)

Hanya output. Pesan peringatan yang dihasilkan oleh item baris. Peringatan ini tidak menghalangi penyimpanan item baris, tetapi beberapa peringatan dapat menghalangi penayangan item baris.
mobileApp

object (MobileApp)

Aplikasi seluler yang dipromosikan oleh item baris.

Opsi ini hanya berlaku jika lineItemType adalah LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL atau LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Hanya output. Jenis reservasi item baris.
excludeNewExchanges

boolean

Apakah akan mengecualikan bursa baru agar tidak otomatis ditargetkan oleh item baris. Kolom ini secara default adalah salah (false).
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Hanya output. Setelan khusus untuk item baris YouTube dan Partner.
demandGenSettings

object (DemandGenSettings)

Opsional. Setelan khusus untuk item baris Peningkat Permintaan.

Hanya berlaku untuk item baris Peningkat Permintaan.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Apakah item baris ini akan menayangkan iklan politik Uni Eropa.

Jika containsEuPoliticalAds telah ditetapkan ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING di pengiklan induk, kolom ini akan ditetapkan ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING jika tidak ditentukan lain. Kemudian, kolom ini dapat diperbarui menggunakan UI, API, atau File Data Terstruktur.

Kolom ini harus ditetapkan saat membuat item baris baru. Jika tidak, permintaan advertisers.lineItems.create akan gagal.
optimizeFixedBidding

boolean

Opsional. Apakah akan mengaktifkan pengoptimalan bid DV360 untuk item baris bid tetap.

Secara default, DV360 mengoptimalkan bid tetap Anda dengan otomatis menurunkan bid untuk tayangan iklan yang cenderung berperforma kurang baik. Pengoptimalan ini diaktifkan secara default (nilainya benar).

Jika kolom ini disetel ke false, pengoptimalan ini akan dinonaktifkan, dan bid tidak akan diturunkan karena alasan apa pun.

Setelan ini hanya berlaku untuk item baris dengan biddingStrategy jenis FIXED_BID.

LineItemType

Kemungkinan jenis item baris.

Jenis item baris menentukan setelan dan opsi yang berlaku, seperti format iklan atau opsi penargetan.

Enum
LINE_ITEM_TYPE_UNSPECIFIED

Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_DISPLAY_DEFAULT Iklan gambar, HTML5, native, atau multimedia.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Menampilkan iklan yang mendorong penginstalan aplikasi.
LINE_ITEM_TYPE_VIDEO_DEFAULT Iklan video dijual berdasarkan CPM untuk berbagai lingkungan.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Iklan video yang mendorong penginstalan aplikasi.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Iklan Display yang ditayangkan di inventaris aplikasi seluler.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Iklan video yang ditayangkan di inventaris aplikasi seluler.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_AUDIO_DEFAULT Iklan Audio RTB dijual untuk berbagai lingkungan.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Iklan over-the-top yang ada dalam perintah penyisipan OTT. Jenis ini hanya berlaku untuk item baris dengan pesanan pemasangan iklan insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Iklan video YouTube yang mempromosikan konversi.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Iklan video YouTube (hingga 15 detik) yang tidak dapat dilewati.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Iklan video YouTube yang menampilkan cerita dalam urutan tertentu menggunakan kombinasi format.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Iklan audio YouTube.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Iklan video YouTube yang mengoptimalkan jangkauan lebih banyak pengguna unik dengan biaya yang lebih rendah. Dapat mencakup iklan bumper, iklan in-stream yang dapat dilewati, atau kombinasi jenis iklan.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Iklan video YouTube default.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Iklan video YouTube TV terhubung (hingga 15 detik) yang tidak dapat dilewati.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Iklan video YouTube TV yang terhubung yang mengoptimalkan jangkauan lebih banyak pengguna unik dengan biaya yang lebih rendah. Dapat mencakup iklan bumper, iklan in-stream yang dapat dilewati, atau kombinasi jenis iklan.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Iklan video YouTube default TV yang terhubung. Hanya sertakan format iklan dalam stream.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Tujuan jenis item baris ini adalah untuk menampilkan iklan YouTube dengan target frekuensi tertentu kepada orang yang sama dalam jangka waktu tertentu.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Iklan video YouTube yang bertujuan untuk mendapatkan lebih banyak penayangan dengan berbagai format iklan.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Iklan Display yang ditayangkan di inventaris iklan digital luar ruangan.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Iklan video yang ditayangkan di inventaris iklan digital luar ruangan.

Item baris jenis ini dan penargetannya tidak dapat dibuat atau diperbarui menggunakan API.
LINE_ITEM_TYPE_DEMAND_GEN

Iklan Peningkat Permintaan.

LineItemFlight

Setelan yang mengontrol durasi aktif item baris.

Representasi JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Kolom
flightDateType

enum (LineItemFlightDateType)

Wajib. Jenis tanggal periode tayang item baris.
dateRange

object (DateRange)

Tanggal mulai dan akhir penayangan item baris. Waktu tersebut diselesaikan relatif terhadap zona waktu pengiklan induk.

  • Wajib jika flightDateType adalah LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Jika tidak, hanya output.
  • Saat membuat penerbangan baru, startDate dan endDate harus berada di masa mendatang.
  • Penerbangan yang sudah ada dengan startDate di masa lalu memiliki endDate yang dapat diubah, tetapi startDate yang tidak dapat diubah.
  • endDate harus startDate atau yang lebih baru, keduanya sebelum tahun 2037.

LineItemFlightDateType

Kemungkinan jenis tanggal periode tayang item baris.

Enum
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED Tanggal penayangan item baris diwarisi dari perjanjian pemasangan iklan induknya.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM Item baris menggunakan tanggal periode tayang kustomnya sendiri.

LineItemBudget

Setelan yang mengontrol cara anggaran dialokasikan.

Representasi JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Kolom
budgetAllocationType

enum (LineItemBudgetAllocationType)

Wajib. Jenis alokasi anggaran.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC hanya berlaku jika alokasi anggaran otomatis diaktifkan untuk surat perintah sisipan induk.

Kolom ini harus disetel ke LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED untuk item baris Peningkat Permintaan.
budgetUnit

enum (BudgetUnit)

Hanya output. Unit anggaran menentukan apakah anggaran berbasis mata uang atau tayangan iklan. Nilai ini diwarisi dari perintah penyisipan induk.
maxAmount

string (int64 format)

Jumlah anggaran maksimum yang akan dibelanjakan item baris. Harus lebih besar dari 0.

Jika budgetAllocationType adalah:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, kolom ini tidak dapat diubah dan ditetapkan oleh sistem.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, jika budgetUnit adalah:
    • BUDGET_UNIT_CURRENCY, kolom ini menampilkan jumlah anggaran maksimum yang akan dibelanjakan, dalam mikro mata uang pengiklan. Misalnya, 1500000 mewakili 1,5 unit standar mata uang.
    • BUDGET_UNIT_IMPRESSIONS, kolom ini menunjukkan jumlah tayangan iklan maksimum yang akan ditayangkan.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, kolom ini tidak berlaku dan akan diabaikan oleh sistem.

LineItemBudgetAllocationType

Kemungkinan jenis alokasi anggaran.

Enum
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC Alokasi anggaran otomatis diaktifkan untuk item baris.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Jumlah anggaran maksimum tetap dialokasikan untuk item baris.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Tidak ada batas anggaran yang diterapkan ke item baris.

PartnerRevenueModel

Setelan yang mengontrol cara penghitungan pendapatan partner.

Representasi JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Kolom
markupType

enum (PartnerRevenueModelMarkupType)

Wajib. Jenis markup model pendapatan partner.

Kolom ini harus disetel ke PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP untuk item baris Peningkat Permintaan.
markupAmount

string (int64 format)

Wajib. Jumlah markup model pendapatan partner. Harus lebih besar dari atau sama dengan 0.

  • Jika markupType ditetapkan ke PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, kolom ini menunjukkan markup CPM dalam mikro mata uang pengiklan. Misalnya, 1500000 mewakili 1,5 unit standar mata uang.
  • Jika markupType ditetapkan menjadi PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, kolom ini menunjukkan markup persen biaya media dalam milidetik. Misalnya, 100 mewakili 0,1% (desimal 0,001).
  • Jika markupType ditetapkan menjadi PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, kolom ini menunjukkan total markup persentase biaya media dalam milidetik. Misalnya, 100 mewakili 0,1% (desimal 0,001).

PartnerRevenueModelMarkupType

Kemungkinan jenis markup model pendapatan partner.

Enum
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Menghitung pendapatan partner berdasarkan CPM tetap.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Menghitung pendapatan partner berdasarkan biaya tambahan persentase dari biaya medianya.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Menghitung pendapatan partner berdasarkan biaya tambahan persentase dari total biaya media, yang mencakup semua biaya partner dan biaya data.

ConversionCountingConfig

Setelan yang mengontrol cara penghitungan konversi.

Semua konversi pasca-klik akan dihitung. Nilai persentase dapat ditetapkan untuk penghitungan konversi pasca-lihat.

Representasi JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
Kolom
postViewCountPercentageMillis

string (int64 format)

Persentase konversi pascatayang yang akan dihitung, dalam milidetik (1/1000 persen). Harus antara 0 dan 100000 inklusif.

Misalnya, untuk melacak 50% konversi pasca-klik, tetapkan nilai 50000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Konfigurasi aktivitas Floodlight yang digunakan untuk melacak konversi.

Jumlah konversi yang dihitung adalah jumlah semua konversi yang dihitung oleh semua ID aktivitas Floodlight yang ditentukan di kolom ini.

Kolom ini tidak dapat diperbarui jika algoritma bidding kustom ditetapkan ke item baris. Jika Anda menetapkan kolom ini dan menetapkan algoritma bidding kustom dalam permintaan yang sama, aktivitas Floodlight harus cocok dengan yang digunakan oleh algoritma bidding kustom.
primaryAttributionModelId

string (int64 format)

Opsional. Model atribusi yang akan digunakan untuk pengukuran konversi. Model atribusi ini akan menentukan cara penghitungan konversi. Model Utama dapat ditetapkan oleh Anda untuk konfigurasi atau grup Floodlight. Lihat detail selengkapnya di sini.

Hanya berlaku untuk item baris Peningkat Permintaan.

TrackingFloodlightActivityConfig

Setelan yang mengontrol perilaku konfigurasi satu aktivitas Floodlight.

Representasi JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Kolom
floodlightActivityId

string (int64 format)

Wajib. ID aktivitas Floodlight.
postClickLookbackWindowDays

integer

Wajib. Jumlah hari setelah iklan diklik saat konversi dapat dihitung. Harus antara 0 dan 90 inklusif.
postViewLookbackWindowDays

integer

Wajib. Jumlah hari setelah iklan dilihat saat konversi dapat dihitung. Harus antara 0 dan 90 inklusif.

LineItemWarningMessage

Pesan peringatan yang dihasilkan oleh item baris. Jenis peringatan ini tidak memblokir penyimpanan item baris, tetapi dapat memblokir penayangan item baris.

Enum
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
INVALID_FLIGHT_DATES Item baris ini memiliki tanggal periode tayang yang tidak valid. Item baris tidak akan ditayangkan.
EXPIRED Tanggal akhir item baris ini sudah berlalu.
PENDING_FLIGHT Item baris ini akan mulai berjalan di masa mendatang.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Semua bursa yang diaktifkan partner ditargetkan secara negatif. Item baris tidak akan ditayangkan.
INVALID_INVENTORY_SOURCE Sumber inventaris aktif tidak ditargetkan. Item baris tidak akan ditayangkan.
APP_INVENTORY_INVALID_SITE_TARGETING Penargetan Aplikasi & URL item baris ini tidak menyertakan aplikasi seluler mana pun. Jenis item baris ini mengharuskan Anda menyertakan aplikasi seluler dalam penargetan saluran, daftar situs, atau aplikasi Anda. Item baris tidak akan ditayangkan.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Item baris ini tidak menargetkan pengguna seluler mana pun. Jenis item baris ini mengharuskan Anda menargetkan daftar pengguna yang berisi pengguna seluler. Item baris tidak akan ditayangkan.
NO_VALID_CREATIVE Item baris ini tidak berisi materi iklan yang valid. Item baris tidak akan ditayangkan.
PARENT_INSERTION_ORDER_PAUSED Perjanjian pemasangan iklan untuk item baris ini dijeda. Item baris tidak akan ditayangkan.
PARENT_INSERTION_ORDER_EXPIRED Tanggal akhir perjanjian pemasangan iklan untuk item baris ini ditetapkan ke tanggal yang sudah lewat. Item baris tidak akan ditayangkan.

MobileApp

Aplikasi seluler yang dipromosikan oleh item baris instal aplikasi seluler.

Representasi JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Kolom
appId

string

Wajib. ID aplikasi yang disediakan oleh toko platform.

Aplikasi Android diidentifikasi berdasarkan ID paket yang digunakan oleh Play Store Android, seperti com.google.android.gm.

Aplikasi iOS diidentifikasi dengan ID aplikasi sembilan digit yang digunakan oleh App Store Apple, seperti 422689480.
platform

enum (Platform)

Hanya output. Platform aplikasi.
displayName

string

Hanya output. Nama aplikasi.
publisher

string

Hanya output. Penerbit aplikasi.

Platform

Kemungkinan platform aplikasi seluler.

Enum
PLATFORM_UNSPECIFIED Platform tidak ditentukan.
IOS Platform iOS.
ANDROID Platform Android.

YoutubeAndPartnersSettings

Setelan untuk item baris YouTube dan Partner.

Representasi JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Kolom
viewFrequencyCap

object (FrequencyCap)

Setelan batas frekuensi penayangan item baris.

Kolom maxViews dalam objek setelan ini harus digunakan jika menetapkan batas terbatas.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opsional. Konfigurasi pengukuran pihak ketiga dari item baris.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Setelan yang mengontrol inventaris YouTube dan Partner yang akan ditargetkan oleh item baris.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Hanya output. Jenis konten tempat iklan YouTube dan Partner akan ditampilkan.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Hanya output. Kategori konten yang berlaku saat menayangkan item baris. Jika kategori konten ditetapkan di item baris dan pengiklan, kategori yang lebih ketat akan berlaku saat menayangkan item baris.

Item baris baru hanya akan mewarisi setelan tingkat pengiklan.
targetFrequency

object (TargetFrequency)

Opsional. Frekuensi rata-rata yang Anda inginkan untuk menampilkan iklan dari item baris ini kepada orang yang sama selama jangka waktu tertentu.
linkedMerchantId

string (int64 format)

Opsional. ID akun Merchant Center yang digunakan untuk menyediakan feed produk.

Akun Merchant Center ini harus sudah ditautkan ke pengiklan.
relatedVideoIds[]

string

Opsional. ID video akan muncul di bawah iklan video utama saat iklan diputar di aplikasi YouTube di perangkat seluler.
leadFormId

string (int64 format)

Opsional. ID formulir untuk menghasilkan prospek.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Opsional. Setelan yang terkait dengan VideoAdSequence.
videoAdInventoryControl

object (VideoAdInventoryControl)

Opsional. Setelan untuk mengontrol inventaris yang diizinkan untuk item baris ini.

ThirdPartyMeasurementConfigs

Setelan yang mengontrol vendor pihak ketiga yang mengukur metrik item baris tertentu.

Representasi JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Kolom
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Opsional. Vendor pihak ketiga yang mengukur visibilitas.

Vendor pihak ketiga berikut berlaku:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Opsional. Vendor pihak ketiga yang mengukur keamanan merek.

Vendor pihak ketiga berikut berlaku:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Opsional. Vendor pihak ketiga yang mengukur jangkauan.

Vendor pihak ketiga berikut berlaku:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Opsional. Vendor pihak ketiga yang mengukur Brand Lift.

Vendor pihak ketiga berikut berlaku:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Setelan yang mengontrol cara vendor pengukuran pihak ketiga dikonfigurasi.

Representasi JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Kolom
vendor

enum (ThirdPartyVendor)

Vendor pengukuran pihak ketiga.
placementId

string

ID yang digunakan oleh platform vendor pihak ketiga untuk mengidentifikasi item baris.

ThirdPartyVendor

Vendor yang melakukan pengukuran pihak ketiga.

Enum
THIRD_PARTY_VENDOR_UNSPECIFIED Vendor pihak ketiga yang tidak dikenal.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Telemetri.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN Asal Anda.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV Ispot TV.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.

YoutubeAndPartnersInventorySourceConfig

Setelan yang mengontrol inventaris terkait YouTube yang akan ditargetkan oleh item baris YouTube dan Partner.

Representasi JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Kolom
includeYoutube

boolean

Opsional. Apakah akan menargetkan inventaris di YouTube. Hal ini mencakup penelusuran, channel, dan video.
includeGoogleTv

boolean

Opsional. Apakah akan menargetkan inventaris di aplikasi video yang tersedia di Google TV.
includeYoutubeVideoPartners

boolean

Apakah akan menargetkan inventaris di kumpulan situs dan aplikasi partner yang mengikuti standar keamanan merek yang sama dengan YouTube.

YoutubeAndPartnersContentCategory

Kategori keamanan merek untuk konten YouTube dan Partner.

Enum
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Kategori konten tidak ditentukan atau tidak diketahui dalam versi ini.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Kategori yang terdiri dari berbagai konten yang sesuai untuk sebagian besar merek. Konten ini didasarkan pada pedoman konten yang cocok untuk pengiklan YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Kategori yang mencakup semua konten di YouTube dan partner video yang memenuhi standar untuk monetisasi.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Kategori yang terdiri dari konten dengan rentang yang lebih kecil yang memenuhi persyaratan yang lebih tinggi, terutama terkait bahasa yang tidak pantas dan konten yang menjurus ke arah seksual.

TargetFrequency

Setelan yang mengontrol jumlah rata-rata penayangan iklan kepada orang yang sama selama jangka waktu tertentu.

Representasi JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Kolom
targetCount

string (int64 format)

Target frekuensi rata-rata iklan akan ditampilkan kepada orang yang sama dalam rentang waktu yang ditentukan oleh timeUnit dan timeUnitCount.
timeUnit

enum (TimeUnit)

Unit waktu yang akan menerapkan target frekuensi.

Unit waktu berikut berlaku:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Jumlah timeUnit target frekuensi akan berlangsung.

Batasan berikut berlaku berdasarkan nilai timeUnit:

  • TIME_UNIT_WEEKS - harus 1

VideoAdSequenceSettings

Setelan yang terkait dengan VideoAdSequence.

Representasi JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Kolom
minimumDuration

enum (VideoAdSequenceMinimumDuration)

Interval waktu minimum sebelum pengguna yang sama melihat urutan ini lagi.
steps[]

object (VideoAdSequenceStep)

Langkah-langkah yang membentuk urutan.

VideoAdSequenceMinimumDuration

Enum untuk kemungkinan waktu interval minimum sebelum pengguna yang sama melihat VideoAdSequence lagi.

Enum
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Tidak ditentukan atau tidak diketahui.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 hari.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 hari.

VideoAdSequenceStep

Detail satu langkah dalam VideoAdSequence.

Representasi JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Kolom
stepId

string (int64 format)

ID langkah.
adGroupId

string (int64 format)

ID grup iklan yang sesuai dengan langkah.
previousStepId

string (int64 format)

ID langkah sebelumnya. Langkah pertama tidak memiliki langkah sebelumnya.
interactionType

enum (InteractionType)

Interaksi pada langkah sebelumnya yang akan mengarahkan penonton ke langkah ini. Langkah pertama tidak memiliki interactionType.

InteractionType

Jenis interaksi pada langkah.

Enum
INTERACTION_TYPE_UNSPECIFIED Tidak ditentukan atau tidak diketahui
INTERACTION_TYPE_PAID_VIEW Penayangan berbayar.
INTERACTION_TYPE_SKIP Dilewati oleh penonton.
INTERACTION_TYPE_IMPRESSION Tayangan iklan (yang dilihat).
INTERACTION_TYPE_ENGAGED_IMPRESSION Tayangan iklan yang tidak segera dilewati oleh penonton, tetapi juga tidak mencapai peristiwa yang dapat ditagih.

VideoAdInventoryControl

Kontrol inventaris iklan video yang digunakan dalam jenis item baris YouTube tertentu.

Representasi JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Kolom
allowInStream

boolean

Opsional. Apakah iklan dapat ditayangkan sebagai format dalam stream.
allowInFeed

boolean

Opsional. Apakah iklan dapat ditayangkan sebagai format dalam feed.
allowShorts

boolean

Opsional. Apakah iklan dapat ditayangkan dalam format video Shorts.

DemandGenSettings

Setelan untuk item baris Peningkat Permintaan.

Representasi JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Kolom
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opsional. Setelan pengukuran pihak ketiga untuk item baris Peningkat Permintaan.
linkedMerchantId

string (int64 format)

Opsional. ID akun Merchant Center yang digunakan untuk menyediakan feed produk.

Akun Merchant Center ini harus sudah ditautkan ke pengiklan.
geoLanguageTargetingEnabled

boolean

Opsional. Tidak dapat diubah. Apakah penargetan lokasi dan bahasa dapat ditetapkan di tingkat item baris. Jika tidak, jenis penargetan yang relevan harus ditetapkan langsung ke grup iklan.

Metode

bulkEditAssignedTargetingOptions

 Mengedit opsi penargetan massal di beberapa item baris.

bulkListAssignedTargetingOptions

 Mencantumkan opsi penargetan yang ditetapkan untuk beberapa item baris di berbagai jenis penargetan.

bulkUpdate

 Memperbarui beberapa item baris.

create

 Membuat item baris baru.

delete

 Menghapus item baris.

duplicate

 Menduplikasi item baris.

get

 Mendapatkan item baris.

list

 Mencantumkan item baris di pengiklan.

patch

 Memperbarui item baris yang ada.