REST Resource: advertisers.campaigns

Resource: Kampanye

Satu kampanye.

Representasi JSON
{
  "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)
    }
  ]
}
Kolom
name

string

Hanya output. Nama resource kampanye.

advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki kampanye tersebut.

campaignId

string (int64 format)

Hanya output. ID unik kampanye. Ditetapkan oleh sistem.

displayName

string

Wajib diisi. Nama tampilan kampanye.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

entityStatus

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.
updateTime

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".

campaignGoal

object (CampaignGoal)

Wajib diisi. Sasaran kampanye.

campaignFlight

object (CampaignFlight)

Wajib diisi. Pembelanjaan yang direncanakan dan durasi kampanye.

frequencyCap

object (FrequencyCap)

Wajib diisi. Setelan batas frekuensi kampanye.

campaignBudgets[]

object (CampaignBudget)

Daftar anggaran yang tersedia untuk kampanye ini.

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

CampaignGoal

Setelan yang mengontrol sasaran kampanye.

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

enum (CampaignGoalType)

Wajib diisi. Jenis sasaran kampanye.

performanceGoal

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

CampaignGoalType

Kemungkinan jenis sasaran kampanye.

Enum
CAMPAIGN_GOAL_TYPE_UNSPECIFIED Nilai sasaran tidak ditentukan atau tidak diketahui dalam versi ini.
CAMPAIGN_GOAL_TYPE_APP_INSTALL Mendorong engagement atau penginstalan aplikasi.
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS Meningkatkan awareness terhadap brand atau produk.
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION Dorong penjualan offline atau di toko.
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION Mendorong tindakan atau kunjungan online.

CampaignFlight

Setelan yang melacak pembelanjaan yang direncanakan dan durasi kampanye.

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

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.

plannedDates

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.

CampaignBudget

Setelan yang mengontrol cara anggaran kampanye dialokasikan.

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

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.

displayName

string

Wajib diisi. Nama tampilan anggaran.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.

budgetUnit

enum (BudgetUnit)

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

budgetAmountMicros

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.

dateRange

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.

externalBudgetSource

enum (ExternalBudgetSource)

Wajib diisi. Sumber eksternal anggaran.

externalBudgetId

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.

invoiceGroupingId

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.

prismaConfig

object (PrismaConfig)

Metadata tambahan untuk digunakan oleh alat Mediaocean Prisma.

Wajib untuk anggaran Mediaocean.

Hanya berlaku untuk pengiklan prismaEnabled.

ExternalBudgetSource

Sumber eksternal untuk segmen anggaran kampanye.

Enum
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED Nilai sumber anggaran eksternal tidak ditentukan atau tidak diketahui dalam versi ini.
EXTERNAL_BUDGET_SOURCE_NONE Anggaran tidak memiliki sumber eksternal.
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN Sumber anggaran adalah Mediaocean.

PrismaConfig

Setelan khusus untuk alat Mediaocean Prisma.

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

enum (PrismaType)

Wajib diisi. Tipe Prisma.

prismaCpeCode

object (PrismaCpeCode)

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

supplier

string

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

PrismaType

Jenis yang mungkin untuk anggaran Prisma.

Enum
PRISMA_TYPE_UNSPECIFIED Jenis tidak ditentukan atau tidak diketahui dalam versi ini.
PRISMA_TYPE_DISPLAY Jenis tampilan.
PRISMA_TYPE_VIDEO Jenis video.
PRISMA_TYPE_AUDIO Jenis audio.
PRISMA_TYPE_SOCIAL Jenis sosial.
PRISMA_TYPE_FEE Jenis biaya.

PrismaCpeCode

Pusat Pembayaran Google mendukung penelusuran dan pemfilteran pada kolom komponen dari kode ini.

Representasi JSON
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
Kolom
prismaClientCode

string

Kode klien Prisma.

prismaProductCode

string

Kode produk Prisma.

prismaEstimateCode

string

Kode estimasi Prisma.

Metode

bulkListCampaignAssignedTargetingOptions

Mencantumkan opsi penargetan kampanye yang ditetapkan di seluruh jenis penargetan.

create

Membuat kampanye baru.

delete

Menghapus kampanye secara permanen.

get

Mendapatkan kampanye.

list

Mencantumkan kampanye dalam pengiklan.

patch

Memperbarui kampanye yang ada.