ConversionAction

Dönüşüm işlemi

JSON gösterimi
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Alanlar
resourceName

string

Sabit. Dönüşüm işleminin kaynak adı. Dönüşüm işlemi kaynak adları şu biçimdedir:

customers/{customerId}/conversionActions/{conversion_action_id}

status

enum (ConversionActionStatus)

Dönüşüm etkinliği tahakkuku için bu dönüşüm işleminin durumu.

type

enum (ConversionActionType)

Sabit. Bu dönüşüm işleminin türü.

origin

enum (ConversionOrigin)

Yalnızca çıkış. Bu dönüşüm işleminin dönüşüm kaynağı.

category

enum (ConversionActionCategory)

Bu dönüşüm işlemi için raporlanan dönüşüm kategorisi.

valueSettings

object (ValueSettings)

Bu dönüşüm işlemiyle ilişkili dönüşüm etkinliklerinin değeriyle ilgili ayarlar.

countingType

enum (ConversionActionCountingType)

Dönüşüm işlemi için dönüşüm etkinliklerini sayma

attributionModelSettings

object (AttributionModelSettings)

Bu dönüşüm işleminin ilişkilendirme modeliyle ilgili ayarlar.

tagSnippets[]

object (TagSnippet)

Yalnızca çıkış. Dönüşümleri izlemek için kullanılan snippet'ler.

mobileAppVendor

enum (MobileAppVendor)

Yalnızca çıkış. Bir uygulama dönüşüm işlemi için mobil uygulama tedarikçi firması.

firebaseSettings

object (FirebaseSettings)

Yalnızca çıkış. Firebase dönüşüm türleri için Firebase ayarları.

thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Yalnızca çıkış. Üçüncü taraf dönüşüm türleri için Üçüncü Taraf Uygulama Analizi ayarları.

googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Yalnızca çıkış. Google Analytics 4 dönüşüm türleri için Google Analytics 4 ayarları.

id

string (int64 format)

Yalnızca çıkış. Dönüşüm işleminin kimliği.

name

string

Dönüşüm işleminin adı.

Yeni dönüşüm işlemleri oluştururken bu alan zorunludur ve boş bırakılmamalıdır.

primaryForGoal

boolean

Bir dönüşüm işleminin primaryForGoal biti yanlışsa dönüşüm işlemi, müşteri dönüşüm hedefi veya kampanya dönüşüm hedefinden bağımsız olarak hiçbir kampanyada teklif verilebilir değildir. Ancak özel dönüşüm hedefleri, primaryForGoal hedefine uymadığından, bir kampanyada primaryForGoal = yanlış dönüşüm işlemi ile yapılandırılmış bir özel dönüşüm hedefi varsa bu dönüşüm işlemi teklif verilebilir olmaya devam eder. Varsayılan olarak, birincil ForGoal ayarlanmazsa true (doğru) değerine ayarlanır. V9'da, primaryForGoal yalnızca bir "güncelleme" işlemiyle oluşturulduktan sonra isteğe bağlı olarak bildirilmediğinden "false" değerine ayarlanabilir.

ownerCustomer

string

Yalnızca çıkış. Dönüşüm işlemi sahibi müşterinin kaynak adı. Sistem tanımlı bir dönüşüm işlemiyse null.

includeInConversionsMetric

boolean

Bu dönüşüm işleminin "dönüşümler" metriğine dahil edilip edilmeyeceği.

clickThroughLookbackWindowDays

string (int64 format)

Etkileşim (ör. tıklama) ile dönüşüm etkinliği arasında geçebilecek maksimum gün sayısı.

viewThroughLookbackWindowDays

string (int64 format)

Gösterim ile etkileşimin olmadığı bir dönüşüm arasında geçebilecek maksimum gün sayısı.

phoneCallDurationSeconds

string (int64 format)

Sonrasında bu dönüşüm işlemi için bir dönüşümün raporlanması gereken, saniye cinsinden telefon araması süresi.

