- Referensi: Kampanye
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- Metode
Referensi: 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. Nama tampilan kampanye. Harus dienkode UTF-8 dengan ukuran maksimum 240 byte. |
entityStatus |
Wajib. Mengontrol apakah perjanjian pemasangan iklan dalam kampanye ini dapat membelanjakan anggaran dan mengajukan bid untuk inventaris.
|
updateTime |
Hanya output. Stempel waktu saat kampanye terakhir diperbarui. Ditetapkan oleh sistem. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
campaignGoal |
Wajib. Sasaran kampanye. |
campaignFlight |
Wajib. Pembelanjaan dan durasi kampanye yang direncanakan. |
frequencyCap |
Wajib. Setelan batas frekuensi kampanye. |
campaignBudgets[] |
Daftar anggaran yang tersedia untuk kampanye ini. Jika kolom ini tidak ditetapkan, kampanye akan menggunakan anggaran tak terbatas. |
CampaignGoal
Setelan yang mengontrol sasaran kampanye.
Representasi JSON |
---|
{ "campaignGoalType": enum ( |
Kolom | |
---|---|
campaignGoalType |
Wajib. Jenis sasaran kampanye. |
performanceGoal |
Wajib. 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 suatu merek atau produk. |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
Mendorong 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. Jenis sasaran performa. |
Kolom union performance_goal_value . Wajib. Nilai sasaran performa yang sesuai dengan performance_goal_type yang ditentukan. performance_goal_value hanya dapat berupa salah satu dari 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 dienkode 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 penyelesaian). |
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). |
PERFORMANCE_GOAL_TYPE_VCPM |
Sasaran performa ditetapkan dalam vCPM (biaya per seribu tayangan 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 (pendengaran audio lengkap per tayangan). |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
Sasaran performa ditetapkan dalam persentase rasio penyelesaian video (penayangan video lengkap per tayangan). |
PERFORMANCE_GOAL_TYPE_OTHER |
Sasaran performa ditetapkan ke Lainnya. |
CampaignFlight
Setelan yang melacak pembelanjaan dan durasi kampanye yang direncanakan.
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. Tanggal kampanye diperkirakan akan berjalan. Penyesuaian ini 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. Nama tampilan anggaran. Harus dienkode UTF-8 dengan ukuran maksimum 240 byte. |
budgetUnit |
Wajib. Tidak dapat diubah. Menentukan apakah anggaran diukur dalam mata uang atau tayangan. |
budgetAmountMicros |
Wajib. Jumlah total 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. Rentang tanggal untuk anggaran kampanye. Segmen anggaran yang ditautkan mungkin memiliki rentang tanggal yang berbeda. Penyesuaian ini diselesaikan sesuai dengan zona waktu pengiklan induk.
|
externalBudgetSource |
Wajib. Sumber eksternal anggaran. |
externalBudgetId |
Tidak dapat diubah. ID yang mengidentifikasi anggaran ini ke sumber eksternal. Jika kolom ini ditetapkan dan tingkat detail invoice profil penagihan terkait disetel ke "PO tingkat anggaran", semua tayangan yang ditayangkan berdasarkan anggaran ini akan menyertakan ID ini di invoice. Harus unik dalam kampanye. |
invoiceGroupingId |
Tidak dapat diubah. ID yang digunakan untuk mengelompokkan anggaran agar disertakan dalam invoice yang sama. Jika kolom ini ditetapkan dan tingkat invoice profil penagihan yang sesuai disetel ke "ID pengelompokan invoice anggaran", semua |
prismaConfig |
Metadata tambahan untuk digunakan oleh alat Mediaocean Prisma. Diperlukan 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. Jenis Prisma. |
prismaCpeCode |
Wajib. Kode klien, produk, dan estimasi yang relevan dari alat Mediaocean Prisma. |
supplier |
Wajib. Entitas mengalokasikan anggaran ini (DSP, situs, dll.). |
PrismaType
Jenis yang memungkinkan 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 dalam 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 di pengiklan. |
|
Mencantumkan opsi penargetan kampanye yang ditetapkan di seluruh jenis penargetan. |
|
Memperbarui kampanye yang ada. |