REST Resource: advertisers.insertionOrders

{
  "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)
  },
  "performanceGoal": {
    object (PerformanceGoal)
  },
  "budget": {
    object (InsertionOrderBudget)
  },
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "reservationType": enum (ReservationType),
  "billableOutcome": enum (BillableOutcome)
}

string

Hanya output. Nama resource pesanan pemasangan iklan.

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Wajib. Nama tampilan pesanan pemasangan iklan.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

enum (InsertionOrderType)

Jenis pesanan pemasangan iklan.

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

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.

string (Timestamp format)

Hanya output. Stempel waktu saat pesanan pemasangan iklan terakhir diperbarui. Ditetapkan oleh sistem.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

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.

object (Pacing)

Wajib. Setelan kecepatan pembelanjaan anggaran pesanan pemasangan iklan.

object (FrequencyCap)

Wajib. Setelan pembatasan frekuensi pesanan pemasangan iklan.

object (IntegrationDetails)

Detail integrasi tambahan pesanan pemasangan iklan.

object (PerformanceGoal)

Wajib. Sasaran performa pesanan pemasangan iklan.

object (InsertionOrderBudget)

Wajib. Setelan alokasi anggaran pesanan pemasangan iklan.

object (BiddingStrategy)

Strategi bidding pesanan pemasangan iklan. Secara default, fixedBid disetel.

enum (ReservationType)

Hanya output. Jenis reservasi pesanan pemasangan iklan.

enum (BillableOutcome)

Tidak dapat diubah. Hasil pesanan pemasangan iklan yang dapat ditagih.

Pembelian berbasis hasil tidak digunakan lagi. BILLABLE_OUTCOME_PAY_PER_IMPRESSION adalah satu-satunya nilai yang valid.

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

enum (BudgetUnit)

Wajib. Tidak dapat diubah. Unit anggaran menentukan apakah anggaran berbasis mata uang atau tayangan.

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.

object (InsertionOrderBudgetSegment)

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

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

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.

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.

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 sebelumnya memiliki endDate yang dapat diubah, tetapi startDate yang tidak dapat diubah.
• endDate harus berupa startDate atau yang lebih baru, keduanya sebelum tahun 2037.

string (int64 format)

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