Etkinlikleri gönder

Etkinlik verilerini gönderme hakkında bilgi edinmek için bu hızlı başlangıç kılavuzunu inceleyebilirsiniz.

Aşağıdaki senaryolardan birinde Veri Yöneticisi API'sini kullanın:

• Reklam etkileşimi sinyallerini en üst düzeye çıkarmak, verilerinizi ve genel performansınızı güçlendirmek için Google Ads etiketi dönüşümlerini veya Google Analytics önemli etkinliklerini etiket dönüşümleriniz için ek bir veri kaynağı olarak gönderin.

  Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir. Google Ads hesabınızı veya Google Analytics mülkünüzü eklemek istiyorsanız formu doldurun.

• Google Ads çevrimdışı dönüşümleri veya potansiyel müşteriler için gelişmiş dönüşümler için etkinlik verilerini gönderin.

Görmek istediğiniz kılavuz sürümünü seçin:

Reklamveren Veri İş Ortağı

Bu hızlı başlangıç kılavuzunda aşağıdaki adımları tamamlayacaksınız:

1. Etkinlik verilerini almak için bir Destination hazırlayın.
2. Gönderilecek etkinlik verilerini hazırlayın.
3. Etkinlikler için IngestionService isteği oluşturun.
4. İsteği Google API Gezgini ile gönderin.
5. Başarı ve hata yanıtlarını anlama

Hedefleri hazırlama

Veri gönderebilmek için verilerle ilgili en az bir Destination hazırlamanız gerekir. Kullanabileceğiniz örnek bir Destination aşağıda verilmiştir:

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

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

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

Destination alanları şunlardır:

operatingAccount

Etkinlikleri alan hesap.

Ek bir veri kaynağı olarak gönderilen etkinlikler için işletim hesabı, Google Ads hesabı veya Google Analytics mülkü olabilir. accountType öğesini GOOGLE_ADS veya GOOGLE_ANALYTICS_PROPERTY olarak, accountId öğesini ise Google Ads müşteri kimliği veya Google Analytics mülk kimliği olarak ayarlayın. accountType GOOGLE_ANALYTICS_PROPERTY ise isteğin kimlik bilgileri, mülk için Düzenleyici veya Yönetici rolüne sahip bir Google Analytics kullanıcısına ait olmalıdır.

Çevrimdışı dönüşümler ve potansiyel müşteriler için gelişmiş dönüşümlerde, işlem hesabının bir Google Ads hesabı olması gerekir. Bu nedenle, accountType değerini GOOGLE_ADS olarak, accountId değerini ise Google Ads müşteri kimliği olarak ayarlayın.

loginAccount

Kimlik bilgisinin kullanıcısının erişebildiği hesap.

OAuth kimlik bilgileriniz, alt hesaplarından biri operatingAccount olan bir Google Ads yönetici hesabına erişimi olan bir kullanıcıya aitse loginAccount gereklidir. loginAccount öğesinin accountId değerini yönetici hesabının kimliği olarak, loginAccount öğesinin accountType değerini ise GOOGLE_ADS olarak ayarlayın.

OAuth kimlik bilgileriniz, operatingAccount öğesine doğrudan erişimi olan bir kullanıcıya aitse loginAccount ayarlamanız gerekmez ve varsayılan olarak operatingAccount olur. Ancak loginAccount değerini operatingAccount ile aynı accountId ve accountType olarak ayarlamanızı öneririz. Bu, kullanıcının erişebileceği hesaplar kümesi değiştiğinde sorun yaşanmasını önlemeye yardımcı olur.

productDestinationId

Etkinlikleri alan operatingAccount içindeki varlığın kimliği.

Ek bir veri kaynağı olarak gönderilen etkinlikler için productDestinationId, WEBPAGE olarak ayarlanmış type ile bir Google Ads dönüşümünün kimliği veya bir Google Analytics web akışının ölçüm kimliği olmalıdır. Etkinlikleri, Google Analytics iOS uygulaması veya Android uygulaması akışına ek bir veri kaynağı olarak gönderemezsiniz.

