Müşteri yaşam döngüsüyle ilgili hedefleri yapılandırmak için Google Ads API'nin CustomerLifecycleGoal
ve CampaignLifecycleGoal
kaynaklarını kullanın. v15 sürümünden itibaren Google Ads API, Google Ads Arama Ağı ve Maksimum Performans kampanyalarınız aracılığıyla verimli bir şekilde yeni müşteriler edinmek için müşteri edinme hedeflerini desteklemektedir.
Google Ads hesabınızda hesaplar arası dönüşüm izleme kullanılıyorsa müşteri yaşam döngüsü hedeflerini doğrudan Google Ads hesabınız yerine Google Ads dönüşüm müşterisi hesabında yapılandırmanız gerekir. Ancak hesabınızda kampanya yaşam döngüsü hedefleri belirlemeye devam etmeniz gerekir. Bu, hesaplar arası dönüşüm izlemeyi kullanırken diğer hedefleri yönetme şeklinize benzer.
Oluşturma ve güncelleme işlemlerini yönetme (yalnızca v15 için)
Google Ads API v15'te, CustomerLifecycleGoalService
ve
CampaignLifecycleGoalService
'de desteklenen işlemler, Google Ads API'deki diğer hizmetlerden biraz farklıdır. v15 CustomerLifecycleGoalOperation
ve CampaignLifecycleGoalOperation
için ayrı create
ve update
işlemleri yerine yalnızca create
işlemi vardır. Niyetinizi şu şekilde belirtirsiniz:update_mask
v15 kullanarak yaşam döngüsü hedefi oluşturmak için
create
öğesini hedefle doldurun ancakresource_name
değerini ayarlamayın ve işleminupdate_mask
değerini ayarlamayın.v15 kullanarak bir yaşam döngüsü hedefini güncellemek için
create
öğesini hedefle doldurun, hedefinresource_name
değerini veupdate_mask
öğesini, güncellemek istediğiniz alanları listeleyecek şekilde ayarlayın.
Müşteri yaşam döngüsü hedeflerini yapılandırın
Müşteri düzeyinde, bir CustomerLifecycleGoal
oluşturarak veya güncelleyerek bir yaşam döngüsü hedefi yapılandırın. Her Google Ads hesabı
için en fazla bir CustomerLifecycleGoal
olabilir. customer_acquisition_goal_value_settings.value
alanı, yeni bir müşterinin ilk satın alma dönüşümüne eklenecek ek değer ayarlamasını tanımlar. Hedefin customer_acquisition_goal_value_settings.high_lifetime_value
kısmını okuyabilirsiniz ancak bu alan Google Ads API'de değiştirilemez.
Kitlelerinizi segmentlere ayırma
Google Ads API v17'den itibaren, kitlelerinizi müşteri yaşam döngüsü hedefleri için segmentlere ayırmak amacıyla UserListCustomerType
kaynağını kullanmanız gerekir. Kitleleri doğrudan CustomerLifecycleGoal
kaynağında yapılandırma özelliği kullanımdan kaldırılmıştır. Ayrıntılar:
- 17 sürümünden önce:
- Kullanıcı listelerini
CustomerLifecycleGoal
öğesininexisting_user_lists
koleksiyonuna ekleyin.
- Kullanıcı listelerini
- 17. sürümden itibaren:
- Her kullanıcı listesi ve kategori kombinasyonu için
UserListCustomerType
oluşturarak her kullanıcı listesini bir veya daha fazla kategoriyle ilişkilendirin.
- Her kullanıcı listesi ve kategori kombinasyonu için
Google Ads API 17 ve sonraki sürümlerde
UserListCustomerType
örnekleri oluşturmak için UserListCustomerTypeService
kodunu kullanın.
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
alanını daha önce doldurduysanız hesabınızda ilgili UserListCustomerType
örnekleri de bulunur.
UserListCustomerTypeService
yalnızca create
ve remove
işlemlerini destekler. Bu nedenle, mevcut bir UserListCustomerType
öğesini güncellemek isterseniz bunu kaldırmanız ve gerekli güncellemeleri içeren yeni bir UserListCustomerType
oluşturmanız gerekir.
UserListCustomerType
, yalnızca bir kullanıcı listesine atanabilir ancak UserListCustomerType
örnekleri arasında hiçbir çakışma olmadığı sürece bir kullanıcı listesinde ilişkili birden fazla UserListCustomerType
örneği bulunabilir. Aynı kullanıcı listesine aşağıdaki customer_type_category
kombinasyonlarıyla UserListCustomerType
örnekleri atamaya çalışıldığında UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
hatası verilir:
İlk customer_type_category |
İkinci customer_type_category |
---|---|
SATIN ALANLAR | CONVERTED_LEADS |
SATIN ALANLAR | QUALIFIED_LEADS |
SATIN ALANLAR | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
Google Ads API 16 ve önceki sürümlerde
Hesabınızın CustomerLifecycleGoal
bölümünde aşağıdaki alanları ayarlayın:
lifecycle_goal_customer_definition_settings.existing_user_lists
, hangi kullanıcı listelerinde mevcut müşterilerin bulunduğunu gösterir.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
alanı, hangi kullanıcı listelerinin yaşam boyu değeri yüksek müşteriler içerdiğini gösterir. Bu alanı okuyabilirsiniz ancak bu alan Google Ads API'de değiştirilemez.
Paylaşılan kaynak davranışı
Google Ads API v16'nın Ocak 2025'te kullanımdan kaldırılacağına kadar, UserListCustomerType
ve CustomerLifecycleGoal
üzerindeki kitle segmentasyonu alanlarının ortak bir kaynak olduğunu unutmayın. Bu durum, v17 ve sonraki sürümlerde yeni UserListCustomerType
örnekleri oluşturduğunuzda CustomerLifecycleGoal
örneğinizde (16 ve önceki sürümler ile tam tersi) değişiklik yapılmasına neden olur.
İki kaynaktaki alanlar şu şekilde eşlenir:
v16'da "CustomerLifecycleGoal" alanı değiştiriliyor | v17'deki "UserListCustomerType"ta yan efekt |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
UserListCustomerType örnek oluşturur veya kaldırır. user_list alanı, ilişkilendirilmiş kullanıcı listesi kaynak adını içerir.
|
v17'de "UserListCustomerType"ta değişiklik yapma | 16. sürümdeki "CustomerLifecycleGoal" alanında yan etki |
---|---|
UserListCustomerType örnek oluşturun veya kaldırın.
|
Bağımsız kaynak adları, lifecycle_goal_customer_definition_settings.existing_user_lists bölümüne eklenir veya oradan kaldırılır
|
customer_type_category öğesinin HIGH_VALUE_CUSTOMERS olarak ayarlandığı UserListCustomerType örnekleri oluşturun veya kaldırın
|
Bağımsız kaynak adları, lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists bölümüne eklenir veya oradan kaldırılır
|
Kampanya yaşam döngüsü hedeflerini yapılandırın
Kampanya düzeyinde, bir CampaignLifecycleGoal
oluşturarak veya güncelleyerek bir yaşam döngüsü hedefi yapılandırın. Kampanya başına en fazla bir CampaignLifecycleGoal
olabilir.
Kampanya düzeyindeki bir hedefin customer_acquisition_goal_settings
alanı, kampanyanın optimizasyon modunu ayarlamanızı ve üst müşteri hedefindeki değer ayarlarını geçersiz kılmanızı sağlar.
optimization_mode
, şu değerlerden biri olabilir:
TARGET_ALL_EQUALLY
- Kampanya, yeni ve mevcut müşterileri eşit şekilde hedefliyor. Bu, varsayılan optimizasyon modudur.
BID_HIGHER_FOR_NEW_CUSTOMERS
- Kampanya hem yeni hem de mevcut müşterileri hedefler ancak yeni olduğu tahmin edilen ve
existing_user_lists
kapsamında olmayan müşteriler için daha yüksek teklif verir. TARGET_NEW_CUSTOMERS
- Kampanya yalnızca yeni müşterileri hedefliyor.
value_settings
, müşteri düzeyindeki hedefte customer_acquisition_goal_value_settings
ile aynı. Belirli bir kampanyanın değerlerini geçersiz kılmak için kampanya düzeyindeki bu ayarları kullanın.
Yaşam döngüsü hedeflerini alma
Yaşam döngüsü hedeflerini almak için Google Ads API'deki diğer kaynaklarda olduğu gibi GoogleAdsService
'in search
veya searchStream
yöntemlerini kullanın.
Aşağıdaki sorgu, bir Google Ads hesabındaki her CustomerLifecycleGoal
ile ilgili ayrıntıları getirir:
SELECT
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal
Benzer şekilde, aşağıdaki sorgu her CampaignLifecycleGoal
öğesinin ayrıntılarını alır:
SELECT
campaign_lifecycle_goal.campaign,
campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal