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şletme konumunuzda veya telefonla): 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 telefon aramaları (
AD_CALL) (CallAssetkullanılarak) seçeneğini kullanın.
Çevrimdışı Dönüşümler:
Telefon görüşmesi mi?
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
Bu, web sitesi ziyareti sonucunda gerçekleşen bir çevrimdışı satış mı yoksa 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ı olacaktı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 görüşme sürelerini izlemek mi istiyorsunuz?
Evet: Kullan
Dinamik Google yönlendirme numarası ve etiket etkinlik snippet'i içeren web sitesinden gelen aramalar (
WEBSITE_CALL).Hayır (yalnızca mobil sitedeki düğme/bağlantı tıklamalarını mı izliyorsunuz?) 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üne ait dokümanların bağlantısı gösterilmektedir:
| Dönüşüm İşlemi Türü | Google Ads Kaynağı | API Kurulum Rehberi |
|---|---|---|
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 İçe Aktarma Rehberi |
STORE_SALES |
Mağaza satışlarından elde edilen dönüşümleri izleme | Ayrıntılar için Mağaza satışları: raporlamayla dönüşüm işlemine aktarma başlıklı makaleyi inceleyin. |
Online (web sitesi) dönüşümler
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 WEBPAGE olarak ayarlanmış bir ConversionActionType ile ConversionAction oluşturmanız ve web sitenizdeki dönüşüm sayfasına etiket adı verilen bir kod snippet'i eklemeniz gerekir.
ConversionAction, çeşitli web sitesi dönüşümlerini kapsar. Bunlar, API'de ConversionAction alanının tag_snippets alanında listelenen her bir TagSnippet içindeki type alanı ile ayırt edilir.
TagSnippet, dönüşüm işlemlerinizi izlemek için web sitenize eklenmesi gereken izleme kodunu sağlar.
Web sitesi ve Telefon numarası tıklama 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 bir 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 numaraların tıklanmasını izlemenize olanak tanır.
Aşağıdaki tabloda, Google Ads web arayüzündeki her bir 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 bir 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 telefon aramaları dönüşümü olarak görünür.
AD_CALL'dan farklı olarak bu izleyici, web sitenizde listelenen numaralarda arama izleme için dinamik Google yönlendirme numarasını almak üzere event_snippet ve global_site_tag'ın web sitenize eklenmesini gerektirir. Ayrıca bir telefon görüşmesi
öğ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 bir 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 tamamlayarak 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 Rehberi |
|---|---|---|
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 (ö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 kombinasyonuyla 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ö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 Apple tarafından gönderilen geri göndermelerin hiçbirinde kaynak alan adının ya da kaynak uygulamanın bulunmadığı anlamına gelir. |
segments.sk_ad_network_user_type |
Belirli bir dönüşümü oluşturan kullanıcının 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
Ayrıca
google_analytics_4_settingsalanından GA4 mülk kimliğini, mülk adını ve etkinlik adını 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 etkilemesi gerektiğini belirtin.nameveyavalue_settingsiçeriğini güncelleme.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 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üncelleme desteklenmez.
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ışı: 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ş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 önemli dönüşüm metrikleriyle ilgili eksiksiz sonuçlar sağlamak için bunları raporlarda döndürür.