イベントを送信する

このクイックスタートでは、イベントデータの送信について説明します。

次のいずれかのシナリオで Data Manager API を使用します。

  • Google 広告タグのコンバージョンまたは Google アナリティクスのキーイベントをタグのコンバージョンの追加のデータソースとして送信し、広告インタラクション シグナルを最大化して、データと全体的なパフォーマンスを強化します。

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

  • Google 広告のオフライン コンバージョンまたはリードの拡張コンバージョンのイベントデータを送信します。

表示するガイドのバージョンを選択してください。

このクイックスタートでは、次の手順を行います。

  1. イベントデータを受信する Destination を準備します。
  2. 送信するイベントデータを準備します。
  3. イベントの IngestionService リクエストをビルドします。
  4. Google APIs Explorer でリクエストを送信します。
  5. 成功レスポンスと失敗レスポンスを理解する。

デスティネーションを準備する

データを送信する前に、データの Destination を少なくとも 1 つ準備する必要があります。使用できる Destination のサンプルを次に示します。

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

Destination のフィールドは次のとおりです。

operatingAccount

イベントを受信するアカウント。

追加のデータソースとして送信されるイベントの場合、運用アカウントは Google 広告アカウントまたは Google アナリティクス プロパティのいずれかになります。accountType を GOOGLE_ADS または GOOGLE_ANALYTICS_PROPERTY に設定し、accountId を Google 広告のお客様 ID または Google アナリティクス プロパティ ID に設定します。accountType が GOOGLE_ANALYTICS_PROPERTY の場合、リクエストの認証情報は、プロパティの編集者または管理者ロールを持つ Google アナリティクス ユーザーのものである必要があります。

オフライン コンバージョンとリードの拡張コンバージョンの場合、オペレーティング アカウントは Google 広告アカウントである必要があります。そのため、accountType を GOOGLE_ADS に設定し、accountId を Google 広告の顧客 ID に設定します。

loginAccount

認証情報のユーザーがアクセスできるアカウント。

OAuth 認証情報が、operatingAccount をサブアカウントの 1 つとして持つ Google 広告クライアント センター（MCC）アカウントにアクセスできるユーザーのものである場合は、loginAccount が必要です。loginAccount の accountId をクライアント センター（MCC）アカウントの ID に設定し、loginAccount の accountType を GOOGLE_ADS に設定します。

OAuth 認証情報が operatingAccount に直接アクセスできるユーザーのものである場合、loginAccount を設定する必要はありません。デフォルトでは operatingAccount に設定されます。ただし、loginAccount は operatingAccount と同じ accountId と accountType に設定することをおすすめします。これにより、ユーザーがアクセスできるアカウントのセットが変更された場合に問題が発生するのを防ぐことができます。

productDestinationId

イベントを受け取る operatingAccount 内のエンティティの ID。

追加のデータソースとして送信されるイベントの場合、productDestinationId は、type が WEBPAGE に設定されている Google 広告コンバージョンの ID、または Google アナリティクス ウェブ ストリームの測定 ID である必要があります。イベントを Google アナリティクス iOS アプリまたは Android アプリ ストリームに追加のデータソースとして送信することはできません。

オフライン コンバージョンまたはリードの拡張コンバージョンの場合、productDestinationId は type が UPLOAD_CLICKS に設定されている Google 広告のコンバージョン アクションの ID である必要があります。

このガイドの例では、すべてのイベントを同じ宛先に送信するリクエストを作成する方法を示します。同じリクエストで複数の宛先にイベントを送信する場合は、複数の宛先にイベントを送信するをご覧ください。

イベントデータを準備する

次のイベントデータを考えてみましょう。各表は 1 つのコンバージョン イベントに対応しています。各コンバージョン イベントには、イベントのタイムスタンプ、コンバージョン アクション、コンバージョン値が含まれます。

各イベントには、gclid などの広告 ID や、メールアドレス、電話番号、住所情報などのユーザー ID が含まれている場合があります。イベントには次のものを含めることもできます。

  • イベント発生時に評価されたユーザーに関する情報（顧客の価値、新規顧客、リピーター、再エンゲージメントした顧客かどうかなど）。
  • ショッピング カートのデータ。
  • Google アナリティクスの client_id や user_id など、宛先の追加のイベント パラメータまたはユーザー プロパティ。

イベントデータは次のとおりです。

イベント 1

イベント #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 30.03
currency USD
gclid GCLID_1
emails
given_name John
family_name Smith-Jones
region_code us
postal_code 94045
customer_type NEW
customer_value_bucket HIGH
client_id 1234567890.1761581763
user_id user_ABC12345
ad_unit_name Banner_01
event_name purchase
カート内の商品
item_id SKU_12345
item_name Stan and Friends Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 2.22
item_index 0
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 10.01
item_quantity 3

