包含用來定義和新增廣告群組的方法。 如需產生器的相關資訊，請參閱 建立器。
範例使用方式：
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
}
方法
建立
建立廣告群組，並傳回用來檢查是否已成功新增廣告群組的工作物件。
傳回
withBiddingStrategy (字串字串strategy)
設定廣告群組的廣告策略。
引數
| 名稱 |
類型 |
說明 |
| 載入器Strategy |
字串 |
要套用至廣告群組的策略。 以下是可能區分大小寫的值。- MANUAL_CPC
- MANUAL_CPM
- MANUAL_CPV
如需這些策略的相關資訊，請參閱 Bid 策略類型。 |
傳回
withCpc (double 並)
設定廣告群組的檢定。
指定當 關鍵字符合使用者的搜尋字詞，且廣告群組的約定策略MANUAL_CPC時，所要使用的約定金額。 如果關鍵字之類的較低層級實體不會覆寫它，則會使用此比對。
引數
| 名稱 |
類型 |
說明 |
| 中國共產黨 |
double |
廣告群組的最大一次的檢索。 帳戶的貨幣會決定最小值和最大報價值。 如需詳細資訊，請參閱 Bid 和 budget 貨幣。 |
傳回
withCpm (double cpm)
設定廣告群組的 CPM 報價。
指定每 1,000 個檢視曝光數所要使用的約定金額，以及廣告群組的MANUAL_CPM。
引數
| 名稱 |
類型 |
說明 |
| Cpm |
double |
廣告群組的最大 CPM 報價。 帳戶的貨幣會決定最小值和最大報價值。 如需詳細資訊，請參閱 Bid 和 budget 貨幣。 |
傳回
withCpv (雙 cpv)
設定廣告群組的 CPV 報價。
指定每一檢視或點選視訊廣告時，以及廣告群組的報價策略MANUAL_CPV時所要使用的約定金額。
引數
| 名稱 |
類型 |
說明 |
| Cpv |
double |
廣告群組的最大 CPV 報價。 帳戶的貨幣會決定最小值和最大報價值。 如需詳細資訊，請參閱 Bid 和 budget 貨幣。 |
傳回
withCustomParameters (Object customParameters)
設定要在最終 URL 或追蹤範本中使用的廣告群組自訂參數。
自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊，請參閱 自訂參數。
引數
| 名稱 |
類型 |
說明 |
| customParameters |
物件 |
最多可套用至廣告群組的三個自訂參數地圖。 例如，其中 {key1: 'value1', key2: 'value2', key3: 'value3'} 索引鍵是自訂參數的名稱，而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元，且值最多可包含 200 個 8 位元組字元。 |
傳回
withEndDate (字串 endDate)
設定廣告群組中的廣告停止供應的日期。 只有在您想要群組中的廣告在特定日期停止提供廣告時，才呼叫此方法。
引數
| 名稱 |
類型 |
說明 |
| endDate |
字串 |
停止提供廣告的日期。 以 YYYYMMDD 格式指定日期。 |
傳回
withEndDate (Object endDate)
設定廣告群組中的廣告停止供應的日期。 只有在您想要群組中的廣告在特定日期停止提供廣告時，才呼叫此方法。
引數
| 名稱 |
類型 |
說明 |
| endDate |
物件 |
停止提供廣告的日期。 使用具有下欄欄位的 物件來指定日期：
例如：var date = {year: 2018, month: 5, day: 13};
月份是以一為基底，其中 1 是 1 月，12 是 12 月。 |
傳回
withLanguage (字串語言)
設定廣告群組中廣告所使用的語言。
根據預設，廣告群組會從其父活動繼承語言。 指定廣告群組層級的語言來覆寫在行銷活動層級指定的語言，或者如果行銷活動未指定語言，則 (必須在行銷活動和/或廣告群組層級指定語言) 。
引數
| 名稱 |
類型 |
說明 |
| 語言 |
字串 |
廣告群組中廣告所使用的語言。 例如，英文。 字串不區分大小寫。 請勿使用兩個字元的語言代碼。 如需支援的語言清單，請參閱 廣告語言。 |
傳回
withName (字串名稱)
設定廣告群組的名稱。
引數
| 名稱 |
類型 |
描述 |
| Name |
字串 |
廣告群組的名稱。 需要名稱。 名稱最多可包含 256 個字元，而且在行銷活動的所有作用中廣告群組中必須是唯一的。 |
傳回
withStartDate (字串 startDate)
設定廣告群組中的廣告開始提供服務的日期。 只有在您想要群組中的廣告在特定日期開始提供服務時，才呼叫此方法;否則，廣告會立即開始提供。
引數
| 名稱 |
類型 |
說明 |
| endDate |
字串 |
開始提供廣告的日期。 以 YYYYMMDD 格式指定日期。 |
傳回
withStartDate (物件 startDate)
設定廣告群組中的廣告開始提供服務的日期。 只有在您想要群組中的廣告在特定日期開始提供服務時，才呼叫此方法;否則，廣告會立即開始提供。
引數
| 名稱 |
類型 |
說明 |
| endDate |
物件 |
開始提供廣告的日期。 使用具有下欄欄位的 物件來指定日期：
例如：var date = {year: 2018, month: 5, day: 13};
月份是以一為基底，其中 1 是 1 月，12 是 12 月。 |
傳回
withStatus (字串狀態)
設定廣告群組的狀態。
引數
| 名稱 |
類型 |
說明 |
| 狀態 |
字串 |
廣告群組的狀態。 以下是可能區分大小寫的值。
預設值為 PAUSED。 |
傳回
withTrackingTemplate (字串追蹤範本)
設定廣告群組的追蹤範本。
追蹤範本會與關鍵字的 FinalUrl 搭配使用，以建立廣告所使用的目的地 URL。 如需詳細資訊，請 參閱我可以使用哪些追蹤或 URL 參數？
引數
| 名稱 |
類型 |
說明 |
| trackingTemplate |
字串 |
要與廣告群組搭配使用的追蹤範本。 |
傳回
另請參閱
Campaign.newAdGroupBuilder ()