スマート キャンペーンを P-MAX キャンペーンに変換する

v25（v25.2 以降）では、SmartCampaignSettingService.GeneratePMaxDraftCampaign メソッドを使用して、スマート アシスト キャンペーンを P-MAX キャンペーンに変換できます。このメソッドは v24 以前では利用できません。

変換の仕組み

SmartCampaignSettingService.GeneratePMaxDraftCampaign を呼び出すと、API はスマート アシスト キャンペーンの構成に基づいて P-MAX キャンペーンの下書きを生成します。

生成された P-MAX 下書き用キャンペーンは、status が PAUSED に設定されて初期化されます（primary_status には配信資格が反映されます）。スマート アシスト キャンペーンのすべての機能コンバータで検証が失敗した場合、リクエストは SmartCampaignError.GENERATE_PMAX_CONVERTERS_FAIL エラーで失敗します。

これにより、キャンペーンを有効にして広告を配信する前に、生成された P-MAX キャンペーン、予算、アセット グループ、アセットを検査、変更、強化できます。P-MAX キャンペーンのドラフトを生成しても、元のスマート アシスト キャンペーンは変更または一時停止されません。元のスマート アシスト キャンペーンは、手動で一時停止するまで有効なままです。

リクエスト パラメータ

GeneratePMaxDraftCampaignRequest メッセージは、次のフィールドを受け入れます。

  • resource_name（必須）: 変換するスマート アシスト キャンペーンで再生成する SmartCampaignSetting のリソース名。次の形式で指定します。

    customers/customer_id/smartCampaignSettings/campaign_id

  • validate_only（省略可）: true の場合、リクエストは検証されますが、実行されません。検証エラー、警告、または変換の問題の可能性のみが、下書きエンティティを作成せずにレスポンスの validated_info フィールドで返されます。

  • gbp_enabled（対象外）: 省略可。P-MAX キャンペーンにリンクされている Google ビジネス プロフィール（GBP）のビジネス情報を変換するかどうか。このフィールドは未設定のままにするか、false に設定します。true に設定することは v25 では実装されておらず、SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED エラーが返されます。

  • image_enabled（対象外）: 省略可。必要な P-MAX キャンペーンの画像（横長、正方形、ロゴの画像タイプなど）を生成するかどうか。このフィールドは未設定のままにするか、false に設定します。true に設定することは v25 では実装されておらず、SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED エラーが返されます。

回答の詳細

GeneratePMaxDraftCampaignResponse メッセージは、生成された P-MAX 下書き用キャンペーンと関連エンティティのリソース名を返します。

  • pmax_campaign: 生成された下書きの P-MAX キャンペーンの Campaign リソース名。
  • campaign_budget: 生成された P-MAX キャンペーンにリンクされている CampaignBudget リソース名。
  • asset_group: 生成された P-MAX キャンペーンにリンクされている AssetGroup リソース名。
  • assets: 生成された P-MAX キャンペーンにリンクされている Asset リソース名のリスト。
  • validated_info: コンバージョン チェックによって返される検証情報またはコンバージョンの可能性のある問題（validate_only が true に設定されている場合と、validate_only が false の場合に生成されたエンティティ リソース名とともに設定されます）。

スマート アシスト キャンペーンを変換するには、次のワークフローを使用します。

  1. 下書き用キャンペーンを生成する: 必須の resource_name のみを設定して SmartCampaignSettingService.GeneratePMaxDraftCampaign を呼び出します（gbp_enabled と image_enabled は設定しないか、false に設定します）。返された pmax_campaign、campaign_budget、asset_group、assets のリソース名を保存します。
  2. キャンペーンを確認してカスタマイズする: 下書きの P-MAX キャンペーンは status = PAUSED で作成されるため、予算、アセット グループ、アセットを確認して設定します。
  3. キャンペーンを有効にして元のキャンペーンを一時停止する: 広告を配信する準備ができたら、P-MAX キャンペーンの status を ENABLED に更新し、元のスマート キャンペーンの status を PAUSED に更新して、重複した配信を防ぎます。
前へ
概要
次へ
候補を取得する