Halaman ini diterjemahkan oleh Cloud Translation API.

Mengirim peristiwa

Anda dapat mempelajari panduan memulai ini untuk memahami cara mengirim data peristiwa.

Gunakan Data Manager API untuk salah satu skenario berikut:

Kirim konversi tag Google Ads atau peristiwa utama Google Analytics sebagai sumber data tambahan untuk konversi tag Anda, guna memaksimalkan sinyal interaksi iklan dan memperkuat data serta performa keseluruhan Anda.

Fitur ini hanya tersedia untuk akun yang ada dalam daftar yang diizinkan. Isi formulir jika Anda tertarik untuk menambahkan akun Google Ads atau properti Google Analytics Anda.

Catatan: Data dari sumber data tambahan yang Anda hubungkan tidak akan mengalir ke bidding konversi Anda selama periode uji coba 14 hari. Hal ini tidak berlaku untuk sumber data tag Google Anda yang sudah ada.
Mengirim data peristiwa untuk konversi offline Google Ads atau konversi yang disempurnakan untuk prospek.

Pilih versi panduan yang ingin Anda lihat:

Dalam panduan memulai ini, Anda akan menyelesaikan langkah-langkah berikut:

Siapkan Destination untuk menerima data peristiwa.
Siapkan data peristiwa untuk dikirim.
Buat permintaan IngestionService untuk peristiwa.
Kirim permintaan dengan Google APIs Explorer.
Memahami respons berhasil dan gagal.

Menyiapkan tujuan

Sebelum dapat mengirim data, Anda harus menyiapkan setidaknya satu Destination untuk data tersebut. Berikut contoh Destination yang dapat Anda gunakan:

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

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

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

Berikut adalah kolom Destination:

operatingAccount

Akun yang menerima peristiwa.

Untuk peristiwa yang dikirim sebagai sumber data tambahan, akun operasi dapat berupa akun Google Ads atau properti Google Analytics. Tetapkan accountType ke GOOGLE_ADS atau GOOGLE_ANALYTICS_PROPERTY, dan tetapkan accountId ke ID pelanggan Google Ads atau ID properti Google Analytics. Jika accountType adalah GOOGLE_ANALYTICS_PROPERTY, kredensial permintaan harus ditujukan untuk pengguna Google Analytics dengan peran Editor atau Administrator untuk properti tersebut.

Untuk konversi offline dan konversi yang disempurnakan untuk prospek, akun operasi harus berupa akun Google Ads, jadi tetapkan accountType ke GOOGLE_ADS dan tetapkan accountId ke ID pelanggan Google Ads.

loginAccount

Akun tempat pengguna kredensial memiliki akses.

Jika kredensial OAuth Anda ditujukan untuk pengguna yang memiliki akses ke akun pengelola Google Ads yang memiliki operatingAccount sebagai salah satu sub-akunnya, maka loginAccount diperlukan. Tetapkan accountId dari loginAccount ke ID akun pengelola, dan tetapkan accountType dari loginAccount ke GOOGLE_ADS.

Jika kredensial OAuth Anda ditujukan untuk pengguna dengan akses langsung ke operatingAccount, Anda tidak perlu menetapkan loginAccount dan secara default akan ditetapkan ke operatingAccount. Namun, sebaiknya tetapkan loginAccount ke accountId dan accountType yang sama dengan operatingAccount. Tindakan ini membantu menghindari masalah jika kumpulan akun yang dapat diakses pengguna berubah.

productDestinationId

ID entitas di operatingAccount yang menerima peristiwa.

Untuk peristiwa yang dikirim sebagai sumber data tambahan, productDestinationId harus berupa ID konversi Google Ads dengan type ditetapkan ke WEBPAGE, atau ID pengukuran dari aliran data Web Google Analytics. Anda tidak dapat mengirim peristiwa sebagai sumber data tambahan ke aliran aplikasi iOS atau Android Google Analytics.

Untuk konversi offline atau konversi yang disempurnakan untuk prospek, productDestinationId harus berupa ID tindakan konversi Google Ads dengan type ditetapkan ke UPLOAD_CLICKS.

