AdGroupBuilder

發行項
11/13/2024

包含用來定義和新增廣告群組的方法。如需產生器的相關資訊，請參閱建立器。

範例使用方式：

    // 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`);
            }
        }
    }

方法

方法名稱	傳回類型	說明
建立	AdGroupOperation	建立廣告群組，並傳回用來檢查是否已成功新增廣告群組的工作物件。
withBiddingStrategy (字串字串strategy)	AdGroupBuilder	設定廣告群組的廣告策略。
withCpc (double 並)	AdGroupBuilder	設定廣告群組的最大一次的檢定。
withCpm (double cpm)	AdGroupBuilder	設定廣告群組的最大 CPM 報價。
withCpv (雙 cpv)	AdGroupBuilder	設定廣告群組的最大 CPV 報價。
withCustomParameters (Object customParameters)	AdGroupBuilder	設定廣告群組的自訂參數。
withEndDate (字串 endDate)	AdGroupBuilder	設定廣告群組中的廣告停止供應的日期。
withEndDate (Object endDate)	AdGroupBuilder	設定廣告群組中的廣告停止供應的日期。
withLanguage (字串語言)	AdGroupBuilder	設定這個廣告群組所使用的語言。
withName (字串名稱)	AdGroupBuilder	設定廣告群組的名稱。
withStartDate (字串 startDate)	AdGroupBuilder	設定廣告群組中的廣告開始提供服務的日期。
withStartDate (物件 startDate)	AdGroupBuilder	設定廣告群組中的廣告開始提供服務的日期。
withStatus (字串狀態)	AdGroupBuilder	設定廣告群組的狀態。
withTrackingTemplate (字串 trackingTemplate)	AdGroupBuilder	設定廣告群組的追蹤範本。

建立

建立廣告群組，並傳回用來檢查是否已成功新增廣告群組的工作物件。

傳回

類型	說明
AdGroupOperation	用來檢查是否已成功新增廣告群組的工作物件。

withBiddingStrategy (字串字串strategy)

設定廣告群組的廣告策略。

引數

名稱	類型	說明
載入器Strategy	字串	要套用至廣告群組的策略。以下是可能區分大小寫的值。 MANUAL_CPC MANUAL_CPM MANUAL_CPV 如需這些策略的相關資訊，請參閱 Bid 策略類型。

傳回

類型	說明
AdGroupBuilder	套用了高階策略的廣告群組產生器。

withCpc (double 並)

設定廣告群組的檢定。

指定當關鍵字符合使用者的搜尋字詞，且廣告群組的約定策略MANUAL_CPC時，所要使用的約定金額。如果關鍵字之類的較低層級實體不會覆寫它，則會使用此比對。

引數

名稱	類型	說明
中國共產黨	double	廣告群組的最大一次的檢索。帳戶的貨幣會決定最小值和最大報價值。如需詳細資訊，請參閱 Bid 和 budget 貨幣。

傳回

類型	說明
AdGroupBuilder	套用了一個已套用了一個已套用了之一併套用了許可權的廣告群組產生器。

withCpm (double cpm)

設定廣告群組的 CPM 報價。

指定每 1,000 個檢視曝光數所要使用的約定金額，以及廣告群組的MANUAL_CPM。

引數

名稱	類型	說明
Cpm	double	廣告群組的最大 CPM 報價。帳戶的貨幣會決定最小值和最大報價值。如需詳細資訊，請參閱 Bid 和 budget 貨幣。

傳回

類型	說明
AdGroupBuilder	已套用 CPM 報價的廣告群組產生器。

withCpv (雙 cpv)

設定廣告群組的 CPV 報價。

指定每一檢視或點選視訊廣告時，以及廣告群組的報價策略MANUAL_CPV時所要使用的約定金額。

引數

名稱	類型	說明
Cpv	double	廣告群組的最大 CPV 報價。帳戶的貨幣會決定最小值和最大報價值。如需詳細資訊，請參閱 Bid 和 budget 貨幣。

傳回

類型	說明
AdGroupBuilder	已套用 CPV 申請的廣告群組產生器。

withCustomParameters (Object customParameters)

設定要在最終 URL 或追蹤範本中使用的廣告群組自訂參數。

自訂參數有助於跨多個 URL 共用動態資訊。如需其使用方式的詳細資訊，請參閱自訂參數。

