- Referensi: Kampanye
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- Metode
Resource: Kampanye
Satu kampanye.
Representasi JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
Kolom | |
---|---|
name |
Hanya output. Nama resource kampanye. |
advertiserId |
Hanya output. ID unik pengiklan yang memiliki kampanye tersebut. |
campaignId |
Hanya output. ID unik kampanye. Ditetapkan oleh sistem. |
displayName |
Wajib diisi. Nama tampilan kampanye. Harus berenkode UTF-8 dengan ukuran maksimum 240 byte. |
entityStatus |
Wajib diisi. Mengontrol apakah pesanan pemasangan iklan dalam kampanye ini dapat membelanjakan anggaran dan mengajukan bid pada inventaris atau tidak.
|
updateTime |
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: |
campaignGoal |
Wajib diisi. Sasaran kampanye. |
campaignFlight |
Wajib diisi. Pembelanjaan yang direncanakan dan durasi kampanye. |
frequencyCap |
Wajib diisi. Setelan batas frekuensi kampanye. |
campaignBudgets[] |
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 ( |
Kolom | |
---|---|
campaignGoalType |
Wajib diisi. Jenis sasaran kampanye. |
performanceGoal |
Wajib diisi. Sasaran performa kampanye. Nilai yang dapat diterima untuk
|
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. |
PerformanceGoal
Setelan yang mengontrol sasaran performa kampanye.
Representasi JSON |
---|
{ "performanceGoalType": enum ( |
Kolom | |
---|---|
performanceGoalType |
Wajib diisi. Jenis sasaran performa. |
Kolom union performance_goal_value . Wajib diisi. Nilai sasaran performa yang sesuai dengan performance_goal_type tertentu. performance_goal_value hanya dapat berupa salah satu dari yang berikut: |
|
performanceGoalAmountMicros |
Jumlah sasaran, dalam mikro mata uang pengiklan. Berlaku jika
Misalnya 1500000 mewakili 1,5 unit standar mata uang. |
performanceGoalPercentageMicros |
Representasi desimal dari persentase sasaran dalam mikro. Berlaku jika
Misalnya, 70000 mewakili 7% (desimal 0,07). |
performanceGoalString |
String indikator performa utama (KPI), yang boleh kosong. Harus berenkode UTF-8 dengan panjang tidak lebih dari 100 karakter. Berlaku jika |
PerformanceGoalType
Kemungkinan jenis sasaran performa.
Enum | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
Jenis sasaran performa tidak ditentukan atau tidak diketahui dalam versi ini. |
PERFORMANCE_GOAL_TYPE_CPM |
Sasaran performa ditetapkan dalam CPM (biaya per seribu). |
PERFORMANCE_GOAL_TYPE_CPC |
Sasaran performa ditetapkan dalam CPC (biaya per klik). |
PERFORMANCE_GOAL_TYPE_CPA |
Sasaran performa ditetapkan dalam CPA (biaya per tindakan). |
PERFORMANCE_GOAL_TYPE_CTR |
Sasaran performa ditetapkan dalam persentase CTR (rasio klik-tayang). |
PERFORMANCE_GOAL_TYPE_VIEWABILITY |
Sasaran performa ditetapkan dalam persentase Visibilitas. |
PERFORMANCE_GOAL_TYPE_CPIAVC |
Sasaran performa ditetapkan sebagai CPIAVC (biaya per tayangan iklan yang terdengar dan terlihat saat iklan selesai). |
PERFORMANCE_GOAL_TYPE_CPE |
Sasaran performa ditetapkan dalam CPE (biaya per engagement). |
PERFORMANCE_GOAL_TYPE_CLICK_CVR |
Sasaran performa ditetapkan dalam persentase rasio konversi klik (konversi per klik). |
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR |
Sasaran performa ditetapkan dalam persentase rasio konversi tayangan (konversi per tayangan iklan). |
PERFORMANCE_GOAL_TYPE_VCPM |
Sasaran performa ditetapkan dalam vCPM (biaya per seribu tayangan iklan terlihat). |
PERFORMANCE_GOAL_TYPE_VTR |
Sasaran performa ditetapkan dalam persentase rasio tontonan YouTube (penayangan YouTube per tayangan). |
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE |
Sasaran performa ditetapkan dalam persentase rasio penyelesaian audio (perdengaran audio lengkap per tayangan iklan). |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
Sasaran performa ditetapkan dalam persentase rasio penyelesaian video (jumlah tontonan video lengkap per tayangan iklan). |
PERFORMANCE_GOAL_TYPE_OTHER |
Sasaran performa ditetapkan ke Lainnya. |
CampaignFlight
Setelan yang melacak pembelanjaan yang direncanakan dan durasi kampanye.
Representasi JSON |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
Kolom | |
---|---|
plannedSpendAmountMicros |
Jumlah yang diperkirakan akan dibelanjakan kampanye untuk Jumlahnya dalam mikro. Harus lebih besar atau sama dengan 0. Misalnya, 500000000 mewakili 500 unit standar mata uang. |
plannedDates |
Wajib diisi. Tanggal kampanye diperkirakan akan berjalan. Masalah tersebut diselesaikan sesuai dengan zona waktu pengiklan induk.
|
CampaignBudget
Setelan yang mengontrol cara anggaran kampanye dialokasikan.
Representasi JSON |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
Kolom | |
---|---|
budgetId |
ID unik anggaran kampanye. Ditetapkan oleh sistem. Jangan tetapkan untuk anggaran baru. Harus disertakan saat memperbarui atau menambahkan anggaran ke |
displayName |
Wajib diisi. Nama tampilan anggaran. Harus berenkode UTF-8 dengan ukuran maksimum 240 byte. |
budgetUnit |
Wajib diisi. Tidak dapat diubah. Menentukan apakah anggaran diukur dalam mata uang atau tayangan iklan. |
budgetAmountMicros |
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 |
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.
|
externalBudgetSource |
Wajib diisi. Sumber eksternal anggaran. |
externalBudgetId |
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 |
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 |
prismaConfig |
Metadata tambahan untuk digunakan oleh alat Mediaocean Prisma. Wajib untuk anggaran Mediaocean. Hanya berlaku untuk pengiklan |
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 ( |
Kolom | |
---|---|
prismaType |
Wajib diisi. Tipe Prisma. |
prismaCpeCode |
Wajib diisi. Kode klien, produk, dan estimasi yang relevan dari alat Mediaocean Prisma. |
supplier |
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_SEARCH |
Jenis penelusuran. |
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 |
Kode klien Prisma. |
prismaProductCode |
Kode produk Prisma. |
prismaEstimateCode |
Kode estimasi Prisma. |
Metode |
|
---|---|
|
Membuat kampanye baru. |
|
Menghapus kampanye secara permanen. |
|
Mendapatkan kampanye. |
|
Mencantumkan kampanye dalam pengiklan. |
|
Mencantumkan opsi penargetan kampanye yang ditetapkan di seluruh jenis penargetan. |
|
Memperbarui kampanye yang ada. |