Değer 0 ile 10.000 arasında (0 ve 10.000 dahil) olmalıdır.

appId

string

Bir uygulama dönüşüm işleminin uygulama kimliği.

ConversionActionStatus

Dönüşüm işleminin olası durumları.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ENABLED Dönüşümler kaydedilir.
REMOVED Dönüşümler kaydedilmez.
HIDDEN Dönüşümler kaydedilmez ve dönüşüm işlemi kullanıcı arayüzünde görünmez.

ConversionActionType

Olası dönüşüm işlemi türleri.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AD_CALL Kullanıcılar bir reklamın telefon uzantısını tıkladığında gerçekleşen dönüşümler.
CLICK_TO_CALL Mobil cihaz kullanıcısı bir telefon numarasını tıkladığında gerçekleşen dönüşümler.
GOOGLE_PLAY_DOWNLOAD Bir kullanıcı Google Play Store'dan bir mobil uygulama indirdiğinde gerçekleşen dönüşümler.
GOOGLE_PLAY_IN_APP_PURCHASE Bir kullanıcı Android faturalandırması üzerinden bir uygulamada satın alma işlemi gerçekleştirdiğinde oluşan dönüşümler.
UPLOAD_CALLS Reklamveren tarafından izlenen ve yüklenen telefon araması dönüşümleri.
UPLOAD_CLICKS Reklamveren tarafından izlenen ve ilişkilendirilen tıklamalarla yüklenen dönüşümler.
WEBPAGE Bir web sayfasında gerçekleşen dönüşümler.
WEBSITE_CALL Kullanıcılar, reklamverenin web sitesinden dinamik olarak oluşturulan bir telefon numarasını aradığında gerçekleşen dönüşümlerdir.
STORE_SALES_DIRECT_UPLOAD Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine dayalı Mağaza Satışları dönüşümü. Mağaza satışları doğrudan yükleme türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir.
STORE_SALES Birinci taraf veya üçüncü taraf satıcı verisi yüklemelerine ve/veya ödeme ağlarındaki kartlar kullanılarak yapılan mağazada satın alma işlemlerine dayalı Mağaza Satışları dönüşümü. Mağaza satışı türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir. Salt okunur.
FIREBASE_ANDROID_FIRST_OPEN Firebase üzerinden izlenen Android uygulaması ilk açılış dönüşümleri.
FIREBASE_ANDROID_IN_APP_PURCHASE Android uygulamasının uygulama içi satın alma dönüşümleri Firebase üzerinden izlenir.
FIREBASE_ANDROID_CUSTOM Firebase üzerinden izlenen Android uygulaması özel dönüşümleri.
FIREBASE_IOS_FIRST_OPEN Firebase üzerinden izlenen iOS uygulaması ilk açılış dönüşümleri.
FIREBASE_IOS_IN_APP_PURCHASE iOS uygulaması uygulama içi satın alma dönüşümleri Firebase üzerinden izlenir.
FIREBASE_IOS_CUSTOM Firebase üzerinden izlenen iOS uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Üçüncü Taraf Uygulama Analizleri ile izlenen Android uygulaması ilk açılış dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Android uygulaması uygulama içi satın alma dönüşümleri Üçüncü Taraf Uygulama Analizleri ile izlenir.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Üçüncü Taraf Uygulama Analizleri ile izlenen Android uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Üçüncü Taraf Uygulama Analizi ile izlenen iOS uygulaması ilk açılış dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Üçüncü Taraf Uygulama Analizleri ile izlenen iOS uygulaması uygulama içi satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Üçüncü Taraf Uygulama Analizleri ile izlenen iOS uygulaması özel dönüşümleri.
ANDROID_APP_PRE_REGISTRATION Bir kullanıcı Google Play Store'dan bir mobil uygulamaya ön kayıt yaptırdığında gerçekleşen dönüşümler. Salt okunur.
ANDROID_INSTALLS_ALL_OTHER_APPS Uygulamaya özgü bir türe göre izlenmeyen tüm Google Play indirmelerini izleyen dönüşümler. Salt okunur.
FLOODLIGHT_ACTION Kullanıcıların, bir reklamverenin reklamlarından birini gördükten veya tıkladıktan sonra belirli bir web sayfasını kaç kez ziyaret ettiklerini sayan Floodlight etkinliği. Salt okunur.
FLOODLIGHT_TRANSACTION Yapılan satış sayısını veya satın alınan öğe sayısını izleyen Floodlight etkinliği. Her satışın toplam değerini de yakalayabilirsiniz. Salt okunur.
GOOGLE_HOSTED Bir reklamla etkileşimde bulunduktan sonra Google ürün ve hizmetlerinden yerel işlemleri izleyen dönüşümler. Salt okunur.
LEAD_FORM_SUBMIT Bir kullanıcı potansiyel müşteri formu gönderdiğinde raporlanan dönüşümler. Salt okunur.
SALESFORCE Salesforce'tan gelen dönüşümler. Salt okunur.
SEARCH_ADS_360 Search Ads 360 Floodlight verilerinden içe aktarılan dönüşümler. Salt okunur.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Akıllı kampanya özel ölçütleri kullanılarak, arama izleme kurulumu olmadan Akıllı kampanya Reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Kullanıcı, Google Haritalar'da bir çağrı öğesini tıklar. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_MAP_DIRECTIONS Kullanıcı, Google Haritalar'daki bir işletme konumu için yol tarifi istiyor. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_TRACKED_CALLS Akıllı kampanya özel ölçütleri kullanılarak telefon araması izleme kurulumuyla Akıllı kampanya Reklamlarında gerçekleşen telefon araması dönüşümleri. Salt okunur.
STORE_VISITS Kullanıcılar bir reklamverenin perakende mağazasını ziyaret ettiğinde oluşan dönüşümler. Salt okunur.
WEBPAGE_CODELESS Ayrı ayrı kodlanmış etkinlik snippet'leri kullanmayan web sitesi etkinliklerinden (form gönderimleri veya sayfa yüklemeleri gibi) oluşturulan dönüşümler. Salt okunur.
UNIVERSAL_ANALYTICS_GOAL Bağlı Universal Analytics hedeflerinden gelen dönüşümler.
UNIVERSAL_ANALYTICS_TRANSACTION Bağlı Universal Analytics işlemlerinden gelen dönüşümler
GOOGLE_ANALYTICS_4_CUSTOM Bağlı Google Analytics 4 özel etkinlik dönüşümlerinden gelen dönüşümler.
GOOGLE_ANALYTICS_4_PURCHASE Bağlı Google Analytics 4 satın alma dönüşümlerinden gelen dönüşümler.

