この記事は Nadine Wang による Google Ads Developer Blog の記事 "Updates to Customer Match, Conversions, and Store Sales Uploads" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

Google は 9 月に、デジタル市場法（DMA）に対応するための変更を行う予定であることを発表しました。2024 年 3 月 6 日に予定されている DMA の施行に先立って、デベロッパーがアプリケーションの変更を行う時間を確保できるようにするために、Google は Google Ads API と Display ＆ Video 360 API の変更をできるだけ早くリリースします。欧州経済領域のユーザーに対する同意要件については、EU ユーザーの同意ポリシーを確認してください。

Google Ads API で必要になる変更点は何ですか

Google Ads API v15 リリースでは、データで同意をアップロードするための Consent オブジェクトが導入されました。この Consent は、通話コンバージョン、クリック コンバージョン、カスタマー マッチ、店舗販売のすべてのアップロードで使用します。それぞれの機能で Consent を設定する場所を以下に示します。

機能	コード変更
通話コンバージョン	CallConversion.consent で通話コンバージョン イベントごとに Consent を設定します。詳しくは、ガイドをご覧ください。
クリック コンバージョン	ClickConversion.consent でクリック コンバージョン イベントごとに Consent を設定します。詳しくは、ガイドをご覧ください。
カスタマー マッチ	CustomerMatchUserListMetadata.consent でカスタマー マッチ ジョブごとに Consent を設定します。詳しくは、ガイドをご覧ください。
店舗販売	UserData.consent で店舗販売イベントごとに Consent を設定します。詳しくは、ガイドをご覧ください。

Display ＆ Video 360 API で必要になる変更点は何ですか

このブログで発表してから数か月のうちに、Display ＆ Video 360 API でも同様の変更をリリースする予定です。既存バージョンのアップデートについてはリリースノートを、最新の実装手順についてはカスタマー マッチ機能ガイドをご覧ください。

どこでサポートを受けることができますか

ご質問などございましたら、Google Ads API の場合は googleadsapi-support@google.com に、Display ＆ Video 360 API の場合はサポート フォームからお問い合わせください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

この記事は Anash P. Oommen による Google Ads Developer Blog の記事 "Upcoming changes to YouTube Select (YTS) in Reach Plan Service" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

2023 年 11 月 14 日より、ReachPlanService の YouTube Select 予測を他のマーケットに拡大しました。この新しいマーケットに対応するため、Google Ads API の v15 に 2 つの新しいエラーコードを導入しました。

エラーコード	理由
ReachPlanError.NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY	予測に十分な広告枠がありません。
ReachPlanError.NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED	アカウントが有効ではありません。

注 : バージョンが古く、この 2 つのエラーコードが含まれていない Google Ads API では、ReachPlanError.UNKNOWN エラーがスローされます。

この機能をご利用の場合は、追加のエラーコードを処理できるように、コードを更新してください。

リーチ予測の詳細については、リーチ予測ガイドを参照してください。ご質問などございましたら、サポートページまたはフォーラムからご連絡ください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

この記事は Thanet Knack Praneenararat による Google Ads Developer Blog の記事 "Announcing v15 of the Google Ads API" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

この度、Google Ads API の v15 リリースをお知らせします。v15 の一部の機能を使用するには、クライアント ライブラリとクライアントのコードをアップグレードする必要があります。更新版のクライアント ライブラリとコードサンプルは公開されました。

主な機能は以下のとおりです。

• 最適化案のサブスクリプションを管理し、自動的に最適化案を適用できる RecommendationSubscriptionService を追加しました。
• 新しい最適化案の種類 FORECASTING_SET_TARGET_CPA、SET_TARGET_CPA、SET_TARGET_ROAS を追加しました。
• P-MAX の更新 : 
  • アセット グループに検索テーマをアタッチしてターゲティングを強化する AssetGroupSignal.search_theme を追加しました。
  • アセット グループ レベルで最もパフォーマンスの高いアセットをレポートするために、asset_group_top_combination_view を新しく追加しました。
  • P-MAX キャンペーンで asset_group の指標フィールドに対してクエリを実行して、アセット グループのパフォーマンスを取得できるようになりました。
