リリースノート

v21（2025 年 8 月 6 日）

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

検索キャンペーン向け AI 最大化設定

  • Campaign の ai_max_setting.enable_ai_max フィールドを使用して、検索キャンペーン向け AI 最大化設定を有効にできるようになりました。検索キャンペーン向け AI 最大化設定は、検索語句マッチングを通じて検索キャンペーンのリーチを拡大し、ターゲティングとクリエイティブの設定が有効になったときに配信するかどうかを制御できます。以前のバージョンのリクエストで設定されたテキスト アセットの自動化とブランドリストのコントロールは、検索キャンペーンの AI 最大化設定が明示的に切り替えられて無効になるまで、引き続き適用されます。 Campaign.ai_max_setting.bundling_required を使用すると、テキスト アセットの自動化とブランドリストのコントロールを適用または変更するために、検索キャンペーンの AI 最大化設定を有効にする必要があるかどうかを判断できます。AdGroup.ai_max_ad_group_setting.disable_search_term_matching を使用すると、親キャンペーンで検索キャンペーン向け AI 最大化設定が有効になっている場合に、検索語句マッチングを無効にできます。ブログ投稿「検索キャンペーン向け AI 最大化設定でパフォーマンスを飛躍的に高める」をご覧ください。

  • キャンペーンで検索キャンペーン向け AI 最大化設定を有効にせずに FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION を有効にした場合に検索キャンペーンでスローされる CampaignError.AI_MAX_MUST_BE_ENABLED を追加しました。

  • 検索キャンペーン向け AI 最大化設定で、広告グループ単位でターゲティング コントロールを適用できるようになりました。広告グループに次の条件を追加できるようになりました。

    • ブランドのリスト
    • ロケーション
    • ウェブページ（URL ルール）

  • 検索語句、見出し、ランディング ページの組み合わせのパフォーマンスをレポートする ai_max_search_term_ad_combination_view を追加しました。このビューには、広告の表示につながった検索語句と、その特定の組み合わせのパフォーマンスが表示されます。今後のリリースでは、パフォーマンス最大化キャンペーンのデータも含む追加のビューが追加される予定です。実装の移行を回避して P-MAX のデータを取得したい場合は、このリリースをお待ちください。

  • search_term_match_type セグメントの新しい値として AI_MAX を追加しました。

アセット

キャンペーン

コンバージョン数

  • conversion_attribution_event_type セグメントの新しい値として ENGAGED_VIEW を追加しました。

  • お客様は ConversionUploadService の debug_enabled モードにアクセスできなくなります。このフィールドが TRUE に設定されている場合、以前はリードの拡張コンバージョンのインポートで CLICK_NOT_FOUND エラーと SUCCESS を区別するために使用されていました。

デマンド ジェネレーション

  • エラーコード CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM を追加しました。今後、デマンド ジェネレーション キャンペーンに非常に低い予算額を設定しようとすると、このエラーが返されるようになります。必要な最小予算の詳細については、新しいエラーの詳細フィールド budgetDailyMinimumErrorDetails をご覧ください。

EU の政治広告に関する変更

EU の政治広告に関するこれらの変更は、v19.2 リリースと v20.1 リリースでも行われています。

  • Campaign.contains_eu_political_advertising を追加しました。このフィールドは、キャンペーンに欧州連合を対象とした政治広告コンテンツが含まれているかどうかを示します。このフィールドが CONTAINS_EU_POLITICAL_ADVERTISING に設定されている場合、キャンペーンは 2025 年 9 月 22 日以降、EU で配信されなくなります。このフィールドが設定されていない場合、新しいキャンペーンを作成する API 呼び出しは FieldError.REQUIRED エラーで失敗します。

    既存のキャンペーンについては、キャンペーン単位または広告グループ単位で近隣地域、地域、地域グループのターゲティングを変更する前に、contains_eu_political_advertising フィールドを設定する必要があります。既存のキャンペーンでこれらのキャンペーン条件または広告グループ条件を作成または更新する API 呼び出しは、キャンペーンで自己申告が完了していない場合、CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION エラーで失敗します。

    バージョン v19.x と 20.x では、このフィールドを設定する要件はまだ適用されていませんが、今後適用される予定です。この変更については事前に告知されます。

  • テスト キャンペーンに欧州連合を対象とする政治広告が含まれているかどうかを自己申告していない場合、トライアルとテストは ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION を返します。

P-MAX

  • 新しい P-MAX キャンペーンの場合、Campaign.brand_guidelines_enabled のデフォルト値が true になりました。

  • campaign_search_term_view レポートを追加しました。このビューには、キャンペーン単位で集計された検索語句の指標が表示されます。このビューでは、P-MAX キャンペーンの検索キーワードのサポートも導入されています。

  • search_term_match_type セグメントの新しい値として PERFORMANCE_MAX を追加しました。

