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 Goal ve CampaignGoalConfig kaynaklarını kullanın. Google Ads API, Google Ads kampanyalarınız aracılığıyla müşteri yaşam döngüsü değer ayarlamalarını verimli bir şekilde yönetmek için müşteri edinme hedeflerini ve elde tutma hedeflerini destekler.

Google Ads hesabınızda hesaplar arası dönüşüm izleme kullanılıyorsa müşteri düzeyindeki 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 hesabınızda kampanya düzeyinde yapılandırmalar ayarlamanız gerekir. Bu, hesaplar arası dönüşüm izleme özelliğini kullanırken diğer hedefleri yönetme şeklinize benzer.

Müşteri yaşam döngüsü hedefi türleri

Müşteri yaşam döngüsü hedefleri, Goal kaynağı kullanılarak hesap düzeyinde yapılandırılır. Hedef, belirli bir yaşam döngüsü hedefini temsil eder ve goal_type ile tanımlanır.

Desteklenen yaşam döngüsü hedefi türleri şunlardır:

NEW_CUSTOMER_ACQUISITION

Dönüşümlerine değer ayarlamaları atayarak yeni müşterileri verimli bir şekilde edinmek için kullanılır.

CUSTOMER_RETENTION

Mevcut, yüksek değere sahip ve etkin olmayan müşterilerle yeniden etkileşim kurmak için kullanılır.

LOYALTY_RETENTION

Özellikle bağlılık programı üyeleri arasında elde tutma ve etkileşimi artırmak için.

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

Müşteri düzeyinde, bir Goal oluşturarak yaşam döngüsü hedefi yapılandırın. Bir Google Ads hesabında hedef türü başına (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION veya LOYALTY_RETENTION) en fazla bir Goal olabilir.

Yeni müşteri edinme hedefi ayarları

Yeni müşteri edinmeyi (NCA) ayarlamak için goal_type değerini NEW_CUSTOMER_ACQUISITION olarak belirleyin ve new_customer_acquisition_goal_settings alanındaki ayarları GoalService kullanarak yapılandırın.

new_customer_acquisition_goal_settings.value_settings alanı, edinilen müşteriler için dönüşüm değeri ayarlamalarını belirtmek üzere CustomerLifecycleOptimizationValueSettings kullanır:

• value_settings (CustomerLifecycleOptimizationValueSettings):
  • value_adjustment (oneof):
    • additional_value (double): Yeni bir müşterinin ilk satın alma dönüşümüne eklenecek artımlı dönüşüm değeri.
    • value_multiplier (double): Yeni bir müşterinin ilk satın alma işlemine ait dönüşüm değerine uygulanacak çarpan (NEW_CUSTOMER_ACQUISITION için desteklenmez; LOYALTY_RETENTION için desteklenir).
  • high_lifetime_value_adjustment (oneof):
    • additional_high_lifetime_value (çift): Yüksek yaşam boyu değere sahip olarak tanımlanan yeni müşteriler için artımlı dönüşüm değeri.
    • high_lifetime_value_multiplier (double): Yaşam boyu değeri yüksek olan yeni müşteriler için uygulanacak dönüşüm değeri çarpanı (henüz desteklenmiyor).

Yüksek yaşam boyu değer, değerden büyük olmalıdır. Yüksek yaşam boyu değer çarpanı ise ayarlanmışsa değer çarpanından kesinlikle büyük olmalıdır.

def create_nca_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new New Customer Acquisition Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.NEW_CUSTOMER_ACQUISITION

    # Configure the value adjustments.
    value_settings = goal.new_customer_acquisition_goal_settings.value_settings
    value_settings.additional_value = 50.0
    value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Müşteriyi elde tutma hedefi ayarları

Müşteriyi elde tutmayı ayarlamak için goal_type değerini CUSTOMER_RETENTION olarak ayarlayın ve retention_goal_settings alanındaki ayarları yapılandırın.

