REST Resource: advertisers.insertionOrders

Resource: InsertionOrder

Satu pesanan pemasangan iklan.

Representasi JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "displayName": string,
  "insertionOrderType": enum (InsertionOrderType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "kpi": {
    object (Kpi)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "optimizationObjective": enum (OptimizationObjective)
}
Kolom
name

string

Hanya output. Nama resource pesanan pemasangan iklan.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki perjanjian pemasangan iklan.
campaignId

string (int64 format)

Wajib. Tidak dapat diubah. ID unik kampanye yang mencakup pesanan pemasangan iklan.
insertionOrderId

string (int64 format)

Hanya output. ID unik pesanan pemasangan iklan. Ditetapkan oleh sistem.
displayName

string

Wajib. Nama tampilan pesanan pemasangan iklan.

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

enum (InsertionOrderType)

Opsional. Jenis pesanan pemasangan iklan.

Jika kolom ini tidak ditentukan dalam pembuatan, nilainya akan ditetapkan secara default ke RTB.
entityStatus

enum (EntityStatus)

Wajib. Mengontrol apakah pesanan pemasangan iklan dapat membelanjakan anggarannya dan mengajukan bid pada inventaris atau tidak.

  • Untuk metode insertionOrders.create, hanya ENTITY_STATUS_DRAFT yang diizinkan. Untuk mengaktifkan pesanan pemasangan iklan, gunakan metode insertionOrders.patch dan perbarui statusnya ke ENTITY_STATUS_ACTIVE setelah pembuatan.
  • Pesanan pemasangan iklan tidak dapat diubah kembali ke status ENTITY_STATUS_DRAFT dari status lainnya.
  • Pesanan pemasangan iklan tidak dapat ditetapkan ke ENTITY_STATUS_ACTIVE jika kampanye induknya tidak aktif.
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat pesanan pemasangan iklan 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)

Opsional. Biaya partner yang terkait dengan pesanan pemasangan iklan.

Jika tidak ada atau kosong dalam metode insertionOrders.create, pesanan pemasangan iklan yang baru dibuat akan mewarisi biaya partner dari setelan partner.
pacing

object (Pacing)

Wajib. Setelan kecepatan pembelanjaan anggaran pesanan pemasangan iklan.

pacingType PACING_TYPE_ASAP tidak kompatibel dengan pacingPeriod PACING_PERIOD_FLIGHT.
frequencyCap

object (FrequencyCap)

Wajib. Setelan pembatasan frekuensi pesanan pemasangan iklan.
integrationDetails

object (IntegrationDetails)

Opsional. Detail integrasi tambahan dari perjanjian pemasangan iklan.
kpi

object (Kpi)

Wajib. Indikator performa utama (KPI) pesanan pemasangan iklan.

Hal ini direpresentasikan sebagai "Sasaran" di antarmuka Display & Video 360.
budget

object (InsertionOrderBudget)

Wajib. Setelan alokasi anggaran pesanan pemasangan iklan.
bidStrategy

object (BiddingStrategy)

Opsional. Strategi bidding pesanan pemasangan iklan. Secara default, fixedBid ditetapkan.

Jika kolom budget automationType ditetapkan ke INSERTION_ORDER_AUTOMATION_TYPE_BUDGET atau INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET, pesanan pemasangan iklan akan menerapkan strategi bidding ini pada item barisnya. Jika strategi bidding yang diterapkan tidak kompatibel dengan setelan enableOptimizedTargeting item baris, setelan penargetan yang dioptimalkan akan diperbarui.
reservationType

enum (ReservationType)

Hanya output. Jenis reservasi pesanan pemasangan iklan.
optimizationObjective

enum (OptimizationObjective)

Wajib. Tujuan pengoptimalan pesanan pemasangan iklan.

InsertionOrderType

Kemungkinan jenis Pesanan Pemasangan Iklan.

Jenis Perjanjian Pemasangan Iklan menentukan setelan dan opsi yang berlaku, seperti format iklan atau opsi penargetan.

Enum
INSERTION_ORDER_TYPE_UNSPECIFIED Jenis pesanan pemasangan iklan tidak ditentukan atau tidak diketahui.
RTB Bidding real-time.
OVER_THE_TOP Over-the-top.
OUT_OF_HOME Luar ruangan.

KPI

Setelan yang mengontrol indikator performa utama, atau KPI, pesanan pemasangan iklan.

Representasi JSON 
{
  "kpiType": enum (KpiType),
  "kpiAlgorithmId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "kpiAmountMicros": string,
  "kpiPercentageMicros": string,
  "kpiString": string
  // End of mutually exclusive fields.
}
Kolom
kpiType