• 類似セグメントを作成できるように、UserList.lookalike_user_list を追加しました。これは、指定された既存のシード オーディエンスをもとに作成されたオーディエンスです。類似セグメントは、デマンド ジェネレーション キャンペーンでのみ使用できます。
• Apple の SkAdNetwork 4 のコンバージョン レポート作成へのサポートを追加しました。これには、Google 検索でのウェブからアプリへのコンバージョンが含まれます。粒度の粗いコンバージョン値、ソースドメイン、ポストバック シーケンス インデックスで分割できるようになりました。
• offline_conversion_upload_client_summary レポートのオフライン コンバージョン アップロード診断が改善され、成功したイベント、成功率、エラー率などのコンバージョン アップロード ステータスに関する有用な詳細情報が増えました。
• 収益、売上総利益、売上総利益率、販売数など、売上と利益の指標のサポートを追加しました。これらの指標は、検索、ショッピング、P-MAX キャンペーンでカートデータを使ってコンバージョンを実装しているすべての広告主が利用できます。
• customer レポートに、ローカル サービス広告主のライセンスや保険に関する詳細な状況を返す LocalServicesSettings と、それに関連するフィールドを追加しました。また、local_services_lead、local_services_lead_conversation、local_services_verification_artifact など、ローカル サービス広告の新しいレポートも追加しました。
• アカウントのリンクに関する変更点 : 
  • Google 広告アカウントと Merchant Center アカウントとのリンクを追加および削除する ProductLink.merchant_center を追加し、MerchantCenterLinkService を削除しました。
  • 他のプロダクトから送信されたリンクに関する招待を更新する ProductLinkInvitationService を追加しました。これは、Hotel Center アカウントと Merchant Center アカウントで利用できます。
    • AccountLink.hotel_center を削除し、AccountLinkService で Hotel Center アカウントからリンクに関する招待を更新できるようにしました。
• ショッピング キャンペーンの変更 :  
  • ShoppingSetting.sales_country を削除しました。この値は、ShoppingSetting.feed_label として返されるようになりました。
  • 検索キャンペーンに Campaign.shopping_setting を追加できなくなりました。
  • 検索キャンペーンに CampaignCriterion.listing_scope を追加できなくなりました。
• NetworkSettings を使って、キャンペーン レベルで Google TV と YouTube をターゲットに指定できるようになりました。
• 顧客レベルとキャンペーン レベルで「新規顧客の獲得」目標を設定できるように、CustomerLifecycleService.ConfigureCustomerLifecycleGoals と CampaignLifecycleService.ConfigureCampaignLifecycleGoals を追加しました。
• 以下のクラスに consent を追加しました。現時点では何もする必要はありませんが、今後数か月間はブログで最新情報をご確認ください。
  • UserData
  • CustomerMatchUserListMetadata
  • CallConversion
  • ClickConversion
• 指定されたブランド接頭辞とブランド除外リストに基づいてブランドの候補を表示する BrandSuggestionService を追加しました。このブランドを使用して BRAND 条件を作成し、それを BRANDS 共有セットに追加できます。さらに CampaignCriterion を作成し、brand_list に共有セットを設定することで、キャンペーンにアタッチできます。このキャンペーン条件の negative フィールドは、検索キャンペーンでは false に、P-MAX キャンペーンでは true に設定する必要があります。

さらに詳しく知りたい方へ

以下のリソースが役立ちます。

• リリースノート
• ガイド
• リファレンス
• v14 と v15 の差分

ご質問やサポートが必要なことがありましたら、フォーラムからご連絡ください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

この記事は Devin Chasanoff による Google Ads Blog の記事 "Performance Max: create listing groups using batch processing" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

新機能

