- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Etkinlik
- AdIdentifiers
- EncryptedUserId
- EncryptionEntityType
- EncryptionSource
- EventSource
- CartData
- Öğe
- ItemParameter
- ItemCustomVariable
- CustomVariable
- ExperimentalField
- UserProperties
- CustomerType
- CustomerValueBucket
- UserProperty
- EventParameter
- EventLocation
- CallInfo
- Deneyin.
Sağlanan Destination dosyasından Event kaynaklarını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 ( |
| Alanlar | |
|---|---|
destinations[] |
Zorunlu. Etkinliklerin gönderileceği hedeflerin listesi. |
events[] |
Zorunlu. Belirtilen hedeflere gönderilecek etkinliklerin listesi. Tek bir istekte en fazla 2.000 |
consent |
İsteğe bağlıdır. İstekteki tüm kullanıcılar için geçerli olacak istek düzeyinde izin. Kullanıcı düzeyindeki izin, istek düzeyindeki izni geçersiz kılar ve her |
validateOnly |
İsteğe bağlıdır. Test amaçlıdır. |
encoding |
İsteğe bağlıdır. |
encryptionInfo |
İsteğe bağlıdı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,
"fieldWarnings": [
{
object ( |
| Alanlar | |
|---|---|
requestId |
İsteğin otomatik olarak üretilmiş kimliği. |
fieldWarnings[] |
Alan yollarıyla birlikte satır düzeyinde ayrıntılı uyarılar. |
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 etkinlik.
| JSON gösterimi |
|---|
{ "destinationReferences": [ string ], "transactionId": string, "eventTimestamp": string, "lastUpdatedTimestamp": string, "userData": { object ( |
| Alanlar | |
|---|---|
destinationReferences[] |
İsteğe bağlıdır. Hedefi belirlemek için kullanılan referans dizesi. Boş bırakılırsa etkinlik, istekteki tüm |
transactionId |
İsteğe bağlıdır. Bu etkinliğin benzersiz tanımlayıcısı. Etiket dönüşümleri için ek veri kaynağı olarak gönderilen etkinliklerde gereklidir. |
eventTimestamp |
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: |
lastUpdatedTimestamp |
İsteğe bağlıdır. Etkinliğin son güncellendiğ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: |
userData |
İsteğe bağlıdır. Etkinliğin ilişkilendirildiği kullanıcıyı temsil eden, kullanıcı tarafından sağlanan veriler. |
consent |
İsteğe bağlıdır. İlişkili kullanıcının farklı izin türleri verip vermediğiyle ilgili bilgiler. |
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 |
İsteğe bağlıdır. Bu etkinlikteki tüm maddi değerlerle ilişkili para birimi kodu. |
eventSource |
İsteğe bağlıdır. Etkinliğin nerede gerçekleştiğine dair sinyal (web, uygulama, mağaza içi vb.) |
eventDeviceInfo |
İsteğe bağlıdır. Etkinlik gerçekleştiğinde kullanılan cihaz (varsa) hakkında toplanan bilgiler. |
cartData |
İsteğe bağlıdır. Etkinlikle ilişkili işlem ve öğeler hakkında bilgi. |
customVariables[] |
İ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[] |
İsteğe bağlıdır. Zaman içinde API'nin bir parçası olacak şekilde yükseltilebilecek deneysel alanlar için anahtar/değer çiftlerinin listesi. |
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. |
eventName |
İsteğe bağlıdır. Etkinliğin adı. GA4 etkinlikleri için gereklidir. |
clientId |
İsteğe bağlıdır. Bu GA4 web akışı için bir web istemcisinin kullanıcı örneğinin benzersiz tanımlayıcısı. |
userId |
İsteğe bağlıdır. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı. |
additionalEventParameters[] |
İsteğe bağlıdır. Diğer yapılandırılmış alanlar kullanılarak henüz belirtilmemiş olan ve etkinliğe dahil edilecek tüm etkinlik parametrelerinin bir grubu. |
thirdPartyUserData |
İsteğe bağlıdır. userData'da sağlanan veri türüyle aynıdır ancak birinci taraf reklamveren verileri değil, üçüncü tarafa ait olarak sağlandığı açıkça işaretlenir. |
eventLocation |
İsteğe bağlıdır. Bu etkinlik gerçekleştiğinde kullanıcının konumu hakkında toplanan bilgiler. |
appInstanceId |
İsteğe bağlıdır. Bu GA4 uygulama veri akışı için bir uygulama istemcisinin kullanıcı örneğinin benzersiz tanımlayıcısı. |
callInfo |
İsteğe bağlıdır. Bu etkinliğe yol açan arama (varsa) hakkında toplanan bilgiler. |
conversionValue |
İsteğe bağlıdır. Değere dayalı dönüşümler için etkinlikle ilişkili dönüşüm değeri. |
conversionCount |
İsteğe bağlıdır. Sayım tabanlı dönüşümler için etkinlikle ilişkili dönüşüm miktarı. |
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 ( |
| Alanlar | |
|---|---|
sessionAttributes |
İsteğe bağlıdır. Etkinlik ilişkilendirme ve modelleme için oturum özellikleri. |
gclid |
İsteğe bağlıdır. Bu etkinlikle ilişkili Google tıklama kimliği (gclid). |
gbraid |
İ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 |
İ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 |
İsteğe bağlıdır. Reklamla etkileşim kurduktan sonra reklamverenin sitesine ulaşıldığı sırada kullanılan cihaz (varsa) hakkında toplanan bilgiler. |
mobileDeviceId |
İsteğe bağlıdır. Reklamverenler için mobil tanımlayıcı. Bu, iOS'te IDFA, Android'de AdID veya diğer platformların reklamverenler için tanımlayıcılarıdır. |
dclid |
İsteğe bağlıdır. Bu etkinlikle ilişkili görüntülü reklam tıklama kimliği. |
impressionId |
İsteğe bağlıdır. Bu etkinlikle ilişkili gösterim kimliği. |
matchId |
İsteğe bağlıdır. Bu etkinliği önceki bir etkinlikle birleştirmek için kullanılan eşleşme kimliği alanı. |
encryptedUserIds[] |
İsteğe bağlıdır. İstediğiniz sayıda şifrelenmiş kullanıcı kimliği. |
ppid |
İsteğe bağlıdır. Yayıncı tarafından tanımlanan, kimliği doğrulanmış (oturum açmış) bir kullanıcı için benzersiz tanımlayıcı. |
visitorPpid |
İsteğe bağlıdır. Yayıncı tarafından tanımlanan, kimliği doğrulanmamış bir kullanıcı (oturum açmamış kullanıcı) için benzersiz tanımlayıcı. |
leadId |
İsteğe bağlıdır. Kullanıcı potansiyel müşteri formu gönderdiğinde Google tarafından oluşturulan kimlik. |
EncryptedUserId
İlişkilendirme için kullanılmak üzere verilen kullanıcı kimliği. Bu alan kullanılıyorsa tüm alanların doldurulması zorunludur.
| JSON gösterimi |
|---|
{ "encryptedId": string, "entityType": enum ( |
| Alanlar | |
|---|---|
encryptedId |
Zorunlu. Alfanümerik şifrelenmiş kimlik. |
entityType |
Zorunlu. Şifreleme varlığı türü. Bu, reklam sunma veya Veri Aktarımı için şifreleme yapılandırmasıyla eşleşmelidir. |
entityId |
Zorunlu. Şifreleme varlığı kimliği. Bu, reklam sunma veya Veri Aktarımı için şifreleme yapılandırmasıyla eşleşmelidir. |
source |
Zorunlu. Şifrelenmiş çerezin reklam sunumundan (%m makrosu) mu yoksa Veri Aktarımı'ndan mı alındığını açıklar. |
EncryptionEntityType
Şifreleme varlığı türü.
| Sıralamalar | |
|---|---|
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED |
Şifreleme varlığı türü belirtilmedi. |
CAMPAIGN_MANAGER_ACCOUNT |
Campaign Manager 360 hesabı. |
CAMPAIGN_MANAGER_ADVERTISER |
Campaign Manager 360 reklamvereni. |
DISPLAY_VIDEO_PARTNER |
Display & Video 360 iş ortağı. |
DISPLAY_VIDEO_ADVERTISER |
Display & Video 360 reklamvereni. |
GOOGLE_ADS_CUSTOMER |
Google Ads müşterisi. |
GOOGLE_AD_MANAGER_NETWORK_CODE |
Google Ad Manager ağ kodu. |
EncryptionSource
Şifreleme kaynağı.
| Sıralamalar | |
|---|---|
ENCRYPTION_SOURCE_UNSPECIFIED |
Şifreleme kaynağı belirtilmemiş. |
AD_SERVING |
Reklam sunma şifreleme kaynağı. |
DATA_TRANSFER |
Veri aktarımı şifreleme kaynağı. |
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 uygulama tarafından oluşturuldu. |
IN_STORE |
Etkinlik, mağaza içi bir işlemden oluşturuldu. |
PHONE |
Etkinlik, bir telefon görüşmesinden oluşturuldu. |
MESSAGE |
Etkinlik bir mesajdan oluşturuldu. |
OTHER |
Etkinlik başka kaynaklardan oluşturulmuştur. |
CartData
Etkinlikle ilişkili alışveriş sepeti verileridir.
| JSON gösterimi |
|---|
{
"merchantId": string,
"merchantFeedLabel": string,
"merchantFeedLanguageCode": string,
"transactionDiscount": number,
"items": [
{
object ( |
| Alanlar | |
|---|---|
merchantId |
İsteğe bağlıdır. Öğelerle ilişkili Merchant Center kimliği. |
merchantFeedLabel |
İsteğe bağlıdır. Öğelerin feed'iyle ilişkili Merchant Center feed etiketi. |
merchantFeedLanguageCode |
İsteğe bağlıdır. Öğelerinizin yüklendiği Merchant Center feed'iyle ilişkili ISO 639-1 dil kodu. |
transactionDiscount |
İsteğe bağlıdır. İşlemle ilişkili tüm indirimlerin toplamı. |
items[] |
İsteğe bağlıdır. Etkinlikle ilişkili öğelerin listesi. |
couponCodes[] |
İsteğe bağlıdır. Alışveriş sepetine uygulanan kupon kodlarının listesi. Alışveriş sepeti düzeyindeki ve öğe düzeyindeki kupon kodları birbirinden bağımsızdır. Etkinlik bir Google Analytics hedefi içinse yalnızca tek bir kupon kodu sağlayın. Google Analytics, ek kupon kodlarını yok sayar. |
Öğe
Etkinlikle ilişkili alışveriş sepetindeki bir öğeyi temsil eder.
| JSON gösterimi |
|---|
{ "merchantProductId": string, "quantity": string, "unitPrice": number, "itemId": string, "additionalItemParameters": [ { object ( |
| Alanlar | |
|---|---|
merchantProductId |
İsteğe bağlıdır. Merchant Center hesabındaki ürün kimliği. |
quantity |
İsteğe bağlıdır. Etkinlikle ilişkili bu öğenin sayısı. |
unitPrice |
İsteğe bağlıdır. Vergi, gönderim bedeli ve işlem düzeyindeki tüm indirimler hariç birim fiyat. |
itemId |
İsteğe bağlıdır. Öğeye referans vermek için kullanılan benzersiz bir tanımlayıcı. |
additionalItemParameters[] |
İsteğe bağlıdır. Diğer yapılandırılmış alanlar kullanılarak henüz belirtilmemiş olan, etkinliğe dahil edilecek bir öğeyle ilgili etkinlik parametrelerinin bir grubu. |
merchantId |
İsteğe bağlıdır. Öğeyle ilişkili Merchant Center kimliği. Mağaza indirim etkinlikleri için bu, alışveriş sepeti düzeyinde ayarlanan değeri geçersiz kılar. Bu alan, diğer etkinlikler için yoksayılır. |
merchantFeedLabel |
İsteğe bağlıdır. Merchant Center feed'inin feed etiketi. Ülkeler hâlâ kullanılıyorsa bunun yerine ISO-3166-1 alfa-2'deki 2 harfli ülke kodu kullanılabilir. Mağaza indirim etkinlikleri için bu, alışveriş sepeti düzeyinde ayarlanan değeri geçersiz kılar. Bu alan, diğer etkinlikler için yoksayılır. |
merchantFeedLanguageCode |
İsteğe bağlıdır. Öğelerinizin yüklendiği Merchant Center feed'iyle ilişkili ISO 639-1 dil kodu. |
customVariables[] |
İsteğe bağlıdır. Öğe başına dönüşümleri izlerken dönüşüm kapsayıcılarına (dönüşüm işlemi veya Floodlight etkinliği) gönderilecek ek anahtar/değer çifti bilgileri. |
conversionValue |
İsteğe bağlıdır. Dönüşüm değerinin her öğe için farklı olduğu durumlarda, etkinlik içinde bu öğeyle ilişkili dönüşüm değeri. |
ItemParameter
Diğer yapılandırılmış alanlar kullanılarak henüz belirtilmemiş olan, etkinliğe dahil edilecek bir öğeyle ilgili etkinlik parametrelerinin bir grubu.
| JSON gösterimi |
|---|
{ "parameterName": string, "value": string } |
| Alanlar | |
|---|---|
parameterName |
Zorunlu. Kullanılacak parametrenin adı. |
value |
Zorunlu. Ayarlanacak parametre değerinin dize gösterimi. |
ItemCustomVariable
Reklam dönüşümleri için öğe düzeyinde özelleştirilebilen değişken.
| JSON gösterimi |
|---|
{ "variable": string, "value": string, "destinationReferences": [ string ] } |
| Alanlar | |
|---|---|
variable |
İ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 |
İsteğe bağlıdır. Özelleştirilebilen değişken için depolanacak değer. |
destinationReferences[] |
İsteğe bağlıdır. Özelleştirilebilen değişkenin hangi |
Ö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 |
İ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 |
İsteğe bağlıdır. Özelleştirilebilen değişken için depolanacak değer. |
destinationReferences[] |
İsteğe bağlıdır. Özelleştirilebilen değişkenin hangi |
ExperimentalField
Resmi olmayan alanları temsil eden deneysel alan.
| JSON gösterimi |
|---|
{ "field": string, "value": string } |
| Alanlar | |
|---|---|
field |
İsteğe bağlıdır. Kullanılacak alanın adı. |
value |
İsteğe bağlıdır. Alanın ayarlanacak 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 ( |
| Alanlar | |
|---|---|
customerType |
İsteğe bağlıdır. Etkinlikle ilişkili müşterinin türü. |
customerValueBucket |
İsteğe bağlıdır. Müşterinin reklamveren tarafından değerlendirilen değeri. |
additionalUserProperties[] |
İsteğe bağlıdır. Bu etkinlikle ilişkili kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir paket. |
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 yenidir. |
RETURNING |
Müşteri, reklamverene geri dönüyor. |
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ğerlidir. |
HIGH |
Müşteri yüksek değere sahiptir. |
UserProperty
Bu etkinlikle ilişkili kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir paket.
| JSON gösterimi |
|---|
{ "propertyName": string, "value": string } |
| Alanlar | |
|---|---|
propertyName |
Zorunlu. Kullanılacak kullanıcı özelliğinin adı. |
value |
Zorunlu. Kullanılacak kullanıcı özelliğinin değerinin dize gösterimi. |
EventParameter
GA4 etkinlikleri için etkinlik parametresi.
| JSON gösterimi |
|---|
{ "parameterName": string, "value": string } |
| Alanlar | |
|---|---|
parameterName |
Zorunlu. Kullanılacak parametrenin adı. |
value |
Zorunlu. Ayarlanacak parametre değerinin dize gösterimi. |
EventLocation
Etkinliğin gerçekleştiği konum.
| JSON gösterimi |
|---|
{ "storeId": string, "city": string, "subdivisionCode": string, "regionCode": string, "subcontinentCode": string, "continentCode": string } |
| Alanlar | |
|---|---|
storeId |
İsteğe bağlıdır. Mağaza satışları için gereklidir. Etkinliğin gerçekleştiği fiziksel mağazayı temsil eden tanımlayıcı. |
city |
İsteğe bağlıdır. Etkinliğin gerçekleştiği şehrin adı. |
subdivisionCode |
İsteğe bağlıdır. Etkinliğin gerçekleştiği ISO 3166-2 alt bölüm kodu. |
regionCode |
İsteğe bağlıdır. Kullanıcının adresinin 2 harfli CLDR bölge kodu. |
subcontinentCode |
İsteğe bağlıdır. Etkinliğin gerçekleştiği alt kıtanın UN M49 biçimindeki kodu. |
continentCode |
İsteğe bağlıdır. Etkinliğin gerçekleştiği kıtanın UN M49 biçimindeki kodu. |
CallInfo
Bu etkinliğe yol açan arama (varsa) hakkında toplanan bilgiler.
| JSON gösterimi |
|---|
{ "startTimestamp": string } |
| Alanlar | |
|---|---|
startTimestamp |
Zorunlu. Bu etkinlikle sonuçlanan telefon aramasının başladığı 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: |