Contoh dalam panduan ini menunjukkan cara membuat permintaan yang mengirim setiap peristiwa ke tujuan yang sama. Jika Anda ingin mengirim peristiwa untuk beberapa tujuan dalam permintaan yang sama, lihat mengirim peristiwa untuk beberapa tujuan.

Menyiapkan data peristiwa

Pertimbangkan data peristiwa berikut. Setiap tabel sesuai dengan satu peristiwa konversi. Setiap peristiwa konversi memiliki stempel waktu peristiwa, tindakan konversi, dan nilai konversinya.

Setiap peristiwa mungkin memiliki ID iklan, seperti gclid, atau ID pengguna, seperti alamat email, nomor telepon, dan informasi alamat. Peristiwa juga dapat memiliki:

Informasi tentang pengguna yang dievaluasi pada saat peristiwa, seperti nilai pelanggan atau apakah mereka pelanggan baru, lama, atau yang kembali berinteraksi.
Data keranjang belanja.
Parameter peristiwa atau properti pengguna tambahan untuk tujuan, seperti client_id atau user_id untuk Google Analytics.

Berikut data peristiwa:

Acara 1

Acara #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 keranjang
`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`

Acara 2

Acara #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 keranjang
`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`

Memformat data

Format kolom sesuai dengan yang ditentukan dalam panduan pemformatan. Berikut data peristiwa setelah diformat:

Acara 1

Acara #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 keranjang
`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`

Acara 2

Acara #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 keranjang
`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`

Melakukan hash dan mengenkode data

Selain itu, alamat email, nama panggilan, dan nama keluarga yang diformat harus di-hash menggunakan algoritma SHA-256 dan dienkode menggunakan encoding hex atau Base64. Berikut adalah data peristiwa setelah diformat, di-hash, dan dienkode menggunakan encoding hex:

Acara 1

Acara #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 keranjang
`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`

Acara 2

Acara #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 keranjang
`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`

Mengonversi data menjadi objek `Event`

Konversi data yang diformat dan di-hash dari setiap peristiwa menjadi Event. Isi kolom berikut seperti yang ditunjukkan:

Tetapkan eventTimestamp ke waktu saat acara terjadi.

Peristiwa untuk Google Analytics harus memiliki eventTimestamp dalam 72 jam terakhir.

Tetapkan kolom wajib diisi untuk kasus penggunaan Anda.

Kasus penggunaan	Pengenal	`transactionId`	`eventSource`
Konversi offline atau konversi yang disempurnakan untuk prospek	Wajib diisi. Tetapkan setidaknya salah satu dari berikut ini: `adIdentifiers` dengan setidaknya satu dari `gclid`, `gbraid`, `wbraid`, atau `sessionAttributes` yang ditetapkan `userData`	Opsional	Wajib diisi. Tetapkan ke salah satu nilai enum untuk `EventSource`.
Peristiwa yang dikirim sebagai sumber data tambahan ke tujuan Google Ads	Wajib diisi. Tetapkan setidaknya salah satu dari berikut ini: `adIdentifiers` dengan setidaknya salah satu dari `gclid`, `gbraid`, atau `wbraid` yang ditetapkan `userData`	Wajib	Opsional. Jika ditetapkan, harus `WEB`.
Peristiwa yang dikirim sebagai sumber data tambahan ke tujuan Google Analytics	Wajib diisi. Tetapkan setidaknya salah satu dari berikut ini: `clientId` `adIdentifiers` dengan `gclid` ditetapkan `userData`	Wajib	Opsional. Jika ditetapkan, harus `WEB`.

Isi kolom lainnya jika Anda memiliki nilai untuk peristiwa tersebut. Lihat dokumentasi referensi Event untuk mengetahui daftar lengkap kolom yang tersedia.

Menambahkan informasi Google Analytics

Jika tujuan untuk peristiwa yang dikirim sebagai sumber data tambahan mencakup properti Google Analytics, isi kolom berikut seperti yang ditunjukkan:

eventName

Wajib diisi. Nama peristiwa Google Analytics.

