REST Resource: advertisers.lineItems

{
  "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)
  }
}

string

Hanya output. Nama resource item baris.

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki item baris.

string (int64 format)

Hanya output. ID unik kampanye tempat item baris berada.

string (int64 format)

Wajib diisi. Tidak dapat diubah. ID unik pesanan pemasangan iklan yang mencakup item baris.

string (int64 format)

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

string

Wajib diisi. Nama tampilan item baris.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

enum (LineItemType)

Wajib diisi. Tidak dapat diubah. Jenis item baris.

enum (EntityStatus)

Wajib diisi. 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 menjadi ENTITY_STATUS_ACTIVE setelah pembuatan.
• Item baris tidak dapat diubah kembali ke status ENTITY_STATUS_DRAFT dari status lainnya.
• Jika pesanan pemasangan iklan induk item baris tidak aktif, item baris tidak dapat membelanjakan anggarannya meskipun statusnya sendiri adalah ENTITY_STATUS_ACTIVE.

string (Timestamp format)

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

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

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 pesanan pemasangan iklan induknya.

object (LineItemFlight)

Wajib diisi. Waktu mulai dan berakhir penayangan item baris.

object (LineItemBudget)

Wajib diisi. Setelan alokasi anggaran item baris.

object (Pacing)

Wajib diisi. Setelan kecepatan pembelanjaan anggaran item baris.

object (FrequencyCap)

Wajib diisi. Setelan batas frekuensi tayangan item baris.

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

object (PartnerRevenueModel)

Wajib diisi. Setelan model pendapatan partner untuk item baris.

object (ConversionCountingConfig)

Setelan tracking konversi item baris.

string (int64 format)

ID materi iklan yang dikaitkan dengan item baris.

object (BiddingStrategy)

Wajib diisi. Strategi bidding item baris.

object (IntegrationDetails)

Detail integrasi item baris.

object (TargetingExpansionConfig)

Setelan penargetan yang dioptimalkan untuk item baris.

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

enum (LineItemWarningMessage)

Hanya output. Pesan peringatan yang dibuat oleh item baris. Peringatan ini tidak akan memblokir penyimpanan item baris, tetapi sebagian peringatan dapat mencegah dijalankannya item baris tersebut.

object (MobileApp)

Aplikasi seluler yang dipromosikan oleh item baris.

Ini hanya berlaku jika lineItemType adalah LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL atau LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

enum (ReservationType)

Hanya output. Jenis reservasi item baris.

boolean

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

object (YoutubeAndPartnersSettings)

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

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

enum (LineItemFlightDateType)

Wajib diisi. Jenis tanggal penayangan item baris.

object (DateRange)

Tanggal mulai dan akhir penayangan item baris. Masalah tersebut diselesaikan sesuai dengan zona waktu pengiklan induk.

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

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

enum (LineItemBudgetAllocationType)

Wajib diisi. Jenis alokasi anggaran.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC hanya berlaku saat alokasi anggaran otomatis diaktifkan untuk pesanan pemasangan iklan induk.

enum (BudgetUnit)

Hanya output. Unit anggaran menentukan apakah anggaran berbasis mata uang atau tayangan. Nilai ini diwarisi dari pesanan pemasangan iklan induk.

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 menunjukkan 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 maksimum tayangan yang ditampilkan.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, kolom ini tidak berlaku dan akan diabaikan oleh sistem.

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

enum (PartnerRevenueModelMarkupType)

Wajib diisi. Jenis markup model pendapatan partner.

string (int64 format)

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

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

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

Persentase konversi pasca-penayangan yang akan dihitung, dalam milidetik (1/1.000 persen). Harus antara 0 dan 100.000 inklusif.

Misalnya, untuk melacak 50% konversi pascaklik, tetapkan nilai 50.000.

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 dalam kolom ini.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

Wajib diisi. ID aktivitas Floodlight.

integer

Wajib diisi. Jumlah hari yang memungkinkan penghitungan konversi setelah iklan diklik. Harus antara 0 dan 90 inklusif.

integer

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

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

string

Wajib diisi. ID aplikasi yang disediakan oleh platform store.

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.

enum (Platform)

Hanya output. Platform aplikasi.

string

Hanya output. Nama aplikasi.

string

Hanya output. Penerbit aplikasi.

{
  "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)
  }
}

object (FrequencyCap)

Setelan batas frekuensi tampilan item baris.

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

object (ThirdPartyMeasurementConfigs)

Opsional. Konfigurasi pengukuran pihak ketiga untuk item baris.

object (YoutubeAndPartnersInventorySourceConfig)

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

enum (YoutubeAndPartnersContentCategory)

Jenis konten tempat iklan YouTube dan Partner akan ditampilkan.

enum (YoutubeAndPartnersContentCategory)

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

object (TargetFrequency)

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

string (int64 format)

ID penjual yang ditautkan ke item baris untuk feed produk.

string

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

string (int64 format)

ID formulir untuk menghasilkan prospek.

object (VideoAdSequenceSettings)

Setelan yang terkait dengan VideoAdSequence.

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

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

object (ThirdPartyVendorConfig)

Opsional. Vendor pihak ketiga yang mengukur keamanan merek.

Vendor pihak ketiga berikut berlaku:

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

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

object (ThirdPartyVendorConfig)

Opsional. Vendor pihak ketiga yang mengukur Brand Lift.

Vendor pihak ketiga berikut berlaku:

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

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

enum (ThirdPartyVendor)

Vendor pengukuran pihak ketiga.

string

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

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

Opsional. Apakah ingin menargetkan inventaris di YouTube atau tidak. Hal ini mencakup penelusuran, channel, dan video.

boolean

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

boolean

Apakah ingin menargetkan inventaris pada kumpulan situs dan aplikasi partner yang mengikuti standar keamanan merek yang sama seperti YouTube.

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

string (int64 format)

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

enum (TimeUnit)

Satuan waktu saat target frekuensi akan diterapkan.

Satuan waktu berikut berlaku:

• TIME_UNIT_WEEKS

integer

Jumlah timeUnit target frekuensi akan berlaku.

Batasan berikut berlaku berdasarkan nilai timeUnit:

• TIME_UNIT_WEEKS - harus 1

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

enum (VideoAdSequenceMinimumDuration)

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

object (VideoAdSequenceStep)

Langkah-langkah yang terdapat dalam urutan.

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

string (int64 format)

ID langkah.

string (int64 format)

ID grup iklan yang sesuai pada langkah.

string (int64 format)

ID langkah sebelumnya. Langkah pertama tidak memiliki langkah sebelumnya.

enum (InteractionType)

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