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)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}

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 yang memiliki item baris.

string (int64 format)

Wajib. Tidak dapat diubah. ID unik perjanjian pemasangan iklan yang memiliki item baris.

string (int64 format)

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

string

Wajib. Nama tampilan item baris.

Harus dienkode UTF-8 dengan ukuran maksimum 240 byte.

enum (LineItemType)

Wajib. Tidak dapat diubah. Jenis item baris.

enum (EntityStatus)

Wajib. Mengontrol apakah item baris dapat membelanjakan anggarannya dan mengajukan bid untuk 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 perjanjian pemasangan iklan induk item baris tidak aktif, item baris tersebut tidak dapat membelanjakan anggarannya meskipun statusnya adalah ENTITY_STATUS_ACTIVE.

string (Timestamp format)

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

Stempel waktu dalam format 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 perjanjian pemasangan iklan induknya.

object (LineItemFlight)

Wajib. Waktu mulai dan berakhir penayangan item baris.

object (LineItemBudget)

Wajib. Setelan alokasi anggaran item baris.

object (Pacing)

Wajib. Setelan kecepatan pembelanjaan anggaran untuk item baris.

object (FrequencyCap)

Wajib. Setelan batas frekuensi tayangan item baris.

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

object (PartnerRevenueModel)

Wajib. Setelan model pendapatan partner item baris.

object (ConversionCountingConfig)

Setelan tracking konversi item baris.

string (int64 format)

ID materi iklan yang terkait dengan item baris.

object (BiddingStrategy)

Wajib. Strategi bidding item baris.

object (IntegrationDetails)

Detail integrasi item baris.

string (int64 format)

ID sumber inventaris pribadi yang ditetapkan ke 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 memblokir penyimpanan item baris, tetapi beberapa peringatan mungkin memblokir penyimpanan item baris.

object (MobileApp)

Aplikasi seluler yang dipromosikan oleh item baris.

Hal 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 false secara default.

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

enum (LineItemFlightDateType)

Wajib. Jenis tanggal penayangan item baris.

object (DateRange)

Tanggal mulai dan akhir penerbangan item baris. Penyesuaian ini diselesaikan sesuai dengan zona waktu pengiklan induk.

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

string (int64 format)

ID pemicu manual yang dikaitkan dengan item baris.

• Wajib jika flightDateType adalah LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER. Tidak boleh ditetapkan sebaliknya.
• Jika ditetapkan, tanggal penayangan item baris akan diwariskan dari perjanjian pemasangan iklan induknya.
• Item baris aktif akan dibelanjakan saat pemicu yang dipilih diaktifkan dalam tanggal penayangan perjanjian pemasangan iklan induk.

Peringatan: Item Baris yang menggunakan pemicu manual tidak lagi ditayangkan di Display & Video 360. Kolom ini akan dihentikan pada 1 Agustus 2023. Baca pengumuman penghentian fitur kami untuk mengetahui informasi selengkapnya.

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

enum (LineItemBudgetAllocationType)

Wajib. Jenis alokasi anggaran.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC hanya berlaku jika alokasi anggaran otomatis diaktifkan untuk perjanjian pemasangan iklan induk.

enum (BudgetUnit)

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

string (int64 format)

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

Jika budgetAllocationType:

• 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 untuk dibelanjakan, dalam mikro mata uang pengiklan. Misalnya, 1500000 mewakili 1,5 unit standar mata uang.
  • BUDGET_UNIT_IMPRESSIONS, kolom ini menunjukkan jumlah tayangan maksimum yang akan ditayangkan.
• LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, kolom ini tidak berlaku dan akan diabaikan oleh sistem.

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

enum (PartnerRevenueModelMarkupType)

Wajib. Jenis markup model pendapatan partner.

string (int64 format)

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

• Jika markupType disetel 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 disetel ke PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, kolom ini menampilkan markup persen biaya media dalam milidetik. Misalnya, 100 mewakili 0,1% (desimal 0,001).
• Jika markupType disetel ke PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, kolom ini merepresentasikan markup persen biaya media total 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 ribuan (1/1.000 dari persen). Harus antara 0 dan 100000 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. ID aktivitas Floodlight.

integer

Wajib. Jumlah hari setelah iklan diklik yang dapat menghitung konversi. Harus antara 0 dan 90 inklusif.

integer

Wajib. Jumlah hari setelah iklan dilihat untuk menghitung konversi. Harus antara 0 dan 90 inklusif.

{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}

enum (TargetingExpansionLevel)

Wajib. Apakah penargetan yang dioptimalkan diaktifkan.

Kolom ini mendukung nilai berikut:

• NO_EXPANSION: penargetan yang dioptimalkan dinonaktifkan
• LEAST_EXPANSION: penargetan yang dioptimalkan diaktifkan

Jika kolom ini ditetapkan ke nilai lain, kolom tersebut akan otomatis ditetapkan ke LEAST_EXPANSION.

NO_EXPANSION akan menjadi nilai default untuk kolom ini dan akan ditetapkan secara otomatis jika kolom tersebut tidak ditetapkan.

boolean

Apakah akan mengecualikan audiens pihak pertama agar tidak digunakan dalam perluasan penargetan atau tidak.

Kolom ini tidak digunakan lagi dengan diluncurkannya penargetan yang dioptimalkan.

Kolom ini akan ditetapkan ke false. Jika kolom ini ditetapkan ke true saat tidak digunakan lagi, semua penargetan audiens pihak pertama positif yang ditetapkan untuk item baris ini akan diganti dengan penargetan negatif dari audiens pihak pertama yang sama guna memastikan pengecualian audiens tersebut dapat terus berlanjut.

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

string

Wajib. ID aplikasi yang disediakan oleh platform store.

Aplikasi Android diidentifikasi dengan 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.