transactionId

Wajib diisi . ID unik untuk peristiwa.

Minimal satu ID

Setidaknya salah satu kolom berikut harus disetel:

clientId: ID unik untuk instance pengguna klien web. Lihat Mengirim peristiwa ke Measurement Protocol.
adIdentifiers.gclid: ID Klik Google.
userData: ID untuk pengguna, seperti alamat email, nomor telepon, atau informasi alamat.

destinationReferences

Wajib jika daftar destinations tingkat permintaan berisi lebih dari satu Destination Google Analytics. Tambahkan entri ke destinationReferences untuk menentukan tujuan Google Analytics yang harus menerima peristiwa. Lihat mengirim peristiwa ke beberapa tujuan untuk mengetahui informasi selengkapnya tentang referensi tujuan.

Jika destinationReferences tidak disetel atau memiliki beberapa entri yang merujuk ke tujuan Google Analytics, Data Manager API akan menolak peristiwa dengan error MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT.

userId

Opsional. User-ID untuk pengguna.

additionalEventParameters

Opsional, tetapi direkomendasikan. Isi daftar ini dengan parameter peristiwa Google Analytics yang tidak tercatat di kolom Event lainnya. Parameter dapat mencakup parameter tambahan yang direkomendasikan dari peristiwa purchase, atau parameter lain yang ingin Anda ambil. Gunakan nama parameter Google Analytics untuk parameterName dari EventParameter.

Misalnya, jika Anda memiliki pajak yang terkait dengan transaksi, tambahkan entri ke additionalEventParameters dengan parameterName ditetapkan ke tax, dan value ditetapkan ke biaya pajak.

Sebaiknya jangan menambahkan entri untuk parameter peristiwa Google Analytics transactionId, currency, atau value. Sebagai gantinya, isi transactionId, currency, dan conversionValue dari Event, yang lebih diprioritaskan daripada entri apa pun di additionalEventParameters.

Menambahkan data keranjang untuk peristiwa pembelian

Isi kolom cartData dari Event dengan informasi tentang item yang dibeli. Untuk setiap item yang dibeli, tambahkan objek Item ke daftar items CartData dan isi kolom berikut seperti yang ditunjukkan:

itemId

Wajib. ID unik untuk item.

unitPrice

Wajib diisi. Harga satuan tidak termasuk pajak, pengiriman, dan diskon cakupan peristiwa (tingkat transaksi).

Jika item memiliki diskon cakupan item, gunakan harga per unit diskon. Misalnya, jika item memiliki harga satuan 27.67 dan diskon satuan 6.66, tetapkan unitPrice ke 21.01.

quantity

Wajib diisi. Jumlah unit yang dibeli untuk item tertentu ini.

additionalItemParameters

Isi daftar ini dengan parameter cakupan item yang tidak tercakup dalam kolom Item lainnya. Gunakan nama parameter item Google Analytics untuk parameterName dari ItemParameter.

Misalnya, jika Anda memiliki merek dan kategori untuk suatu item, tambahkan entri ke additionalItemParameters item dengan parameterName ditetapkan ke item_brand dan value ditetapkan ke nama merek, serta entri lain dengan parameterName ditetapkan ke item_category dan value ditetapkan ke kategori item.

Sebaiknya jangan menambahkan entri untuk parameter item Google Analytics quantity, price, atau item_id. Sebagai gantinya, isi itemId, unitPrice, dan quantity dari Item, yang lebih diprioritaskan daripada entri apa pun di additionalItemParameters.

Berikut contoh Event untuk data yang diformat, di-hash, dan dienkode dari peristiwa kedua, dengan data tambahan untuk Google Analytics:

{
  "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"
          }
        ]
      }
    ]
  }
}

Buat isi permintaan

Gabungkan Destination dan Events untuk isi permintaan:

{
  "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
}

Perbarui placeholder di isi, seperti OPERATING_ACCOUNT_ID dan PRODUCT_DESTINATION_ID dengan nilai untuk akun dan tujuan Anda.
Tetapkan validateOnly ke true untuk memvalidasi permintaan tanpa menerapkan perubahan. Jika Anda sudah siap untuk menerapkan perubahan, tetapkan validateOnly ke false.
Perhatikan bahwa contoh ini tidak menggunakan enkripsi.

