リリースノート

ここでは、Data Manager API の各リリースでの変更点について説明します。

2026-07-30 v1.8

  • RemoveAllAudienceMembers メソッドを IngestionService に追加し、指定したユーザーリストのすべてのオーディエンス メンバーを削除または置換できるようにしました。
    • まず、特定の統合のオーディエンスからすべてのメンバーを削除する方法についてのガイドをご覧ください。たとえば、Google 広告またはディスプレイ＆ビデオ 360 のカスタマー マッチ ガイドをご覧ください。
  • イベントとオーディエンスの取り込み中に詳細な警告を返すサポートを追加しました。
    • FieldWarning オブジェクトのリストを含む field_warnings フィールドを IngestEventsResponse と IngestAudienceMembersResponse に追加しました。
    • FieldWarning リソースを追加しました。これには、reason（WarningReason）、description、field パスが含まれています。
    • WarningReason 列挙型を追加して、警告の理由（カスタム変数が有効になっていない、カートデータに販売者 ID がないなど）を定義しました。
  • Google アナリティクスのイベント取り込みで追加のアドレス フィールドを送信するサポートを追加しました。
    • address_line、city、administrative_area フィールドを AddressInfo（UserData で使用）に追加しました。
  • ErrorReason 列挙型に INVALID_REMOVE_AS_OF_TIME と REQUIRED_PREREQUISITE_LINK_MISSING のエラー理由を追加しました。

2026-05-28 v1.7

2026-05-07 v1.6

  • IngestEventsRequest を使用して Google 広告の店舗販売コンバージョンを送信する機能を追加しました。この機能を使用するには、Google 広告アカウントが特定の資格要件を満たしている必要があります。
    • Event に event_location フィールドを追加しました。これにより、物理的な store_id. を提供できるようになりました。
    • Event に third_party_user_data フィールドを追加し、取り込まれたデータに第三者が所有していることを明示的にフラグ付けできるようにしました。
    • Item リソースに次のフィールドを追加しました。
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables（ItemCustomVariable オブジェクトのリストを受け入れます）
    • まずは、以下のガイドをご覧ください。
  • 予約済みイベント以外のウェブイベントまたはアプリイベントを Google アナリティクスに送信する機能を追加しました。
  • タグまたは Firebase 向け Google アナリティクス（GA4F）SDK の実装の追加データソースとして、トランザクション ID を含むイベントをウェブとアプリの両方のアプリデータ ストリームに送信する機能を追加しました。
    • この機能は、許可リストに登録されている Google アナリティクスのプロパティでのみご利用いただけます。プロパティを許可リストに追加することをご希望の場合は、こちらのフォームにご記入ください。
  • coupon_codes フィールドを CartData に追加し、Google 広告と Google アナリティクスに送信されるイベントについて、カートに適用されたすべてのクーポンコードをトラッキングできるようにしました。
    • Google 広告でクーポン利用のユースケースを扱う場合は、OFFLINE_PROMOTION_REDEMPTION コンバージョン タイプを使用します。
  • パートナー リンクの作成、検索、削除に関連するメソッドに、新しい OAuth スコープ https://www.googleapis.com/auth/datamanager.partnerlink を追加しました。
  • 店舗販売と Google アナリティクス イベントの取り込みの詳細な検証をサポートするため、ErrorReason 列挙型に新しい値を追加しました。
  • youtube_members_count フィールドと gmail_members_count フィールドを SizeInfo リソースに追加しました。

2026-03-26

2026-02-17 v1.5

Data Manager API は、オーディエンスの作成、取り込み、取得など、オーディエンスを管理するためのエンドツーエンドのワークフロー全体をサポートするようになりました。

2026-02-10

複数のデータソースを使用してコンバージョンを送信し、パフォーマンスとデータの質を高める機能が、すべての Google 広告アカウントで一般提供されるようになりました。

この機能は、許可リストに登録されている Google アナリティクスのプロパティでのみご利用いただけます。Google アナリティクス プロパティを許可リストに追加することをご希望の場合は、こちらのフォームにご記入ください。