引數

名稱	類型	說明
customParameters	物件	最多可套用至廣告群組的三個自訂參數地圖。例如，其中 `{key1: 'value1', key2: 'value2', key3: 'value3'}` 索引鍵是自訂參數的名稱，而 value 是參數的值。名稱最多可包含 16 個 8 位元組字元，且值最多可包含 200 個 8 位元組字元。

傳回

類型	說明
AdGroupBuilder	已套用自訂參數的廣告群組產生器。

withEndDate (字串 endDate)

設定廣告群組中的廣告停止供應的日期。只有在您想要群組中的廣告在特定日期停止提供廣告時，才呼叫此方法。

引數

名稱	類型	說明
endDate	字串	停止提供廣告的日期。以 YYYYMMDD 格式指定日期。

傳回

類型	說明
AdGroupBuilder	已套用結束日期的廣告群組產生器。

withEndDate (Object endDate)

設定廣告群組中的廣告停止供應的日期。只有在您想要群組中的廣告在特定日期停止提供廣告時，才呼叫此方法。

引數

名稱	類型	說明
endDate	物件	停止提供廣告的日期。使用具有下欄欄位的物件來指定日期：年月一天例如：`var date = {year: 2018, month: 5, day: 13};` 月份是以一為基底，其中 1 是 1 月，12 是 12 月。

傳回

類型	說明
AdGroupBuilder	已套用結束日期的廣告群組產生器。

withLanguage (字串語言)

設定廣告群組中廣告所使用的語言。

根據預設，廣告群組會從其父活動繼承語言。指定廣告群組層級的語言來覆寫在行銷活動層級指定的語言，或者如果行銷活動未指定語言，則 (必須在行銷活動和/或廣告群組層級指定語言) 。

引數

名稱	類型	說明
語言	字串	廣告群組中廣告所使用的語言。例如，英文。字串不區分大小寫。請勿使用兩個字元的語言代碼。如需支援的語言清單，請參閱廣告語言。

傳回

類型	說明
AdGroupBuilder	已套用語言的廣告群組產生器。

withName (字串名稱)

設定廣告群組的名稱。

引數

名稱	類型	描述
Name	字串	廣告群組的名稱。需要名稱。名稱最多可包含 256 個字元，而且在行銷活動的所有作用中廣告群組中必須是唯一的。

傳回

類型	說明
AdGroupBuilder	已套用名稱的廣告群組產生器。

withStartDate (字串 startDate)

設定廣告群組中的廣告開始提供服務的日期。只有在您想要群組中的廣告在特定日期開始提供服務時，才呼叫此方法;否則，廣告會立即開始提供。

引數

名稱	類型	說明
endDate	字串	開始提供廣告的日期。以 YYYYMMDD 格式指定日期。

傳回

類型	說明
AdGroupBuilder	已套用開始日期的廣告群組產生器。

withStartDate (物件 startDate)

設定廣告群組中的廣告開始提供服務的日期。只有在您想要群組中的廣告在特定日期開始提供服務時，才呼叫此方法;否則，廣告會立即開始提供。

引數

名稱	類型	說明
endDate	物件	開始提供廣告的日期。使用具有下欄欄位的物件來指定日期：年月一天例如：`var date = {year: 2018, month: 5, day: 13};` 月份是以一為基底，其中 1 是 1 月，12 是 12 月。

傳回

類型	說明
AdGroupBuilder	已套用開始日期的廣告群組產生器。

withStatus (字串狀態)

設定廣告群組的狀態。

引數

名稱	類型	說明
狀態	字串	廣告群組的狀態。以下是可能區分大小寫的值。啟用暫停刪除預設值為 PAUSED。

傳回

類型	說明
AdGroupBuilder	已套用狀態的廣告群組產生器。

withTrackingTemplate (字串追蹤範本)

設定廣告群組的追蹤範本。

追蹤範本會與關鍵字的 FinalUrl 搭配使用，以建立廣告所使用的目的地 URL。如需詳細資訊，請參閱我可以使用哪些追蹤或 URL 參數？

引數

名稱	類型	說明
trackingTemplate	字串	要與廣告群組搭配使用的追蹤範本。

傳回

類型	說明
AdGroupBuilder	已套用追蹤範本的廣告群組產生器。

另請參閱

Campaign.newAdGroupBuilder ()

共用方式為