REST Resource: advertisers.campaigns

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}

string

Hanya output. Nama resource kampanye.

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki kampanye tersebut.

string (int64 format)

Hanya output. ID unik kampanye. Ditetapkan oleh sistem.

string

Wajib diisi. Nama tampilan kampanye.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

enum (EntityStatus)

Wajib diisi. Mengontrol apakah pesanan pemasangan iklan dalam kampanye ini dapat membelanjakan anggaran dan mengajukan bid pada inventaris atau tidak.

• Nilai yang diterima adalah ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED, dan ENTITY_STATUS_PAUSED.
• Untuk metode campaigns.create, ENTITY_STATUS_ARCHIVED tidak diizinkan.

string (Timestamp format)

Hanya output. Stempel waktu saat kampanye 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 (CampaignGoal)

Wajib diisi. Sasaran kampanye.

object (CampaignFlight)

Wajib diisi. Pembelanjaan yang direncanakan dan durasi kampanye.

object (FrequencyCap)

Wajib diisi. Setelan batas frekuensi kampanye.

object (CampaignBudget)

Daftar anggaran yang tersedia untuk kampanye ini.

Jika kolom ini tidak ditetapkan, kampanye akan menggunakan anggaran tidak terbatas.

{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}

enum (CampaignGoalType)

Wajib diisi. Jenis sasaran kampanye.

object (PerformanceGoal)

Wajib diisi. Sasaran performa kampanye.

Nilai yang dapat diterima untuk performanceGoalType adalah:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_OTHER

{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}

enum (PerformanceGoalType)

Wajib diisi. Jenis sasaran performa.

string (int64 format)

Jumlah sasaran, dalam mikro mata uang pengiklan.

Berlaku jika performanceGoalType adalah salah satu dari:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_VCPM

Misalnya 1500000 mewakili 1,5 unit standar mata uang.

string (int64 format)

Representasi desimal dari persentase sasaran dalam mikro.

Berlaku jika performanceGoalType adalah salah satu dari:

• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_CLICK_CVR
• PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
• PERFORMANCE_GOAL_TYPE_VTR
• PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
• PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

Misalnya, 70000 mewakili 7% (desimal 0,07).

string

String indikator performa utama (KPI), yang boleh kosong. Harus berenkode UTF-8 dengan panjang tidak lebih dari 100 karakter.

Berlaku jika performanceGoalType ditetapkan ke PERFORMANCE_GOAL_TYPE_OTHER.

{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}

string (int64 format)

Jumlah yang diperkirakan akan dibelanjakan kampanye untuk plannedDates yang ditentukan. Tindakan ini tidak akan membatasi penayangan, tetapi akan digunakan untuk melacak pembelanjaan di UI DV360.

Jumlahnya dalam mikro. Harus lebih besar atau sama dengan 0. Misalnya, 500000000 mewakili 500 unit standar mata uang.

object (DateRange)

Wajib diisi. Tanggal kampanye diperkirakan akan berjalan. Masalah tersebut diselesaikan sesuai dengan zona waktu pengiklan induk.

• Tanggal yang ditentukan di sini tidak akan memengaruhi penayangan. Fungsi ini digunakan untuk membuat peringatan dan peringatan. Misalnya, jika tanggal penayangan pesanan pemasangan iklan turunan berada di luar rentang tanggal tersebut, antarmuka pengguna akan menampilkan peringatan.
• startDate wajib diisi dan harus berupa tanggal saat ini atau setelahnya.
• endDate bersifat opsional. Jika ditentukan, nilai harus berupa startDate atau yang lebih baru.
• Setiap tanggal yang ditentukan harus sebelum tahun 2037.

{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}

string (int64 format)

ID unik anggaran kampanye. Ditetapkan oleh sistem. Jangan tetapkan untuk anggaran baru.

Harus disertakan saat memperbarui atau menambahkan anggaran ke campaignBudgets. Jika tidak, ID baru akan dibuat dan ditetapkan.

string

Wajib diisi. Nama tampilan anggaran.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

enum (BudgetUnit)

Wajib diisi. Tidak dapat diubah. Menentukan apakah anggaran diukur dalam mata uang atau tayangan iklan.

string (int64 format)

Wajib diisi. Total jumlah yang dapat dianggarkan oleh segmen pesanan pemasangan iklan tertaut.

Jumlahnya dalam mikro. Harus lebih besar dari 0. Misalnya, 500000000 mewakili 500 unit standar mata uang.

object (DateRange)

Wajib diisi. Rentang tanggal untuk anggaran kampanye. Segmen anggaran yang ditautkan mungkin memiliki rentang tanggal yang berbeda. Masalah tersebut diselesaikan sesuai dengan zona waktu pengiklan induk.

startDate dan endDate harus sebelum tahun 2037.

enum (ExternalBudgetSource)

Wajib diisi. Sumber eksternal anggaran.

string

Tidak dapat diubah. ID yang mengidentifikasi anggaran ini ke sumber eksternal.

Jika kolom ini ditetapkan dan tingkat detail invoice pada profil penagihan yang sesuai ditetapkan ke "PO tingkat anggaran", semua tayangan iklan yang ditampilkan terhadap anggaran ini akan menyertakan ID ini di invoice.

Harus unik dalam kampanye.

string

Tidak dapat diubah. ID yang digunakan untuk mengelompokkan anggaran yang akan disertakan dalam invoice yang sama.

Jika kolom ini ditetapkan dan tingkat invoice profil penagihan yang sesuai ditetapkan ke "Budget invoice attribution ID", semua externalBudgetId yang memiliki invoiceGroupingId yang sama akan dikelompokkan dalam invoice yang sama.

object (PrismaConfig)

Metadata tambahan untuk digunakan oleh alat Mediaocean Prisma.

Wajib untuk anggaran Mediaocean.

Hanya berlaku untuk pengiklan prismaEnabled.

{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}

enum (PrismaType)

Wajib diisi. Tipe Prisma.

object (PrismaCpeCode)

Wajib diisi. Kode klien, produk, dan estimasi yang relevan dari alat Mediaocean Prisma.

string

Wajib diisi. Entitas yang mengalokasikan anggaran ini (DSP, situs, dll.).

{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}

string

Kode klien Prisma.

string

Kode produk Prisma.

string

Kode estimasi Prisma.