- 資源:廣告活動
- CampaignGoal
- CampaignGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- 方法
資源:Campaign
只需一個廣告活動,
JSON 表示法 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。廣告活動的資源名稱。 |
advertiserId |
僅供輸出。廣告活動所屬的廣告客戶專屬 ID。 |
campaignId |
僅供輸出。廣告活動的專屬 ID。由系統指派。 |
displayName |
必要欄位。廣告活動的顯示名稱。 必須使用 UTF-8 編碼,且大小上限為 240 個位元組。 |
entityStatus |
必要欄位。控管這個廣告活動中的廣告訂單能否支出預算及對廣告空間出價。
|
updateTime |
僅供輸出。廣告活動上次更新時的時間戳記。由系統指派。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
campaignGoal |
必要欄位。廣告活動的目標。 |
campaignFlight |
必要欄位。廣告活動的預計支出和放送期間。 |
frequencyCap |
必要欄位。廣告活動的展示頻率上限設定。 |
campaignBudgets[] |
廣告活動可用的預算清單。 如未設定這個欄位,廣告活動會使用無限制預算。 |
CampaignGoal
控制廣告活動目標的設定。
JSON 表示法 |
---|
{ "campaignGoalType": enum ( |
欄位 | |
---|---|
campaignGoalType |
必要欄位。廣告活動目標的類型。 |
performanceGoal |
必要欄位。廣告活動的成效目標。
|
CampaignGoalType
可能的廣告活動目標類型。
列舉 | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
這個版本未指定或不知道目標價值。 |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
提高應用程式安裝次數或參與度。 |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
提高品牌或產品的知名度。 |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
提高離線或店內銷售量。 |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
吸引顧客在線上採取動作或造訪網站。 |
CampaignFlight
追蹤廣告活動預定支出和持續時間的設定。
JSON 表示法 |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
欄位 | |
---|---|
plannedSpendAmountMicros |
廣告活動在指定 金額以微量為單位。必須大於或等於 0。例如,500000000 代表貨幣的 500 個標準單位。 |
plannedDates |
必要欄位。廣告活動的預計放送日期。而是以上層廣告客戶的時區為準。
|
CampaignBudget
控制廣告活動預算分配方式的設定。
JSON 表示法 |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
欄位 | |
---|---|
budgetId |
廣告活動預算的專屬 ID。由系統指派。不要為新預算設定。 更新或新增預算至 |
displayName |
必要欄位。預算的顯示名稱。 必須使用 UTF-8 編碼,且大小上限為 240 個位元組。 |
budgetUnit |
必要欄位。不可變動。指定預算是以貨幣或曝光評估。 |
budgetAmountMicros |
必要欄位。已連結廣告訂單區隔可預算的總金額。 金額以微量為單位。(必須大於 0)。例如,500000000 代表貨幣的 500 個標準單位。 |
dateRange |
必要欄位。廣告活動預算的日期範圍。已連結的預算區隔可能會有不同的日期範圍。而是以上層廣告客戶的時區為準。
|
externalBudgetSource |
必要欄位。預算的外部來源。 |
externalBudgetId |
不可變動。向外部來源識別此預算的 ID。 如果您已設定這個欄位,且對應帳單資料的月結單詳細資料層級設為「預算層級訂購單」,透過這筆預算放送的所有曝光都會在月結單中加入這個 ID。 在廣告活動下不得重複。 |
invoiceGroupingId |
不可變動。用來將預算分組至同一張月結單的 ID。 如果您已設定這個欄位,且對應帳單資料的月結單層級已設為「預算月結單分組 ID」,共用相同的 |
prismaConfig |
Mediaocean Prisma 工具使用的其他中繼資料。 Mediaocean 預算必填。 僅適用於 |
ExternalBudgetSource
廣告活動預算區隔的外部來源。
列舉 | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
這個版本未指定或不明外部預算來源值。 |
EXTERNAL_BUDGET_SOURCE_NONE |
預算沒有外部來源。 |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
預算來源為 Mediaocean。 |
PrismaConfig
Mediaocean Prisma 工具的特定設定。
JSON 表示法 |
---|
{ "prismaType": enum ( |
欄位 | |
---|---|
prismaType |
必要欄位。Prisma 類型。 |
prismaCpeCode |
必要欄位。Mediaocean Prisma 工具提供的相關客戶、產品和預估代碼。 |
supplier |
必要欄位。分配此預算的實體 (需求端平台、網站等)。 |
PrismaType
Prisma 預算可能使用的類型。
列舉 | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
這個版本未指定或不明類型。 |
PRISMA_TYPE_DISPLAY |
顯示類型。 |
PRISMA_TYPE_SEARCH |
搜尋類型。 |
PRISMA_TYPE_VIDEO |
影片類型。 |
PRISMA_TYPE_AUDIO |
音訊類型。 |
PRISMA_TYPE_SOCIAL |
社群類型。 |
PRISMA_TYPE_FEE |
費用類型。 |
PrismaCpeCode
Google 付款中心支援搜尋及篩選這組代碼的元件欄位。
JSON 表示法 |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
欄位 | |
---|---|
prismaClientCode |
Prisma 用戶端代碼。 |
prismaProductCode |
Prisma 產品代碼。 |
prismaEstimateCode |
Prisma 預估代碼。 |
方法 |
|
---|---|
|
建立新的廣告活動。 |
|
永久刪除廣告活動。 |
|
取得廣告活動。 |
|
列出廣告客戶的廣告活動。 |
|
列出廣告活動在不同指定目標類型的指定目標選項。 |
|
更新現有的廣告活動。 |