2023 年 10 月 4 日より、Google Ads API のバッチ処理で、非同期に AssetGroupListingGroupFilters を作成できるようになりました。BatchJobService を使って 1 回のリクエストで AssetGroupListingGroupFilter エンティティなどの P-MAX リソースを作成する場合、リスティング グループのツリー作成中にエラーが発生しても、残りのエンティティの作成はブロックされません。ただし、リスティング グループのツリーを作成する操作がアトミックである点は変わりません。つまり、リスティング グループのツリー作成に関連する操作でエラーが返された場合、そのリスティング グループのツリーに関連するすべての操作も失敗します。ただし、いくつかの注意事項があります。こちらのジョブおよびリスティング グループ フィルタガイドに詳しく記載されているので、ご覧ください。

リスティング グループ フィルタの作成操作を含まない既存のバッチジョブの動作は、今回のアップデートで変更されることはありません。

これまでの動作

2023 年 10 月 4 日より前の時点では、AssetGroupListingGroupFilters は GoogleAdsService.Mutate メソッドまたは AssetGroupListingGroupFilterService.MutateAssetGroupListingGroupFilters メソッドを使って同期的に作成することしかできません。AssetGroupListingGroupFilterOperation 操作が含まれている場合、GoogleAdsService.Mutate メソッドによるリクエストは常にアトミックです。このような動作になるのは、この操作で partial_failure がサポートされていないためです。つまり、リスティング グループのツリー作成でエラーが発生した場合、リクエスト内の他のすべての操作がブロックされます。2023 年 10 月 4 日より前にバッチ処理で AssetGroupListingGroupFilter エンティティを作成しようとすると、MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE エラーが返されます。

変更の理由

バッチ処理は Google Ads API の機能で、同期的に操作の完了を待つことなく、一連の操作を複数のサービスにディスパッチできます。その際に、それぞれの操作に相互依存関係があっても問題ありません。今回は、AssetGroupListingGroupFilters でバッチ処理を利用できるようにして、同じリクエストの他の操作をブロックすることなく、リスティング グループのツリー作成を非同期でも行えるようにしました。これは、皆さんからのフィードバックにお応えしたものです。

実装の詳細

バッチジョブで AssetGroupListingGroupFilter を追加するには、次の手順を実行します。

1. AssetGroupListingGroupFilterOperation を含む MutateOperation を作成します。これは、GoogleAdsService.Mutate サービスを使って MutateOperation を作成する操作と同様です。
2. バッチジョブに MutateOperation を追加します。これは、他のタイプの操作と同様です。

次の例は、既存のバッチジョブに 1 つの AssetGroupListingGroupFilter を追加するプロセスを示しています。AssetGroupListingGroupFilter エンティティを使って製品パーティション ツリーを作成する方法については、ショッピング リスティング グループの作成に関するガイドをご覧ください。

// Constructs the AssetGroupListingGroupFilter.
AssetGroupListingGroupFilter listingGroupFilter =
     AssetGroupListingGroupFilter.newBuilder()
         .setAssetGroup(assetGroupResourceName)
         .setType(ListingGroupFilterType.UNIT_INCLUDED)
         .setVertical(ListingGroupFilterVertical.SHOPPING)
         .build();

// Constructs the operation to create the AssetGroupListingGroupFilter.
MutateOperation operation = MutateOperation.newBuilder()
     .setAssetGroupListingGroupFilterOperation(
           AssetGroupListingGroupFilterOperation
      .newBuilder()
      .setCreate(listingGroupFilter))
      .build();

// Sends a request to add the operation to the batch job.
AddBatchJobOperationsResponse response =
    batchJobServiceClient.addBatchJobOperations(
        AddBatchJobOperationsRequest.newBuilder()
            .setResourceName(batchJobResourceName)
            .addMutateOperations(operation)
            .build());

以下のリソースには、連携の際に役立つ追加情報が含まれています。

• ジョブおよびリスティング グループ フィルタガイド
• リスティング グループガイド
• バッチ処理ガイド