イベント 2

イベント #2
conversion_time June 10, 2025 11:42:33PM America/New_York
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 42.02
currency eur
gclid GCLID_2
emails

zoe@EXAMPLE.COM

cloudy.sanfrancisco@gmail.com
given_name zoë
family_name pérez
region_code PT
postal_code 1229-076
customer_type RETURNING
client_id 9876543210.1761582117
user_id user_DEF9876
ad_unit_name Banner_02
event_name purchase
カート内の商品
item_id SKU_12346
item_name Google Grey Women's Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 3.33
item_index 1
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 21.01
item_quantity 2

データの形式を設定する

書式設定ガイドで指定されているとおりにフィールドをフォーマットします。フォーマット後のイベントデータは次のとおりです。

イベント 1

イベント #1
conversion_time 2025-06-10T15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 30.03
currency USD
gclid GCLID_1
emails
given_name john
family_name smith-jones
region_code US
postal_code 94045
customer_type NEW
customer_value_bucket HIGH
client_id 1234567890.1761581763
user_id user_ABC12345
ad_unit_name Banner_01
event_name purchase
カート内の商品
item_id SKU_12345
item_name Stan and Friends Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 2.22
item_index 0
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 10.01
item_quantity 3

イベント 2

イベント #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 42.02
currency EUR
gclid GCLID_2
emails

zoe@example.com

cloudysanfrancisco@gmail.com
given_name zoë
family_name pérez
region_code PT
postal_code 1229-076
customer_type RETURNING
client_id 9876543210.1761582117
user_id user_DEF9876
ad_unit_name Banner_02
event_name purchase
カート内の商品
item_id SKU_12346
item_name Google Grey Women's Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 3.33
item_index 1
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 21.01
item_quantity 2

データをハッシュ化してエンコードする

また、形式設定されたメールアドレス、名、姓は、SHA-256 アルゴリズムを使用してハッシュ化し、16 進数または Base64 エンコードを使用してエンコードする必要があります。16 進数エンコードを使用してフォーマット、ハッシュ化、エンコードを行った後のイベントデータは次のようになります。

イベント 1

イベント #1
conversion_time 2025-06-10T15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 30.03
currency USD
gclid GCLID_1
emails
given_name 96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A
family_name DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081
region_code US
postal_code 94045
customer_type NEW
customer_value_bucket HIGH
client_id 1234567890.1761581763
user_id user_ABC12345
ad_unit_name Banner_01
event_name purchase
カート内の商品
item_id SKU_12345
item_name Stan and Friends Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 2.22
item_index 0
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 10.01
item_quantity 3

イベント 2

イベント #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 42.02
currency EUR
gclid GCLID_2
emails

3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250

223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4
given_name 2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450
family_name 6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F
region_code PT
postal_code 1229-076
customer_type RETURNING
client_id 9876543210.1761582117
user_id user_DEF9876
ad_unit_name Banner_02
event_name purchase
カート内の商品
item_id SKU_12346
item_name Google Grey Women's Tee
item_affiliation Google Merchandise Store
item_coupon SUMMER_FUN
item_discount 3.33
item_index 1
item_brand Google
item_category Apparel
item_category2 Adult
item_category3 Shirts
item_category4 Crew
item_category5 Short sleeve
item_list_id related_products
item_list_name Related Products
item_price 21.01
item_quantity 2

データを Event オブジェクトに変換する

各イベントのフォーマット済みハッシュ化データを Event に変換します。次のフィールドに、次のように入力します。

  1. eventTimestamp をイベントが発生した時刻に設定します。

    Google アナリティクスのイベントには、過去 72 時間以内の eventTimestamp が必要です。

  2. ユースケースの必須フィールドを設定します。

    ユースケース 識別子 transactionId eventSource
    オフライン コンバージョンまたはリードの拡張コンバージョン 必須。次のうち少なくとも 1 つを設定します。
    • adIdentifiers で、gclid、gbraid、wbraid、sessionAttributes のうち少なくとも 1 つが設定されている
    • userData
    		 省略可 必須。EventSource の列挙型のいずれかの値に設定します。
    Google 広告の宛先に追加のデータソースとして送信されるイベント 必須。次のうち少なくとも 1 つを設定します。 必須 省略可。設定する場合は、WEB にする必要があります。
    Google アナリティクスの宛先に追加のデータソースとして送信されるイベント 必須。次のうち少なくとも 1 つを設定します。 必須 省略可。設定する場合は、WEB にする必要があります。

  3. イベントの値があるその他のフィールドに入力します。使用可能なフィールドの完全なリストについては、Event リファレンス ドキュメントをご覧ください。

Google アナリティクスの情報を追加する