Kirim permintaan

Salin isi permintaan menggunakan tombol salin di kanan atas contoh.
Klik tombol API di toolbar.
Tempelkan isi permintaan yang disalin ke dalam kotak Isi permintaan.
Klik tombol Execute, selesaikan perintah otorisasi, dan tinjau responsnya.

Respons keberhasilan

Permintaan yang berhasil akan menampilkan respons dengan objek yang berisi requestId.

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

Catat requestId yang ditampilkan sehingga Anda dapat mengambil diagnostik saat setiap tujuan dalam permintaan diproses.

Respons kegagalan

Permintaan yang gagal akan menghasilkan kode status respons error seperti 400 Bad Request, dan respons dengan detail error.

Misalnya, emailAddress yang berisi string teks biasa, bukan nilai yang dienkode hex, akan menghasilkan respons berikut:

{
  "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"
          }
        ]
      }
    ]
  }
}

emailAddress yang tidak di-hash dan hanya dienkode hex menghasilkan respons berikut:

{
  "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"
          }
        ]
      }
    ]
  }
}

Mengirim peristiwa untuk beberapa tujuan

Jika data Anda berisi peristiwa untuk tujuan yang berbeda, Anda dapat mengirimkannya dalam permintaan yang sama menggunakan referensi tujuan.

Misalnya, jika Anda memiliki peristiwa untuk ID tindakan konversi 123456789 dan peristiwa lain untuk ID tindakan konversi 777111122, kirim kedua peristiwa dalam satu permintaan dengan menetapkan reference setiap Destination. reference ditentukan pengguna. Satu-satunya persyaratan adalah setiap Destination memiliki reference unik. Berikut daftar destinations yang diubah untuk permintaan:

  "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"
    }
  ]

Tetapkan destinationReferences setiap Event untuk mengirimkannya ke satu atau beberapa tujuan tertentu. Misalnya, berikut adalah Event yang hanya untuk Destination pertama, sehingga daftar destinationReferences-nya hanya berisi reference dari Destination pertama:

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

Kolom destinationReferences adalah daftar, sehingga Anda dapat menentukan beberapa tujuan untuk suatu peristiwa. Jika Anda tidak menetapkan destinationReferences dari Event, Data Manager API akan mengirim peristiwa ke semua tujuan dalam permintaan.

Jika suatu peristiwa memiliki beberapa tujuan, Data Manager API akan mengirimkan kolom yang relevan ke setiap tujuan. Misalnya, jika peristiwa memiliki tujuan Google Ads dan tujuan Google Analytics, API akan menyertakan kolom Google Analytics seperti clientId atau eventName saat mengirim peristiwa ke tujuan Google Analytics, dan menyertakan kolom Google Ads seperti customVariables saat mengirim peristiwa ke tujuan Google Ads.

Langkah berikutnya

Konfigurasi autentikasi dan siapkan lingkungan Anda dengan library klien.
Pelajari persyaratan pemformatan, hashing, dan encoding untuk setiap jenis data.
Pelajari cara mengenkripsi data pengguna.
Pelajari cara mengambil diagnostik untuk permintaan Anda.
Pelajari praktik terbaik.
Pelajari batas dan kuota.

Sebelumnya

Ringkasan peristiwa

Mengirim peristiwa Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Menyiapkan tujuan

Menyiapkan data peristiwa

Acara 1

Acara 2

Memformat data

Acara 1

Acara 2

Melakukan hash dan mengenkode data

Acara 1

Acara 2

Mengonversi data menjadi objek Event

Menambahkan informasi Google Analytics

Menambahkan data keranjang untuk peristiwa pembelian

Buat isi permintaan

Kirim permintaan

Respons keberhasilan

Respons kegagalan

Mengirim peristiwa untuk beberapa tujuan

Langkah berikutnya

Mengirim peristiwa

Mengonversi data menjadi objek `Event`