Çevrimdışı dönüşümler veya potansiyel müşteriler için gelişmiş dönüşümlerde productDestinationId, type değeri UPLOAD_CLICKS olarak ayarlanmış bir Google Ads dönüşüm işleminin kimliği olmalıdır.

Bu kılavuzdaki örnekte, her etkinliği aynı hedefe gönderen bir isteğin nasıl oluşturulacağı gösterilmektedir. Aynı istekte birden fazla hedef için etkinlik göndermek istiyorsanız Birden fazla hedef için etkinlik gönderme başlıklı makaleyi inceleyin.

Etkinlik verilerini hazırlama

Aşağıdaki etkinlik verilerini göz önünde bulundurun. Her tablo bir dönüşüm etkinliğine karşılık gelir. Her dönüşüm etkinliğinde etkinliğin zaman damgası, dönüşüm işlemi ve dönüşüm değeri bulunur.

Her etkinlikte gclid gibi reklam tanımlayıcıları veya e-posta adresleri, telefon numaraları ve adres bilgileri gibi kullanıcı tanımlayıcıları olabilir. Bir etkinlikte şunlar da olabilir:

• Etkinlik sırasında değerlendirilen kullanıcıyla ilgili bilgiler (ör. müşterinin değeri veya yeni, geri gelen ya da yeniden etkileşime giren bir müşteri olup olmadığı).
• Alışveriş sepeti verileri.
• Bir hedef için ek etkinlik parametreleri veya kullanıcı özellikleri (ör. Google Analytics için client_id veya user_id).

Etkinlik verileri:

Verileri biçimlendirme

Alanları, biçimlendirme kılavuzunda belirtildiği şekilde biçimlendirin. Biçimlendirmeden sonraki etkinlik verileri:

Verileri anonimleştirme ve kodlama

Ayrıca, biçimlendirilmiş e-posta adresleri, adlar ve soyadlar SHA-256 algoritması kullanılarak karma oluşturma işlemine tabi tutulmalı ve onaltılık veya Base64 kodlaması kullanılarak kodlanmalıdır. Biçimlendirme, karma oluşturma ve onaltılık kodlama kullanılarak kodlama işlemlerinden sonraki etkinlik verileri aşağıda verilmiştir:

Verileri Event nesnelerine dönüştürme

Her etkinliğin biçimlendirilmiş ve karma oluşturma işlemi uygulanmış verilerini Event olarak dönüştürün. Aşağıdaki alanları belirtildiği şekilde doldurun:

1. eventTimestamp değerini etkinliğin gerçekleştiği zamana ayarlayın.

   Google Analytics etkinlikleri son 72 saat içinde bir eventTimestamp içermelidir.

2. Kullanım alanınız için zorunlu alanları ayarlayın.

   Kullanım alanı	Tanımlayıcılar	transactionId	eventSource
   Çevrimdışı dönüşümler veya potansiyel müşteriler için gelişmiş dönüşümler	Zorunludur. Aşağıdakilerden en az birini ayarlayın: adIdentifiers gclid, gbraid, wbraid veya sessionAttributes özelliklerinden en az biri ayarlanmış olmalıdır. userData	İsteğe bağlı	Zorunludur. EventSource için enum değerlerinden birine ayarlayın.
   Google Ads hedefi için ek veri kaynağı olarak gönderilen etkinlikler	Zorunludur. Aşağıdakilerden en az birini ayarlayın: adIdentifiers gclid, gbraid veya wbraid değerlerinden en az biri ayarlanmış olmalıdır. userData	Zorunlu	İsteğe bağlıdır. Ayarlanırsa WEB olmalıdır.
   Google Analytics hedefi için ek veri kaynağı olarak gönderilen etkinlikler	Zorunludur. Aşağıdakilerden en az birini ayarlayın: clientId gclid ayarlı adIdentifiers userData	Zorunlu	İsteğe bağlıdır. Ayarlanırsa WEB olmalıdır.

3. Etkinlikle ilgili bir değerinizin olduğu diğer alanları doldurun. Kullanılabilir alanların tam listesi için Event referans belgelerine bakın.

Google Analytics bilgilerini ekleme

Ek veri kaynağı olarak gönderilen bir etkinliğin hedefleri arasında Google Analytics mülkü varsa aşağıdaki alanları belirtildiği şekilde doldurun:

eventName

Zorunludur. Google Analytics etkinliğinin adı.

transactionId

Zorunludur . Etkinliğin benzersiz tanımlayıcısı.

En az bir tanımlayıcı

Aşağıdaki alanlardan en az biri ayarlanmalıdır:

• clientId: Web istemcisinin kullanıcı örneği için benzersiz tanımlayıcı. Measurement Protocol'e etkinlik gönderme başlıklı makaleyi inceleyin.

• adIdentifiers.gclid: Google tıklama kimliği.

• userData: Kullanıcıya ait tanımlayıcılar (ör. e-posta adresleri, telefon numaraları veya adres bilgileri).

destinationReferences

İstek düzeyindeki destinations listesi birden fazla Google Analytics Destination içeriyorsa zorunludur. Hangi Google Analytics hedefinin etkinliği alacağını belirtmek için destinationReferences öğesine bir giriş ekleyin. Hedef referansları hakkında daha fazla bilgi için Etkinlikleri birden fazla hedefe gönderme başlıklı makaleyi inceleyin.

destinationReferences ayarlanmamışsa veya Google Analytics hedeflerine atıfta bulunan birden fazla giriş varsa Veri Yöneticisi API'si, etkinliği MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT hatasıyla reddeder.

userId

İsteğe bağlıdır. Kullanıcının User-ID'si.

additionalEventParameters

İsteğe bağlıdır ancak önerilir. Bu listeyi, diğer Event alanlarında yakalanmayan tüm Google Analytics etkinlik parametreleriyle doldurun. Parametreler, purchase etkinliğinden ek önerilen parametreleri veya yakalamak istediğiniz diğer parametreleri içerebilir. EventParameter için parameterName Google Analytics parametre adını kullanın.

Örneğin, bir işlemle ilişkili vergileriniz varsa additionalEventParameters öğesine bir giriş ekleyin. Bu girişte parameterName, tax olarak, value ise vergi maliyeti olarak ayarlanmalıdır.

transactionId, currency veya value Google Analytics etkinlik parametreleri için giriş eklemenizi önermiyoruz. Bunun yerine, additionalEventParameters'daki girişlerden öncelikli olan Event'ün transactionId, currency ve conversionValue alanlarını doldurun.

Satın alma etkinlikleri için alışveriş sepeti verileri ekleme

Event alanını, satın alınan öğelerle ilgili bilgilerle doldurun.cartData Satın alınan her öğe için CartData öğesinin items listesine bir Item nesnesi ekleyin ve aşağıdaki alanları belirtildiği şekilde doldurun:

itemId

Zorunludur. Öğenin benzersiz tanımlayıcısı.

unitPrice

Zorunludur. Vergi, kargo ve etkinlik kapsamındaki (işlem düzeyinde) indirimler hariç birim fiyat.

Öğede öğe kapsamlı bir indirim varsa indirimli birim fiyatını kullanın. Örneğin, bir öğenin birim fiyatı 27.67 ve birim indirimi 6.66 ise unitPrice özelliğini 21.01 olarak ayarlayın.

quantity

Zorunludur. Bu öğe için satın alınan birim miktarı.

additionalItemParameters

Bu listeyi, diğer Item alanlarında yakalanmayan tüm öğe kapsamlı parametrelerle doldurun. ItemParameter parameterName için Google Analytics öğe parametresi adını kullanın.

Örneğin, bir öğenin markası ve kategorisi varsa additionalItemParameters özelliğine parameterName değeri item_brand ve value değeri marka adı olarak ayarlanmış bir giriş, parameterName değeri item_category ve value değeri öğenin kategorisi olarak ayarlanmış başka bir giriş ekleyin.

quantity, price veya item_id Google Analytics öğe parametreleri için giriş eklemenizi önermiyoruz. Bunun yerine, additionalItemParameters'deki girişlere göre öncelikli olan Item'ün itemId, unitPrice ve quantity alanlarını doldurun.

İkinci etkinlikten alınan biçimlendirilmiş, karma oluşturulmuş ve kodlanmış veriler için Google Analytics'e yönelik ek veriler içeren örnek bir Event aşağıda verilmiştir:

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