追加のデータソースとして送信されるイベントのリンク先に Google アナリティクス プロパティが含まれている場合は、次のフィールドに指定された値を入力します。

eventName

必須。Google アナリティクス イベントの名前。

transactionId

必須。イベントの一意の識別子。

少なくとも 1 つの識別子

次のフィールドのうち少なくとも 1 つを設定する必要があります。

destinationReferences

リクエスト レベルの destinations リストに複数の Google アナリティクス Destination が含まれている場合は必須です。destinationReferences にエントリを追加して、イベントを受信する Google アナリティクスのリンク先を指定します。宛先参照の詳細については、複数の宛先にイベントを送信するをご覧ください。

destinationReferences が設定されていない場合や、Google アナリティクスの宛先を参照するエントリが複数ある場合、Data Manager API はエラー MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT でイベントを拒否します。

userId

省略可。ユーザーの User-ID。

additionalEventParameters

これは省略可能ですが、指定することをおすすめします。このリストには、他の Event フィールドで取得されない Google アナリティクス イベント パラメータを入力します。パラメータには、purchase イベントから推奨される追加のパラメータや、キャプチャするその他のパラメータを含めることができます。EventParameter の parameterName には、Google アナリティクスのパラメータ名を使用します。

たとえば、取引に関連付けられた税金がある場合は、parameterName を tax に設定し、value を税額に設定して、additionalEventParameters にエントリを追加します。

transactionId、currency、value の Google アナリティクス イベント パラメータのエントリを追加することはおすすめしません。代わりに、Event の transactionId、currency、conversionValue に値を入力します。これらの値は additionalEventParameters のエントリよりも優先されます。

購入イベントのカートデータを追加する

Event の cartData フィールドに、購入したアイテムに関する情報を入力します。購入されたアイテムごとに、CartData の items リストに Item オブジェクトを追加し、次のフィールドに示された値を入力します。

itemId
必須。アイテムの一意の識別子。
unitPrice

必須。税金、送料、イベント スコープ（トランザクション単位）の割引を除いた単価。

アイテムにアイテム スコープの割引がある場合は、割引単価を使用します。たとえば、商品の単価が 27.67 で、単位割引が 6.66 の場合、unitPrice を 21.01 に設定します。

quantity

必須。この特定の商品アイテムの購入数。

additionalItemParameters

このリストには、他の Item フィールドで取得されないアイテム スコープのパラメータを入力します。ItemParameter の parameterName には、Google アナリティクスのアイテム パラメータ名を使用します。

たとえば、アイテムのブランドとカテゴリがある場合は、parameterName を item_brand に、value をブランド名に設定したエントリをアイテムの additionalItemParameters に追加し、parameterName を item_category に、value をアイテムのカテゴリに設定した別のエントリを追加します。

quantity、price、item_id の Google アナリティクス アイテム パラメータのエントリを追加することはおすすめしません。代わりに、Item の itemId、unitPrice、quantity に値を入力します。これらの値は additionalItemParameters のエントリよりも優先されます。

以下は、2 つ目のイベントのフォーマット、ハッシュ化、エンコードされたデータの Event の例です。Google アナリティクスの追加データも含まれています。

{
  "adIdentifiers": {
     "gclid": "GCLID_2"
  },
  "conversionValue": 42.02,
  "currency": "EUR",
  "eventTimestamp": "2025-06-10T23:42:33-05:00",
  "transactionId": "DEF999911111",
  "eventSource": "WEB",
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
      },
      {
        "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
      },
      {
        "address": {
          "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
          "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
          "regionCode": "PT",
          "postalCode": "1229-076"
        }
      }
    ],
  },
  "userProperties": {
    "customerType": "RETURNING"
  },
  "eventName": "purchase",
  "clientId": "9876543210.1761582117",
  "userId": "user_DEF9876",
  "additionalEventParameters": [
    {
      "parameterName": "ad_unit_name",
      "value": "Banner_02"
    }
  ],
  "cartData": {
    "transactionDiscount": 6.66,
    "items": [
      {
        "itemId": "SKU_12346",
        "quantity": 2,
        "unitPrice": 21.01,
        "additionalItemParameters": [
          {
            "parameterName": "item_name",
            "value": "Google Grey Women's Tee"
          },
          {
            "parameterName": "affiliation",
            "value": "Google Merchandise Store"
          },
          {
            "parameterName": "coupon",
            "value": "SUMMER_FUN"
          },
          {
            "parameterName": "discount",
            "value": "3.33"
          },
          {
            "parameterName": "index",
            "value": "1"
          },
          {
            "parameterName": "item_brand",
            "value": "Google"
          },
          {
            "parameterName": "item_category",
            "value": "Apparel"
          },
          {
            "parameterName": "item_category2",
            "value": "Adult"
          },
          {
            "parameterName": "item_category3",
            "value": "Shirts"
          },
          {
            "parameterName": "item_category4",
            "value": "Crew"
          },
          {
            "parameterName": "item_category5",
            "value": "Short sleeve"
          },
          {
            "parameterName": "item_list_id",
            "value": "related_products"
          },
          {
            "parameterName": "item_list_name",
            "value": "Related Products"
          }
        ]
      }
    ]
  }
}

