- Referensi: Pesanan Pemasangan Iklan
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Metode
Resource: LinkingOrder
Satu perjanjian pemasangan iklan.
Representasi JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Kolom | |
---|---|
name |
Hanya output. Nama resource perjanjian pemasangan iklan. |
advertiserId |
Hanya output. ID unik pengiklan yang memiliki perjanjian pemasangan iklan. |
campaignId |
Wajib. Tidak dapat diubah. ID unik kampanye tempat perjanjian pemasangan iklan berada. |
insertionOrderId |
Hanya output. ID unik pesanan pemasangan iklan. Ditetapkan oleh sistem. |
displayName |
Wajib. Nama tampilan pesanan pemasangan iklan. Harus dienkode UTF-8 dengan ukuran maksimum 240 byte. |
insertionOrderType |
Jenis pesanan pemasangan iklan. Jika kolom ini tidak ditentukan dalam pembuatan, nilainya akan ditetapkan secara default ke |
entityStatus |
Wajib. Mengontrol apakah perjanjian pemasangan iklan dapat membelanjakan anggaran dan mengajukan bid untuk inventaris atau tidak.
|
updateTime |
Hanya output. Stempel waktu saat perjanjian pemasangan iklan terakhir diperbarui. Ditetapkan oleh sistem. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
partnerCosts[] |
Biaya partner yang terkait dengan perjanjian pemasangan iklan. Jika tidak ada atau kosong dalam metode |
pacing |
Wajib. Setelan kecepatan pembelanjaan anggaran untuk perjanjian pemasangan iklan. |
frequencyCap |
Wajib. Setelan pembatasan frekuensi pesanan pemasangan iklan. |
integrationDetails |
Detail integrasi tambahan perjanjian pemasangan iklan. |
performanceGoal |
Wajib. Sasaran performa perjanjian pemasangan iklan. |
budget |
Wajib. Setelan alokasi anggaran perjanjian pemasangan iklan. |
bidStrategy |
Strategi bidding perjanjian pemasangan iklan. Secara default, |
reservationType |
Hanya output. Jenis reservasi pesanan pemasangan iklan. |
billableOutcome |
Tidak dapat diubah. Hasil perjanjian pemasangan iklan yang dapat ditagih. Pembelian berbasis hasil tidak digunakan lagi. |
InsertionOrderType
Kemungkinan jenis Pesanan Pemasangan Iklan.
Jenis Perjanjian Pemasangan Iklan menentukan setelan dan opsi mana 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. |
InsertionOrderBudget
Setelan yang mengontrol cara anggaran pesanan pemasangan iklan dialokasikan.
Representasi JSON |
---|
{ "budgetUnit": enum ( |
Kolom | |
---|---|
budgetUnit |
Wajib. Tidak dapat diubah. Unit anggaran menentukan apakah anggaran berbasis mata uang atau tayangan. |
automationType |
Jenis otomatisasi yang digunakan untuk mengelola bid dan anggaran untuk perjanjian pemasangan iklan. Jika kolom ini tidak ditentukan dalam pembuatan, nilainya akan ditetapkan secara default ke |
budgetSegments[] |
Wajib. Daftar segmen anggaran. Menggunakan segmen anggaran untuk menentukan anggaran tertentu selama jangka waktu tertentu saat perjanjian pemasangan iklan dijalankan. |
InsertionOrderAutomationType
Kemungkinan opsi untuk mengotomatiskan bid dan anggaran perjanjian pemasangan iklan.
Enum | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Opsi otomatisasi pesanan pemasangan iklan tidak ditentukan atau tidak dikenal dalam versi ini. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Alokasi anggaran otomatis. Memungkinkan sistem untuk otomatis mengalihkan anggaran ke item baris pemilik untuk mengoptimalkan performa yang ditentukan oleh performanceGoal . Tidak ada otomatisasi pada setelan bid. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Tidak ada otomatisasi bid atau anggaran di tingkat perjanjian pemasangan iklan. Bid dan anggaran harus dikonfigurasi secara manual di tingkat item baris. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Mengizinkan sistem untuk secara otomatis menyesuaikan bid dan mengalihkan anggaran ke item baris pemilik untuk mengoptimalkan performa yang ditentukan oleh performanceGoal . |
InsertionOrderBudgetSegment
Setelan yang mengontrol anggaran satu segmen anggaran.
Representasi JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Kolom | |
---|---|
budgetAmountMicros |
Wajib. Jumlah anggaran yang akan dibelanjakan pesanan pemasangan iklan untuk |
description |
Deskripsi segmen anggaran. Kolom ini dapat digunakan untuk memasukkan informasi Pesanan Pembelian (PO) untuk setiap segmen anggaran dan mencetak informasi tersebut di invoice. Harus berenkode UTF-8. |
dateRange |
Wajib. Setelan tanggal mulai dan akhir segmen anggaran. Penyesuaian ini diselesaikan sesuai dengan zona waktu pengiklan induk.
|
campaignBudgetId |
|
BillableOutcome
Kemungkinan hasil yang dapat ditagih untuk perjanjian pemasangan iklan.
Enum | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Hasil yang dapat ditagih tidak ditentukan. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Bayar per tayangan. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Bayar per klik. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Bayar per tampilan aktif. |
Metode |
|
---|---|
|
Mencantumkan opsi penargetan pesanan pemasangan iklan yang ditetapkan di seluruh jenis penargetan. |
|
Membuat pesanan pemasangan iklan baru. |
|
Menghapus pesanan pemasangan iklan. |
|
Mendapatkan pesanan pemasangan iklan. |
|
Mencantumkan pesanan pemasangan iklan di pengiklan. |
|
Memperbarui pesanan pemasangan iklan yang ada. |