イベントを送信する

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

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

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

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

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

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

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

移行先を準備する

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

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

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  • operatingAccount の accountId を、イベントデータを受け取る Google 広告アカウントの ID に設定します。operatingAccount の accountType は GOOGLE_ADS である必要があります。

  • productDestinationId をイベントのコンバージョン アクションの ID に設定します。オンライン イベントの場合、コンバージョン アクションは type が WEBPAGE に設定されている Google 広告のコンバージョン アクションである必要があります。オフライン イベントの場合、コンバージョン アクションは、type が UPLOAD_CLICKS に設定されている Google 広告のコンバージョン アクションである必要があります。

    このガイドでは、すべてのイベントを同じコンバージョン アクションに送信するリクエストを作成する方法について説明します。同じリクエストで複数のコンバージョン アクションのイベントを送信する場合は、複数の宛先をご覧ください。

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

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

各イベントには、gclid などの広告 ID や、メールアドレス、電話番号、住所情報などのユーザー ID が含まれている場合があります。イベントには、イベント発生時に評価されたユーザーに関する情報（顧客の価値、新規顧客、リピーター、再エンゲージメント顧客のいずれであるかなど）を含めることもできます。

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

イベント #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
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

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

イベント #2
conversion_time June 10, 2025 11:42:33PM America/New_York
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
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

データの形式を設定する

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

イベント #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
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

書式設定後の 2 つ目のイベントのデータは次のようになります。

イベント #2
conversion_time 2025-06-10T23:42:33-05:00
conversion_action_id 123456789
transaction_id DEF999911111
conversion_value 3.25
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

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

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

イベント #1
conversion_time 2025-06-10 15:07:01-05:00
conversion_action_id 123456789
transaction_id ABC798654321
conversion_value 1.99
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

16 進数エンコードを使用してフォーマット、ハッシュ化、エンコードを行った後の 2 つ目のイベントのデータは次のようになります。

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

3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250

223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4
given_name 2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450
family_name 6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F
region_code PT
postal_code 1229-076
customer_type RETURNING

データを Event に変換する

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

  • event_timestamp: イベントが発生した時刻。
  • event_source: イベントのソース。オフライン イベントで必須です。オンライン イベントの場合は省略可。オンライン イベントに指定する場合は、WEB である必要があります。
  • ad_identifiers または user_data: イベントには、広告 ID またはユーザーデータのいずれかが含まれている必要があります。イベントの両方がある場合は、両方を送信します。

パフォーマンスとデータ強度を高めるためにオフライン コンバージョンを追加のデータソースとして送信する場合は、transaction_id が必要です。それ以外の場合、transaction_id は省略可能ですが、指定することをおすすめします。

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

2 番目のイベントのフォーマット、ハッシュ化、エンコードされたデータの Event のサンプルを次に示します。

{
   "adIdentifiers": {
      "gclid": "GCLID_2"
   },
   "conversionValue": 3.25,
   "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"
      }
   }
}

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

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

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

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 1.99,
       "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"
       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 3.25,
       "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"
       }
     }
  ],
  "validateOnly": true
}
  1. 本文のプレースホルダ（OPERATING_ACCOUNT_ID、CONVERSION_ACTION_1_ID など）を、アカウントと宛先の値に置き換えます。
  2. validateOnly を true に設定して、変更を適用せずにリクエストを検証します。変更を適用する準備ができたら、validateOnly を false に設定します。
  3. この例では暗号化を使用していません。

リクエストを送信する

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

成功したレスポンス

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

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

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

失敗レスポンス

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

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

{
  "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 進数エンコードのみが行われた email_address は、次のレスポンスを生成します。

{
  "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": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "123456789",
      "reference": "conversion_action_1"
    },
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

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

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

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

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

次のステップ

前へ
イベントの概要