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, doldurulması zorunlu bir alandır 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 verilemez. Ancak, özel dönüşüm hedefleri primaryForGoal'ı dikkate almaz. Bu nedenle, bir kampanyanın 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 durumda kalır. Varsayılan olarak, ayarlanmazsa primaryForGoal doğru olacaktır. V9 'da primaryForGoal yalnızca bir "güncelleme" işlemiyle oluşturulduktan sonra isteğe bağlı olarak bildirilmediğinden yanlış değerine ayarlanabilir.

ownerCustomer

string

Yalnızca çıkış. Dönüşüm işlemi sahibi müşterinin kaynak adı. Bu 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)

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

viewThroughLookbackWindowDays

string (int64 format)

Etkileşim olmadan bir gösterim ile dönüşüm arasında gidebilecek 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 mobil uygulama indirdiğinde oluşan 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 bir reklamverenin web sitesinden dinamik olarak oluşturulmuş 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ışı 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ğaza içi satın alma işlemlerine dayalı Mağaza Satışı dönüşümü. Mağaza satışı türlerini yalnızca izin verilenler listesindeki müşteriler kullanabilir. Salt okunur.
FIREBASE_ANDROID_FIRST_OPEN Android uygulaması ilk açılış dönüşümlerinin Firebase üzerinden izlenmesi.
FIREBASE_ANDROID_IN_APP_PURCHASE Android uygulamasının uygulama içi satın alma dönüşümleri Firebase üzerinden izlendi.
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ının uygulama içi satın alma dönüşümleri Firebase üzerinden izleniyor.
FIREBASE_IOS_CUSTOM Firebase üzerinden izlenen iOS uygulaması özel dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Üçüncü Taraf Uygulama Analizi ile izlenen Android uygulaması ilk açılış dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Üçüncü Taraf Uygulama Analizi ile izlenen Android uygulaması uygulama içi satın alma dönüşümleri.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Üçüncü Taraf Uygulama Analizi 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 iOS uygulamasının uygulama içi satın alma dönüşümleri Üçüncü Taraf Uygulama Analizi ile izleniyor.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Üçüncü Taraf Uygulama Analizi ile izlenen iOS uygulaması özel dönüşümleri.
ANDROID_APP_PRE_REGISTRATION 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 özel bir türe göre izlenmeyen tüm Google Play indirmelerini izleyen dönüşümler. Salt okunur.
FLOODLIGHT_ACTION Kullanıcıların, reklamverenin reklamlarından birini gördükten veya tıkladıktan sonra belirli bir web sayfasını kaç kez ziyaret ettiğini 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'ın ürün ve hizmetlerine ait yerel işlemleri izleyen dönüşümler. Salt okunur.
LEAD_FORM_SUBMIT Kullanıcılar 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 arama öğesini tıklar. Yalnızca akıllı kampanya. Salt okunur.
SMART_CAMPAIGN_MAP_DIRECTIONS Kullanıcı, Google Haritalar'da 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 reklamverenin perakende mağazasını ziyaret ettiğinde gerçekleşen dönüşümlerdir. 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ğer 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.

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üşüme ilişkin 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ıyor.
GOOGLE_ADS_LAST_CLICK Bir dönüşüme ilişkin tüm krediyi son tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google Arama ilişkilendirmesini kullanarak bir dönüşüme ilişkin tüm krediyi ilk tıklamasıyla ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google Arama ilişkilendirmesi kullanarak dönüşüme ilişkin krediyi tüm tıklamalarında eşit olarak ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google Arama ilişkilendirmesi (yarı ömrü 1 haftadır) kullanarak bir dönüşüme katlanarak daha fazla krediyi daha yeni tıklamalarına ilişkilendirir.
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Dönüşüm kredisinin% 40'ını ilk ve son tıklamalarına atar. Kalan% 20, diğer tüm tıklamalar arasında eşit olarak dağıtılır. Bu özellik, 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 öğreniminden yararlanan 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üncellenmedi. 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üncellenmediği için kullanılamaz. Bunun en yaygın nedeni, son 30 günlük süre içinde gerekli sayıda etkinlik gerçekleşmemesidir.
NEVER_GENERATED Veriye dayalı model hiç oluşturulmadı. Bunun en yaygın nedeni, herhangi bir 30 günlük dönemde gerekli sayıda etkinlik gerçekleşmemesidir.

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.