キャンペーンの下書きは、基本のキャンペーンに加える、予定している一連の変更をステージングするための手段です。各キャンペーンの下書きには、基本のキャンペーンと、それに関連付けられた下書き用キャンペーンがあります。
- 基本のキャンペーンとは、広告、広告グループ、その他のリソースを含む、アカウント内の通常のキャンペーンです。
- 下書き用キャンペーンは仮想レイヤで、オペレーションの実行時に変更内容が集約されますが、アカウント内の実際のキャンペーンには影響しません。下書き用キャンペーンの状態に問題がなければ、いくつかの方法で実際のキャンペーンに適用できます。
下書きの作成
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"
下書き用キャンペーンのリソース名を作成したら、アカウント内の実際のキャンペーンと同じようにキャンペーンを変更できます。下書き用キャンペーンは広告を配信できませんが、実際のキャンペーンに適用可能な変更のステージング領域として機能します。
下書き用キャンペーンをプロモーションまたは削除する
下書き用キャンペーンの設定が完了したら、次のオプションを使用できます。
- 下書き用キャンペーンを基本のキャンペーンに昇格させ、下書き用キャンペーンで行った変更をすべて基本のキャンペーンに適用します。これは非同期オペレーションです。これを行うには、
CampaignDraftService.PromoteCampaignDraftを呼び出します。 statusをREMOVEDに設定して、キャンペーンの下書きを削除します。これにより、処理を続行しない場合、変更が破棄されます。これは同期オペレーションであり、他の API 呼び出しと同様に機能します。