Yaşam Döngüsü Hedefleri

Müşteri yaşam döngüsü ile ilgili hedefleri yapılandırmak için Google Ads API'nin CustomerLifecycleGoal ve CampaignLifecycleGoal kaynaklarını kullanın. 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 destekler.

Google Ads hesabınız hesaplar arası dönüşüm izlemeyi kullanıyorsa müşteri yaşam döngüsü hedeflerini doğrudan Google Ads hesabınızdan değil, Google Ads dönüşüm 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önetmenize benzer.

Müşteri yaşam döngüsü hedeflerini yapılandırma

Müşteri düzeyinde, bir CustomerLifecycleGoal oluşturarak veya güncelleyerek yaşam döngüsü hedefini yapılandırın. Her Google Ads hesabında 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 ayarını tanımlar. Hedefin customer_acquisition_goal_value_settings.high_lifetime_value değerini okuyabilirsiniz ancak bu alan Google Ads API'de değiştirilemez.

Kitlelerinizi segmentlere ayırma

Google Ads API 17 sürümünden itibaren, kitlelerinizi müşteri yaşam döngüsü hedeflerine göre segmentlere ayırmak için UserListCustomerType kaynağını kullanmanız gerekir. Kitlelerin doğrudan CustomerLifecycleGoal kaynağında yapılandırılması desteği sonlandırılmıştır. Ayrıntılar:

• 17 sürümünden önce:
  • Bir CustomerLifecycleGoal'ın existing_user_lists koleksiyonuna kullanıcı listeleri ekleyin.
• 17 sürümünden itibaren:
  • Her kullanıcı listesi ve kategori kombinasyonu için bir UserListCustomerType oluşturarak her kullanıcı listesini bir veya daha fazla kategoriyle ilişkilendirin.

Google Ads API 17 ve sonraki sürümlerde

UserListCustomerType örnekleri oluşturmak için UserListCustomerTypeService öğesini kullanın. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists alanını daha önce doldurduysanız hesabınızda ilgili UserListCustomerType örnekleri zaten mevcuttur.

UserListCustomerTypeService yalnızca create ve remove işlemlerini destekler. Bu nedenle, mevcut bir UserListCustomerType öğesini güncellemek istiyorsanız öğeyi kaldırmanız ve gerekli güncellemeleri içeren yeni bir öğe oluşturmanız gerekir.

Bir UserListCustomerType yalnızca bir kullanıcı listesine atanabilir ancak kullanıcı listesinde, UserListCustomerType örnekleri arasında çakışma olmadığı sürece birden fazla ilişkili UserListCustomerType örneği olabilir. Aşağıdaki customer_type_category kombinasyonlarıyla UserListCustomerType örneklerini aynı kullanıcı listesine atamaya çalışmak UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES hatasıyla sonuçlanır:

İlk customer_type_category	İkinci customer_type_category
ALICILAR	CONVERTED_LEADS
ALICILAR	QUALIFIED_LEADS
ALICILAR	CART_ABANDONERS
CONVERTED_LEADS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CONVERTED_LEADS
DISENGAGED_CUSTOMERS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CART_ABANDONERS

Google Ads API v16'da

Hesabınızın CustomerLifecycleGoal alanında aşağıdaki alanları ayarlayın:

1. lifecycle_goal_customer_definition_settings.existing_user_lists, mevcut müşterilerin bulunduğu kullanıcı listelerini belirtir.

2. lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists alanı, yaşam boyu değeri yüksek müşteriler içeren kullanıcı listelerini gösterir. Bu alanı okuyabilirsiniz ancak Google Ads API'de değiştirilemez.

Paylaşılan kaynak davranışı

Google Ads API v16, Şubat 2025'te kullanımdan kaldırılana kadar UserListCustomerType ve CustomerLifecycleGoal'daki kitle segmentasyonu alanlarının paylaşılan bir kaynak olduğunu unutmayın. Diğer bir deyişle, v17 ve sonraki sürümlerde yeni UserListCustomerType örnekleri oluşturmak, v16 ve önceki sürümlerdeki CustomerLifecycleGoal örneğinizde değişikliklere neden olur ve bunun tersi de geçerlidir.

İki kaynaktaki alanlar aşağıdaki gibi eşlenir:

v16'da "CustomerLifecycleGoal" alanını değiştirme	v17'de "UserListCustomerType" üzerinde yan etki
lifecycle_goal_customer_definition_settings.existing_user_lists	UserListCustomerType örnekleri oluşturur veya kaldırır. user_list alanı, ilişkili kullanıcı listesi kaynak adını içerir.

v17'de "UserListCustomerType" değerini değiştirme	v16'da "CustomerLifecycleGoal" alanındaki yan etki
UserListCustomerType örnekleri oluşturma veya kaldırma.	Ayrı kaynak adları lifecycle_goal_customer_definition_settings.existing_user_lists
customer_type_category değerinin HIGH_VALUE_CUSTOMERS olarak ayarlandığı UserListCustomerType örnekleri oluşturma veya kaldırma	Ayrı kaynak adları lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists

Kampanya yaşam döngüsü hedeflerini yapılandırma

Kampanya düzeyinde, bir CampaignLifecycleGoal oluşturarak veya güncelleyerek yaşam döngüsü hedefini 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 belirlemenize ve üst müşteri hedefindeki değer ayarlarını geçersiz kılmanıza olanak tanır.

optimization_mode aşağıdaki değerlerden biri olabilir:

TARGET_ALL_EQUALLY

Kampanya, yeni ve mevcut müşterileri eşit şekilde hedefler. 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 gruplarından birinde bulunmayan 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 hedefteki customer_acquisition_goal_value_settings ile aynıdır. 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

Google Ads API'deki diğer kaynaklarda olduğu gibi, yaşam döngüsü hedeflerini almak için GoogleAdsService sınıfının search veya searchStream yöntemlerini kullanın.

Aşağıdaki sorgu, bir Google Ads hesabındaki her CustomerLifecycleGoal öğesinin ayrıntılarını alır:

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 ile ilgili ayrıntıları 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