Method: events.ingest

Sağlanan Destination içindeki Event kaynakların listesini yükler.

HTTP isteği

POST https://datamanager.googleapis.com/v1/events:ingest

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
Alanlar
destinations[]

object (Destination)

Zorunlu. Etkinliklerin gönderileceği hedeflerin listesi.
events[]

object (Event)

Zorunlu. Belirtilen hedeflere gönderilecek etkinliklerin listesi. Tek bir istekte en fazla 2.000 Event kaynağı gönderilebilir.
consent

object (Consent)

İsteğe bağlı. İstek düzeyinde izin, istekteki tüm kullanıcılar için geçerli olur. Kullanıcı düzeyinde izin, istek düzeyinde izni geçersiz kılar ve her Event içinde belirtilebilir.
validateOnly

boolean

İsteğe bağlı. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.
encoding

enum (Encoding)

İsteğe bağlı. UserData yüklemeleri için gereklidir. Kullanıcı tanımlayıcılarının kodlama türü. Karma oluşturulmuş kullanıcı tanımlayıcıları için bu, karma oluşturulmuş dizenin kodlama türüdür. Şifrelenmiş karma kullanıcı tanımlayıcıları için bu, içteki karma dizeyi değil, dıştaki şifrelenmiş dizenin kodlama türüdür. Bu nedenle, içteki karma dize, dıştaki şifrelenmiş dizeden farklı şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.
encryptionInfo

object (EncryptionInfo)

İsteğe bağlı. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

Yanıt metni

IngestEventsRequest tarafından verilen yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "requestId": string
}
Alanlar
requestId

string

İsteğin otomatik olarak oluşturulan kimliği.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

Etkinlik

Kullanıcının bir reklamverenin web sitesi veya uygulamasıyla etkileşimini temsil eden bir etkinlik.

JSON gösterimi 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  },
  "eventName": string,
  "clientId": string,
  "userId": string,
  "additionalEventParameters": [
    {
      object (EventParameter)
    }
  ],
  "conversionValue": number
}
Alanlar
destinationReferences[]

string

İsteğe bağlı. Hedefi belirlemek için kullanılan referans dizesi. Boş bırakılırsa etkinlik, istekteki tüm destinations'lara gönderilir.
transactionId

string

İsteğe bağlı. Bu etkinliğin benzersiz tanımlayıcısı. Birden fazla veri kaynağı kullanan dönüşümler için gereklidir.
eventTimestamp

string (Timestamp format)

Zorunlu. Etkinliğin gerçekleştiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastUpdatedTimestamp

string (Timestamp format)

İsteğe bağlı. Etkinliğin son güncellenme zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
userData

object (UserData)

İsteğe bağlı. Etkinliğin ilişkilendirildiği kullanıcıyı temsil eden, kullanıcı tarafından sağlanan veri parçaları.
consent

object (Consent)

İsteğe bağlı. İlişkili kullanıcının farklı türlerde izin verip vermediğiyle ilgili bilgiler.
adIdentifiers

object (AdIdentifiers)

İsteğe bağlı. Dönüşüm etkinliğini diğer online etkinliklerle (ör. reklam tıklamaları) eşleştirmek için kullanılan tanımlayıcılar ve diğer bilgiler.
currency

string

İsteğe bağlı. Bu etkinlikteki tüm parasal değerlerle ilişkili para birimi kodu.
eventSource

enum (EventSource)

İsteğe bağlı. Etkinliğin gerçekleştiği yerle ilgili sinyal (web, uygulama, mağaza vb.).
eventDeviceInfo

object (DeviceInfo)

İsteğe bağlı. Etkinlik gerçekleştiğinde kullanılan cihaz hakkında toplanan bilgiler (varsa).
cartData

object (CartData)

İsteğe bağlı. İşlem ve etkinlikle ilişkili öğeler hakkında bilgiler.
customVariables[]

object (CustomVariable)

İsteğe bağlı. Dönüşüm kapsayıcılarına (dönüşüm işlemi veya FL etkinliği) gönderilecek ek anahtar/değer çifti bilgileri.
experimentalFields[]

object (ExperimentalField)

İsteğe bağlı. Sonunda API'nin bir parçası olarak tanıtılabilecek deneysel alanlar için anahtar/değer çiftlerinin listesi.
userProperties

object (UserProperties)

İsteğe bağlı. Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler.
eventName

string

İsteğe bağlı. Etkinliğin adı. GA4 etkinlikleri için gereklidir.
clientId

string

