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

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

変換の仕組み

SmartCampaignSettingService.GeneratePMaxDraftCampaign を呼び出すと、リクエストで指定されたスマート アシスト キャンペーンの構成に基づいて、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 に更新して、重複配信を防ぎます。
前へ
概要
次へ
候補を取得する