REST Resource: advertisers.insertionOrders

Resource: LinkingOrder

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)
}
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 tersebut berada.
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)

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 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 status 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 fraksional. 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 untuk 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.

Hal 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 telah disetel.
reservationType

enum (ReservationType)

Hanya output. Jenis reservasi pesanan pemasangan iklan.

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, untuk 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 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: 1.500.000 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 adalah CPM (biaya per seribu).
KPI_TYPE_CPC KPInya adalah CPC (biaya per klik).
KPI_TYPE_CPA KPInya adalah CPA (biaya per tindakan).
KPI_TYPE_CTR KPI adalah persentase CTR (rasio klik-tayang).
KPI_TYPE_VIEWABILITY KPI adalah persentase Visibilitas.
KPI_TYPE_CPIAVC KPInya adalah CPIAVC (biaya per tayangan iklan yang terdengar dan terlihat saat selesai).
KPI_TYPE_CPE KPI adalah CPE (biaya per engagement).
KPI_TYPE_CPV KPI ditetapkan dalam CPV (biaya per tampilan).
KPI_TYPE_CLICK_CVR KPI adalah persentase rasio konversi klik (konversi per klik).
KPI_TYPE_IMPRESSION_CVR KPI adalah persentase rasio konversi tayangan (konversi per tayangan).
KPI_TYPE_VCPM KPInya adalah vCPM (biaya per seribu tayangan terlihat).
KPI_TYPE_VTR KPI adalah persentase rasio tontonan YouTube (penayangan YouTube per tayangan).
KPI_TYPE_AUDIO_COMPLETION_RATE KPI adalah persentase rasio penyelesaian audio (pemutaran audio lengkap per tayangan).
KPI_TYPE_VIDEO_COMPLETION_RATE KPI adalah persentase rasio penyelesaian video (penayangan 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 berdasarkan frekuensi waktu di layar lebih dari 10 detik (Persentase tayangan iklan terukur dan tidak dapat dilewati yang ada 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 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 berbasis mata uang atau tayangan iklan.
automationType

enum (InsertionOrderAutomationType)

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. Menggunakan segmen anggaran untuk menentukan anggaran tertentu selama jangka waktu tertentu saat pesanan pemasangan iklan sedang berjalan.

InsertionOrderAutomationType

Kemungkinan opsi 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. Memungkinkan sistem mengalihkan anggaran secara otomatis 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 Memungkinkan sistem untuk secara 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 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 pada faktur.

Harus berenkode UTF-8.
dateRange

object (DateRange)

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

  • Saat membuat segmen anggaran baru, startDate dan endDate harus berada di masa mendatang.
  • Segmen anggaran yang sudah ada dengan startDate sebelumnya memiliki endDate yang dapat berubah, 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 menjadi bagian dari segmen anggaran pesanan pemasangan iklan ini.

Metode

create

 Membuat pesanan pemasangan iklan baru.

delete

 Menghapus pesanan pemasangan iklan.

get

 Mendapatkan pesanan pemasangan iklan.

list

 Mencantumkan pesanan pemasangan iklan di pengiklan.

listAssignedTargetingOptions

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

patch

 Memperbarui pesanan pemasangan iklan yang sudah ada.