2026 年 4 月 22 日(水曜日)
本日、Google Ads API の v24 リリースを発表しました。新しい v24 の機能を使用するには、クライアント ライブラリとクライアント コードをアップグレードする必要があります。更新されたクライアント ライブラリとコードサンプルはすべて公開されています。
明日(4 月 23 日午前 10 時(米国東部時間))に開催される Discord の「Google Ads API リリースのハイライト」イベント、Ads Developers YouTube ライブ、LinkedIn Live イベントで、このリリースのライブ ウォークスルーにご参加ください。ライブイベントに参加できない方のために、録画して YouTube に投稿する予定です。ご不明な点がある場合や、この投稿についてご相談がある場合は、Discord の #ads-api チャンネルからお問い合わせください。
新機能
カート コンバージョン レポートのサポート: カート コンバージョン レポートは、ウェブサイトやアプリで実施されるコンバージョン トラッキングの拡張機能です。このレポートを使用すると、各トランザクションで販売された商品の詳細を確認し、ご利用の Google 広告アカウントとキャンペーンが貢献した売り上げと利益に関する高度なレポートと分析情報(注文数、カートの平均サイズ、収益、総利益など)を詳しく把握できます。
Google Ads API v24 では、この機能のサポートが次のように追加されています。
- 新しいリソース
CartDataSalesViewを追加しました。これにより、product_sold_brandなどのセグメントを使用して、商品のクリックだけでなく、販売された商品でもコンバージョン指標をセグメント化できるようになりました。これにより、広告主は、広告が別の商品のものであっても、広告をクリックした後にユーザーが実際に購入した商品に関する統計情報を確認できます。 - 入札不可の「すべて」の指標をいくつか追加しました。これは、キャンペーンで積極的に最適化されていないコンバージョンも含む指標です(例:
all_cost_of_goods_sold_micros)。新しい指標は、対応する入札可能な指標をサポートするすべてのリソースに追加されます。 ShoppingPerformanceViewリソースにconversion_attribution_event_typeセグメントを追加し、カートのデータやその他のコンバージョン指標で選択できるようにしました。このセグメントは、コンバージョンがクリックまたはビューに起因するかどうかを示します。ビュースルー コンバージョンによって生成されたカートのデータの統計情報を認識するために必要です。
更新された機能
バージョン v24 では、既存の機能に更新が加えられており、アップグレード時にコードの変更が必要になります。ここでは、最も重要な変更点について説明します。変更点の完全なリストについては、リリースノートをご覧ください。
キャンペーンでの動画コンテンツの除外設定: 個々のキャンペーンで動画コンテンツの除外設定を行う機能を簡素化しました。この設定はクライアント単位で利用でき、すべてのキャンペーンに適用されます。コンテンツの除外設定は、Google のポリシーに準拠しつつ、お客様のブランドやビジネスに適合しないコンテンツの種類を除外するための追加設定です。動画コンテンツの除外設定について詳しくは、https://support.google.com/google-ads/answer/7515513 をご覧ください。
AudienceInsightsService の変更: コードのリファクタリングの一環として、InsightsAudience.topic_audience_combinations リクエスト フィールドを common 名前空間に移動しました。プログラミング言語によっては、インポート ディレクティブの更新が必要になる場合があります。
ReachPlanService の変更: コードのリファクタリングの一環として、youtube_select_lineups フィールドを ReachPlanService.ListPlannableProducts サービスから移動しました。ラインナップは youtube_select_lineup_targeting フィールド内で今すぐチェックできます。YouTube セレクト ラインナップは、要件を満たしている広告主様向けの予約サービスです。YouTube で人気の高い上位 1% のチャンネルで、特定の市場への関心が高いオーディエンスに広告を表示できます。詳細。
ContentCreatorInsightsService の変更: コードのリファクタリングの一環として、ContentCreatorInsightsService.GenerateCreatorInsights サービスと ContentCreatorInsightsService.GenerateTrendingInsights サービスから is_brand_connect_creator フィールドを削除しました。
代わりに、partnership_opportunities で CREATOR_PARTNERSHIPS オプションが利用可能なクリエイターを探す必要があります。Google 広告の YouTube クリエイター パートナーシップは、スポンサー コンテンツを通じて提携する YouTube クリエイターを見つけ、クリエイター パートナーシップを効率的に管理できる機能です。詳細。
KeywordPlanIdeaService の変更: より効率的で信頼性の高いエクスペリエンスを提供するため、予測インフラストラクチャを統合しました。Google Ads API v24 では、更新された GenerateKeywordForecastMetrics メソッドが導入され、パフォーマンスに最も直接的に影響する指標に焦点を当てることで、プランニング プロセスが簡素化されます。この変更に関する詳細なブログ投稿を近日中に公開する予定です。
campaign_budget リソースの変更: campaign_budget リソースの ad_sub_network_type セグメントは、このビューと互換性がないため削除されました。
アセットビューの変更: ad_group_asset、campaign_asset、customer_asset の各ビューから click_type セグメントを削除しました。この変更は、データの誤表示を避けるために Google 広告からこのセグメントを削除した最近のプロダクト変更に沿ったものです。ad_group_ad リソースの click_type セグメンテーションを使用すると、広告のパフォーマンスと、広告が配信されたアセットの詳細を取得できます。
レスポンシブ動画広告の変更: VideoResponsiveAdInfo が変更可能になりました。この変更の一環として、videos、business_name、logo_images を DemandGenVideoResponsiveAdInfo オブジェクトと VideoResponsiveAdInfo オブジェクトの両方で必須フィールドとしてマークしました。
ShareablePreviewService の変更: ShareablePreviewService.GenerateShareablePreviews を更新し、部分的な失敗を使用しないようにしました。いずれかの ID でリクエストが失敗すると、エラーがスローされます。詳細
使用を開始する際に、以下のリソースが役に立ちます。
技術的なサポートが必要な場合は、https://support.google.com/google-ads/contact/google_ads_api にお問い合わせください。
ラベル: google-ads-api、 release