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ğeri ayarlamalarını verimli bir şekilde yönetmek için müşteri edinme hedeflerini ve elde tutma hedeflerini destekler.

Google Ads hesabınız hesaplar arası dönüşüm izleme kullanı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 yine de hesabınızda kampanya düzeyinde yapılandırmalar ayarlamanız gerekir. Bu, hesaplar arası dönüşüm izleme 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.

CUSTOMER_RETENTION

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

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, Goal oluşturarak bir yaşam döngüsü hedefi yapılandırın. Bir Google Ads hesabında hedef türü (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION veya LOYALTY_RETENTION) başına en fazla bir Goal olabilir.

Yeni müşteri edinme hedefi ayarları

Yeni müşteri edinme (NCA) özelliğini ayarlamak için goal_type seçeneğini NEW_CUSTOMER_ACQUISITION olarak belirleyin ve new_customer_acquisition_goal_settings alanındaki ayarları GoalService kullanarak yapılandırın.

Ayarlarda, edinilen müşteriler için dönüşüm değeri ayarlamalarını belirtmek üzere CustomerLifecycleOptimizationValueSettings kullanılır:

• value_adjustment (oneof):
  • additional_value (çift): Yeni bir müşterinin ilk satın alma dönüşümüne eklenecek artımlı dönüşüm değeri.
  • value_multiplier (çift): Yeni müşterinin ilk satın alma işlemine ait dönüşüm değerine uygulanacak çarpan (henüz desteklenmemektedir).
• high_lifetime_value_adjustment (oneof):
  • additional_high_lifetime_value (çift): Yaşam boyu değeri yüksek olarak tanımlanan yeni müşteriler için artımlı dönüşüm değeri.
  • high_lifetime_value_multiplier (çift): Yaşam boyu değeri yüksek olan yeni müşteriler için uygulanacak dönüşüm değeri çarpanı (henüz desteklenmemektedir).

Yüksek yaşam boyu değeri, ayarlanmışsa değerden 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.
    goal.new_customer_acquisition_goal_settings.value_settings.additional_value = 50.0
    goal.new_customer_acquisition_goal_settings.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 tutma ayarını yapmak için goal_type seçeneğini 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 bölümünde açıklanan ön koşulları karşılamanız gerekir. Buna, Maksimum Performans kampanyası ve Müşteri Eşleştirme kullanıcı listesi sahibi olmak da 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
    goal.retention_goal_settings.value_settings.additional_value = 50.0
    goal.retention_goal_settings.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. Bu hedef, müşteri hesabını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 programı elde tutma hedefi ayarları

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

Bağlılık programı üyelerini elde tutma hedefleri için CustomerLifecycleOptimizationValueSettings kullanılarak value_settings içinde yalnızca value_multiplier ayarı desteklenir:

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ü hedefleri (yeni müşteri edinme, müşteri elde tutma ve bağlılık elde tutma hedefleri dahil) için segmentlere ayırmak üzere 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.

UserListCustomerTypeService kullanarak UserListCustomerType örnekleri oluşturun.

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üncellemelerle yeni bir öğe oluşturmanız gerekir.

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

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çenekleri yapılandırabilirsiniz. Hesap düzeyinde bir hedefiniz olduğunda, CampaignGoalConfigService üzerinde mutate_campaign_goal_configs yöntemini kullanarak resource_name ile CampaignGoalConfig oluşturun.

Kampanya yeni müşteri edinme ayarları

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

• value_settings_override (Tür: CustomerLifecycleOptimizationValueSettings): Hesap düzeyindeki ayarları geçersiz kılacak özel değer düzenlemeleri.
• 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 hedefler. 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.
    goal_config.campaign_new_customer_acquisition_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    goal_config.campaign_new_customer_acquisition_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ılacak özel değer düzenlemeleri.
• target_option (Tür: CustomerLifecycleOptimizationMode): Optimizasyon modunu kontrol eder. Varsayılan olarak TARGET_ALL değerine ayarlanır. Bu ayarı TARGET_SPECIFIC olarak belirlemek 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_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 ayarlanmamışsa varsayılan olarak TARGET_ALL olur. TARGET_SPECIFIC olarak ayarlama seçeneği yalnızca uygun izin verilenler listesindeki kullanıcılar tarafından kullanılabilir.

Kampanya bağlılığıyla müşteriyi elde tutma ayarları

LOYALTY_RETENTION hedefleri için ayarları geçersiz kılmak veya kampanyaya özel olarak sadakat programı üyelerine yönelik davranışları yapılandırmak istiyorsanız 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 programı ile müşteriyi elde tutma değeri ayarlarını geçersiz kılacak özel değer düzenlemeleri.
• 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ği.

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 Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty 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

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members = True
    goal_config.campaign_loyalty_retention_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 (NCA 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ğeri varsa standart değer de olmalıdır (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Ayrıca, ayarlanmışsa yüksek yaşam boyu değeri değerden büyük olmalıdır (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

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

Belirli hedef değer geçersiz kılma çakışması

Yeni müşteri edinme hedefleri için target_option, TARGET_SPECIFIC olarak ayarlanırsa (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.

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

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

Uyumsuz hedefler

Bir kampanya, uyumsuz müşteri yaşam döngüsü optimizasyonu hedeflerini aynı anda uygulamaya çalışırsa hata verilir (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). Aşağıdaki tabloda, bu hatayı tetikleyen karşılıklı olarak hariç tutulan hedef kombinasyonları özetlenmiştir:

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'in 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 CampaignGoalConfig ayrıntısı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