İsteğe bağlı. Bu GA4 web akışı için bir web istemcisinin kullanıcı örneğinin benzersiz tanımlayıcısı.
userId

string

İsteğe bağlı. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı.
additionalEventParameters[]

object (EventParameter)

İsteğe bağlı. Diğer yapılandırılmış alanlar kullanılarak daha önce belirtilmemiş, etkinliğe dahil edilecek tüm etkinlik parametrelerinin bulunduğu bir grup.
conversionValue

number

İsteğe bağlı. Değere dayalı dönüşümler için etkinlikle ilişkili dönüşüm değeri.

AdIdentifiers

Dönüşüm etkinliğini diğer online etkinliklerle (ör. reklam tıklamaları) eşleştirmek için kullanılan tanımlayıcılar ve diğer bilgiler.

JSON gösterimi 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  }
}
Alanlar
sessionAttributes

string

İsteğe bağlı. Etkinlik ilişkilendirmesi ve modellemesi için oturum özellikleri.
gclid

string

İsteğe bağlı. Bu etkinlikle ilişkilendirilen Google tıklama kimliği (gclid).
gbraid

string

İsteğe bağlı. Uygulama etkinlikleriyle ilişkilendirilen ve iOS 14 veya sonraki sürümü yüklü iOS cihazlardan gelen tıklamalara yönelik tıklama tanımlayıcısı.
wbraid

string

İsteğe bağlı. Web etkinlikleriyle ilişkilendirilen ve iOS 14 veya sonraki sürümü yüklü iOS cihazlardan gelen tıklamalara yönelik tıklama tanımlayıcısı.
landingPageDeviceInfo

object (DeviceInfo)

İsteğe bağlı. Reklamla etkileşimden sonra reklamverenin sitesine yönlendirme sırasında kullanılan cihaz hakkında toplanan bilgiler (varsa).

DeviceInfo

Etkinlik gerçekleştiğinde kullanılan cihaz hakkında bilgiler (varsa).

JSON gösterimi 
{
  "userAgent": string,
  "ipAddress": string
}
Alanlar
userAgent

string

İsteğe bağlı. Belirli bir bağlam için cihazın kullanıcı aracısı dizesi.
ipAddress

string

İsteğe bağlı. Belirli bir bağlam için cihazın IP adresi.

Not: Google Ads, Avrupa Ekonomik Alanı (AEA), Birleşik Krallık (UK) veya İsviçre'deki (CH) son kullanıcılar için IP adresi eşleştirmeyi desteklemez. IP adreslerinin bu bölgelerdeki kullanıcılardan paylaşımını koşullu olarak hariç tutmak için mantık ekleyin ve kullanıcılara sitelerinizde, uygulamalarınızda ve diğer mülklerinizde topladığınız verilerle ilgili açık ve kapsamlı bilgiler sağladığınızdan, ayrıca yasalar veya geçerli Google politikaları uyarınca gerekli olduğu durumlarda izin aldığınızdan emin olun. Daha fazla bilgi için Çevrimdışı dönüşümlerin içe aktarılması hakkında başlıklı sayfayı inceleyin.

EventSource

Etkinliğin kaynağı.

Sıralamalar
EVENT_SOURCE_UNSPECIFIED Belirtilmemiş EventSource. Hiçbir zaman kullanılmamalıdır.
WEB Etkinlik bir web tarayıcısından oluşturuldu.
APP Etkinlik bir uygulamadan oluşturuldu.
IN_STORE Etkinlik, mağaza içi bir işlemden oluşturuldu.
PHONE Etkinlik, telefon görüşmesinden oluşturuldu.
OTHER Etkinlik, diğer kaynaklardan oluşturuldu.

CartData

Etkinlikle ilişkili alışveriş sepeti verileri.

JSON gösterimi 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Alanlar
merchantId

string

İsteğe bağlı. Öğelerle ilişkili Merchant Center kimliği.
merchantFeedLabel

string

İsteğe bağlı. Öğelerin feed'iyle ilişkili Merchant Center feed etiketi.
merchantFeedLanguageCode

string

İsteğe bağlı. Öğelerinizin yüklendiği Merchant Center feed'iyle ilişkili ISO 639-1 dil kodu.
transactionDiscount

number

İsteğe bağlı. İşlemle ilişkili tüm indirimlerin toplamı.
items[]

object (Item)

İsteğe bağlı. Etkinlikle ilişkili öğelerin listesi.

Öğe

Etkinlikle ilişkili alışveriş sepetindeki bir öğeyi temsil eder.

