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çmek üzere aşağıdaki karar yolunu kullanın:
Dönüşüm etkinliği nerede gerçekleşiyor?
- Çevrimdışı ortamda (ör. ofisinizde, işletmenizin bulunduğu konumda veya telefon üzerinden): 2. adıma gidin.
- Doğrudan web sitenizde (ör. 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 yapılan telefon aramaları: Reklamlardan gelen telefon aramaları (
AD_CALL) (CallAssetkullanarak) seçeneğini kullanın.
Çevrimdışı Dönüşümler:
Telefon araması mı?
Evet: Kullan
Arama sonuçlarını izlemek için Telefon Araması Dönüşümlerini İçe Aktarma (
UPLOAD_CALLS)'yı kullanın.
Fiziksel mağaza satışı mı?
Evet: Kullan
Web sitesi ziyaretinden kaynaklanan çevrimdışı satışlar veya potansiyel müşteri ilerlemesi mi?
- Evet: Veri Yöneticisi API'sini kullanarak potansiyel müşteriler için gelişmiş dönüşümleri kullanın (önerilir) veya mevcut Google Ads API entegrasyonları için çevrimdışı tıklama dönüşümlerini yönetme başlıklı makaleyi inceleyin. (Not: 15 Haziran 2026'dan itibaren,
UploadClickConversionskullanılarak tıklama dönüşümlerinin yüklenmesi, daha önce çevrimdışı tıklama dönüşümleri yüklemiş olan geliştirici jetonlarıyla sınırlıdır).
- Evet: Veri Yöneticisi API'sini kullanarak potansiyel müşteriler için gelişmiş dönüşümleri kullanın (önerilir) veya mevcut Google Ads API entegrasyonları için çevrimdışı tıklama dönüşümlerini yönetme başlıklı makaleyi inceleyin. (Not: 15 Haziran 2026'dan itibaren,
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 telefon araması sürelerini izlemek mi istiyorsunuz?
Evet: Kullan
Dinamik Google yönlendirme numarası ve etiket etkinlik snippet'i içeren web sitesinden gelen telefon aramaları (
WEBSITE_CALL).Hayır (yalnızca mobil sitedeki düğme/bağlantı tıklamalarını izlemek istiyorum). Kullan
- 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 yükleme veya satın alma işlemlerini izlemek yeterli mi?
- Evet: Uygulama dönüşümlerini kullanın
(
GOOGLE_PLAY_DOWNLOADveyaGOOGLE_PLAY_IN_APP_PURCHASE).
- Evet: Uygulama dönüşümlerini kullanın
(
Uygulama işlemlerini Google Analytics (GA4) veya üçüncü taraf uygulama analizlerini kullanarak mı izliyorsunuz?
Evet: Kullan
Firebase ve üçüncü taraf uygulama analizi (
FIREBASE_*veyaTHIRD_PARTY_*dönüşüm işlemlerini etkinleştirerek).
- Google Play Store'dan 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şen 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 dokümanların bağlantısı 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 (önerilir) veya mevcut Google Ads API entegrasyonları için Çevrimdışı tıklama dönüşümlerini yönetme başlıklı makaleyi inceleyin. |
UPLOAD_CALLS |
Telefon aramalarından elde edilen dönüşümleri izleyin | Telefon araması dönüşümlerini içe aktarma kılavuzu |
STORE_SALES |
Mağaza satışlarından elde edilen dönüşümleri izleme | Ayrıntılar için Mağaza satışları: raporlama ile dönüşüm işlemine aktarma başlıklı makaleyi inceleyin. |
Online (web sitesi) dönüşümleri
Web sitesi dönüşümü; online satışlar, bağlantı tıklamaları, sayfa görüntülemeleri ve kaydolma işlemleri gibi web sitesi işlemlerini izlemenize olanak tanır.
Web sitenizdeki dönüşümleri izlemek için ConversionActionType WEBPAGE olarak ayarlanmış bir ConversionAction oluşturmanız ve web sitenizdeki dönüşüm sayfasına etiket adı verilen bir kod snippet'i eklemeniz gerekir.
ConversionAction, API'de bir ConversionAction öğesinin tag_snippets alanında listelenen her TagSnippet öğesindeki type alanıyla 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 ve global_site_tag gerekir.
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.
global_site_tag ise web sitenizin her sayfasına yüklenmelidir. 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 yapılan 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, reklam çağrılarından, web sitenizdeki bir numaraya yapılan aramalardan ve mobil sitelerdeki numaralara yapılan tıklamalardan gelen aramaları 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 dönüşüm işleminin kaynak adını belirtin.
Telefon öğeleri, doğrudan reklamlarınızda telefon numarası göstermenize olanak tanır.
Belirli bir süreyi aşan 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 telefon aramaları dönüşümü olarak görünür.
AD_CALL'ın aksine bu izleyici, web sitenizde listelenen numaralarda telefon araması izleme için dinamik Google yönlendirme numarasını almak üzere web sitenize event_snippet ve global_site_tag'nin eklenmesini gerektirir. Ayrıca bir telefon öğesi oluşturmanız ve
Müşteri, kampanya veya reklam grubu düzeyinde bağlayabilirsiniz.
CLICK_TO_CALL
CLICK_TO_CALL dönüşüm işlemi, Google Ads web arayüzünde Mobil web sitenizde numaranıza yapılan tıklamalar dönüşümü olarak görünür.
CLICK_TO_CALL türü, gerçek telefon aramalarını izlememesi bakımından AD_CALL türünden farklıdır. Bunun yerine, CLICK_TO_CALL yalnızca mobil cihazdan gelen telefon numarası tıklamalarını 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 bir 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 Rehberi |
|---|---|---|
UPLOAD_CLICKS |
Potansiyel müşteriler için gelişmiş dönüşümler
Web sitesindeki potansiyel müşteri veya ziyaretçilerden gelen çevrimdışı işlemlerin ölçümünü iyileştirir. |
Data Manager API'yi kullanın (önerilir) veya mevcut Google Ads API entegrasyonları için Çevrimdışı tıklama dönüşümlerini yönetme başlıklı makaleyi inceleyin. |
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. GoogleAdsService kullanarak dönüşüm işlemlerinizi ve türlerini sorgulayabilirsiniz:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
SKAdNetwork dönüşüm sayısı
iOS uygulama kampanyaları yayınlıyorsanız ve SKAdNetwork'ü uyguladıysanız aşağıdaki kaynakları kullanarak Customer ve Campaign düzeyinde Google'a sağlanan SKAdNetwork verilerine 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 kombinasyonuna göre segmentlere ayrılabilir.
|
metrics.sk_ad_network_total_conversions |
Apple tarafından bildirilen yüklemeler ve 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 bölümlere 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 |
İlişkilendirmenin belirli bir dönüşüm için nasıl kredilendirildiği. |
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öndermelerin hiçbirinde 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 Apple tarafından gönderilen geri çağırmalarda kaynak alanın ya da kaynak uygulamanın bulunmadığı anlamına gelir. |
segments.sk_ad_network_user_type |
Belirli bir dönüşümü gerçekleştiren 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 Reklam Ağı API sürümü. |
Google Analytics
Bağlı bir Google Analytics mülkünden gelen dönüşümler, aşağıdaki type değerlerinden 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:
- Dönüşümün
statusalanınıHIDDENyerineENABLEDolarak 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 etkilemesi gerektiğini belirtin.nameveyavalue_settingsbilgisini güncelleme.removeişlemini kullanarak 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 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'dan ENABLED'a değiştirin. Bu dönüşüm işlemleri için app_id güncellemesi desteklenmiyor.
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_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ışları: Raporlama ile 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şlemlerini içe aktarmayı 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 önemli dönüşüm metrikleri için eksiksiz sonuçlar sağlamak amacıyla bunları raporlarda döndürür.