2025-11-05 v1.4

  • タグのコンバージョンの追加のデータソースとして Google アナリティクスの purchase イベントを送信する機能を追加しました。これにより、広告インタラクション シグナルを最大限に活用し、データと全体的なパフォーマンスを強化できます。

    • GOOGLE_ANALYTICS_PROPERTY を AccountType 列挙型に追加しました。
    • Event に複数のフィールドを追加しました。
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • additional_user_properties を UserProperties に追加しました。

    Google アナリティクス purchase イベントの送信方法と、Google アナリティクスのイベント パラメータとユーザー プロパティを Data Manager API の同等のパラメータにマッピングする方法については、イベントガイドをご覧ください。

  • AWS Key Management Service の暗号鍵の使用をサポートするために AwsWrappedKeyInfo を追加しました。

  • ErrorReason に次の列挙値を追加しました。

    • EVENT_TIME_INVALID
    • FIELD_VALUE_TOO_LONG
    • INVALID_EVENT_NAME
    • INVALID_PROPERTY_TYPE
    • INVALID_REQUEST_ID
    • INVALID_STREAM_TYPE
    • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
    • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
    • NOT_ALLOWLISTED
    • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
    • RESERVED_NAME_USED
    • TOO_MANY_ELEMENTS
    • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
    • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

  • Data Manager API がすべてのユーザーに一般提供されるようになりました。

    パフォーマンスとデータの充実度を高めるために複数のデータソースを使用してコンバージョンを送信する機能は、引き続き許可リストに登録されているアカウントでのみご利用いただけます。アカウントの追加をご希望の場合は、フォームにご記入ください。

    データ パートナーになることに関心がある場合は、パートナー登録フォームにご記入ください。

  • イベントとオーディエンスの取り込みリクエストの診断情報を取得するための RetrieveRequestStatus メソッドを追加しました。

  • ProductAccount の product フィールドと Product 列挙型は非推奨になりました。代わりに、account_type フィールドと新しい AccountType 列挙型を使用してください。

  • IngestAudienceMembersRequest の各 AudienceMember に destination を指定するサポートを追加しました。この機能を使用すると、1 つのリクエストでオーディエンス データを複数の異なる宛先に送信できます。

  • API で取り込まれたオーディエンスは、メンバー数が 100 人以上になるとターゲティングの対象になります。以前は、メンバーのしきい値は 1, 000 人でした。

  • オフライン コンバージョンまたはリードの拡張コンバージョンを送信する際に、Event の transaction_id がオプションになりました。パフォーマンスとデータの充実度を高めるために、オフライン コンバージョンを追加のデータソースとして送信する場合でも、transaction_id は必要です。

2025-08-06 v1.2

  • IngestEvents メソッドを使用して、Google 広告のリンク先にオフライン コンバージョンとリードの拡張コンバージョンを送信する機能を追加しました。これらのコンバージョンの暗号化を構成する方法については、更新された暗号化ガイドをご覧ください。
  • APP、IN_STORE、PHONE、OTHER の値を EventSource 列挙型に追加しました。オフライン コンバージョンとリードの拡張コンバージョンには event_source が必要です。
  • user_properties フィールドを Event に追加しました。このフィールドを UserProperties オブジェクトに設定すると、イベント発生時のユーザーに関する広告主評価情報を追加できます。
  • CustomVariable に destination_references 繰り返しフィールドを追加しました。このフィールドを使用すると、Event の宛先のサブセットにのみカスタム変数の値を適用できます。
  • オフライン コンバージョンとリードの拡張コンバージョンに関する次のエラーを追加しました。
    • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
    • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
    • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

  • IngestEvents メソッドを IngestionService に追加しました。タグ コンバージョンの追加のデータソースとして IngestEvents を使用すると、広告インタラクション シグナルを最大化し、データと全体的なパフォーマンスを強化できます。

2025-04-02 v1.0

  • Data Manager API の最初のリリース。Google 広告とディスプレイ＆ビデオ 360 へのオーディエンス データの送信をサポートしています。
  • gRPC と REST のサポートを追加しました。
  • IngestionService を追加しました。IngestAudienceMembers メソッドと RemoveAudienceMembers メソッドを使用して、次のデータタイプでオーディエンス メンバーを管理します。
  • Data Manager API を使用して管理されるオーディエンスは、メンバーが 1,000 人以上の場合にのみターゲティングの対象となります。