計画

  • 広告主様が ReachPlanService.GenerateReachForecast でサポートされているユーザーの興味 / 関心（アフィニティと購買意向）を検出できる新しいメソッド ReachPlanService.ListPlannableUserInterests を追加しました。このメソッドは、特定のユーザーの興味 / 関心タイプを検索し、名前とパスをクエリすることをサポートします。

  • ReachPlanService.ListPlannableUserLists にオプションの入力フィールドとして AdditionalApplicationInfo を追加しました。

  • リクエストを行う顧客 ID の利用可能なファーストパーティ ユーザーリストを取得する AudienceInsightsService.ListAudienceInsightsAttributes のサポートを追加しました。

  • AudienceInsightsService.GenerateAudienceCompositionInsights にファーストパーティ ユーザーリストのサポートを追加し、ユーザーリストをターゲットとするオーディエンスの分析情報を取得できるようにしました。ユーザーリストを対象とするリクエストは、オーディエンス インデックスのみを返し、次の AudienceInsightsDimension でのみ使用できます。AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST。

  • AudienceInsightsService.GenerateTargetingSuggestionMetrics のオーディエンス入力タイプを InsightsAudience に更新しました。新しいオーディエンス入力では、ユーザーの興味 / 関心の OR の AND の組み合わせが可能になり、よりカスタマイズされたオーディエンス定義のリーチの可能性の指標がサポートされます。

  • TrendInsightMetrics にオーディエンス シェアを追加して、トレンドのオーディエンス シェアを取得します。

  • KnowledgeGraphAttributeMetadata に新しい関連カテゴリを追加しました。これにより、ユーザーはカテゴリ別にナレッジグラフ属性をフィルタできるようになります。

レポート

動画

v20.1（2025-08-06）

EU の政治広告に関するこれらの変更は、v19.2 リリースと v21 リリースにも反映されています。

EU の政治広告に関する変更

  • Campaign.contains_eu_political_advertising を追加しました。このフィールドは、キャンペーンに欧州連合を対象とした政治広告コンテンツが含まれているかどうかを示します。このフィールドが CONTAINS_EU_POLITICAL_ADVERTISING に設定されている場合、キャンペーンは 2025 年 9 月 22 日以降、EU で配信されなくなります。

    既存のキャンペーンについては、キャンペーン単位または広告グループ単位で近隣地域、地域、地域グループのターゲティングを変更する前に、contains_eu_political_advertising フィールドを設定する必要があります。既存のキャンペーンでこれらのキャンペーン条件または広告グループ条件を作成または更新する API 呼び出しは、キャンペーンで自己申告が完了していない場合、CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION エラーで失敗します。

    バージョン v19.x と 20.x では、このフィールドを設定する要件はまだ適用されていませんが、今後適用される予定です。この変更については事前に告知されます。

  • テストのキャンペーンで、欧州連合を対象とする政治広告が含まれているかどうかを自己申告していない場合、トライアルとテストは ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION をスローします。

v20（2025 年 6 月 4 日）

v20 では、以下の新機能とアップデートが追加されました。

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

アセット

asset_group レポートに新しい指標とセグメントの列がいくつか追加されました。

指標の列

セグメント列

キャンペーン

コンバージョン数

  • 既存の顧客の google_ads_conversion_customer フィールドを更新して、クロスアカウント コンバージョン トラッキングを有効にしたり、既存のコンバージョン トラッキングの親を別の MCC アカウントに変更したりできるようになりました。

  • ClickConversion.user_ip_address フィールドを追加しました。Google 広告では、欧州経済領域（EEA）、英国（UK）、スイス（CH）のエンドユーザーの IP アドレス照合はサポートされていません。これらの地域のユーザーからの IP アドレスの共有を条件付きで除外するロジックを追加してください。サイト、アプリ、その他のプロパティで収集するデータに関しては、明確で包括的な情報をユーザーに開示し、法律または該当する Google のポリシーで必要な場合は、データ収集への同意を得なければならないことにご注意ください。詳しくは、オフライン コンバージョンのインポートについてをご覧ください。

デマンド ジェネレーション

推奨事項

  • GenerateRecommendationsRequest を使用している場合、キャンペーンの作成時に ShoppingSetting のサポートを追加しました。
  • GenerateRecommendationsRequest に merchant_center_account_id フィールドを追加しました。これにより、標準の P-MAX キャンペーンではなく、小売向けの最適化案を生成するタイミングを指定できます。