P-MAX 連携の改善についてのブログシリーズ

この記事は、皆さんから要望があった新機能や今後予定されている機能についてお伝えするシリーズの一部です。今後も、新機能や現在の実装アプローチとの違いについて説明してまいります。

今後のアップデートや改善についてお伝えするデベロッパー ブログにご注目ください。Google Ads API と P-MAX の連携についてのフィードバックも、引き続きお寄せください。サポートが必要な場合は、いつものようにチームにお問い合わせください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

この記事は Nadine Wang による Google Ads Blog の記事 "Google Ads Shopping Campaign Enhanced CPC Deprecation" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

2023 年 10 月上旬より、拡張クリック単価（eCPC）を使っているショッピング キャンペーンは、手動クリック単価（CPC）入札と同じ動作になりました。

拡張 CPC は、10 年以上前に Google が導入した最初のスマート入札戦略でした。これは、目標広告費用対効果（ROAS）やコンバージョン値の最大化といったさらに高度な入札戦略や、P-MAX などの完全自動キャンペーンに置き換えられています。

何も変更しないとどうなりますか

2023 年 10 月までにキャンペーンを変更しないと、手動 CPC 入札と同じ動作になります。eCPC を使っている既存キャンペーンは、すべて設定された手動入札に基づいて提供され続けます。ショッピング キャンペーンで ManualCpc.enhanced_cpc_enabled を true に設定しても、設定は無視され、手動 CPC 入札のみが使われます。

何を変更すればよいですか

今後も手動 CPC を使いたい場合は、ショッピング キャンペーンで ManualCpc.enhanced_cpc_enabled を true に設定しているコードをすべて削除してください。手動 CPC の代わりに次の方法を使うことをお勧めします。

• 目標広告費用対効果（ROAS）
• 最新の完全自動ソリューション : P-MAX キャンペーン

どこでサポートを受けることができますか

ご不明点などございましたら、フォーラムまたは googleadsapi-support@google.com にご連絡ください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

この記事は Nico Jersch による Chromium Blog の記事 "A new way to seamlessly browse across devices with Chrome on iOS" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

Chrome はすべてのプラットフォームで優れた機能を発揮するように設計されているので、自宅から PC でウェブをブラウジングするときも、外出先からスマートフォンでブラウジングするときも簡単に使えるようになっています。例えば、Chrome sync のようなツールによって、すべてのデバイスを切り替えてもブックマークやパスワードにアクセスできるようになりました。

今後数週間で iOS 版 Chrome に変更を加え、特に重要な情報をすぐ利用できるようにします。デバイスで Chrome 同期を設定する必要がなくなり、Chrome にログインするだけで、新しい情報を Google アカウントに保存したり、既存の情報にアクセスしたりできるようになります。iOS ですでに動作している Google アプリの数が多いため、これに慣れ親しんでいるように感じるかもしれません。Chrome にサインインすると、ブックマーク、リーディングリスト、パスワード、支払い情報、住所、設定など、重要な情報をアカウントに保存できます。また、タブと閲覧履歴を iOS の Chrome から Google アカウントに別々に同期させることもできます。これにより、別のデバイスで中断した閲覧を再開できます。

以上のアップデートは、データ管理にも役立つように設計されています。Chrome にログインすると、すでにデバイスに保存されている閲覧データは、デバイスのローカルデータとして別に保管されます。ローカルデータとアカウント データは、設定で簡単に区別できます。また、他のデバイスでローカルデータを利用できるようにしたい場合は、設定に移動してアカウントに保存することもできます。

iOS での Chrome へのログインは、今後とも完全に任意です。ログインしなくても、ブックマークやパスワードなどは保存できますが、保存したデバイスでのみ利用できます。また今後も、Chrome にログインしないまま、Gmail などの Google のウェブサービスにログインすることができます。

これらの変更により、求められるあらゆる柔軟性を提供するとともに、さらに簡単に Chrome を活用できるようになることを期待しています。

