キャンペーンの下書きは、ベース キャンペーンに対する一連の変更をステージングする方法です。各キャンペーンの下書きには、関連付けられた基本のキャンペーンと下書き用キャンペーンがあります。
- ベース キャンペーンは、アカウント内の通常のキャンペーンで、広告、広告グループ、その他のリソースが含まれています。
- 下書きキャンペーンは、オペレーションの実行時に変更が集約される仮想レイヤですが、アカウント内の実際のキャンペーンには影響しません。下書きキャンペーンの状態に問題がなければ、いくつかの方法で実際のキャンペーンに適用できます。
下書きを作成する
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 呼び出しと同様に動作します。