REST Resource: advertisers.insertionOrders

Resource: InsertOrder

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 pesanan pemasangan iklan.
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. Ditetapkan oleh sistem.
displayName

string

Wajib. Nama tampilan pesanan pemasangan iklan.

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

enum (InsertionOrderType)

Jenis pesanan pemasangan iklan.

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

enum (EntityStatus)

Wajib. Mengontrol apakah pesanan 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 iklan, 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. Ditetapkan oleh sistem.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal 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 pesanan pemasangan iklan.
kpi

object (Kpi)

Wajib. Indikator performa utama (KPI) pesanan 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 disetel.
reservationType

enum (ReservationType)

Hanya output. Jenis reservasi pesanan pemasangan iklan.
optimizationObjective

enum (OptimizationObjective)

Opsional. Tujuan pengoptimalan pesanan pemasangan iklan.

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

InsertionOrderType

Kemungkinan jenis Perjanjian 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 Algoritme Bidding Kustom yang dikaitkan 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 yang 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 dari 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 jika 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 iklan yang dapat didengar dan terlihat saat iklan 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 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 tontonan (penayangan YouTube per tayangan iklan) YouTube.
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 (jumlah tontonan video lengkap per tayangan iklan).
KPI_TYPE_CPCL KPI ditetapkan dalam CPCL (biaya per pemutaran audio lengkap).
KPI_TYPE_CPCV KPI ditetapkan dalam CPCV (biaya per penayangan video lengkap).
KPI_TYPE_TOS10 KPI ditetapkan dalam frekuensi di layar 10 detik lebih (Persentase tayangan iklan terukur yang tidak dapat dilewati yang muncul di layar selama minimal 10 detik).
KPI_TYPE_MAXIMIZE_PACING KPI ditetapkan untuk memaksimalkan dampak brand 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 beberapa nilai lainnya.

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 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 dalam pembuatan, nilai akan ditetapkan secara default ke INSERTION_ORDER_AUTOMATION_TYPE_NONE.
budgetSegments[]

object (InsertionOrderBudgetSegment)

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

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

string

Deskripsi segmen anggaran. Formulir ini dapat digunakan untuk memasukkan informasi Pesanan Pembelian (PO) 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. Masalah 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)

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, dan app store.
BRAND_AWARENESS Memprioritaskan tayangan 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 pesanan pemasangan iklan baru.

delete

 Menghapus pesanan pemasangan iklan.

get

 Mendapatkan pesanan pemasangan iklan.

list

 Mencantumkan pesanan pemasangan iklan dalam pengiklan.

listAssignedTargetingOptions

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

patch

 Memperbarui pesanan pemasangan iklan yang sudah ada.