enum (KpiType)

Wajib. Jenis KPI.
kpiAlgorithmId

string (int64 format)

Opsional. ID Algoritma Bidding Kustom yang terkait dengan KPI_CUSTOM_IMPRESSION_VALUE_OVER_COST. Kolom ini akan diabaikan jika KPI yang tepat tidak dipilih.
Wajib. Nilai KPI. Kolom yang relevan sesuai dengan kpi_type. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
kpiAmountMicros

string (int64 format)

Jumlah sasaran, dalam mikro mata uang pengiklan.

Berlaku jika kpiType adalah salah satu dari:

  • KPI_TYPE_CPM
  • KPI_TYPE_CPC
  • KPI_TYPE_CPA
  • KPI_TYPE_CPIAVC
  • KPI_TYPE_VCPM

Misalnya: 1500000 mewakili 1,5 unit standar mata uang.
kpiPercentageMicros

string (int64 format)

Representasi desimal persentase sasaran dalam mikro.

Berlaku jika kpiType adalah salah satu dari:

  • KPI_TYPE_CTR
  • KPI_TYPE_VIEWABILITY
  • KPI_TYPE_CLICK_CVR
  • KPI_TYPE_IMPRESSION_CVR
  • KPI_TYPE_VTR
  • KPI_TYPE_AUDIO_COMPLETION_RATE
  • KPI_TYPE_VIDEO_COMPLETION_RATE

Misalnya: 70000 mewakili 7% (desimal 0,07).
kpiString

string

String KPI, yang dapat dikosongkan. Harus berenkode UTF-8 dengan panjang tidak lebih dari 100 karakter.

Berlaku jika kpiType adalah KPI_TYPE_OTHER.
Akhir kolom yang saling eksklusif.

KpiType

Kemungkinan jenis indikator performa utama (KPI).

Enum
KPI_TYPE_UNSPECIFIED Jenis KPI tidak ditentukan atau tidak diketahui dalam versi ini.
KPI_TYPE_CPM KPI-nya adalah CPM (biaya per seribu tayangan iklan).
KPI_TYPE_CPC KPI-nya adalah CPC (biaya per klik).
KPI_TYPE_CPA KPI-nya adalah CPA (biaya per tindakan).
KPI_TYPE_CTR KPI-nya adalah persentase CTR (rasio klik-tayang).
KPI_TYPE_VIEWABILITY KPI-nya adalah Persentase visibilitas.
KPI_TYPE_CPIAVC KPI-nya adalah CPIAVC (biaya per tayangan terdengar dan terlihat saat selesai).
KPI_TYPE_CPE KPI-nya adalah CPE (biaya per engagement).
KPI_TYPE_CPV KPI ditetapkan dalam CPV (biaya per penayangan).
KPI_TYPE_CLICK_CVR KPI-nya adalah persentase rasio konversi klik (konversi per klik).
KPI_TYPE_IMPRESSION_CVR KPI-nya adalah persentase rasio konversi tayangan (konversi per tayangan).
KPI_TYPE_VCPM KPI-nya adalah VCPM (biaya per seribu tayangan iklan terlihat).
KPI_TYPE_VTR KPI-nya adalah persentase rasio penayangan YouTube (penayangan YouTube per tayangan iklan).
KPI_TYPE_AUDIO_COMPLETION_RATE KPI-nya adalah persentase rasio penyelesaian audio (pemutaran audio lengkap per tayangan iklan).
KPI_TYPE_VIDEO_COMPLETION_RATE KPI-nya adalah persentase rasio penyelesaian video (penayangan video lengkap per tayangan iklan).
KPI_TYPE_CPCL KPI ditetapkan dalam CPCL (biaya per pemutaran penuh audio).
KPI_TYPE_CPCV KPI ditetapkan dalam CPCV (biaya per penayangan video lengkap).
KPI_TYPE_TOS10 KPI ditetapkan dalam rasio waktu di layar 10+ detik (Persentase tayangan iklan yang tidak dapat dilewati dan terukur yang berada di layar selama minimal 10 detik).
KPI_TYPE_MAXIMIZE_PACING KPI ditetapkan untuk memaksimalkan dampak merek sekaligus memprioritaskan pembelanjaan seluruh anggaran.
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST KPI ditetapkan dalam nilai tayangan iklan kustom dibagi dengan biaya.
KPI_TYPE_OTHER KPI adalah nilai lain.

InsertionOrderBudget

Setelan yang mengontrol cara anggaran pesanan pemasangan iklan dialokasikan.