İstek gövdesini oluşturma

İstek gövdesi için Destination ve Events değerlerini birleştirin:

{
  "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. Gövdedeki yer tutucuları (ör. OPERATING_ACCOUNT_ID ve PRODUCT_DESTINATION_ID) hesabınızın ve hedefinizin değerleriyle güncelleyin.
2. Değişiklikleri uygulamadan isteği doğrulamak için validateOnly değerini true olarak ayarlayın. Değişiklikleri uygulamaya hazır olduğunuzda validateOnly seçeneğini false olarak ayarlayın.
3. Bu örnekte şifreleme kullanılmadığını unutmayın.

İsteği gönderin

1. Örneğin sağ üst kısmındaki kopyalama düğmesini kullanarak istek gövdesini kopyalayın.
2. Araç çubuğunda API düğmesini tıklayın.
3. Kopyalanan istek gövdesini İstek gövdesi kutusuna yapıştırın.
4. Execute (Çalıştır) düğmesini tıklayın, yetkilendirme istemlerini tamamlayın ve yanıtı inceleyin.

Başarılı yanıtlar

Başarılı bir istek, requestId içeren bir nesneyle yanıt döndürür.

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

İstek işlenirken her hedef için tanılama bilgilerini alabilmek amacıyla requestId döndürülenleri kaydedin.

Hata yanıtları

Başarısız bir istek, 400 Bad Request gibi bir hata yanıtı durum kodu ve hata ayrıntılarını içeren bir yanıtla sonuçlanır.

Örneğin, onaltılık kodlanmış değer yerine düz metin dizesi içeren bir emailAddress aşağıdaki yanıtı üretir:

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

Karma oluşturulmamış ve yalnızca on altılık olarak kodlanmış bir emailAddress aşağıdaki yanıtı üretir:

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

Birden fazla hedef için etkinlik gönderme

Verileriniz farklı hedeflere yönelik etkinlikler içeriyorsa hedef referanslarını kullanarak bunları aynı istekte gönderebilirsiniz.

Örneğin, dönüşüm işlemi kimliği 123456789 için bir etkinliğiniz ve dönüşüm işlemi kimliği 777111122 için başka bir etkinliğiniz varsa her Destination için reference değerini ayarlayarak her iki etkinliği de tek bir istekte gönderin. reference, kullanıcı tarafından tanımlanır. Tek koşul, her Destination öğesinin benzersiz bir reference içermesidir. İstek için değiştirilmiş destinations listesi aşağıda verilmiştir:

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

Her Event öğesinin destinationReferences değerini, bir veya daha fazla belirli hedefe gönderecek şekilde ayarlayın. Örneğin, burada yalnızca ilk Event için olan bir Destination var. Bu nedenle, destinationReferences listesinde yalnızca ilk Destination'nin reference yer alıyor:

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

destinationReferences alanı bir liste olduğundan bir etkinlik için birden fazla hedef belirtebilirsiniz. Bir destinationReferences öğesinin Event değerini ayarlamazsanız Veri Yöneticisi API'si, etkinliği istekteki tüm hedeflere gönderir.

Bir etkinliğin birden fazla hedefi varsa Veri Yöneticisi API'si ilgili alanları her hedefe gönderir. Örneğin, bir etkinliğin Google Ads hedefi ve Google Analytics hedefi varsa API, etkinliği Google Analytics hedefine gönderirken clientId veya eventName gibi Google Analytics alanlarını, etkinliği Google Ads hedefine gönderirken ise customVariables gibi Google Ads alanlarını içerir.

Sonraki adımlar

• Kimlik doğrulama yapılandırın ve ortamınızı bir istemci kitaplığıyla ayarlayın.
• Her veri türü için biçimlendirme, karma oluşturma ve kodlama koşulları hakkında bilgi edinin.
• Kullanıcı verilerini nasıl şifreleyeceğinizi öğrenin.
• İstekleriniz için teşhis bilgilerini nasıl alacağınızı öğrenin.
• En iyi uygulamalar hakkında bilgi edinin.
• Sınırlar ve kotalar hakkında bilgi edinin.