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

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

コンバージョンの仕組み

SmartCampaignSettingService.GeneratePMaxDraftCampaign を呼び出すと、API は、リクエストで指定されたスマート アシスト キャンペーンの構成に基づいて、P-MAX キャンペーン、予算、アセット グループ、アセットの下書きを生成します。生成された新しいリソースは、キャンペーンで広告を配信する前に、確認、変更、拡張する必要があります。

生成された P-MAX 下書きキャンペーンは、次のステータス値で初期化されます。

  • status が PAUSED に設定されている。
  • 配信の適格性は primary_status に反映されます。
  • contains_eu_political_advertising は、デフォルトで DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING に設定されます（スマート アシスト キャンペーンでまだ指定されていない場合）。キャンペーンに EU の政治広告が含まれている場合は、この項目を確認して更新してください。

これにより、キャンペーンを有効にして広告を配信する前に、生成された P-MAX キャンペーン、予算、アセット グループ、アセットを検査、変更、拡張できます。

下書きのアセット

新しいキャンペーンには、新しいキャンペーンを有効にする前に置き換える必要があるプレースホルダ画像のグループが付属しています。image_enabled フィールドがサポートされ、リクエストで true に設定されている場合、API はプレースホルダ画像を使用する代わりに、画像を自動的に生成します。レスポンスの assets フィールドで新しいアセットを検査し、次の手順で置き換えることができます。

  1. アセット要件ガイドを確認します。
  2. 画像アセットのアップロードの例に沿って、新しい画像をアップロードします。
  3. 新しいアセットをドラフト キャンペーンのアセット グループにリンクし、プレースホルダ画像の AssetGroupAsset リンクを削除します（同じアトミック変更リクエスト内、または新しいアセットをリンクした後で、最小アセット要件が満たされるようにします）。詳しくは、アセット グループをアセットにリンクするガイドをご覧ください。

リクエスト パラメータ

GeneratePMaxDraftCampaignRequest メッセージでは、次のフィールドを指定できます。

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

    customers/customer_id/smartCampaignSettings/campaign_id

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

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

  • image_enabled（サポート対象外）: 省略可。必要な P-MAX キャンペーン画像（横向き、正方形、ロゴ画像タイプなど）を生成するかどうか。このフィールドは未設定のままにするか、false に設定します。true に設定することはサポートされておらず、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 と creation_status = INCOMPLETE を使用して作成されるため、予算、アセット グループ、アセットを検査して構成します。
  3. キャンペーンを有効にして、元のキャンペーンを一時停止する: 広告を配信する準備ができたら、P-MAX キャンペーンの status を ENABLED に更新し、元のスマート アシスト キャンペーンの status を PAUSED に更新して、重複配信を防ぎます。
前へ
概要
次へ
候補を取得する