Bu kılavuzda, Google Ads API'yi kullanarak oluşturabileceğiniz farklı dönüşüm işlemi türlerinin listesi ve bunların Google Ads web arayüzüyle nasıl eşlendiği hakkında bilgiler verilmektedir.
Doğru dönüşüm işlemi türünü seçme
Entegrasyonunuz için doğru dönüşüm işlemi türünü ve kurulum kılavuzunu seçmenize yardımcı olması için aşağıdaki karar yolunu kullanın:
Dönüşüm etkinliği nerede gerçekleşiyor?
- Çevrimdışı ortamda (örneğin, ofisinizde, iş yerinizde veya telefon üzerinden): 2. adıma gidin.
- Doğrudan web sitenizde (örneğin, web sitesi satın alma işlemleri, kayıtlar veya form gönderimleri): 3. adıma gidin.
- Mobil uygulamada: 4. adıma gidin.
- Doğrudan reklamlarınızdan aranan bir telefon görüşmesi üzerinden: Reklamlardan gelen aramalar (
AD_CALL) (CallAssetkullanılarak) seçeneğini kullanın.
Çevrimdışı Dönüşümler:
- Telefon görüşmesi mi?
- Evet: Arama sonuçlarını izlemek için Telefon Araması Dönüşümlerini İçe Aktarma'yı (
UPLOAD_CALLS) kullanın.
- Evet: Arama sonuçlarını izlemek için Telefon Araması Dönüşümlerini İçe Aktarma'yı (
- Fiziksel mağaza satışı mı?
- Evet: Mağaza satışı dönüşümlerini (
STORE_SALES) kullanın.
- Evet: Mağaza satışı dönüşümlerini (
- Bu, web sitesi ziyareti sonucunda gerçekleşen bir çevrimdışı satış mı yoksa potansiyel müşteri ilerlemesi mi?
- Evet: Data Manager API'yi kullanarak potansiyel müşteriler için gelişmiş dönüşümleri kullanın.
(Not:
UPLOAD_CLICKSveyaUploadClickConversionkullanılarak tıklama dönüşümlerinin yüklenmesi 15 Haziran 2026 itibarıyla kullanımdan kaldırılmıştır).
- Evet: Data Manager API'yi kullanarak potansiyel müşteriler için gelişmiş dönüşümleri kullanın.
(Not:
- Telefon görüşmesi mi?
Online (web sitesi) dönüşümleri:
- Sayfa yüklemelerini (satın alma işlemleri, makbuzlar) mi yoksa kullanıcı tıklamalarını mı izlemek istiyorsunuz?
- Evet: Etiket snippet'i
WEBPAGEveyaWEBPAGE_ONCLICKolarak ayarlanmış Web Sitesi Dönüşümleri'ni kullanın.
- Evet: Etiket snippet'i
- Web sitenizde listelenen bir telefon numarasıyla tetiklenen aramaları izlemek
istiyor musunuz?
- Gerçek arama sürelerini izlemek mi istiyorsunuz?
- Evet: Dinamik bir Google yönlendirme numarası ve etiket etkinlik snippet'i ile Web sitesinden gelen aramalar (
WEBSITE_CALL) seçeneğini kullanın. - Hayır (yalnızca mobil sitedeki düğme/bağlantı tıklamalarını izleyin)? Mobil telefon numaranızın tıklanma sayısı (
CLICK_TO_CALL) metriğini kullanın.
- Evet: Dinamik bir Google yönlendirme numarası ve etiket etkinlik snippet'i ile Web sitesinden gelen aramalar (
- Gerçek arama sürelerini izlemek mi istiyorsunuz?
- Sayfa yüklemelerini (satın alma işlemleri, makbuzlar) mi yoksa kullanıcı tıklamalarını mı izlemek istiyorsunuz?
Mobil Uygulama Dönüşümleri:
- Google Play Store'dan yapılan yükleme veya satın alma işlemlerini izlemek yeterli mi?
- Evet: Uygulama dönüşümlerini (
GOOGLE_PLAY_DOWNLOADveyaGOOGLE_PLAY_IN_APP_PURCHASE) kullanın.
- Evet: Uygulama dönüşümlerini (
- Uygulama işlemlerini Google Analytics (GA4) veya üçüncü taraf uygulama analizlerini kullanarak mı izliyorsunuz?
- Evet: Firebase ve üçüncü taraf uygulama analizlerini kullanın (
FIREBASE_*veyaTHIRD_PARTY_*dönüşüm işlemlerini etkinleştirerek).
- Evet: Firebase ve üçüncü taraf uygulama analizlerini kullanın (
- Google Play Store'dan yapılan yükleme veya satın alma işlemlerini izlemek yeterli mi?
Çevrimdışı dönüşümler
Çevrimdışı dönüşümler, ofisinizde, işletmenizin bulunduğu konumda veya telefon üzerinden gerçekleşenler gibi çevrimdışı dünyadaki dönüşüm etkinliklerini izlemenize yardımcı olur.
Aşağıdaki tabloda, Google Ads web arayüzündeki her bir Kaynak için kullanılacak eşdeğer ConversionActionType API parametreleri ve her bir dönüşüm işlemi türüyle ilgili belgelere yönelik bir bağlantı gösterilmektedir:
| Dönüşüm İşlemi Türü | Google Ads Kaynağı | API Kurulum Kılavuzu |
|---|---|---|
UPLOAD_CLICKS |
Tıklamalardan elde edilen dönüşümleri ve potansiyel müşteriler için gelişmiş dönüşümleri izleme | Data Manager API'yi kullanın. |
UPLOAD_CALLS |
Telefon aramalarından elde edilen dönüşümleri izleyin | Telefon Araması Dönüşümlerini İçe Aktarma Rehberi |
STORE_SALES |
Mağaza satışı dönüşümlerini izleme | Mağaza Satışı Dönüşümlerini İçe Aktarma Rehberi |
Online (web sitesi) dönüşümleri
Web sitesi dönüşümü, online satışlar, bağlantı tıklamaları, sayfa görüntülemeleri ve kayıtlar gibi web sitesi işlemlerini izlemenize olanak tanır.
Web sitenizdeki dönüşümleri izlemek için ConversionAction oluşturmanız, ConversionActionType değerini WEBPAGE olarak ayarlamanız ve web sitenizdeki dönüşüm sayfasına etiket adlı bir kod snippet'i eklemeniz gerekir.
ConversionAction, API'de ConversionAction öğesinin tag_snippets alanında listelenen her bir TagSnippet öğesindeki type alanı ile ayırt edilen çeşitli web sitesi dönüşümü türlerini kapsar.
TagSnippet, dönüşüm işlemlerinizi izlemek için web sitenize eklenmesi gereken izleme kodunu sağlar.
Web sitesi ve Telefon numarası tıklaması dönüşümleri için event_snippet (ödeme onayı veya potansiyel müşteri formu gönderme sayfası gibi bir dönüşüm işlemini gösteren web sayfalarına yerleştirilmelidir) ve global_site_tag (web sitenizin her sayfasına yüklenmelidir) gerekir. Bu özelliklerin her ikisini de ConversionActionService ile alabilirsiniz. Sayfalarınızı nasıl etiketleyeceğiniz hakkında daha fazla bilgi için Yardım Merkezimizi ziyaret edin.
Aşağıdaki tabloda, Google Ads web arayüzündeki her bir kaynak için kullanılacak eşdeğer API parametreleri gösterilmektedir:
| İzleme Kodu Türü | Google Ads Kaynağı |
|---|---|
WEBPAGE |
Web sitesi, Web sitesi (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Web sitesi, Web sitesi (Google Analytics (GA4)) |
CLICK_TO_CALL |
Telefon numarası tıklamaları |
Uygulama dönüşümleri
Uygulama dönüşümü, Google Play Store'dan gelen mobil uygulama yüklemelerini veya uygulama içi satın alma işlemlerini izlemenize olanak tanır.
Aşağıdaki tabloda, Google Ads web arayüzündeki her kaynak için kullanılacak eşdeğer ConversionActionType API parametreleri gösterilmektedir:
| Dönüşüm İşlemi Türü | Google Ads Kaynağı |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Yüklemeler |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Uygulama içi satın alma işlemleri |
Google Analytics 4 mülkleri veya üçüncü taraf uygulama analizlerini kullanarak diğer mobil uygulama işlemlerini izlemek için Ek Dönüşüm İşlemi Türleri başlıklı makaleyi inceleyin.
Telefon araması dönüşümleri
Telefon araması dönüşümü izleme, reklamlardan gelen telefon aramalarını, web sitenizdeki bir numaraya yapılan aramaları ve mobil sitelerdeki numaralara yapılan tıklamaları izlemenize olanak tanır.
Aşağıdaki tabloda, Google Ads web arayüzündeki her kaynak için kullanılacak eşdeğer ConversionActionType API parametreleri gösterilmektedir:
| Dönüşüm İşlemi Türü | Google Ads Kaynağı |
|---|---|
AD_CALL |
Telefon uzantıları kullanan reklamlardan veya yalnızca telefon araması üreten reklamlardan gelen aramalar |
WEBSITE_CALL |
Web sitenizdeki bir telefon numarasına gelen aramalar |
CLICK_TO_CALL |
Mobil web sitenizdeki bir numaraya yapılan tıklamalar |
AD_CALL
Bir AD_CALL dönüşüm işlemi, Google Ads web arayüzünde Reklamlardan gelen telefon aramaları dönüşümü olarak görünür. AD_CALL dönüşüm işleminizi oluşturduktan sonra CallAsset oluştururken call_conversion_action alanında kaynak adını belirtin.
Telefon öğeleri, doğrudan reklamlarınızda telefon numarası göstermenize olanak tanır.
Belirli bir süreden uzun süren aramalar dönüşüm olarak raporlanır. Varsayılan değer 60 saniyedir.
WEBSITE_CALL
WEBSITE_CALL dönüşüm işlemi, Google Ads web arayüzünde web sitesinden gelen aramalar dönüşümü olarak görünür.
AD_CALL'ın aksine, bu izleyici, web sitenizde listelenen numaralarda telefon izleme için dinamik Google yönlendirme numarasını almak üzere web sitenize event_snippet ve global_site_tag eklenmesini gerektirir. Ayrıca, bir telefon öğesi oluşturmanız ve bunu müşteri, kampanya veya reklam grubu düzeyinde bağlamanız gerekir.
CLICK_TO_CALL
CLICK_TO_CALL dönüşüm işlemi, Google Ads web arayüzünde mobil web sitenizdeki numaranızın tıklanması dönüşümü olarak görünür.
CLICK_TO_CALL türü, gerçek telefon aramalarını izlememesi nedeniyle AD_CALL türünden farklıdır. Bunun yerine CLICK_TO_CALL yalnızca mobil cihazdan bir telefon numarasına yapılan tıklamaları izler. Bu özellik, telefon aramalarını izlemek için Google yönlendirme numarası kullanamadığınız durumlarda faydalıdır.
Gelişmiş dönüşümler
Gelişmiş dönüşümler, mevcut dönüşüm etiketlerinizi e-posta adresi, ad, ev adresi ve telefon numarası gibi birinci taraf dönüşüm verileriyle destekleyerek dönüşüm ölçümünüzün doğruluğunu artırmanıza yardımcı olur.
Aşağıdaki tabloda, her gelişmiş dönüşüm türü için kullanılacak eşdeğer API parametreleri gösterilmektedir:
| Dönüşüm İşlemi Türü | Gelişmiş Dönüşüm Türü | API Kurulum Kılavuzu |
|---|---|---|
UPLOAD_CLICKS |
Potansiyel müşteriler için gelişmiş dönüşümler
Web sitesindeki potansiyel müşterilerden veya ziyaretçilerden gelen çevrimdışı işlemlerin ölçümünü iyileştirir. |
Data Manager API'yi kullanın. |
WEBPAGE |
Web için gelişmiş dönüşümler
Online dönüşümlerin ölçümünü iyileştirir. |
API Kurulum Kılavuzu |
Ek dönüşüm işlemi türleri
Google Ads API, raporlarda ek dönüşüm işlemi türlerini kullanılabilir hale getirir ancak bu işlemlerin oluşturulmasını veya değiştirilmesini sınırlayabilir ya da yasaklayabilir.
SKAdNetwork dönüşüm sayısı
iOS uygulama kampanyaları yayınlıyorsanız ve SKAdNetwork'ü uyguladıysanız aşağıdaki kaynakları kullanarak Google'a sağlanan SKAdNetwork verilerine Customer ve Campaign düzeyinde erişebilirsiniz:
| Rapor alanı | Açıklama |
|---|---|
metrics.sk_ad_network_installs |
Apple tarafından bildirilen yükleme sayısı. Bu metrik yalnızca segments.sk_ad_network_conversion_value ve tarihle ilgili segmentlerin herhangi bir kombinasyonuyla segmentlere ayrılabilir.
|
metrics.sk_ad_network_total_conversions |
Yüklemeler ve Apple tarafından bildirilen diğer dönüşüm türleri dahil olmak üzere toplam dönüşüm sayısı. Bu metrik yalnızca SKAdNetwork ile ilgili segmentlere ve tarihle ilgili segmentlere göre segmentlere ayrılabilir. |
segments.sk_ad_network_ad_event_type |
Belirli bir dönüşüm için gerçekleşen etkinlik türü. |
segments.sk_ad_network_attribution_credit |
Belirli bir dönüşüm için ilişkilendirme nasıl kredilendirilir? |
segments.sk_ad_network_fine_conversion_value |
Apple tarafından bildirilen bir dönüşümün değeri. Bu segment, Apple |
segments.sk_ad_network_coarse_conversion_value |
Tek bir dönüşümün kaba değeri. |
segments.sk_ad_network_postback_sequence_index |
Belirli bir dönüşüm için geri gönderme işleminin sıradaki konumu. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
iOS Store Kit Ad Network yüklemesini artıran reklamın gösterildiği uygulama kimliği. |
segments.sk_ad_network_source_domain |
iOS Store Kit Ad Network yüklemesini artıran reklamın gösterildiği web sitesi. Boş değer, bu segmentin geçerli olmadığı (ör. iOS dışı bir kampanya) veya Apple tarafından gönderilen geri göndermelerde bulunmadığı anlamına gelir. |
segments.sk_ad_network_source_type |
iOS Store Kit Ad Network yüklemesini artıran reklamın gösterildiği kaynak türü. Boş değer, bu segmentin geçerli olmadığı (ör. iOS dışı kampanya) veya kaynak alan adının ya da kaynak uygulamanın Apple tarafından gönderilen geri göndermelerde bulunmadığı anlamına gelir. |
segments.sk_ad_network_user_type |
Belirli bir dönüşümü oluşturan kullanıcı türü. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Bu segmentteki dönüşüm değerleri, dönüşüm değerlerine yeniden dağıtılan boş değerleri içerir. Bu segment, Apple tarafından döndürülen gözlemlenen ayrıntılı dönüşüm değerleri ile Google'dan gelen modellenmiş boş değerlerin toplamını temsil eder. |
segments.sk_ad_network_version |
Kullanılan iOS Store Kit Ad Network API sürümü. |
Google Analytics
Bağlı bir Google Analytics mülkünden gelen dönüşümler aşağıdaki type değerlerden birine sahiptir:
GA4 mülk dönüşümü:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
GA4 mülk kimliğini, mülk adını ve etkinlik adını
google_analytics_4_settingsalanından da alabilirsiniz.
GA4 mülkü dönüşümünde aşağıdaki değişiklikleri yapabilirsiniz:
statusalanınıHIDDENdeğerindenENABLEDdeğerine değiştirerek dönüşümü GA4 mülkünüzden Google Ads hesabınıza aktarın.primary_for_goalvecategoryalanlarını değiştirerek Google Ads teklif verme ve raporlarını nasıl etkileyeceğini belirtin.nameveyavalue_settingsözelliğini güncelleyin.removeişlemiyle dönüşümü Google Ads hesabınızdan kaldırın.
İçe aktarılan bir GA4 dönüşümünün diğer özelliklerini veya içe aktarılan bir Universal Analytics dönüşümünün herhangi bir özelliğini değiştirmeye yönelik tüm girişimler MUTATE_NOT_ALLOWED hatasıyla sonuçlanır. Bu değişiklikleri yalnızca Google Ads kullanıcı arayüzünü kullanarak yapabilirsiniz.
Firebase ve üçüncü taraf uygulama analizleri
Üçüncü taraf uygulama analizi veya Firebase dönüşümlerini içe aktarmak için ConversionActionService mutate yöntemini kullanarak ConversionAction status değerini HIDDEN yerine ENABLED olarak değiştirin. Bu dönüşüm işlemleri için app_id güncelleme desteklenmez.
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Mağaza satışı: Raporlamayla birlikte dönüşüm işlemine aktarma
Google Ads API'yi kullanarak STORE_SALES veya STORE_SALES_DIRECT_UPLOAD
dönüşüm işlemleri oluşturamasanız da API, mağaza satışı işlemlerinin içe aktarılmasını destekler.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Salt okunur dönüşüm işlemi türleri
Aşağıdaki dönüşüm işlemi türleri, Google Ads API'de salt okunurdur ve raporlama amacıyla sağlanır.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
Bilinmiyor
Google Ads hesabınızda başka türde dönüşüm işlemleri varsa sorgular ve raporlar, ConversionAction.type değerinin UNKNOWN olduğu dönüşüm işlemlerini döndürebilir. API, bu dönüşüm işlemlerinin yönetilmesini desteklemez ancak metrics.conversions ve metrics.conversions_value gibi temel dönüşüm metrikleriyle ilgili eksiksiz sonuçlar sağlamak için raporlarda bu işlemleri döndürür.