計画

  • AudienceInsightsService と ContentCreatorInsightsService の AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP の代わりとして AudienceInsightsDimension.YOUTUBE_LINEUP を追加しました。この新しいディメンションを使用すると、YouTube Select（YTS）ラインナップの分析情報とメタデータを取得できます。YOUTUBE_DYNAMIC_LINEUP に関連付けられているオブジェクト（DynamicLineupAttributeMetadata や AudienceInsightsDynamicLineup など）を置き換えました。これは、Google 広告全体で動的ラインナップの削除を拡大することに対応するためです。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。
  • AudienceInsightsService、ContentCreatorInsightsService、ReachPlanService に AdditionalApplicationInfo と ApplicationInstance を追加しました。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。
  • AudienceInsightsService と ContentCreatorInsightsService を更新し、より詳細な分析情報を提供できるようにしました。両方のサービスで新しい AudienceInsightsDimension.DEVICE と AudienceInsightsAttribute.device を使用して、コンテンツ クリエイターのデータをデバイス別にセグメント化できるようになりました。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。
  • コンテンツ クリエイターの分析をより包括的に行うため、GenerateCreatorInsightsResponse に動画の集計指標を追加しました（engagement_rate、average_views_per_video、average_likes_per_video、average_shares_per_video、average_comments_per_video、shorts_views_count、shorts_video_count、is_brand_connect_creator）。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。
  • ContentCreatorInsightsService の GenerateCreatorInsightsRequest に sub_country_locations を追加しました。これにより、国以下の地域を指定して、クリエイター分析の検索を絞り込むことができます。sub_country_locations フィールドは、criteria フィールドで search_attributes oneof を使用する場合にのみサポートされます。sub_country_locations が他の条件タイプとともに指定されている場合、リクエストは無効になります。これにより、コンテンツ クリエイターの分析情報について、より詳細な地域ターゲティングと分析が可能になります。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。
  • ReachPlanService.ListPlannableUserLists を追加しました。これは、顧客が所有するファーストパーティ ユーザーリストを返します。また、GenerateReachForecastRequest のオーディエンス ターゲティング オプションに UserListInfo を追加しました。これにより、特定の顧客のプラン可能なユーザーリストを取得し、それらの特定のオーディエンスをターゲットとするキャンペーンのリーチ予測を生成できます。これらの機能強化により、ファーストパーティ オーディエンス データを予測に直接組み込むことで、リーチ プランニングのカスタマイズが向上します。リーチ予測は、許可リストに登録されたアカウントでのみご利用いただけます。

動画

  • テレビ画面の YouTube オーガニック動画に配信される AdFormatType.PAUSE 広告が追加され、レポートに含まれるようになりました。これらの広告は、一時停止画面の静止動画フレームのすぐ横に表示されます。これには、一時停止されたオーガニック動画の下または上に表示されるデマンド ジェネレーション動画広告は含まれません。これらの広告は AdFormatType.INFEED でレポートされます。

v19.2（2025 年 8 月 6 日）

EU の政治広告に関するこれらの変更は、v20.1 と v21 のリリースでも行われています。

EU の政治広告に関する変更

  • Campaign.contains_eu_political_advertising を追加しました。このフィールドは、キャンペーンに欧州連合を対象とした政治広告コンテンツが含まれているかどうかを示します。このフィールドが CONTAINS_EU_POLITICAL_ADVERTISING に設定されている場合、キャンペーンは 2025 年 9 月 22 日以降、EU で配信されなくなります。

    既存のキャンペーンについては、キャンペーン単位または広告グループ単位で近隣地域、地域、地域グループのターゲティングを変更する前に、contains_eu_political_advertising フィールドを設定する必要があります。既存のキャンペーンでこれらのキャンペーン条件または広告グループ条件を作成または更新する API 呼び出しは、キャンペーンで自己申告が完了していない場合、CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION エラーで失敗します。

    バージョン v19.x と 20.x では、このフィールドを設定する要件はまだ適用されていませんが、今後適用される予定です。この変更の発表をお待ちください。

  • テストのキャンペーンで、欧州連合を対象とする政治広告が含まれているかどうかを自己申告していない場合、トライアルとテストは ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION をスローします。

v19.1（2025 年 4 月 16 日）

v19.1 では、次の機能と変更が追加されました。

アセット

キャンペーン

デマンド ジェネレーション

変更履歴

  • ChangeStatusResourceType に 3 つのリソースタイプのサポートを追加しました。
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • これら 3 つのより詳細なタイプは、change_status レポートから取得できます。