Representasi JSON 
{
  "budgetUnit": enum (BudgetUnit),
  "automationType": enum (InsertionOrderAutomationType),
  "budgetSegments": [
    {
      object (InsertionOrderBudgetSegment)
    }
  ]
}
Kolom
budgetUnit

enum (BudgetUnit)

Wajib. Tidak dapat diubah. Unit anggaran menentukan apakah anggaran didasarkan pada mata uang atau tayangan iklan.
automationType

enum (InsertionOrderAutomationType)

Opsional. Jenis otomatisasi yang digunakan untuk mengelola bid dan anggaran pesanan pemasangan iklan.

Jika kolom ini tidak ditentukan dalam pembuatan, nilainya akan ditetapkan secara default ke INSERTION_ORDER_AUTOMATION_TYPE_NONE.
budgetSegments[]

object (InsertionOrderBudgetSegment)

Wajib. Daftar segmen anggaran. Gunakan segmen anggaran untuk menentukan anggaran tertentu selama jangka waktu tertentu saat pesanan pemasangan iklan berjalan.

InsertionOrderAutomationType

Opsi yang memungkinkan untuk mengotomatiskan bid dan anggaran pesanan pemasangan iklan.

Enum
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED Opsi otomatisasi pesanan pemasangan iklan tidak ditentukan atau tidak diketahui dalam versi ini.
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET Alokasi anggaran otomatis. Izinkan sistem mengalihkan anggaran secara otomatis ke item baris yang memiliki anggaran untuk mengoptimalkan performa yang ditentukan oleh kpi. Tidak ada otomatisasi pada setelan bid.
INSERTION_ORDER_AUTOMATION_TYPE_NONE Tidak ada otomatisasi bid atau anggaran di tingkat pesanan pemasangan iklan. Bid dan anggaran harus dikonfigurasi secara manual di tingkat item baris.
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET Izinkan sistem menyesuaikan bid secara otomatis dan mengalihkan anggaran ke item baris yang menang untuk mengoptimalkan performa yang ditentukan oleh bidStrategy.

InsertionOrderBudgetSegment

Setelan yang mengontrol anggaran satu segmen anggaran.

Representasi JSON 
{
  "budgetAmountMicros": string,
  "description": string,
  "dateRange": {
    object (DateRange)
  },
  "campaignBudgetId": string
}
Kolom
budgetAmountMicros

string (int64 format)

Wajib. Jumlah anggaran yang akan dibelanjakan oleh perjanjian pemasangan iklan untuk dateRange tertentu. Jumlahnya dalam mikro. Harus lebih besar dari 0. Misalnya, 500000000 mewakili 500 unit standar mata uang.
description

string

Opsional. Deskripsi segmen anggaran. Kolom ini dapat digunakan untuk memasukkan informasi Pesanan Pembelian untuk setiap segmen anggaran dan mencetak informasi tersebut di invoice.

Harus berenkode UTF-8.
dateRange

object (DateRange)

Wajib. Setelan tanggal mulai dan akhir segmen anggaran. Tanggal tersebut diselesaikan sesuai dengan zona waktu pengiklan induk.

  • Saat membuat segmen anggaran baru, startDate dan endDate harus berada di masa mendatang.
  • Segmen anggaran yang ada dengan startDate di masa lalu memiliki endDate yang dapat diubah, tetapi startDate yang tidak dapat diubah.
  • endDate harus berupa startDate atau yang lebih baru, keduanya sebelum tahun 2037.
campaignBudgetId

string (int64 format)

Opsional. budgetId anggaran kampanye yang menyertakan segmen anggaran perjanjian pemasangan iklan ini.

OptimizationObjective

Jenis tujuan pengoptimalan yang memungkinkan.

Enum
OPTIMIZATION_OBJECTIVE_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
CONVERSION Memprioritaskan tayangan iklan yang meningkatkan penjualan dan konversi.
CLICK Memprioritaskan tayangan iklan yang meningkatkan traffic situs, aplikasi, app store.
BRAND_AWARENESS Memprioritaskan tayangan iklan dengan kualitas tertentu.
CUSTOM Tujuan ditentukan oleh algoritma bidding kustom yang ditetapkan.
NO_OBJECTIVE Tujuan tidak ditentukan. KPI atau strategi bidding apa pun dapat digunakan.

Metode

create

 Membuat perjanjian pemasangan iklan baru.

delete

 Menghapus perjanjian pemasangan iklan.

get

 Mendapatkan pesanan pemasangan iklan.

list

 Mencantumkan pesanan pemasangan iklan di pengiklan.

patch

 Memperbarui pesanan pemasangan iklan yang ada.