v23(2026 年 1 月 28 日)
v23 では、次の新機能とアップデートが追加されました。
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
広告
AdGroupAdErrorEnumにAD_SHARING_NOT_ALLOWEDを追加しました。このエラーは、複数の広告グループ間で広告を共有しようとした場合に返されます。これは現在許可されていません。AdFormatTypeに新しい形式タイプ(TEXT、VERTICAL_ADS_BOOKING_LINK、VERTICAL_ADS_PROMOTION)を追加しました。- v23 で
CallAdとCallAdInfoのサポートを削除しました。詳しくは、https://support.google.com/google-ads/answer/6341403 をご覧ください。
アセット
asset_group レポートに次の指標が追加されました。
asset_group_asset レポートに次の指標を追加しました。
Assetの画像アセットと動画アセットに読み取り専用フィールドorientationを追加しました。field_typeHEADLINEとDESCRIPTIONを使用してCampaignAssetを取得するサポートを追加しました。サイトリンクとして配信されるアセットの
ServedAssetFieldTypeにHEADLINE_AS_SITELINK_POSITION_ONE、HEADLINE_AS_SITELINK_POSITION_TWO、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE、DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWOを追加しました。ビジネス メッセージ アセットの更新:
BusinessMessageAssetのプロバイダとして Facebook Messenger と Zalo のサポートを追加し、BusinessMessageProviderEnum.BusinessMessageProviderにFACEBOOK_MESSENGERとZALOを追加し、BusinessMessageAssetに新しいフィールドfacebook_messenger_infoとzalo_infoを追加しました。AssetErrorEnumにCUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETSを追加しました。
課金
ListInvoicesRequestでinclude_granular_level_invoice_detailsを設定すると、Invoiceでより詳細な情報を取得できるようになりました。たとえば、キャンペーン単位の費用の内訳、規制費用の項目別情報、調整情報などです。InvoiceService.ListInvoicesRegulatoryFeeTypeEnumとUnitOfMeasureEnumを追加しました。
キャンペーン
CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGETとCampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGETのエラーコードを追加しました。Campaign.start_dateとCampaign.end_dateを置き換えるCampaign.start_date_timeとCampaign.end_date_timeを追加し、特定のキャンペーン タイプで時間コンポーネントを指定できるようにしました。
コンバージョン数
ConversionActionCategoryにYOUTUBE_FOLLOW_ON_VIEWSを追加して、広告を視聴した後に同じチャンネルの動画を視聴したユーザーのトラッキングをサポートしました。
デマンド ジェネレーション
DemandGenVideoResponsiveAdInfo.companion_bannerフィールドを追加しました。DemandGenMultiAssetAdInfoからlead_form_onlyフィールドを削除しました。
インセンティブ
Choose Your Own(CYO)インセンティブのサポートを追加しました。これにより、パートナーは顧客の Google 広告インセンティブをプログラムで取得して適用できるようになりました。
IncentiveServiceを追加:FetchIncentiveメソッドを使用すると、国、言語、必要に応じてユーザーのメールアドレスに基づいて、ユーザーが利用できるインセンティブを取得できます。これにより、パーソナライズされた「Choose Your Own」(CYO)インセンティブ オプションが返されます。ApplyIncentiveメソッドを使用すると、ユーザーが選択したインセンティブを特定の Google 広告クライアント アカウントに適用できます。
- 読み取り専用リソース
AppliedIncentiveを追加しました。これはGoogleAdsService.SearchとGoogleAdsService.SearchStreamを介してクエリできます。特典のステータス、達成状況、特典額、関連する日付など、利用済みの特典の詳細が表示されます。 - インセンティブの取得や適用に関する問題を処理するため、
IncentiveErrorEnumに新しいエラーコードを追加しました。 AuthenticationErrorEnumにINVALID_EMAIL_ADDRESSを追加しました。
障害のより詳細なプログラム処理を容易にするため、今後のリリースで
IncentivesServiceにエラーコードを追加します。アプリケーションでこれらの新しい障害モードを管理できるように、今後の発表とリリースノートでこれらの新しいエラーコードをモニタリングすることをおすすめします。
計画
AudienceInsightsDimensionEnumにLIFE_EVENT_USER_INTERESTを追加しました。この新しいディメンションを使用すると、次の方法でライフイベントを使用してオーディエンスを作成できます。AudienceInsightsService.GenerateAudienceCompositionInsightsAudienceInsightsService.GenerateSuggestedTargetingInsightsAudienceInsightsService.GenerateInsightsFinderReportContentCreatorInsightsService.GenerateCreatorInsights
ライフイベントは、
AudienceInsightsService.GenerateAudienceOverlapやAudienceInsightsService.GenerateTargetingSuggestionMetricsなどの他のAudienceInsightsServiceメソッドではサポートされていません。ReachPlanService.GenerateConversionRatesレスポンスにサーフェスが含まれるようになり、サーフェス コントロール(Gmail、ショート動画など)に基づいて異なるコンバージョン率の候補を表示できるようになりました。これは、デマンド ジェネレーション キャンペーンでのみサポートされています。YouTubeChannelInsightsにLanguageDistributionを追加しました。YouTube チャンネルのコンテンツの言語分布を提供します。YouTube 広告のデータを業界ベンチマークと比較するための
BenchmarksServiceを追加しました。AudienceInsightsService.GenerateAudienceDefinitionを追加しました。これにより、生成 AI を使用して、ターゲット ユーザーの自由形式の説明を一致するユーザー属性に変換できます。YouTubeChannelInsights.relevance_scoreを追加しました。これは、クリエイターがトピックにどれほど関連しているかを視聴回数で重み付けして評価します。TrendInsightMetrics.trend_change_percentを追加しました。これは、比較期間におけるトレンドの値の変化率を表します。
推奨事項
GenerateRecommendationsRequestにis_new_customerフィールドを追加しました。タイプCAMPAIGN_BUDGETの推奨事項に対してtrueに設定すると、新規顧客向けのモデルを使用して推奨事項が生成されます。この方法は、キャンペーンがないお客様にのみおすすめします。
レポート
指標とセグメンテーション
AdGroupAdAssetViewとAdGroupAdAssetCombinationViewで、RESPONSIVE_DISPLAY_ADのインプレッション、パフォーマンス、コンバージョンの指標がサポートされるようになりました。- 広告ネットワーク内のパフォーマンスをより詳細に分類するための
ad_sub_network_typeセグメントを追加しました。この機能は、最初は YouTube のデマンド ジェネレーション キャンペーン(インストリーム、インフィード、ショート)でご利用いただけます。このセグメントは、ad_network_typeとともに選択する必要があります。 - P-MAX キャンペーンで有効になっている広告ネットワークのタイプの内訳。
- UserLocationView と GeographicView で、コンバージョン日別にセグメント化された指標がサポートされるようになりました。
conversions_by_conversion_dateall_conversions_by_conversion_dateconversions_value_by_conversion_dateall_conversions_value_by_conversion_datevalue_per_conversions_by_conversion_datevalue_per_all_conversions_by_conversion_datecross_device_conversions_by_conversion_datecross_device_conversions_value_by_conversion_date。
業種別広告の新しいセグメント
新規閲覧回数:
- 店舗の所在地に関する詳細情報をクエリする
PerStoreViewを追加しました。 - AI 最大化キャンペーンの
MatchedLocationInterestViewを追加しました。ユーザーが関心を示した地域別のパフォーマンス指標が表示されます。
- 店舗の所在地に関する詳細情報をクエリする
P-MAX:
- P-MAX キャンペーンで有効になっている広告ネットワークのタイプの内訳。
削除:
- アセットのパフォーマンスの集計ラベル指標を削除しました。検索とディスプレイでパフォーマンス ラベル列挙型が返されなくなりました。
ショッピング
ShoppingPerformanceViewで、コンバージョン日別に分類された次の指標がサポートされるようになりました。conversions_by_conversion_date、all_conversions_by_conversion_date、conversions_value_by_conversion_date、all_conversions_value_by_conversion_date、value_per_conversions_by_conversion_date、value_per_all_conversions_by_conversion_date。ShoppingPerformanceViewで、競合他社の指標(search_budget_lost_impression_share、search_rank_lost_impression_share、search_budget_lost_absolute_top_impression_share、search_rank_lost_absolute_top_impression_share)がサポートされるようになりました。ShoppingProductにproduct_image_uriを追加しました。
縦型広告
- 旅行フィードを使用する検索キャンペーンの
AdGroupにvertical_ads_format_settingを追加しました。これにより、配信可能な広告フォーマットを制御できるようになります。 AdGroupCriterionにvertical_ads_item_group_rule_list条件タイプを追加しました。vertical_ads_item_group_ruleをSharedCriterionに追加しました。これらの条件により、旅行フィードを使用する検索キャンペーンでアイテム グループをターゲットに設定できます。- 業種別広告のデータフィードを AI 最大化設定で実行中の検索キャンペーンに接続して、テキスト広告とともに物件プロモーション広告と予約リンクの旅行広告を表示できるようになりました。広告グループ単位では、vertical_ads_format_setting で表示するフォーマットを制御し、アイテム グループ ルールのセットを定義して、業種別広告データフィードのエンティティのサブセットをターゲットに設定できます。また、レポートを AdFormatType と業種別広告データフィードのディメンションの両方で分割できるようになりました。
動画
AdVideoAssetInfo.ad_video_asset_feature_controlフィールドを追加しました。- エラーコード
CampaignCriterionError.INVALID_VIDEO_LINEUP_IDを追加しました。 - YouTube のオーディオ広告の聴取可能性指標を追加しました。広告が聴取可能だったかどうかと、聴取可能性を測定できたインプレッションの数をレポートします。
v22(2025-10-15)
v22 では、次の新機能とアップデートが追加されました。
アセット
- 新しい画像アセット フィールド タイプとして
LANDING_PAGE_PREVIEWを追加しました。 AssetGenerationService(ベータ版)を導入しました。- このサービスでは、生成 AI を使用してテキスト アセットと画像アセットを生成できます。このサービスは、最初は一部のクローズド ベータ版参加者のみが利用できます。
GenerateText: 最終ページ URL、自由形式のプロンプト、キーワード、既存のキャンペーンのコンテキストなどの入力に基づいてテキストを生成します。GenerateImages: 最終ページ URL、フリーフォーム プロンプト、既存のキャンペーン コンテキストなどの入力に基づいて画像を生成します。また、既存の商品画像を再コンテキスト化して画像を生成することもできます。- アセット生成中のエラーは、
AssetGenerationErrorEnumのコードとともに返されます。
キャンペーン
- アプリ インストール キャンペーン(ACi)向けの新しい入札目標を追加しました。目標を指定せずに最適化できるため、迅速な拡大や、適切な目標を特定するのが難しい場合に便利です。
AppCampaignBiddingStrategyGoalTypeの場合: *OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: 標準のコンバージョン数の最大化で使用します。 - 固定インプレッション シェアの入札戦略タイプのサポートを追加しました。
Campaign.feed_typesを追加しました。キャンペーンに添付されているフィードのタイプが表示されます。P-MAX キャンペーンの場合、これはビジネス業種(小売業の場合はMERCHANT_CENTER_FEEDなど)を示すことができます。NEGATIVE_KEYWORDS共有セットをMULTI_CHANNEL(アプリ キャンペーンの場合)とLOCALキャンペーンに適用できるようになりました。
デマンド ジェネレーション
- デマンド ジェネレーション キャンペーンの目標クリック単価入札戦略を追加しました。この戦略では、設定した目標クリック単価(CPC)でクリック数を最大化するように入札単価が設定されます。
Campaign.target_cpcを使用して、キャンペーン単位の目標クリック単価を設定します。AdGroup.target_cpc_microsを使用して広告グループレベルでオーバーライドします。
- 新しい
AssetAutomationTypeを追加しました。 *GENERATE_DESIGN_VERSIONS_FOR_IMAGES:DemandGenMultiAssetAdsで使用できます。有効にすると、デザイン要素が追加され、テキスト アセットが画像アセットに埋め込まれて、アスペクト比が異なる新しい画像アセットが作成されます。新しいDemandGenMultiAssetAdsはデフォルトで有効になっています。 - 新しい
AssetAutomationTypeを追加しました。 *GENERATE_VIDEOS_FROM_OTHER_ASSETS:DemandGenMultiAssetAdsで使用できます。有効にすると、画像やテキストなどの他のアセットを使用して動画が生成されます。これらの動画は、新しいDemandGenVideoResponsiveAdsの作成に使用できます。新しいDemandGenMultiAssetAdsはデフォルトで有効になっています。 - フィールド
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_microsの名前をminimum_budget_amount_microsに変更しました。
全般
AddBatchJobOperationsリクエストあたりのオペレーション数の上限を 10,000 に設定しました。ListBatchJobResultsRequestのpage_sizeフィールドの処理を更新しました。page_sizeが設定されていないか 0 の場合、デフォルトで最大 1,000 になります(以前はINVALID_PAGE_SIZEを返していました)。page_sizeが 1,000 を超えると、API はINVALID_PAGE_SIZEエラーを返すようになりました(以前は 1,000 で上限が設定されていました)。
- 新しいエラーコード
QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDEDを追加しました。これは、お支払いプロファイルの有効化率の上限を超えたことを示します。
P-MAX
- P-MAX キャンペーンに新しい
AssetAutomationType値を追加しました。GENERATE_IMAGE_ENHANCEMENT: 自動トリミングなどの拡張画像の自動作成を有効にします。デフォルトで有効。GENERATE_IMAGE_EXTRACTION: 最終ページ URL から画像を自動的に取得できるようにします。デフォルトでは、アカウント単位の動的画像拡張機能の設定が使用されます。
- P-MAX キャンペーンの
AssetPerformanceLabelを削除しました。 - 削除された
Campaign.url_expansion_opt_outの機能は、AssetAutomationSettingでAssetAutomationTypeFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONを設定することで管理されるようになりました。 - P-MAX キャンペーンに新しいセグメントを追加しました。これらのセグメントは P-MAX キャンペーンでのみ使用でき、他のキャンペーン タイプを選択した場合はデータが返されません。
ad_using_product_data: 広告で Google Merchant Center フィードの商品データが使用されているかどうかを示します。ad_using_video: 広告で動画アセットが使用されているかどうかを示します。
計画
UserListCrmDataSourceTypeで、値THIRD_PARTY_PARTNER_DATAを追加しました。- パートナー オーディエンスに関連する新しいエラーコードを追加しました。
PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPEPARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPECOMMERCE_PARTNER_NOT_ALLOWEDPARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPEPARTNER_MANAGER_ACCOUNT_DISALLOWEDPARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATAADVERTISER_TOS_NOT_ACCEPTEDADVERTISER_PARTNER_LINK_MISSINGADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATAACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPEINVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
YouTubeMetricsにis_active_live_stream_creatorを追加しました。これはContentCreatorInsightsService.GenerateCreatorInsightsによって返され、クリエイターが過去 90 日間にライブ配信を公開したかどうかを示します。PlannableUserListにUserListCrmDataSourceTypeを含む新しいPlannableUserListMetadataメッセージを追加しました。このメッセージは、CRM ユーザーリストのデータソースがFIRST_PARTYかTHIRD_PARTY_PARTNER_DATAかを示すために 'ReachPlanService.ListPlannableUserLists' によって返されます。ReachPlanServiceで、viewsフィールドを置き換えるtrueview_viewsフィールドを追加しました。TrendInsightで、related_videosとrelated_creatorsのサポートを追加しました。また、YouTubeVideoAttributeMetadata.video_propertiesとYouTubeVideoAttributeMetadata.publish_dateに動画のプロパティのメタデータと公開日を追加しました。AudienceInsightsService.GenerateInsightsFinderReportでparental_statusとincome_rangesがサポートされるようになり、トピックとオーディエンスのより複雑な AND/OR の組み合わせもサポートされるようになりました。
レポート
CLICK_TO_MESSAGE_THIRD_PARTY_CLICKとCLICK_TO_MESSAGE_LANDING_PAGE_CLICKの 2 つの新しいクリックタイプを追加しました。AssetGroupAssetは、device、conversion_action、conversion_action_name、conversion_action_categoryで分割できるようになりました。AdGroupAdAssetViewとAdGroupAdAssetCombinationViewで、RESPONSIVE_SEARCH_ADのパフォーマンスとコンバージョンの指標が完全にサポートされるようになりました。以前は、これらのビューでこの広告タイプに対してインプレッションのみが返されていました。
- スマート自動入札の入札範囲拡大機能を使いやすくするため、次の指標が日付フィールド(
date、month、quarter、week、year)でセグメント化できるようになりました。 - 新しいリソース
TargetingExpansionViewを追加しました。このリソースは、検索キャンペーン向け AI 最大化設定のキーワードレス拡大など、手動ターゲティングの拡大に関する指標をレポートします。 P-MAX キャンペーンの新しいセグメントを追加しました。P-MAX の最新情報をご覧ください。
### ショッピング
ShoppingProductリソースの指標のキャンペーンと広告グループのスコープ設定を修正しました。
統合された目標
- 既存顧客の再エンゲージメントを重視した最適化を行うための、顧客維持目標のサポートを追加しました。
CampaignRetentionGoalSettings.target_optionを使用してターゲティングを設定します。 *TARGET_SPECIFIC: キャンペーンに関連付けられたユーザーリストのユーザーのみを使用します。(現時点では許可リストに登録されている場合のみ)。TARGET_ALL(デフォルト): すべてのユーザーを再エンゲージメントの対象とします。
動画
- 動画の視聴回数に関連する複数の指標の名前を変更しました。
average_cpvはtrueview_average_cpvになりましたvideo_view_rateはvideo_trueview_view_rateになりましたvideo_viewsはvideo_trueview_viewsになりましたvideo_view_rate_in_feedはvideo_trueview_view_rate_in_feedになりましたvideo_view_rate_in_streamはvideo_trueview_view_rate_in_streamになりましたvideo_view_rate_shortsはvideo_trueview_view_rate_shortsになりました
- 動画広告の視聴時間に関する指標を追加しました。
video_watch_time_duration_millis: 総視聴時間。average_video_watch_time_duration_millis: インプレッションあたりの平均総再生時間。
v21(2025-08-06)
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
検索キャンペーン向け 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 最大化設定でパフォーマンスを飛躍的に高めるをご覧ください。CampaignError.AI_MAX_MUST_BE_ENABLEDを追加しました。これは、キャンペーンで検索キャンペーン向け AI 最大化設定を有効にせずにFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONを有効にした場合に、検索キャンペーンでスローされます。検索キャンペーン向け AI 最大化設定で、広告グループ単位でターゲティング コントロールを適用できるようになりました。広告グループに次の条件を追加できるようになりました。
- ブランドのリスト
- ロケーション
- ウェブページ(URL ルール)
検索語句、見出し、ランディング ページの組み合わせのパフォーマンスをレポートする
ai_max_search_term_ad_combination_viewを追加しました。このビューでは、広告の表示につながった検索語句と、その組み合わせのパフォーマンスを確認できます。今後のリリースでは、P-MAX キャンペーンのデータも含まれるビューが追加される予定です。P-MAX のデータを取得するために実装を移行したくない場合は、このリリースをお待ちください。search_term_match_typeセグメントの新しい値としてAI_MAXを追加しました。
アセット
PromotionAssetにフィールドterms_and_conditions_text、terms_and_conditions_uri、promotion_barcode_info、promotion_qr_code_infoを追加しました。バーコード フィールドと QR コード フィールドはpromotion_triggeroneof 内にあります。ヘルプセンターの記事「プロモーション アセットについて」をご覧ください。AssetAutomationTypeEnumにFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONを追加しました。この設定を使用すると、検索キャンペーンの最終ページ URL からのテキスト アセットとランディング ページの自動生成を制御できます。Campaignから自動作成アセットを削除する新しいサービスAutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAssetを追加しました。このサービスでは、最終ページ URL の拡張アセットの削除のみがサポートされています。ServedAssetFieldType列挙型にDESCRIPTION_PREFIXを追加しました。これは、ad_group_ad_asset_combination_viewのserved_asset_field_typeが説明の接頭辞として機能するアセットのUNKNOWNになっていた問題を修正するものです。
キャンペーン
CampaignPrimaryStatusReasonに新しい列挙値MISSING_LOCATION_TARGETINGを追加しました。この新しいステータスの理由は、地域制限のあるキャンペーンで地域ターゲティングが指定されていない場合にのみ返されます。地域制限付きキャンペーンでは、許可された地域外の地域ターゲティングを追加しようとすると、条件エラーLOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGNが発生します。VideoCustomer.third_party_integration_partnersレベルと Campaign.third_party_integration_partners レベルで、サードパーティ統合パートナーのサポートを追加しました。ヘルプセンター記事の第三者アプリ分析を使ってアプリのコンバージョンをトラッキングするをご覧ください。既存の
Campaignのadvertising_partner_idsフィールドを設定できるようになりました。以前は、このフィールドは新しいキャンペーンの作成時にのみ設定できました。このフィールドは、設定後も変更できません。MCC アカウント単位で定義されたタイプ
TYPE_PLACEMENT_LISTの共有リストを使用することで、広告主様はCustomerNegativeCriterion条件を使用して、個々の広告主様の顧客アカウントでプレースメントのリストを除外できるようになりました。ServedAssetFieldType列挙型にDESCRIPTION_PREFIXを追加しました。これは、ad_group_ad_asset_combination_viewのserved_asset_field_typeが、説明の接頭辞として機能するアセットに対してUNKNOWNになっていた問題を修正するものです。MaximizeConversionValueとTargetRoasの入札戦略でtarget_roas_tolerance_percent_millisフィールドがサポートされるようになりました。TargetRoas.target_roas_tolerance_percent_millisはポートフォリオ戦略でのみ使用できます。ポートフォリオ戦略は検索キャンペーンでのみ使用できます。ProductGroupエラーコードを変更しました。部分的な失敗が有効になっているリクエストの場合、INVALID_LISTING_GROUP_HIERARCHYではなくLISTING_GROUP_ERROR_IN_ANOTHER_OPERATIONが返されます。広告グループの地域インタレスト条件のパフォーマンスをまとめた新しいリソース
LocationInterestViewを追加しました。
コンバージョン数
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.ListPlannableUserInterestsを追加しました。これにより、広告主様はReachPlanService.GenerateReachForecastでサポートされているユーザーの興味 / 関心(アフィニティと購買意向)を検出できます。このメソッドは、特定のユーザーの興味 / 関心タイプを検索し、名前とパスをクエリすることをサポートしています。ReachPlanService.ListPlannableUserListsにオプションの入力フィールドとしてAdditionalApplicationInfoを追加しました。リクエストを行う顧客 ID の利用可能なファーストパーティ ユーザーリストを取得するために、
AudienceInsightsService.ListAudienceInsightsAttributesのサポートを追加しました。AudienceInsightsService.GenerateAudienceCompositionInsightsにファーストパーティ ユーザーリストのサポートを追加し、ユーザーリストをターゲットとするオーディエンスの分析情報を取得できるようにしました。ユーザーリストを対象とするリクエストは、オーディエンス インデックスのみを返し、次のAudienceInsightsDimensionでのみ使用できます。AGE_RANGE、GENDER、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST。AudienceInsightsService.GenerateTargetingSuggestionMetricsのオーディエンス入力タイプをInsightsAudienceに更新しました。新しいオーディエンス入力では、ユーザーの興味 / 関心の AND-of-ORs の組み合わせが可能になり、よりカスタマイズされたオーディエンス定義のリーチの可能性の指標がサポートされます。TrendInsightMetricsにオーディエンス シェアを追加して、トレンドのオーディエンス シェアを取得します。KnowledgeGraphAttributeMetadataに新しい関連カテゴリを追加しました。これにより、ユーザーはカテゴリ別にナレッジグラフの属性をフィルタできるようになります。
レポート
AssetGroupAsset、ChannelAggregateAssetView、CampaignAggregateAssetViewで、さまざまな新しい指標を利用できるようになりました。また、ChannelAggregateAssetViewとCampaignAggregateAssetViewについては、これまで P-MAX キャンペーンでゼロに設定されていたimpressionsが、実際の値をレポートするようになります。ChangeStatusでAssetSetリソースを選択できるようにしました。これにより、ユーザーは 1 つのクエリでAssetSetまたはCampaignAssetSetタイプのりソースに関する詳細情報を取得できます。ChangeStatusでCampaignAssetSetリソースを選択できるようにしました。これにより、ユーザーは 1 つのクエリでAssetSetまたはCampaignAssetSetタイプのより多くの情報を取得できます。キャンペーンの検索語句ビューで選択できる新しいセグメント
search_term_targeting_statusを追加しました。新しい
final_url_expansion_asset_viewを追加しました。AssetGroupレポートで指標value_adjustmentとall_value_adjustmentのサポートが追加されました。ad_network_typeでAssetGroupAssetをセグメント化できるようにしました。landing_page_viewリソースで使用できる新しいセグメントlanding_page_sourceを追加しました。検索キーワード ビューとキャンペーンの検索キーワード ビューで選択できる新しいセグメント
search_term_match_sourceを追加しました。キーワード ビューから選択できる新しいセグメント
match_typeを追加しました。次の条件を満たすユニークなクエリ インテント クラスタの指標のサポートを追加しました。
click_viewセグメンテーションに新しいクリックタイプVEHICLE_ASSETSを追加しました。これにより、車両アセットに固有の広告フォーマットに関連するクリックをトラッキングしてレポートできます。
検索の「目標広告費用対効果」入札戦略向けスマート自動入札の入札範囲拡大機能
MaximizeConversionValueとTargetRoasの入札戦略でtarget_roas_tolerance_percent_millisフィールドを 10,000(10%)から 30,000(30%)までの 1,000 で割り切れる任意の値に設定することで、検索キャンペーンでスマート自動入札の入札範囲拡大機能を有効にできるようになりました。MaximizeConversionValue入札戦略では、target_roasフィールドの設定も必要です。TargetRoas.target_roas_tolerance_percent_millisはポートフォリオ戦略でのみ使用できます。詳しくは、スマート自動入札の入札範囲拡大機能に関するブログ投稿とヘルプセンターの記事をご覧ください。ユニークな検索意図クラスタの次の指標で、集計された多様性レポートがサポートされるようになりました。Google 広告の管理画面で、期間で分割されたビューを利用できます。
動画
YouTubeVideoListAssetを追加しました。また、campaign型とYouTubeVideoListAsset型の間にリンクを作成するために使用できるAsset#youtube_video_list_assetも追加されました。ヘルプセンター記事の関連動画を使用するをご覧ください。YouTubeChannelInsightsとYouTubeVideoAttributeMetadataに新しいメタデータ フィールドを追加しました。新しいクリックタイプ(
VIDEO_RELATED_VIDEOS_CLICK、VIDEO_CHANNEL_CLICK、PRODUCT_ASSETS)を公開しました。VideoAdInventoryControlにallow_non_skippable_in_streamフィールドを追加し、動画レスポンシブ広告をスキップ不可のインストリーム広告として配信できるようにしました。このオプションは、スキップ不可フォーマットと他のフォーマットの組み合わせをサポートするキャンペーンで使用できます。Campaign.VideoCampaignSettings.video_ad_sequenceフィールドとAdGroup.VideoAdGroupSettings.VideoAdSequenceStepSettingフィールド(読み取り専用)を追加しました。ヘルプセンター記事の動画広告シーケンスについてをご覧ください。YouTubeChannelInsightsとYouTubeVideoAttributeMetadataに新しいメタデータ フィールドを追加しました。VIDEO_LINEUP条件タイプとvideo_lineupフィールドをCampaignCriterionとAdGroupCriterionに追加しました。この機能は、許可リストに登録されたアカウントでのみ利用可能です。詳しくは、Google のビジネス デベロップメント担当者にお問い合わせください。詳細レベルとグループ レベルの両方で、コンテンツの適合性レポートを追加しました。ヘルプセンター記事の「コンテンツの適合性」レポートについてをご覧ください。
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-06-04)
v20 では、以下の新機能とアップデートが追加されました。
ガイダンスについては、最新バージョンにアップグレードするをご覧ください。
アセット
asset_group レポートに新しい指標とセグメントの列がいくつか追加されました。
指標の列
new_customer_lifetime_valueall_new_customer_lifetime_valueconversions_by_conversion_dateall_conversions_by_conversion_dateconversions_value_by_conversion_dateall_conversions_value_by_conversion_datevalue_per_conversions_by_conversion_datevalue_per_all_conversions_by_conversion_date
セグメント列
ad_network_typeconversion_actionconversion_action_nameconversion_action_categoryexternal_conversion_sourceconversion_attribution_event_typeconversion_adjustmentconversion_lag_bucketconversion_or_adjustment_lag_bucketnew_versus_returning_customersdeviceslot
キャンペーン
- P-MAX キャンペーンでキャンペーン単位の除外キーワードの追加と更新がサポートされるようになりました。
コンバージョン数
既存の顧客の
google_ads_conversion_customerフィールドを更新して、クロスアカウント コンバージョン トラッキングを有効にしたり、既存のコンバージョン トラッキングの親を別の MCC アカウントに変更したりできるようになりました。ClickConversion.user_ip_addressフィールドを追加しました。Google 広告では、欧州経済領域(EEA)、英国(UK)、スイス(CH)のエンドユーザーについては、IP アドレスの照合がサポートされません。これらの地域のユーザーからの IP アドレスの共有を条件付きで除外するロジックを追加してください。サイト、アプリ、その他のプロパティで収集するデータに関しては、明確で包括的な情報をユーザーに開示し、法律または適用される Google のポリシーで必要な場合は、データ収集への同意を得なければならないことにご注意ください。詳しくは、オフライン コンバージョンのインポートについてをご覧ください。
デマンド ジェネレーション
ad_network_typeセグメントに新しい値を追加しました。これにより、デマンド ジェネレーション キャンペーンをチャネル別にセグメント化できます。MAPSGMAILDISCOVER
- 同等プラットフォームと同様のコンバージョンの指標を追加しました。
platform_comparable_conversions_from_interactions_rateplatform_comparable_conversionsplatform_comparable_conversions_valueplatform_comparable_conversions_value_per_costplatform_comparable_conversions_by_conversion_dateplatform_comparable_conversions_value_by_conversion_dateplatform_comparable_conversions_from_interactions_value_per_interactionvalue_per_platform_comparable_conversionvalue_per_platform_comparable_conversions_by_conversion_datecost_converted_currency_per_platform_comparable_conversion
推奨事項
GenerateRecommendationsRequestを使用する場合のキャンペーン作成時のShoppingSettingのサポートを追加しました。GenerateRecommendationsRequestにmerchant_center_account_idフィールドを追加しました。これは、標準の P-MAX キャンペーンではなく、小売店向けの最適化案を生成するタイミングを示すものです。
計画
AudienceInsightsServiceとContentCreatorInsightsServiceのAudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUPを置き換えるためにAudienceInsightsDimension.YOUTUBE_LINEUPを追加しました。この新しいディメンションを使用すると、YouTube Select(YTS)ラインナップの分析情報とメタデータを取得できます。Google 広告全体でダイナミック広告フォーマットの削除が拡大されたことに伴い、YOUTUBE_DYNAMIC_LINEUPに関連するオブジェクト(DynamicLineupAttributeMetadata、AudienceInsightsDynamicLineupなど)を置き換えました。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。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_attributesoneof を使用する場合にのみサポートされます。sub_country_locationsが他の条件タイプとともに指定されている場合、リクエストは無効になります。これにより、コンテンツ クリエイターの分析情報について、より詳細な地域ターゲティングと分析が可能になります。この機能は、許可リストに登録されているアカウントでのみご利用いただけます。- お客様が所有するファーストパーティ ユーザーリストを返す
ReachPlanService.ListPlannableUserListsを追加し、GenerateReachForecastRequestのオーディエンス ターゲティング オプションにUserListInfoを追加しました。これにより、特定の顧客のプラン可能なユーザーリストを取得し、特定のオーディエンスをターゲットとするキャンペーンのリーチ予測を生成できます。これらの機能強化により、ファーストパーティ オーディエンス データを予測に直接組み込むことで、リーチ プランニングのカスタマイズが向上します。リーチ予測は、許可リストに登録されたアカウントでのみご利用いただけます。
動画
- テレビ画面でオーガニックの YouTube 動画に配信された
AdFormatType.PAUSE広告がレポートに含まれるようになりました。これらの広告は、一時停止画面の静止動画フレームのすぐ横に表示されます。一時停止したオーガニック動画の下または上に表示されるデマンド ジェネレーション動画広告は含まれません。これらの広告はAdFormatType.INFEEDでレポートされます。
リリースノートのアーカイブ
アーカイブされたリリースノートについては、サポート終了バージョンをご覧ください。