廣告活動草稿

廣告活動草稿可讓您預先準備對基礎廣告活動進行的變更。每個廣告活動草稿都與基礎廣告活動和草稿廣告活動相關聯。

  • 基礎廣告活動是帳戶中的一般廣告活動，包含廣告、廣告群組和其他資源。
  • 廣告活動草稿是虛擬層，您執行作業時，系統會匯總變更，但不會影響帳戶中的任何實際廣告活動。確認草稿廣告活動的狀態符合需求後，即可透過幾種不同方式將草稿套用至實際廣告活動。

您可以在程式碼範例目錄中找到完整範例，瞭解如何建立實驗。

建立草稿

如要建立 CampaignDraft，請按照下列步驟操作：

  1. 建立 CampaignDraft 物件，並填入下列欄位：

    • base_campaign：這份草稿所依據的廣告活動資源名稱。
    • name：廣告活動草稿的名稱。

  2. 接著，請建立 CampaignDraftOperation，並將 create 欄位設為您建立的 CampaignDraft 物件。

  3. 最後，使用 CampaignDraftService.MutateCampaignDrafts 方法將這項作業傳送至 Google Ads API。create 要求是同步的，會立即傳回回應。

修改廣告活動草稿

建立廣告活動草稿後，您可以從 MutateCampaignDraftsResponse 的 results 欄位擷取資源名稱。

您必須先擷取相關聯的草稿廣告活動資源名稱，才能進行變更。有了廣告活動草稿資源名稱，您就可以查詢 GoogleAdsService.SearchStream 來找出草稿廣告活動：

SELECT campaign_draft.draft_campaign
FROM campaign_draft
WHERE campaign_draft.resource_name = "CAMPAIGN_DRAFT_RESOURCE_NAME_HERE"

取得草稿廣告活動的資源名稱後，您就可以像修改帳戶中的其他廣告活動一樣，草稿廣告活動無法放送廣告，但可做為變更的暫存區，方便您稍後套用至基礎廣告活動。

升級或移除草稿廣告活動

設定完草稿廣告活動後，您有幾種做法：

  1. 呼叫 CampaignDraftService.PromoteCampaignDraft，將草稿廣告活動升級為基礎廣告活動。系統會將草稿廣告活動中的所有變更套用至基礎廣告活動。這是一項非同步作業。
  2. 使用 CampaignDraftService.MutateCampaignDrafts 的 remove 作業，傳遞廣告活動草稿的資源名稱，移除廣告活動草稿。如果決定不繼續，系統會取消草稿並捨棄所有變更。這項作業會同步執行。