行銷活動

包含用來管理 廣告活動的方法。

方法

方法名稱 傳回類型 描述
addLocation (int locationId) TargetedLocationOperation 在此廣告活動中,從位置識別碼建立位置目標。
addLocation (int locationId, double bidModifier) TargetedLocationOperation 根據位置識別碼和出價調節係數,建立此廣告活動中的位置目標。
addNegativeKeywordList (NegativeKeywordList negativeKeywordList) void 將排除字彙清單新增至此廣告活動。
廣告群組 AdGroupSelector 取得用來篩選此廣告活動中廣告群組清單的 選取器
廣告 AdSelector 取得用來篩選此廣告活動中的廣告清單的 選取器
applyLabel (字串名稱) void 將標籤套用至此廣告活動。
assetGroups AssetGroupSelector 取得用來篩選此行銷活動中的資產群組清單的 選取器
[啟用] void 啟用此行銷活動。
excludeLocation (int locationId) ExcludedLocationOperation 在這個廣告活動中,從位置識別碼建立位置排除。
getBiddingStrategyType 字串 取得這個廣告活動的出價策略。
getBudget 預算 取得這個廣告活動的預算。
getEntityType 字串 取得此實體的類型。
getId 字串 取得可唯一識別此行銷活動的識別碼。
getName 字串 取得這個行銷活動的名稱。
getStats 統計資料 取得這個廣告活動的成效資料。
isEnabled 布林值 取得布林值,指出是否已啟用此行銷活動。
isPaused 布林值 取得布林值,指出此行銷活動是否已暫停。
isRemoved 布林值 取得布林值,指出是否已移除 (刪除) 此行銷活動。
關鍵字 KeywordSelector 取得用來篩選此廣告活動中關鍵字清單的 選取器
標籤 LabelSelector 取得用來篩選與此行銷活動相關聯標籤清單的 選取器
newAdGroupBuilder AdGroupBuilder 取得用來將廣告群組新增至此廣告活動的建立器。
暫停 void 暫停此行銷活動。
productGroups ProductGroupSelector 取得用來篩選此廣告活動中產品群組清單的選取器。
remove void 移除此行銷活動。
removeLabel (字串名稱) void 從這個廣告活動移除標籤。
setName (字串名稱) void 設定這個廣告活動的名稱。
目標設定 CampaignTargeting 提供廣告活動層級目標設定準則的存取權:位置目標設定。
URL CampaignUrls 取得管理這個廣告活動追蹤範本和自訂參數的方法。

addLocation (int locationId)

在此廣告活動中,從位置識別碼建立位置目標。

傳回

類型 描述
TargetedLocationOperation 作業物件用來檢查目標位置是否已成功新增。

addLocation (int locationId, double bidModifier)

根據位置識別碼和出價調節係數,建立此廣告活動中的位置目標。

傳回

類型 描述
TargetedLocationOperation 作業物件用來檢查目標位置是否已成功新增。

addNegativeKeywordList (NegativeKeywordList negativeKeywordList)

將排除字彙清單新增至此廣告活動。

引數

名稱 類型 描述
negativeKeywordList NegativeKeywordList 要新增至此廣告活動的排除字彙清單。 一個廣告活動最多可以包含 20 個清單。

傳回

類型 描述
void 會傳回 nothing。

廣告群組

取得用來篩選此廣告活動中廣告群組清單的 選取器

傳回

類型 描述
AdGroupSelector 用來篩選此廣告活動中廣告群組清單的選取器。

廣告

取得用來篩選此廣告活動中的廣告清單的 選取器

傳回

類型 描述
AdSelector 用來篩選此廣告活動中的廣告清單的選取器。

applyLabel (字串名稱)

將標籤套用至廣告活動。

一個廣告活動最多可以套用 50 個標籤。 如需將標籤新增至實體的範例,請參閱 使用標籤

引數

名稱 類型 描述
Name 字串 標籤的區分大小寫的名稱。 若要取得此帳戶中可套用的標籤清單,請參閱 AdsApp.labels

傳回

