Yaşam Döngüsü Hedefleri

CustomerLifecycleGoal ve CampaignLifecycleGoal Müşteri yaşam döngüsüyle ilgili hedefleri yapılandırmak için Google Ads API'yi kullanın. 15. sürümden itibaren Google Ads API, müşteri edinmeyi ve verimli şekilde kullanabileceğiniz Google Ads Arama Ağı ve Maksimum Performans kampanyalarıyla yeni müşteriler edinme kampanyaları.

Google Ads hesabınızda hesaplar arası dönüşüm izleme kullanılıyorsa Google Ads dönüşüm işleminde müşteri yaşam döngüsü hedeflerini müşteri hesabınızda oturum açmanız gerekir. Yine de kampanya yaşam döngüsü hedeflerini ekleyebilirsiniz. Bu, önceki görüşmenizde kullanırken diğer hedefleri yönetme Dönüşüm İzleme'yi nasıl kullanacağınızı göstereceğim.

Oluşturma ve güncelleme işlemlerini yönetme (yalnızca v15 için)

Google Ads API v15'te, CustomerLifecycleGoalService ve CampaignLifecycleGoalService Google Ads API'deki diğer hizmetlerden biraz farklıdır. Ayrı bir ekip oluşturmak yerine create ve update işlemleri, v15 CustomerLifecycleGoalOperation ve CampaignLifecycleGoalOperation yalnızca create işlemi varsa ve niyetinizi Şu şekilde update_mask:

  • v15'i kullanarak bir yaşam döngüsü hedefi oluşturmak için create öğesini hedefle doldurun ancak resource_name özelliğini ayarlamayın ve update_mask işlemidir.

  • v15 kullanarak bir yaşam döngüsü hedefini güncellemek için create öğesini hedefle doldurun, hedefin resource_name'ını seçin ve update_mask değerini alanları tıklayın.

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

Müşteri düzeyinde CustomerLifecycleGoal. Google Ads hesabı başına en fazla bir CustomerLifecycleGoal. İlgili içeriği oluşturmak için kullanılan customer_acquisition_goal_value_settings.value alanı, ek yeni bir müşterinin ilk satın alma dönüşümüne eklenecek değer ayarlaması. Şunları yapabilirsiniz: şu bölümünü okuyun: customer_acquisition_goal_value_settings.high_lifetime_value hedefidir, ancak bu alan Google Ads API'de sabittir.

Kitlelerinizi segmentlere ayırma

Google Ads API v17'den itibaren, Segmentlere eklenecek UserListCustomerType kaynak hedef kitlelerinizi daha verimli şekilde kullanabilirsiniz. Kitleleri doğrudan CustomerLifecycleGoal kaynağı desteği sonlandırıldı. Ayrıntılar:

  • 17 sürümünden önce:
    • Şu öğenin existing_user_lists koleksiyonuna kullanıcı listeleri ekleyin: CustomerLifecycleGoal.
  • 17. sürümden itibaren:
    • Her kullanıcı listesini bir veya daha fazla kategoriyle ilişkilendirmek üzere Her bir kullanıcı listesi ve kategori kombinasyonu için UserListCustomerType.
ziyaret edin.

Google Ads API 17 ve sonraki sürümlerde

Şunu kullanın: UserListCustomerTypeService - UserListCustomerType örnek oluşturabilirsiniz. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists. alanına girdiyseniz, hesabınızda zaten alakalı UserListCustomerType sağlar.

UserListCustomerTypeService yalnızca create ve remove özelliklerini destekler işlemleri içindir. Mevcut bir UserListCustomerType öğesini güncellemek isterseniz dosyayı kaldırmanız ve gerekli güncellemelerle yeni bir dosya oluşturmanız gerekir.

UserListCustomerType yalnızca bir kullanıcı listesine atanabilir, ancak kullanıcı listesinde birden fazla ilişkili UserListCustomerType örneği olabilir UserListCustomerType arasında çakışma olmadığı sürece sağlar. Şu ayarı içeren UserListCustomerType örnek atanmaya çalışılıyor: şu kombinasyonların customer_type_category ekleme işlemi, UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES hatası:

İ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:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists şunu belirtir: mevcut müşterileri içeren kullanıcı listeleri oluşturabilirsiniz.

  2. İlgili içeriği oluşturmak için kullanılan 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. Siz bu alanı okuyabilir ancak Google Ads API'de sabittir.

Paylaşılan kaynak davranışı

Google Ads API 16. sürüm Ocak 2025'te kullanımdan kaldırılana kadar şunu unutmayın: UserListCustomerType ve kitle segmentasyonu alanları CustomerLifecycleGoal paylaşılan bir kaynaktır, yani yeni 17. sürüm ve sonraki sürümlerde UserListCustomerType örnek üzerinde değişiklik yapıldı v16 ve önceki sürümlerdeki CustomerLifecycleGoal örneğinize, tam tersi etrafta dolaşırsınız.

İ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. İlgili içeriği oluşturmak için kullanılan user_list alanı, ilişkilendirilmiş kullanıcı listesi kaynağını içeriyor dokunun.
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. Kaynak adları tek tek lifecycle_goal_customer_definition_settings.existing_user_lists.
Aşağıdaki örnekte gösterildiği gibi: UserListCustomerType customer_type_category şuna ayarlandı: HIGH_VALUE_CUSTOMERS Kaynak adları tek tek lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists.

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

Kampanya düzeyinde, bir dönüşüm izleme kodu oluşturarak veya güncelleyerek CampaignLifecycleGoal. kampanya başına en fazla bir CampaignLifecycleGoal.

Kampanya düzeyindeki bir hedefin customer_acquisition_goal_settings alanı şunları yapmanıza olanak tanır: kampanya için optimizasyon modunu ayarlama ve değer ayarlarını geçersiz kılma ana müşteri hedefinden yararlanabilir.

optimization_mode, şu değerlerden biri olabilir:

TARGET_ALL_EQUALLY
Kampanya, yeni ve mevcut müşterileri eşit şekilde hedefliyor. Bu, varsayılan ayardır optimizasyon moduna geçebilirsiniz.
BID_HIGHER_FOR_NEW_CUSTOMERS
Kampanya hem yeni hem de mevcut müşterileri hedefliyor, ancak yeni olduğu tahmin edilen ve existing_user_lists.
TARGET_NEW_CUSTOMERS
Kampanya yalnızca yeni müşterileri hedefliyor.

value_settings, ile aynıdır Müşteri düzeyindeki hedef customer_acquisition_goal_value_settings. Bunları kullan kampanya düzeyindeki ayarları kullanarak belirli bir kampanyanın değerlerini geçersiz kılabilir.

Yaşam döngüsü hedeflerini alma

Google Ads API'sindeki diğer kaynaklarda olduğu gibi, search veya searchStream kullanın. GoogleAdsService yöntemini alma yaşam döngüsü hedeflerini destekler.

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

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:

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