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.
Çevrimdışı dönüşümler
Çevrimdışı dönüşümler, ofisinizde, işletmenizin bulunduğu yerde veya telefon üzerinden gerçekleşenler gibi çevrimdışı 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 | Çevrimdışı Tıklama Dönüşümlerini Yönetme Kılavuzu
Potansiyel Müşteriler İçin Gelişmiş Dönüşümler Kılavuzu |
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üşü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 ConversionAction oluşturmanız, ConversionActionType değerini WEBPAGE olarak ayarlamanız ve web sitenizdeki dönüşüm sayfasına etiket adı verilen 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önderim 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ülklerini 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, reklamdan gelen aramaları, 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 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 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, reklamlarınızda doğrudan
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
çağrı 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 öğ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 bakımından AD_CALL
türünden farklıdır. Bunun yerine, CLICK_TO_CALL yalnızca bir mobil cihazdan 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 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. |
API Kurulum Kılavuzu |
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ıyor ve SKAdNetwork'ü uyguladıysanız aşağıdaki kaynakları kullanarak Google'a Customer ve Campaign düzeyinde 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 |
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 tarihe 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 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'ın modellenmiş boş değerlerinin 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 yöntemini kullanarak ConversionAction öğesinin status değerini HIDDEN'dan ENABLED'a değiştirin.mutate Bu dönüşüm işlemleri için app_id güncelleme işlemi 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ş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 sorgu ve raporların, ConversionAction.type değerinin UNKNOWN olduğu dönüşüm işlemlerini döndürdüğünü görebilirsiniz.
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 bunları raporlarda döndürür.