Elde tutma hedefi oluşturmadan önce Elde tutma hedefi hakkında başlıklı makalede açıklanan ön koşulları karşılamanız gerekir. Buna, Maksimum Performans kampanyası ve Müşteri Eşleştirme kullanıcı listesi de dahildir.

def create_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Customer Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.CUSTOMER_RETENTION
    value_settings = goal.retention_goal_settings.value_settings
    value_settings.additional_value = 50.0
    value_settings.additional_high_lifetime_value = 100.0

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Bu işlem, belirtilen müşteri hesabı için hesap düzeyinde yeni bir elde tutma hedefi oluşturur ve bu hedef, hesabın tüm kampanyalarına uygulanır. Bu hedef, varsayılan olarak Müşteri Eşleştirme kullanıcı listelerinizdeki tüm kullanıcıları hedefler.

Bağlılık elde tutma hedefi ayarları

Bağlılık programı üyeleri için bağlılık elde tutma hedefleri belirlemek istiyorsanız goal_type değerini LOYALTY_RETENTION olarak ayarlayın ve loyalty_retention_goal_settings alanındaki (LoyaltyRetentionGoal) ayarları yapılandırın.

NEW_CUSTOMER_ACQUISITION ve CUSTOMER_RETENTION hedeflerinin (toplama değer ayarlamalarını kullanan) aksine, LOYALTY_RETENTION hedefleri value_settings'de value_multiplier ayarını CustomerLifecycleOptimizationValueSettings kullanarak destekler:

def create_loyalty_retention_goal(
    client: GoogleAdsClient, customer_id: str
) -> None:
    """Sends an API request to add a new Loyalty Retention Goal.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
    """
    goal_operation: GoalOperation = client.get_type("GoalOperation")
    goal = goal_operation.create
    goal.goal_type = client.enums.GoalTypeEnum.LOYALTY_RETENTION
    goal.loyalty_retention_goal_settings.value_settings.value_multiplier = 1.5

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

Kitlelerinizi segmentlere ayırma

Kitlelerinizi müşteri yaşam döngüsü hedeflerine (yeni müşteri edinme, müşteri elde tutma ve bağlılık elde tutma hedefleri dahil) göre segmentlere ayırmak için UserListCustomerType kaynağını kullanmanız gerekir. Her kullanıcı listesi ve kategori kombinasyonu için bir UserListCustomerType oluşturarak her kullanıcı listesini bir veya daha fazla kategoriyle ilişkilendirmeniz gerekir.

UserListCustomerType örnekleri oluşturmak için UserListCustomerTypeService kullanın.

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

Bir UserListCustomerType yalnızca bir kullanıcı listesine atanabilir ancak bir kullanıcı listesi, UserListCustomerType örnekleri arasında çakışma olmadığı sürece birden fazla ilişkili UserListCustomerType örneğine sahip 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:

Yapılandırılmış kampanya yaşam döngüsü hedefi yapılandırmalarını ayarlama

Kampanya düzeyinde, CampaignGoalConfig kullanarak kampanyaya özel geçersiz kılmaları veya hedefleme seçeneklerini yapılandırabilirsiniz. Hesap düzeyinde bir hedefiniz olduğunda CampaignGoalConfigService üzerinde mutate_campaign_goal_configs yöntemini kullanarak CampaignGoalConfig oluşturmak için hedefin resource_name değerini kullanın.

Kampanya yeni müşteri edinme ayarları

Ayarları geçersiz kılmak veya kampanya düzeyinde NCA için hedeflemeyi yapılandırmak istiyorsanız CampaignNewCustomerAcquisitionGoalSettings türündeki campaign_new_customer_acquisition_settings alanını yapılandırın:

• value_settings_override (Tür: CustomerLifecycleOptimizationValueSettings): Hesap düzeyindeki ayarları geçersiz kılmak için özel değer ayarlamaları.
• target_option (Tür: CustomerLifecycleOptimizationMode): Müşteri yaşam döngüsü optimizasyon modunu kontrol eder. Seçenekler şunlardır:
  • TARGET_ALL: Kampanya hem yeni hem de mevcut müşterileri hedefler ancak yapılandırılan değer ayarlamalarını kullanarak yeni müşteriler için daha yüksek teklifler verir.
  • TARGET_SPECIFIC: Kampanya yalnızca yeni müşterileri hedefliyor. Teklif ayarlamaları bu seçenek için geçerli değildir.

