v25_2 リリース以降、Google Ads API に SmartCampaignSettingService.GeneratePMaxDraftCampaign メソッドが導入され、スマート アシスト キャンペーンを P-MAX キャンペーンに変換できるようになります。
コンバージョンの仕組み
SmartCampaignSettingService.GeneratePMaxDraftCampaign を呼び出すと、API は既存のスマート アシスト キャンペーンの構成に基づいて、P-MAX キャンペーンの下書きを生成します。
生成された P-MAX 下書き用キャンペーンは、次のステータス値で初期化されます。
statusはPAUSEDに設定されています。creation_statusはINCOMPLETEに設定されています。
これにより、キャンペーンを有効にして広告を配信する前に、生成された P-MAX キャンペーン、予算、アセット グループ、アセットを検査、変更、強化できます。
リクエスト パラメータ
GeneratePMaxDraftCampaignRequest メッセージでは、次のフィールドを指定できます。
resource_name(必須): 変換する既存のスマート アシスト キャンペーンに関連付けられているSmartCampaignSettingのリソース名。次の形式で指定します。customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(省略可):trueの場合、リクエストは検証されますが、実行されません。レスポンスのvalidated_infoフィールドには、検証エラー、警告、または変換に関する問題の可能性のみが返されます。gbp_enabled(現在サポートされていません): スマート キャンペーンに関連付けられている Google ビジネス プロフィール(GBP)の住所を、生成された P-MAX キャンペーンに変換してリンクするかどうか。このフィールドをtrueに設定することは現在実装されておらず、GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTEDエラーが返されます。image_enabled(現在サポートされていません): P-MAX キャンペーンに必要な画像(横長、正方形、ロゴの画像アセットなど)を自動的に生成するかどうか。このフィールドをtrueに設定することは現在実装されておらず、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に設定されている場合に返される追加の検証情報または変換に関する問題。
おすすめのワークフロー
スマート アシスト キャンペーンを変換するには、次のワークフローを使用します。
- 下書き用キャンペーンを生成する: 必要な
resource_nameのみを設定してSmartCampaignSettingService.GeneratePMaxDraftCampaignを呼び出します(gbp_enabledとimage_enabledは設定しないか、falseに設定します)。返されたpmax_campaign、campaign_budget、asset_group、assetsのリソース名を保存します。 - キャンペーンを確認してカスタマイズする: 下書きの P-MAX キャンペーンは
status = PAUSEDとcreation_status = INCOMPLETEで作成されるため、予算、アセット グループ、アセットを確認して設定します。 - キャンペーンを有効にする: 広告を配信する準備ができたら、キャンペーンの
statusをENABLEDに、creation_statusをCOMPLETEに更新します。