リクエストの本文を作成する

リクエスト本文の Destination と Events を組み合わせます。

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 30.03,
       "currency": "USD",
       "eventTimestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "NEW",
         "customerValueBucket": "HIGH"
       },
       "eventName": "purchase",
       "clientId": "1234567890.1761581763",
       "userId": "user_ABC12345",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_01"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12345",
             "quantity": 3,
             "unitPrice": 10.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Stan and Friends Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "2.22"
               },
               {
                 "parameterName": "index",
                 "value": "0"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]

       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 42.02,
       "currency": "EUR",
       "eventTimestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "RETURNING"
       },
       "eventName": "purchase",
       "clientId": "9876543210.1761582117",
       "userId": "user_DEF9876",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_02"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12346",
             "quantity": 2,
             "unitPrice": 21.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Google Grey Women's Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "3.33"
               },
               {
                 "parameterName": "index",
                 "value": "1"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]
       }
     }
  ],
  "validateOnly": true
}
  1. 本文のプレースホルダ（OPERATING_ACCOUNT_ID、PRODUCT_DESTINATION_ID など）を、アカウントと宛先の値に置き換えます。
  2. validateOnly を true に設定して、変更を適用せずにリクエストを検証します。変更を適用する準備ができたら、validateOnly を false に設定します。
  3. この例では暗号化を使用していません。

リクエストを送信する

  1. サンプルの右上にあるコピーボタンを使用して、リクエスト本文をコピーします。
  2. ツールバーの [API] ボタンをクリックします。
  3. コピーしたリクエスト本文を [リクエストの本文] ボックスに貼り付けます。
  4. [実行] ボタンをクリックし、承認プロンプトを完了して、レスポンスを確認します。

成功したレスポンス

リクエストが成功すると、requestId を含むオブジェクトを含むレスポンスが返されます。

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

返された requestId を記録して、リクエスト内の各宛先が処理されるときに診断を取得できるようにします。

失敗レスポンス

リクエストが失敗すると、400 Bad Request などのエラー レスポンス ステータス コードと、エラーの詳細を含むレスポンスが返されます。

たとえば、16 進数エンコード値ではなくプレーン テキスト文字列を含む emailAddress は、次のレスポンスを生成します。

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

ハッシュ化されず、16 進数エンコードのみが行われた emailAddress は、次のレスポンスを生成します。

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

複数の宛先にイベントを送信する

データに複数の宛先のイベントが含まれている場合は、宛先参照を使用して同じリクエストで送信できます。

たとえば、コンバージョン アクション ID 123456789 のイベントとコンバージョン アクション ID 777111122 のイベントがある場合は、各 Destination の reference を設定して、両方のイベントを 1 つのリクエストで送信します。reference はユーザー定義です。各 Destination に固有の reference があることが唯一の要件です。リクエストの変更後の destinations リストは次のとおりです。

  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID",
      "reference": "destination_a"
    },
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_2_TYPE",
        "accountId": "OPERATING_ACCOUNT_2_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_2_TYPE",
        "accountId": "LOGIN_ACCOUNT_2_ID"
      },

      "productDestinationId": "777111122",
      "reference": "destination_b"
    }
  ]

各 Event の destinationReferences を設定して、1 つ以上の特定の宛先に送信します。たとえば、最初の Destination のみの Event は次のようになります。この場合、destinationReferences リストには最初の Destination の reference のみが含まれます。

{
   "adIdentifiers": {
      "gclid": "GCLID_1"
   },
   "conversionValue": 1.99,
   "currency": "USD",
   "eventTimestamp": "2025-06-10T20:07:01Z",
   "transactionId": "ABC798654321",
   "eventSource": "WEB",
   "destinationReferences": [
      "destination_a"
   ]
}

destinationReferences フィールドはリストであるため、イベントの複数の宛先を指定できます。Event の destinationReferences を設定しない場合、Data Manager API はリクエスト内のすべての宛先にイベントを送信します。

イベントに複数の転送先がある場合、Data Manager API は関連するフィールドを各転送先に送信します。たとえば、イベントの宛先が Google 広告と Google アナリティクスの両方である場合、Google アナリティクス宛先にイベントを送信するときに、API には clientId や eventName などの Google アナリティクス フィールドが含まれ、Google 広告宛先にイベントを送信するときには、customVariables などの Google 広告フィールドが含まれます。

次のステップ

前へ
イベントの概要