Method: events.ingest

Belirtilen 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 içeriği

İstek metni 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ıdır. İstek düzeyinde izin, isteğin 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ıdır. 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ıdır. 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. Yani içteki karma dize, dıştaki şifrelenmiş dizeden farklı bir şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.
encryptionInfo

object (EncryptionInfo)

İsteğe bağlıdır. 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 gövdesi

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,
  "conversionValue": number,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  }
}
Alanlar
destinationReferences[]

string

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

string

Zorunlu. Bu etkinliğin benzersiz tanımlayıcısı.
eventTimestamp

string (Timestamp format)

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

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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ıdır. Etkinliğin son güncellenme zamanı.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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ıdır. 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ıdır. İlişkili kullanıcının farklı türlerde izin verip vermediğiyle ilgili bilgiler.
adIdentifiers

object (AdIdentifiers)

İsteğe bağlıdır. 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ıdır. Bu etkinlikteki tüm parasal değerlerle ilişkili para birimi kodu.
conversionValue

number

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

enum (EventSource)

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

object (DeviceInfo)

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

object (CartData)

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

object (CustomVariable)

İsteğe bağlıdır. 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ıdır. 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ıdır. Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler.

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ıdır. Etkinlik ilişkilendirmesi ve modelleme için oturum özellikleri.
gclid

string

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

string

İsteğe bağlıdır. 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ıdır. 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ıdır. Reklamla etkileşimden sonra reklamverenin sitesine yönlendirme sırasında kullanılan cihazla ilgili toplanan bilgiler (varsa).

DeviceInfo

Etkinlik gerçekleştiğinde kullanılan cihazla ilgili bilgiler (varsa).

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

string

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

string

İsteğe bağlıdır. 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ılarla paylaşılmasını koşullu olarak hariç tutacak bir 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 ve 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ıdır. Öğelerle ilişkili Merchant Center kimliği.
merchantFeedLabel

string

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

string

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

number

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

object (Item)

İsteğe bağlıdır. 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
}
Alanlar
merchantProductId

string

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

string (int64 format)

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

number

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

Ö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ıdır. Ayarlanacak özelleştirilebilen değişkenin adı. Değişken, belirtilen hedef için bulunamazsa yoksayılır.
value

string

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

string

İsteğe bağlıdır. Özel değişkenin Event.destination_references değerlerinden hangisine gönderileceğini belirlemek için kullanılan referans dizesi. Boşsa 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ıdır. Kullanılacak alanın adı.
value

string

İsteğe bağlıdır. Alanın ayarlanacağı değer.

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)
}
Alanlar
customerType

enum (CustomerType)

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

enum (CustomerValueBucket)

İsteğe bağlıdır. Müşterinin reklamveren tarafından değerlendirilen değeri.

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.