ValueSettings

Bu dönüşüm işlemiyle ilişkili dönüşüm etkinliklerinin değeriyle ilgili ayarlar.

JSON gösterimi
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Alanlar
defaultValue

number

Bu dönüşüm işlemi için dönüşüm etkinlikleri geçersiz, izin verilmeyen veya eksik bir değerle gönderildiğinde ya da bu dönüşüm işlemi her zaman varsayılan değeri kullanacak şekilde yapılandırıldığında kullanılacak değer.

defaultCurrencyCode

string

Bu dönüşüm işlemi için dönüşüm etkinlikleri geçersiz veya eksik bir para birimi koduyla gönderildiğinde ya da bu dönüşüm işlemi her zaman varsayılan değeri kullanacak şekilde yapılandırıldığında kullanılacak para birimi kodu.

alwaysUseDefaultValue

boolean

Bu dönüşüm işlemi için dönüşüm etkinliklerinde belirtilen değer ve para birimi kodunun yerine varsayılan değerin ve varsayılan para birimi kodunun kullanılıp kullanılmayacağını kontrol eder.

ConversionActionCountingType

Bu işlem için dönüşümlerin nasıl sayılacağını gösterir. Daha fazla bilgi için https://support.google.com/google-ads/answer/3438531 adresini inceleyin.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
ONE_PER_CLICK Tıklama başına yalnızca bir dönüşüm sayın.
MANY_PER_CLICK Tıklama başına tüm dönüşümleri sayın.

