キャンペーンの下書き

キャンペーンの下書きは、ベースとなるキャンペーンに意図した変更をいくつか設定する方法です。各キャンペーンの下書きには、基本のキャンペーンと下書きのキャンペーンが関連付けられています。

  • ベース キャンペーンは、アカウント内の通常のキャンペーンで、広告、広告グループなどのリソースが含まれています。
  • 下書きキャンペーンは仮想レイヤであり、操作を行うと変更が集約されますが、アカウント内の実際のキャンペーンには影響しません。下書きキャンペーンの状態に問題がなければ、いくつかの方法で実際のキャンペーンに適用できます。

下書きを作成する

CampaignDraft の作成は、Google Ads API の他のエンティティの作成と同じくらい簡単です。CampaignDraft を作成し、その base_campaign と name を指定して、CampaignDraftService.MutateCampaignDrafts を呼び出し、新しく作成した CampaignDraft を create オペレーションとして渡します。

create リクエストは、レスポンスがすぐに返されるという点で、通常の API 呼び出しと同様に動作します。

下書き用キャンペーンを変更する

キャンペーンの下書きを作成したら、変更を開始できるように、関連付けられている下書きキャンペーンのリソース名を検索する必要があります。これを行うには、GoogleAdsService.SearchStream で次のクエリを使用します。

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

下書きキャンペーンのリソース名を取得したら、アカウント内の実際のキャンペーンと同じ方法でそのキャンペーンを変更できます。下書きキャンペーンでは広告を配信できませんが、後で実際のキャンペーンに適用できる変更のステージング エリアとして使用できます。

下書き用キャンペーンを公開または削除する

下書きのキャンペーンの設定が完了したら、次のオプションを選択できます。

  1. 下書きのキャンペーンを基本のキャンペーンに昇格し、下書きのキャンペーンで行ったすべての変更を基本のキャンペーンに適用します。これは非同期オペレーションです。これを行うには、CampaignDraftService.PromoteCampaignDraft を呼び出します。
  2. status を REMOVED に設定して、キャンペーンの下書きを削除します。続行しない場合は、変更内容が破棄されます。これは同期オペレーションであり、他の API 呼び出しと同様に機能します。