Posted by Eiji Kitamura - Developer Relations Team

この記事は Josh Radcliff による Google Ads Blog の記事 "Google Ads API support for importing and editing conversions from Google Analytics" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

変更点
2023 年 10 月 9 日以降、Google Ads API で、Google アナリティクス 4（GA4）プロパティからインポートした ConversionAction について、次の種類の変更操作が許可されるようになりました。

1. status、primary_for_goal、category、name、value_settings を変更する update
2. コンバージョン アクションを削除する remove

これが重要な理由
Google アナリティクスからインポートするコンバージョンは、多くの Google 広告ユーザーにとって、入札やレポートの重要な要素になっています。これまでも、Google Analytics Admin API を使って Google アナリティクスと広告アカウントをリンクすることはできました。しかし、次に示すリンクプロセスのその他の手順を、Google Ads API から完了することはできませんでした。

• status フィールドを HIDDEN から ENABLED に変更し、GA4 プロパティのコンバージョンを Google 広告アカウントにインポートする操作。
• インポートしたコンバージョンの primary_for_goal フィールドと category フィールドを設定し、Google 広告の入札とレポートに与える効果を指定する操作。

今回の変更により、両方の操作が Google Ads API でサポートされ、API ベースのソリューションだけで Google アナリティクス 4 プロパティを Google 広告アカウントにリンクできるようになります。

適切なコンバージョン目標を設定するために必要な属性に加えて、インポートした GA4 の ConversionAction の次の属性も変更できます。

• name
• value_settings

インポートした GA4 の ConversionAction のその他の属性を変更するリクエストは、今後も失敗します。また、ユニバーサル アナリティクス（UA）プロパティからインポートした ConversionAction を remove または update するリクエストも同様です。

対応が必要になる点
Google Ads API の連携コードにおいて、インポートした GA4 コンバージョンを update または remove しようとしたときに、ConversionActionOperation が MUTATE_NOT_ALLOWED エラーで拒否されることを前提としている場合は、変更してください。たとえば、コンバージョン アクションがインポートした GA4 コンバージョンであるかどうかを検出するためにこの動作を利用している場合は、ConversionAction の type が GOOGLE_ANALYTICS_4_CUSTOM か GOOGLE_ANALYTICS_4_PURCHASE であることを確認するように変更します。

また、UI を使って Google アナリティクスを Google 広告アカウントにリンクしている場合は、API ベースのソリューションに切り替えることが適切かどうかを検討してください。

サポートの利用方法
ご質問やサポートが必要なことがありましたら、Google Ads API サポートページでオプションをご確認ください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

この記事は Mattia Tommasone による Google Ads Blog の記事 "Changes in dynamic ad targets reporting" を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。

2023 年 9 月 20 日より、Google 広告の動的広告ターゲット レポートのバックエンド改善のロールアウトが開始されました。これにより、削除されてから除外条件として再追加された条件が含まれるようになります。

変更前は、ウェブページ条件のレポートクエリ（つまり、webpage_view リソースに対するクエリ）で過去のデータをリクエストした場合、削除されてから除外条件として再追加された条件は含まれませんでした。

そのため、この条件によって指標が生成された時間帯（つまり、この条件が  negative = false  だったときにターゲットになっていた時間帯）のレポートが、期待と異なる値になっていました。これは、レポートクエリの結果で、その時間帯に生成された指標が返されなかったためです。

今回の変更は、除外でない条件が削除されてから除外条件として再追加された場合にのみ影響します。他のすべての条件は、変更前と同じ値を返します。

変更のリリース後は、削除された条件と、除外条件として再追加された条件の両方が考慮された条件指標となります。

必要なアクション

GAQL クエリを変更する必要はありません。ただし、正しい値が報告されるようになるため、変更後の条件レポートに差異が生じる場合があります。

質問や懸念事項がある方は、遠慮なくフォーラムからご連絡ください。

Reviewed by Thanet Knack Praneenararat - Ads Developer Relations Team