類型 描述
void 會傳回 nothing。

assetGroups

取得用來篩選此行銷活動中的資產群組清單的 選取器

傳回

類型 描述
AssetGroupSelector 用來篩選此行銷活動中的資產群組清單的選取器。

[啟用]

啟用此行銷活動。

傳回

類型 描述
void 會傳回 nothing。

excludeLocation (int locationId)

在這個廣告活動中,從位置識別碼建立位置排除。

傳回

類型 描述
ExcludedLocationOperation 作業物件,用來檢查是否已成功新增排除位置。

getBiddingStrategyType

取得這個廣告活動的出價策略。

傳回

類型 描述
字串 廣告活動的出價策略。 可能的值為:
  • MANUAL_CPC
  • TARGET_SPEND
  • MAXIMIZE_CONVERSIONS
  • ENHANCED_CPC
  • TARGET_CPA
如需詳細資訊,請參閱 出價策略

getBudget

取得這個廣告活動的預算。

傳回

類型 描述
預算 包含管理這個廣告活動預算的方法。

getEntityType

取得此實體的類型。

傳回

類型 描述
字串 此實體的類型,即 Campaign

getId

取得可唯一識別此行銷活動的識別碼。

傳回

類型 描述
字串 可唯一識別此行銷活動的 ID。

getName

取得這個行銷活動的名稱。

傳回:

類型 描述
字串 行銷活動的名稱。

getStats

取得這個廣告活動的成效資料。

若要呼叫這個方法,您必須在廣告活動選取器的鏈結中包含其中一個forDateRange方法。

傳回

類型 描述
統計資料 廣告活動的成效資料。

isEnabled

取得布林值,指出是否已啟用此行銷活動。

傳回

類型 描述
布林值 如果已啟用此行銷活動,則為 True ;否則為 false

isPaused

取得布林值,指出此行銷活動是否已暫停。

傳回

類型 描述
布林值 如果此行銷活動已暫停,則為 True ;否則為 false

isRemoved

取得布林值,指出是否已移除 (刪除) 此行銷活動。

傳回

類型 描述
布林值 如果移除此行銷活動,則為 True ;否則為 false

關鍵字

取得用來篩選此廣告活動中關鍵字清單的 選取器

傳回

類型 描述
KeywordSelector 用來篩選此廣告活動中關鍵字清單的選取器。

標籤

取得用來篩選與此行銷活動相關聯標籤清單的 選取器

傳回

類型 描述
LabelSelector 用來篩選與此行銷活動相關聯標籤清單的選取器。

newAdGroupBuilder

取得用來將廣告群組新增至此廣告活動的 建立器

傳回

類型 描述
AdGroupBuilder 用來將廣告群組新增至此廣告活動的建立器。

暫停

暫停此行銷活動。

傳回

類型 描述
void 會傳回 nothing。

productGroups

取得用來篩選此廣告活動中產品群組清單的 選取器

傳回

類型 描述
ProductGroupSelector 用來篩選此廣告活動中產品群組清單的選取器。

移除

移除此行銷活動。

傳回

類型 描述
void 會傳回 nothing。

removeLabel (字串名稱)

從廣告活動移除標籤。

引數

名稱 類型 描述
Name 字串 標籤的區分大小寫的名稱。 若要取得與此行銷活動相關聯的標籤清單,請參閱標籤。

傳回

類型 描述
void 會傳回 nothing。

setName (字串名稱)

設定廣告活動的名稱。

引數

名稱 類型 描述
Name 字串 行銷活動的名稱。 名稱最多可以包含 128 個字元,且必須在帳戶內是唯一的。

傳回

類型 描述
void 會傳回 nothing。

目標設定

提供廣告活動層級目標設定準則的存取權:位置目標設定。

傳回

類型 描述
CampaignTargeting 存取此廣告活動中的位置目標設定條件。

URL

取得管理這個廣告活動追蹤範本和自訂參數的方法。

傳回

類型 描述
CampaignUrls 包含管理此廣告活動追蹤範本和自訂參數的方法。

另請參閱