AttributionModelSettings

Bu dönüşüm işleminin ilişkilendirme modeliyle ilgili ayarlar.

JSON gösterimi
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Alanlar
attributionModel

enum (AttributionModel)

Bu dönüşüm işleminin ilişkilendirme modeli türü.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

Yalnızca çıkış. Dönüşüm işlemi için veriye dayalı ilişkilendirme modelinin durumu.

AttributionModel

Belirli bir dönüşüm için kredinin potansiyel olarak önceki birçok etkileşime nasıl dağıtılacağını açıklayan ilişkilendirme modeli.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
EXTERNAL Harici ilişkilendirme kullanılır.
GOOGLE_ADS_LAST_CLICK Bir dönüşüme ilişkin tüm krediyi son tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Bir dönüşüme ilişkin tüm krediyi, Google Arama ilişkilendirmesi kullanarak ilk tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google Arama ilişkilendirmesi kullanarak dönüşümlerin kredisini tüm tıklamaları arasında eşit şekilde ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google Arama ilişkilendirmesi kullanarak bir dönüşüme katlanarak daha fazla kredi atar (yarı ömür 1 haftadır).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Bir dönüşüm için kredinin% 40'ını ilk ve son tıklamalarıyla ilişkilendirir. Kalan% 20, tüm diğer tıklamalar arasında eşit bir şekilde dağıtılır. Bu, Google Arama ilişkilendirmesi kullanır.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Kredinin tıklamalar arasında uygun dağıtımını belirlemek için Google Arama ilişkilendirmesi kullanılarak makine öğrenimini kullanan esnek model.

DataDrivenModelStatus

Veriye dayalı model durumlarını sıralar.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
AVAILABLE Veriye dayalı model kullanılabilir.
STALE Veriye dayalı model eski. En az 7 gündür güncellenmemiş. Bu bilgiler hâlâ kullanılıyor ancak 30 gün boyunca güncellenmezse süresi dolacak.
EXPIRED Veriye dayalı modelin süresi doldu. En az 30 gündür güncellenmemiş ve kullanılamaz. Bunun en yaygın nedeni, son 30 günlük dönemde gereken sayıda etkinlik olmamasıdır.
NEVER_GENERATED Veriye dayalı model hiç oluşturulmadı. Bunun en yaygın nedeni, 30 günlük bir dönemde gereken sayıda etkinlik gerçekleşmemiş olmasıdır.

FirebaseSettings

Bir Firebase dönüşüm işlemiyle ilgili ayarlar.

JSON gösterimi
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Alanlar
propertyId

string (int64 format)

Yalnızca çıkış. Dönüşümün GA mülk kimliği.

propertyName

string

Yalnızca çıkış. Dönüşümün GA mülkü adı.

eventName

string

Yalnızca çıkış. Bir Firebase dönüşümünün etkinlik adı.

projectId

string

Yalnızca çıkış. Dönüşümün Firebase proje kimliği.

ThirdPartyAppAnalyticsSettings

Üçüncü taraf uygulama analizi dönüşüm işlemiyle ilgili ayarlar.

JSON gösterimi
{
  "providerName": string,
  "eventName": string
}
Alanlar
providerName

string

Yalnızca çıkış. Üçüncü taraf uygulama analizi sağlayıcısının adı.

eventName

string

Yalnızca çıkış. Bir üçüncü taraf uygulama analizi dönüşümünün etkinlik adı.

GoogleAnalytics4Settings

Bir Google Analytics 4 dönüşüm işlemiyle ilgili ayarlar.

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

string

Yalnızca çıkış. GA 4 etkinliğinin adı.

propertyName

string

Yalnızca çıkış. GA 4 mülkünün adı.

propertyId

string (int64 format)

Yalnızca çıkış. GA 4 mülkünün kimliği.