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.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki pesanan pemasangan.
campaignId

string (int64 format)

Wajib. Tidak dapat diubah. ID unik kampanye tempat pesanan pemasangan iklan berada.
insertionOrderId

string (int64 format)

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

string

Wajib. Nama tampilan pesanan pemasangan iklan.

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

enum (InsertionOrderType)

Jenis perjanjian pemasangan iklan.

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

enum (EntityStatus)

Wajib. Mengontrol apakah perjanjian pemasangan iklan dapat membelanjakan anggaran dan mengajukan bid pada inventaris atau tidak.

  • Untuk metode insertionOrders.create, hanya ENTITY_STATUS_DRAFT yang diizinkan. Untuk mengaktifkan pesanan pemasangan, gunakan metode insertionOrders.patch dan perbarui statusnya menjadi 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. Ditugaskan 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".
partnerCosts[]

object (PartnerCost)

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.
frequencyCap

object (FrequencyCap)

Wajib. Setelan pembatasan frekuensi pesanan pemasangan iklan.
integrationDetails

object (IntegrationDetails)

Detail integrasi tambahan dari perjanjian pemasangan iklan.
kpi

object (Kpi)

Wajib. Indikator kinerja utama (KPI) perjanjian pemasangan iklan.

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

object (InsertionOrderBudget)

Wajib. Setelan alokasi anggaran pesanan pemasangan iklan.
bidStrategy

object (BiddingStrategy)

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

enum (ReservationType)

Hanya output. Jenis reservasi pesanan pemasangan iklan.
optimizationObjective

enum (OptimizationObjective)

Opsional. Tujuan pengoptimalan perjanjian pemasangan iklan.

Kolom ini hanya tersedia untuk pelanggan yang diizinkan. Jika pelanggan tidak diizinkan, kolom ini akan bernilai null dan upaya untuk menetapkannya akan menampilkan error.

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.

KPI

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

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

  // Union field kpi_value can be only one of the following:
  "kpiAmountMicros": string,
  "kpiPercentageMicros": string,
  "kpiString": string
  // End of list of possible types for union field kpi_value.
}
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 diabaikan jika KPI yang tepat tidak dipilih.
Kolom union kpi_value. Wajib. Nilai KPI. Kolom yang relevan sesuai dengan kpi_type. kpi_value hanya dapat berupa salah satu dari hal berikut:
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 boleh kosong. Harus berenkode UTF-8 dengan panjang tidak lebih dari 100 karakter.

Berlaku saat kpiType adalah KPI_TYPE_OTHER.

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).
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 yang terdengar dan terlihat saat penyelesaian).
KPI_TYPE_CPE KPI-nya adalah CPE (biaya per engagement).
KPI_TYPE_CPV KPI ditetapkan dalam CPV (biaya per tampilan).
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 ini adalah persentase rasio tontonan YouTube (penayangan YouTube per tayangan).
KPI_TYPE_AUDIO_COMPLETION_RATE KPI ini adalah persentase rasio penyelesaian audio (pemutaran audio lengkap per tayangan iklan).
KPI_TYPE_VIDEO_COMPLETION_RATE KPI-nya adalah persentase rasio penyelesaian video (jumlah tontonan video lengkap per tayangan iklan).
KPI_TYPE_CPCL KPI ditetapkan dalam CPCL (biaya per penyelesaian pemutaran audio).
KPI_TYPE_CPCV KPI ditetapkan dalam CPCV (biaya per penyelesaian tampilan video).
KPI_TYPE_TOS10 KPI ditetapkan dalam rasio waktu di layar 10+ detik (Persentase tayangan yang tidak dapat dilewati dan terukur yang ditampilkan 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 kustom dibagi dengan biaya.
KPI_TYPE_OTHER KPI adalah nilai lain.

InsertionOrderBudget

Setelan yang mengontrol cara anggaran pesanan pemasangan 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 berbasis mata uang atau tayangan.
automationType

enum (InsertionOrderAutomationType)

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

Jika kolom ini tidak ditentukan saat pembuatan, nilai defaultnya adalah 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 mungkin untuk mengotomatiskan bid dan anggaran pesanan pemasangan.

Enum
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED Opsi otomatisasi pesanan pemasangan tidak ditentukan atau tidak diketahui dalam versi ini.
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET Alokasi anggaran otomatis. Izinkan sistem untuk otomatis mengalihkan anggaran ke item baris pemilik 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 untuk otomatis menyesuaikan bid dan mengalihkan anggaran ke item baris pemilik untuk mengoptimalkan performa yang ditentukan oleh kpi.

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 perjanjian pemasangan iklan untuk dateRange yang diberikan. Jumlahnya dalam mikro. Harus lebih besar dari 0. Misalnya, 500000000 mewakili 500 unit standar mata uang.
description

string

Deskripsi segmen anggaran. Informasi 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. Zona waktu ini di-resolve secara relatif terhadap zona waktu pengiklan induk.

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

string (int64 format)

budgetId anggaran kampanye yang mencakup segmen anggaran pesanan pemasangan iklan ini.

OptimizationObjective

Kemungkinan jenis tujuan pengoptimalan.

Enum
OPTIMIZATION_OBJECTIVE_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
CONVERSION Prioritaskan tayangan yang meningkatkan penjualan dan konversi.
CLICK Prioritaskan tayangan 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 di pengiklan.

listAssignedTargetingOptions

 Mencantumkan opsi penargetan pesanan pemasangan iklan yang ditetapkan di seluruh jenis penargetan.

patch

 Memperbarui pesanan pemasangan iklan yang ada.