コンバージョン数

  • Google Ads API を使用して新しい顧客を作成する際に、google_ads_conversion_customer フィールドを設定できるようになりました。以前は読み取り専用のフィールドでした。

    注: この機能は、非公開の許可リストの背後にあります。使用する際は、アカウント マネージャーにお問い合わせください。

  • オフライン コンバージョンをアップロードする際に、コンバージョンに関連付けられた顧客のタイプを指定できるようになりました。

  • ClickConversion に新しい session_attributes フィールドが導入されました。

ローカル サービス広告

  • LocalServicesLeadService に新しい RPC ProvideLeadFeedback を追加して、LocalServicesLead の品質に関するフィードバックを提供します。
  • 特定のリソースに対してフィードバックが提供されたかどうかを確認する新しいフィールド lead_feedback_submitted を LocalServicesLead リソースに追加しました。

プランニング サービス

  • ReachPlanService.GenerateReachForecast でフリークエンシー目標設定の月次予測のサポートを追加しました。
  • 新しいメソッド ReachPlanService.GenerateConversionRates を追加しました。これにより、広告主様はサポートされているプラン可能な商品の推奨コンバージョン率をリクエストできます。
  • ReachPlanService.GenerateReachForecast でのデマンド ジェネレーションの予測:
    • デベロッパーは、デマンド ジェネレーション キャンペーンのリーチ予測をリクエストできるようになりました。デベロッパーは、新しい DEMAND_GEN_MAX_CONVERSIONS 計画可能な商品コードを使用して、デマンド ジェネレーションのリーチ予測を生成できます。
    • デマンド ジェネレーションのリーチ予測をリクエストするデベロッパーがコンバージョン率を指定できるように、新しい conversion_rate フィールドを追加しました。推奨コンバージョン率は、新しい ReachPlanService.GenerateConversionRates メソッドを使用して取得できます。このフィールドは、デマンド ジェネレーションの予測リクエストに必要です。他のプラン可能な商品ではサポートされていません。
    • 返される予測に新しい conversions フィールドを追加しました。このフィールドには、リーチ曲線上の特定の時点でのコンバージョン数が含まれます。コンバージョンは、DEMAND_GEN_MAX_CONVERSIONS 計画可能な商品でのみサポートされています。

推奨事項

動画

  • オーディオ広告の読み取り専用サポートを追加しました。この機能について詳しくは、Google 広告ヘルプセンターをご覧ください。この変更により、次のものが公開されます。
  • デモ調整を使用してリーチ指標をクエリする際に、新しい指標とセグメントを追加しました。これらの変更の一環として、
    • coviewed_impressions と primary_impressions という名前の 2 つの新しい指標列が導入されました。
    • adjusted_age_range と adjusted_gender という 2 つの新しいセグメントが導入されました。
    • リーチ指標フィールド（coviewed_impressions、primary_impressions、unique_users、average_impression_frequency_per_user）とともに 2 つの新しいセグメントのいずれかを選択した場合は、これらの列の有効な統計情報を取得するために、もう一方のセグメントも選択する必要があります。
    • この機能は現在、許可リストに登録されたお客様のみにご利用いただけます。

v19（2025 年 2 月 26 日）

バージョン 19 では、次の機能と変更が追加されました。

ガイダンスについては、最新バージョンにアップグレードするをご覧ください。

アカウント管理

  • 今後の変更に対応するため、CustomerError に次の値を追加しました。
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

広告

アセット

コンバージョン数

フィード

  • Feed、FeedMapping、FeedService、AdGroupFeed、feed_placeholder_view などのフィード関連のエンティティをすべて削除しました。ユーザーは、同じ目的を達成するために assets を使用する必要があります。

ホテル、旅行

  • ValueRuleItineraryAdvanceBookingWindow の min_days と max_days を optional フィールドにして、値を 0 に指定できるようにしました。これにより、今日行われる旅行検索のターゲティングがサポートされます。

P-MAX

  • （許可リストに登録されたアカウントのみ）ブランド ガイドライン
    • P-MAX キャンペーンの作成時にのみ変更可能になるように Campaign.brand_guidelines_enabled を変更しました。
    • これは、旅行関連の目標達成のための P-MAX とは互換性がありません。
    • 既存の P-MAX キャンペーンでブランド ガイドラインを有効にするには、新しく追加された CampaignService.EnablePMaxBrandGuidelines を使用します。ブランド ガイドラインを無効にすることはできません。
    • ブランドの色とフォント ファミリーを設定できるように、Campaign.brand_guidelines と BrandGuidelines を追加しました。
    • 新しいエラー値:
    • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
  • P-MAX キャンペーンで拡張動画アセットを自動生成するための AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS を追加しました。

計画

動画

リリースノートのアーカイブ

アーカイブされたリリースノートについては、サポート終了バージョンをご覧ください。