Yaşam Döngüsü Hedefleri

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. 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ızda değil, Google Ads dönüşüm hesabında yapılandırmanız gerekir. Ancak yine de hesabınızda kampanya yaşam döngüsü hedefleri belirlemeniz 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 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 değerini okuyabilirsiniz ancak bu alan Google Ads API'de değiştirilemez.

Kitlelerinizi segmentlere ayırma

Google Ads API v17'den itibaren müşteri yaşam döngüsü hedefleri için kitlelerinizi 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:
    • Bir CustomerLifecycleGoal'ın existing_user_lists koleksiyonuna kullanıcı listeleri ekleyin.
  • 17. sürümden 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
SATIN ALANLAR 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 bölümünde aşağıdaki alanları ayarlayın:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists, hangi kullanıcı listelerinde mevcut müşterilerin bulunduğunu gösterir.

  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 bu alan Google Ads API'de değiştirilemez.

Paylaşılan kaynak davranışı

Ocak 2025'te kullanımdan kaldırılacak olan Google Ads API 16 sürümü kullanımdan kaldırılana kadar UserListCustomerType ve CustomerLifecycleGoal'daki kitle segmentasyonu alanlarının paylaşılan bir kaynak olduğunu unutmayın. Bu, 17 ve sonraki sürümlerde yeni UserListCustomerType örnekleri oluşturmanın 16 ve önceki sürümlerdeki CustomerLifecycleGoal örneğinizde değişikliklere neden olacağı anlamına gelir.

İ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 16. sürümdeki "CustomerLifecycleGoal" alanında 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 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 aşağıdaki 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 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 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 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
Önceki
Kampanya hedefleri