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. 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 ancak resource_name değerini ayarlamayın ve işlemin update_mask değerini ayarlamayın.

  • v15 kullanarak bir yaşam döngüsü hedefini güncellemek için create öğesini hedefle doldurun, hedefin resource_name değerini ve update_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 öğesinin existing_user_lists koleksiyonuna ekleyin.
  • 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.

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:

  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ı, 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
Önceki
Kampanya hedefleri