- 資源:Campaign
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- 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」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
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 |
吸引顧客在線上採取動作或造訪網站。 |
PerformanceGoal
控制廣告活動成效目標的設定。
JSON 表示法 |
---|
{ "performanceGoalType": enum ( |
欄位 | |
---|---|
performanceGoalType |
必要欄位。成效目標的類型。 |
聯集欄位 performance_goal_value 。必要欄位。與指定performance_goal_type 對應的成效目標值。performance_goal_value 只能採用下列其中一種設定: |
|
performanceGoalAmountMicros |
目標金額 (以廣告客戶幣別的百萬分之一表示)。 適用於
舉例來說,1500000 代表 1.5 標準貨幣單位。 |
performanceGoalPercentageMicros |
目標百分比的十進位表示法 (以微秒為單位)。 適用於
例如,70000 代表 7% (小數點 0.07)。 |
performanceGoalString |
主要成效指標 (KPI) 字串,可以留空。必須使用 UTF-8 編碼,且長度不得超過 100 個字元。 適用於 |
PerformanceGoalType
可能的成效目標類型。
列舉 | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
未指定成效目標類型,或這個版本中不明。 |
PERFORMANCE_GOAL_TYPE_CPM |
成效目標會以千次曝光出價 (CPM) 設定。 |
PERFORMANCE_GOAL_TYPE_CPC |
成效目標會以單次點擊出價 (CPC) 設定。 |
PERFORMANCE_GOAL_TYPE_CPA |
成效目標是在單次操作出價 (CPA) 中設定。 |
PERFORMANCE_GOAL_TYPE_CTR |
成效目標會以點閱率百分比設定。 |
PERFORMANCE_GOAL_TYPE_VIEWABILITY |
成效目標是在「可視度百分比」中設定。 |
PERFORMANCE_GOAL_TYPE_CPIAVC |
成效目標設為 CPIAVC (在影片結束播放時仍然可聽可見的單次曝光費用)。 |
PERFORMANCE_GOAL_TYPE_CPE |
成效目標是在單次參與出價 (CPE) 中設定。 |
PERFORMANCE_GOAL_TYPE_CLICK_CVR |
成效目標以點擊轉換率 (單次點擊轉換次數) 百分比設定。 |
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR |
成效目標是以曝光轉換率 (單次曝光轉換) 百分比設定。 |
PERFORMANCE_GOAL_TYPE_VCPM |
成效目標是在千次可視曝光出價 (vCPM) 中設定。 |
PERFORMANCE_GOAL_TYPE_VTR |
成效目標是以 YouTube 收視率 (每次曝光的 YouTube 觀看次數) 百分比為依據。 |
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE |
成效目標會以音訊播放完成率 (每次曝光的完整音訊播放次數) 百分比設定。 |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
成效目標會以影片播放完成率 (每次曝光的完整影片觀看次數) 百分比設定。 |
PERFORMANCE_GOAL_TYPE_OTHER |
成效目標設為「其他」。 |
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。 如果設定了這個欄位,且對應帳單資料的月結單詳細資料層級設為「預算層級訂購單」,則針對這筆預算放送的所有曝光都會納入月結單中。 在廣告活動中不得重複。 |
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 預估代碼。 |
方法 |
|
---|---|
|
建立新廣告活動。 |
|
永久刪除廣告活動。 |
|
取得廣告活動。 |
|
列出廣告客戶中的廣告活動。 |
|
列出跨指定類型廣告活動的指派指定目標選項。 |
|
更新現有的廣告活動。 |