DevFest は、Google Developer Group（GDG）コミュニティによって世界各地で開かれるデベロッパー向けイベントです。参加者は Android、Firebase、Google Cloud Platform、TensorFlow、Web などの Google のデベロッパー テクノロジーに関する技術情報、知識やアイデアを共有できます。

それぞれの DevFest は、主催するコミュニティとその地域のニーズに沿ったユニークな内容となり、日本では下記のイベントが現時点では企画がされています。情報は追加、更新されていきますので、ブログ記事やツイッターをご確認ください。

■ DevFest Shikoku 2023 うどん県 with えれくら

    日時 : 2023 年 10 月 29 日（日） 13:00～17:00
    場所 : e-とぴあ・かがわ BBスクエア Zoom）
　参加費 : 無料
　定員 :  0 名
　申込サイト : こちら
　主催 : GDG Shikoku、えれくら
　内容 : IoT 

■ DevFest Shikoku 2023 in 徳島

    日時 : 2023 年 11 月 4 日（土） 
    場所 : 株式会社 HIROKA サテライトオフィス鳴門
　参加費 : 無料
　定員 :  
　申込サイト : こちら
　主催 : GDG Shikoku
　内容 : GCP 入門ハンズオン

■ DevFest Nagoya 2023

    日時 : 2023 年 11 月 24 日（金） 18:30～
    場所 : マネーフォアード 東海支社、名古屋開発拠点
    参加費 : 無料
    定員 : 一般参加（19 名）
    　　   LT 参加（6 名）
    申込サイト : こちら
    主催 : GDG Nagoya
    内容 : LT のテーマは『ことしの頑張り共有しましょう！』

■ DevFest Shikoku 2023 愛媛

    日時 : 2023 年 12 月 10 日（日）  13:00～
    場所 : 愛媛大学 総合情報メディアセンター 2F ゼミ室
　参加費 : 無料
　定員 :  10
　申込サイト : こちら
　主催 : GDG Shikoku
　内容 : 機械学習

■ DevFest: Kobe Developer Day

    日時 : 2023 年 12 月 16 日（土） 14:00～
    場所 : 会場調整中
　参加費 : 無料
　定員 :  オフライン会場参加（50 名）
　　　　オンライン参加（100 名）
　申込サイト : こちら
　主催 : GDG Kobe
　内容 : 復活の GDG Kobe！ 記念すべき今年の年末イベント、DevFest Kobe Developer Day を開催いたします！噂のシリコンバレー流エンジニア教育から企業での生成 AI 活用事例まで、幅広くテクノロジーを取り扱ったお話を聞いていただける予定です。

■ DevFest 2023 in 高知

    日時 : 2023 年 12 月 17 日（日） 13:30～
    場所 : Kochi Startup BASE
　参加費 : 無料
　定員 :  15
　申込サイト : こちら
　主催 : GDG Shikoku
　内容 : Google Cloud Platform 入門ハンズオン

■ DevFest Kyoto 2023

    日時 : 2023 年 12 月 17 日（日） 13:30～
    場所 : ウィングス京都
　参加費 : 無料
　定員 :  一般参加（14 名）
　　　　LT 参加（6 名）
　申込サイト : こちら
　主催 : GDG京都, WTM京都
　内容 : コードラボ、LT 大会

■ GDG DevFest Tokyo 2023

    日時 : 2023 年 12 月 9 日（土）10:00～19:00
    場所 : ハイブリッド（Google 六本木オフィス＆ YouTube Live）
    参加費 : 無料
　定員 : 会場オフライン・一般参加（300 名）
　　　　LT 参加（10 名）
　　　　オンライン参加は人数制限無し
　申込サイト : こちら
　主催 : GDG Tokyo
　内容 : Android, Chrome, ML など幅広くセッションを予定中

※ リンクがない箇所は、情報が入り次第更新していきます。

皆さまのご参加を心よりお待ちしております。

Posted by Reisa Matsuda - Developer Relations Team