キャンペーンの下書きは、ベース キャンペーンに対して行う予定の一連の変更をステージングする方法です。各キャンペーンの下書きには、基本のキャンペーンと下書き用キャンペーンが関連付けられています。
- 基本のキャンペーンは、広告、広告グループ、その他のリソースを含む、アカウント内の通常のキャンペーンです。
- 下書きキャンペーンは仮想レイヤで、オペレーションを実行すると変更が集約されますが、アカウント内の実際のキャンペーンには影響しません。 下書きキャンペーンの状態に満足したら、いくつかの方法で実際のキャンペーンに適用できます。
実験の作成の実証済みの例は、 コードサンプル カタログで確認できます。
下書きの作成
CampaignDraft を作成するには:
次のフィールドを使用して
CampaignDraftオブジェクトを作成します。base_campaign: この下書きのベースとなるキャンペーンのリソース名。name: キャンペーンの下書きの名前。
次に、作成した
CampaignDraftオブジェクトにcreateフィールドを設定して、CampaignDraftOperationを作成します。最後に、
CampaignDraftService.MutateCampaignDraftsメソッドを使用して、このオペレーションを Google Ads API に送信します。createリクエストは 同期型で、すぐにレスポンスを返します。
下書きキャンペーンを変更する
キャンペーンの下書きを作成したら、
results フィールドからリソース名を取得できます。
MutateCampaignDraftsResponse
下書きキャンペーンに変更を加えるには、関連付けられている下書きキャンペーンのリソース名を取得する必要があります。キャンペーンの下書きのリソース名を使用して、
GoogleAdsService.SearchStream
をクエリして下書きキャンペーンを見つけることができます。
SELECT campaign_draft.draft_campaign
FROM campaign_draft
WHERE campaign_draft.resource_name = "CAMPAIGN_DRAFT_RESOURCE_NAME_HERE"
下書きキャンペーンのリソース名を取得したら、アカウント内の他のキャンペーンと同様に変更できます。下書きキャンペーンでは広告を配信できませんが、後で基本のキャンペーンに適用できる変更のステージング エリアとして機能します。
下書きキャンペーンを昇格または削除する
下書きキャンペーンの設定が完了したら、次のいずれかを選択できます。
- 下書きキャンペーンをベース キャンペーンに
CampaignDraftService.PromoteCampaignDraftを呼び出して**昇格** させます。これにより、下書きキャンペーンで行ったすべての変更が基本のキャンペーンに適用されます。これは 非同期オペレーションです。 - キャンペーンの下書きのリソース
名を渡して、
removeのCampaignDraftService.MutateCampaignDraftsオペレーションを使用して、キャンペーンの下書きを削除 します。これにより、下書きがキャンセルされ、続行しない場合は変更が破棄されます。これは同期オペレーションです。