def create_campaign_nca_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for NCA.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing NCA Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type(
        "CampaignGoalConfigOperation"
    )
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Set the target option to target both new and existing customers.
    nca_settings = goal_config.campaign_new_customer_acquisition_settings
    nca_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    nca_settings.value_settings_override.additional_value = 60.0

    campaign_goal_config_service = client.get_service(
        "CampaignGoalConfigService"
    )
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Kampanya müşteriyi elde tutma ayarları

Ayarları geçersiz kılmak veya elde tutma hedefleri için hedeflemeyi kampanya düzeyinde yapılandırmak üzere CampaignRetentionGoalSettings türündeki campaign_retention_settings alanını yapılandırın:

• value_settings_override (Tür: CustomerLifecycleOptimizationValueSettings): Hesap düzeyindeki ayarları geçersiz kılmak için özel değer ayarlamaları.
• target_option (Tür: CustomerLifecycleOptimizationMode): Optimizasyon modunu kontrol eder. Varsayılan değer TARGET_ALL'dir. Bu özelliği TARGET_SPECIFIC olarak ayarlamak için hesabınızın uygun izin verilenler listesinde olması gerekir.

def create_campaign_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Retention Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type(
        "CampaignGoalConfigOperation"
    )
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    goal_config.campaign_retention_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Accounts on the allowlist can set TARGET_SPECIFIC instead:
    # goal_config.campaign_retention_settings.target_option = (
    #     client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
    # )

    campaign_goal_config_service = client.get_service(
        "CampaignGoalConfigService"
    )
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

campaign_retention_settings.target_option ayarlanmazsa varsayılan olarak TARGET_ALL değerine ayarlanır. TARGET_SPECIFIC seçeneği yalnızca uygun izin verilenler listesindeki kullanıcılar tarafından kullanılabilir.

Kampanya bağlılık programı elde tutma ayarları

LOYALTY_RETENTION hedefleri için ayarları geçersiz kılmak veya kampanyaya özel davranışları kampanya düzeyinde yapılandırmak üzere CampaignGoalConfig üzerinde CampaignLoyaltyRetentionGoalSettings türündeki campaign_loyalty_retention_settings alanını yapılandırın:

• value_settings_override (Tür: CustomerLifecycleOptimizationValueSettings): Hesap düzeyindeki bağlılık elde tutma değeri ayarlarını geçersiz kılmak için özel değer ayarlamaları.
• enable_bid_adjustments_for_loyalty_members (Tür: bool): Bu kampanyada bağlılık programı üyeleri için teklif ayarlamalarının etkinleştirilip etkinleştirilmeyeceği.
• show_targeted_loyalty_member_benefits_in_pla (Tür: bool): Hedeflenen bağlılık programı üyesi avantajlarının, uygun ülkelerde ürün listeleme reklamı (ÜLR) biçiminde gösterilip gösterilmeyeceğini belirler.