JSON gösterimi 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number,
  "itemId": string,
  "additionalItemParameters": [
    {
      object (ItemParameter)
    }
  ]
}
Alanlar
merchantProductId

string

İsteğe bağlı. Merchant Center hesabındaki ürün kimliği.
quantity

string (int64 format)

İsteğe bağlı. Etkinlikle ilişkilendirilmiş bu öğenin sayısı.
unitPrice

number

İsteğe bağlı. Vergi ve kargo ücretinin yanı sıra, işlem düzeyindeki tüm indirimler hariç birim fiyat.
itemId

string

İsteğe bağlı. Öğeye referans vermek için kullanılan benzersiz tanımlayıcı.
additionalItemParameters[]

object (ItemParameter)

İsteğe bağlı. Diğer yapılandırılmış alanlar kullanılarak daha önce belirtilmemiş, etkinliğe dahil edilecek bir öğeyle ilgili tüm etkinlik parametrelerinin bulunduğu bir grup.

ItemParameter

Diğer yapılandırılmış alanlar kullanılarak daha önce belirtilmemiş, etkinliğe dahil edilecek bir öğeyle ilgili tüm etkinlik parametrelerinin bulunduğu bir grup.

JSON gösterimi 
{
  "parameterName": string,
  "value": string
}
Alanlar
parameterName

string

Zorunlu. Kullanılacak parametrenin adı.
value

string

Zorunlu. Ayarlanacak parametrenin değerinin dize gösterimi.

ÖzelleştirilebilenDeğişken

Reklam dönüşümleri için özelleştirilebilen değişken.

JSON gösterimi 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
Alanlar
variable

string

İsteğe bağlı. Ayarlanacak özelleştirilebilen değişkenin adı. Değişken, belirtilen hedef için bulunamazsa yoksayılır.
value

string

İsteğe bağlı. Özelleştirilebilen değişken için depolanacak değer.
destinationReferences[]

string

İsteğe bağlı. Özel değişkenin Event.destination_references değerlerinden hangisine gönderileceğini belirlemek için kullanılan referans dizesi. Boş bırakılırsa Event.destination_references kullanılır.

ExperimentalField

Resmi olmayan alanları temsil eden deneysel alan.

JSON gösterimi 
{
  "field": string,
  "value": string
}
Alanlar
field

string

İsteğe bağlı. Kullanılacak alanın adı.
value

string

İsteğe bağlı. Ayarlanacak alanın değeri.

UserProperties

Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler. Daha fazla bilgi için https://support.google.com/google-ads/answer/14007601 adresini ziyaret edin.

JSON gösterimi 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket),
  "additionalUserProperties": [
    {
      object (UserProperty)
    }
  ]
}
Alanlar
customerType

enum (CustomerType)

İsteğe bağlı. Etkinlikle ilişkili müşterinin türü.
customerValueBucket

enum (CustomerValueBucket)

İsteğe bağlı. Müşterinin reklamveren tarafından değerlendirilen değeri.
additionalUserProperties[]

object (UserProperty)

İsteğe bağlı. Bu etkinlikle ilişkilendirilen kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir grup.

CustomerType

Etkinlikle ilişkili müşterinin türü.

Sıralamalar
CUSTOMER_TYPE_UNSPECIFIED Belirtilmemiş CustomerType. Hiçbir zaman kullanılmamalıdır.
NEW Müşteri, reklamveren için yeni olmalıdır.
RETURNING Müşteri, reklamverene geri dönüyorsa
REENGAGED Müşteri, reklamverenle yeniden etkileşime geçmiştir.

CustomerValueBucket

Müşterinin reklamveren tarafından değerlendirilen değeri.

Sıralamalar
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Belirtilmemiş CustomerValueBucket. Hiçbir zaman kullanılmamalıdır.
LOW Müşterinin değeri düşük.
MEDIUM Müşteri, orta değere sahip.
HIGH Müşteri yüksek değere sahip.

UserProperty

Bu etkinlikle ilişkilendirilen kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir grup.

JSON gösterimi 
{
  "propertyName": string,
  "value": string
}
Alanlar
propertyName

string

Zorunlu. Kullanılacak kullanıcı özelliğinin adı.
value

string

Zorunlu. Kullanılacak kullanıcı özelliği değerinin dize gösterimi.

EventParameter

GA4 etkinlikleri için etkinlik parametresi.

JSON gösterimi 
{
  "parameterName": string,
  "value": string
}
Alanlar
parameterName

string

Zorunlu. Kullanılacak parametrenin adı.
value

string

Zorunlu. Ayarlanacak parametrenin değerinin dize gösterimi.