def create_campaign_loyalty_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Loyalty.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty Goal.
        campaign_resource_name: the resource name of an existing Campaign.
    """
    operation: CampaignGoalConfigOperation = client.get_type(
        "CampaignGoalConfigOperation"
    )
    goal_config = operation.create
    goal_config.campaign = campaign_resource_name
    goal_config.goal = goal_resource_name

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    loyalty_settings = goal_config.campaign_loyalty_retention_settings
    loyalty_settings.enable_bid_adjustments_for_loyalty_members = True
    loyalty_settings.show_targeted_loyalty_member_benefits_in_pla = True

    campaign_goal_config_service = client.get_service(
        "CampaignGoalConfigService"
    )
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Doğrulama ve hatalar

Müşteri yaşam döngüsü hedefleri yapılandırılırken aşağıdaki kısıtlamalar ve hatalarla karşılaşılabilir:

Hedef doğrulama hataları

Yinelenen hedef yapılandırması

Halihazırda bir yaşam döngüsü hedefi varken aynı hedeften bir tane daha oluşturmak GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (yeni müşteri edinme için), GoalError.RETENTION_GOAL_ALREADY_EXISTS (elde tutma hedefleri için) veya GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (bağlılık elde tutma hedefleri için) hatasına neden olur.

Geçersiz değer ayarları

Yaşam döngüsü hedefi değer ayarlarını yapılandırırken yüksek yaşam boyu değer varsa standart değer de olmalıdır (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT) ve yüksek yaşam boyu değer, ayarlanmışsa değerden büyük olmalıdır (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Benzer şekilde, çarpımsal değer ayarları için yüksek yaşam boyu değer çarpanı varsa değer çarpanı da olmalıdır (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT) ve yüksek yaşam boyu değer çarpanı, değer çarpanından kesinlikle büyük olmalıdır (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Kampanya hedefi yapılandırması doğrulama hataları

Hedef belirli değer geçersiz kılma çakışması

Yeni müşteri edinme hedefleri için target_option, TARGET_SPECIFIC olarak ayarlanmışsa (yalnızca yeni müşterileri hedeflemek için) kampanya düzeyinde değer geçersiz kılmaları yapılandırılmamalıdır (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Yalnızca yeni müşteriler hedeflenirken teklif ayarlamaları geçerli değildir.

Geçersiz değer ayarlarını geçersiz kılma

Kampanya düzeyinde yaşam boyu değer ayarı geçersiz kılmaları yapılandırılırken yüksek yaşam boyu değer varsa standart değer de olmalıdır (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT) ve yüksek yaşam boyu değer, ayarlanmışsa değerden daha yüksek olmalıdır (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). Benzer şekilde, çarpımsal değer ayarları için yüksek yaşam boyu değer çarpanı varsa değer çarpanı da olmalıdır (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT) ve yüksek yaşam boyu değer çarpanı, değer çarpanından kesinlikle daha yüksek olmalıdır (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Yüksek yaşam boyu değer kampanyası türü desteği

Yüksek yaşam boyu değeri geçersiz kılmaları ve yüksek yaşam boyu değeri çarpanı geçersiz kılmaları yalnızca desteklenen kampanya türleri (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE veya CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE) için ayarlanmalıdır.

Uyumsuz hedefler

Bir kampanya, uyumlu olmayan müşteri yaşam döngüsü optimizasyonu hedeflerini aynı anda uygulamaya çalışırsa hata oluşur (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). Aşağıdaki tabloda, bu hatayı tetikleyen ve birbirini dışlayan hedef kombinasyonları açıklanmaktadır:

Yaşam döngüsü hedeflerini alma

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

Aşağıdaki sorgu, bir Google Ads API hesabında yapılandırılmış her Goal öğesinin ayrıntılarını alır:

SELECT
  goal.goal_id,
  goal.goal_type,
  goal.owner_customer,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_value,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value,
  goal.retention_goal_settings.value_settings.additional_value,
  goal.retention_goal_settings.value_settings.additional_high_lifetime_value,
  goal.loyalty_retention_goal_settings.value_settings.value_multiplier
FROM goal

Benzer şekilde, aşağıdaki sorgu her bir CampaignGoalConfig öğesinin ayrıntılarını alır:

SELECT
  campaign_goal_config.campaign,
  campaign_goal_config.goal,
  campaign_goal_config.goal_type,
  campaign_goal_config.campaign_new_customer_acquisition_settings.target_option,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_high_lifetime_value,
  campaign_goal_config.campaign_retention_settings.target_option,
  campaign_goal_config.campaign_retention_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_loyalty_retention_settings.value_settings_override.value_multiplier,
  campaign_goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members,
  campaign_goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla
FROM campaign_goal_config