Cele cyklu życia

Skonfiguruj cele związane z cyklem życia klienta za pomocą zasobów Goal i CampaignGoalConfig interfejsu Google Ads API. Interfejs Google Ads API obsługuje cele związane z pozyskiwaniem klientów i cele związane z utrzymaniem klientów, co umożliwia efektywne zarządzanie korektami wartości cyklu życia klienta za pomocą kampanii Google Ads.

Jeśli Twoje konto Google Ads korzysta ze śledzenia konwersji dla wielu kont, musisz skonfigurować cele związane z cyklem życia na poziomie klienta na koncie konwersji Google Ads, a nie bezpośrednio na koncie Google Ads. Nadal jednak musisz skonfigurować ustawienia na poziomie kampanii na swoim koncie. Działa to podobnie jak w przypadku zarządzania innymi celami podczas korzystania ze śledzenia konwersji dla wielu kont.

Rodzaje celów związanych z cyklem życia klienta

Cele związane z cyklem życia klienta konfiguruje się na poziomie konta za pomocą zasobu Goal. Cel reprezentuje konkretny cel związany z cyklem życia i jest określany przez jego goal_type.

Obsługiwane typy celów związanych z cyklem życia klienta:

NEW_CUSTOMER_ACQUISITION

Aby skutecznie pozyskiwać nowych klientów, przypisując korekty wartości do ich konwersji.

CUSTOMER_RETENTION

Do ponownego angażowania obecnych, wartościowych i nieaktywnych klientów.

LOYALTY_RETENTION

Aby zwiększać utrzymanie klientów i zaangażowanie, zwłaszcza wśród uczestników programu lojalnościowego.

Konfigurowanie celów związanych z cyklem życia klienta

Na poziomie klienta skonfiguruj cel związany z cyklem życia, tworząc Goal. Na koncie Google Ads może być co najwyżej 1 Goal na typ celu (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION lub LOYALTY_RETENTION).

Ustawienia celu dotyczącego pozyskiwania nowych klientów

Aby skonfigurować pozyskiwanie nowych klientów, ustaw wartość goal_type na NEW_CUSTOMER_ACQUISITION i skonfiguruj ustawienia w polu new_customer_acquisition_goal_settings za pomocą GoalService.

Pole new_customer_acquisition_goal_settings.value_settings używa wartości CustomerLifecycleOptimizationValueSettings do określania korekt wartości konwersji w przypadku pozyskanych klientów:

• value_settings (CustomerLifecycleOptimizationValueSettings):
  • value_adjustment (oneof):
    • additional_value (double): przyrostowa wartość konwersji, którą należy dodać do konwersji polegającej na pierwszym zakupie przez nowego klienta.
    • value_multiplier (double): mnożnik, który ma być zastosowany do wartości konwersji w przypadku pierwszego zakupu nowego klienta (nie jest obsługiwany w przypadku NEW_CUSTOMER_ACQUISITION, ale jest obsługiwany w przypadku LOYALTY_RETENTION).
  • high_lifetime_value_adjustment (oneof):
    • additional_high_lifetime_value (liczba zmiennoprzecinkowa): przyrostowa wartość konwersji w przypadku nowych klientów, którzy zostali zidentyfikowani jako klienci o wysokiej wartości od początku śledzenia.
    • high_lifetime_value_multiplier (double): mnożnik wartości konwersji, który ma być stosowany w przypadku nowych klientów o wysokiej wartości od początku śledzenia (nie jest jeszcze obsługiwany).

Wartość od początku śledzenia musi być większa niż wartość, a mnożnik wartości od początku śledzenia musi być większy niż mnożnik wartości, jeśli jest ustawiony.

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]
    )

Ustawienia celu dotyczącego utrzymania klientów

Aby skonfigurować utrzymanie klientów, ustaw wartość goal_type na CUSTOMER_RETENTION i skonfiguruj ustawienia w polu retention_goal_settings.

Zanim utworzysz cel dotyczący utrzymania klientów, musisz spełnić wymagania wstępne opisane w artykule Cel dotyczący utrzymania klientów. Obejmuje to kampanię Performance Max i listę użytkowników kierowania na listę klientów.

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]
    )

Spowoduje to utworzenie nowego celu dotyczącego utrzymania klientów na poziomie konta określonego konta klienta, który będzie stosowany we wszystkich jego kampaniach. Domyślnie ten cel jest kierowany na wszystkich użytkowników z Twoich list użytkowników z kierowania na listę klientów.

Ustawienia celu utrzymania lojalności

Aby skonfigurować cele dotyczące utrzymania lojalności dla uczestników programu lojalnościowego, ustaw wartość parametru goal_type na LOYALTY_RETENTION i skonfiguruj ustawienia w polu loyalty_retention_goal_settings (LoyaltyRetentionGoal).

W przeciwieństwie do celów NEW_CUSTOMER_ACQUISITION i CUSTOMER_RETENTION (które korzystają z dostosowań wartości addytywnych) cele LOYALTY_RETENTION obsługują ustawienie value_multiplier w value_settings za pomocą CustomerLifecycleOptimizationValueSettings:

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]
    )

Segmentowanie odbiorców

Aby segmentować listy odbiorców na potrzeby celów związanych z cyklem życia klienta (w tym celów „Pozyskiwanie nowych klientów”, „Utrzymanie klientów” i „Utrzymanie lojalności”), musisz używać zasobu UserListCustomerType. Musisz powiązać każdą listę użytkowników z co najmniej jedną kategorią, tworząc UserListCustomerType dla każdej kombinacji listy użytkowników i kategorii.

Użyj ikony UserListCustomerTypeService, aby utworzyć instancje UserListCustomerType.

UserListCustomerTypeService obsługuje tylko operacje create i remove, więc jeśli chcesz zaktualizować istniejący element UserListCustomerType, musisz go usunąć, a następnie utworzyć nowy z niezbędnymi zmianami.

UserListCustomerType można przypisać tylko do 1 listy użytkowników, ale lista użytkowników może mieć wiele powiązanych instancji UserListCustomerType, o ile nie ma między nimi konfliktów.UserListCustomerType Próba przypisania UserListCustomerType instancji z tymi kombinacjami customer_type_category do tej samej listy użytkowników powoduje błąd UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Konfigurowanie celów związanych z cyklem życia kampanii

Na poziomie kampanii możesz skonfigurować zastąpienia lub opcje kierowania specyficzne dla kampanii za pomocą CampaignGoalConfig. Gdy masz już cel na poziomie konta, użyj jego resource_name, aby utworzyć CampaignGoalConfig za pomocą metody mutate_campaign_goal_configs na CampaignGoalConfigService.

Ustawienia kampanii dotyczące pozyskiwania nowych klientów

Aby zastąpić ustawienia lub skonfigurować kierowanie na potrzeby pozyskiwania nowych klientów na poziomie kampanii, skonfiguruj pole campaign_new_customer_acquisition_settings typu CampaignNewCustomerAcquisitionGoalSettings:

• value_settings_override (Type: CustomerLifecycleOptimizationValueSettings): Niestandardowe korekty wartości, które zastępują ustawienia na poziomie konta.
• target_option (Type: CustomerLifecycleOptimizationMode): określa tryb optymalizacji cyklu życia klienta. Dostępne opcje:
  • TARGET_ALL: Kampania jest kierowana na nowych i obecnych klientów, ale ustala wyższe stawki w przypadku nowych klientów, korzystając ze skonfigurowanych korekt wartości.
  • TARGET_SPECIFIC: kampania jest kierowana tylko na nowych klientów. Dostosowania stawek nie mają zastosowania w przypadku tej opcji.

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]
    )

Ustawienia utrzymania klientów w kampanii

Aby zastąpić ustawienia lub skonfigurować kierowanie na cele związane z utrzymaniem klientów na poziomie kampanii, skonfiguruj pole campaign_retention_settings typu CampaignRetentionGoalSettings:

• value_settings_override (Type: CustomerLifecycleOptimizationValueSettings): Niestandardowe korekty wartości, które zastępują ustawienia na poziomie konta.
• target_option (Type: CustomerLifecycleOptimizationMode): określa tryb optymalizacji. Domyślna wartość to TARGET_ALL. Aby ustawić tę wartość na TARGET_SPECIFIC, Twoje konto musi znajdować się na odpowiedniej liście dozwolonych kont.

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_optionJeśli nie zostanie ustawiona, domyślnie przyjmuje wartość TARGET_ALL. Opcja ustawienia TARGET_SPECIFIC jest dostępna tylko dla użytkowników z odpowiedniej listy dozwolonych.

Ustawienia utrzymania klientów w programie lojalnościowym w kampanii

Aby zastąpić ustawienia lub skonfigurować zachowanie specyficzne dla uczestników programu lojalnościowego na poziomie kampanii w przypadku celów LOYALTY_RETENTION, skonfiguruj pole campaign_loyalty_retention_settings typu CampaignLoyaltyRetentionGoalSettings w CampaignGoalConfig:

• value_settings_override (Type: CustomerLifecycleOptimizationValueSettings): Niestandardowe korekty wartości, które zastępują ustawienia wartości utrzymania klientów w programie lojalnościowym na poziomie konta.
• enable_bid_adjustments_for_loyalty_members (Type: bool): czy w tej kampanii włączyć korekty stawek dla uczestników programu lojalnościowego.
• show_targeted_loyalty_member_benefits_in_pla (Typ: bool): czy w odpowiednich krajach wyświetlać w reklamach z informacjami o produktach korzyści dla uczestników programu lojalnościowego.

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]
    )

Weryfikacja i błędy

Podczas konfigurowania celów związanych z cyklem życia klienta mogą wystąpić te ograniczenia i błędy:

Błędy weryfikacji celu

Zduplikowana konfiguracja celu

Utworzenie zduplikowanego celu związanego z cyklem życia klienta, gdy taki cel już istnieje, powoduje błąd:GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (w przypadku celu „Pozyskiwanie nowych klientów”),GoalError.RETENTION_GOAL_ALREADY_EXISTS (w przypadku celów związanych z utrzymaniem klientów) lubGoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (w przypadku celów związanych z utrzymaniem lojalności klientów).

Nieprawidłowe ustawienia wartości

Podczas konfigurowania ustawień wartości celu związanego z cyklem życia, jeśli występuje wysoka wartość od początku śledzenia, musi też występować wartość standardowa (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT), a wartość od początku śledzenia musi być większa od wartości, jeśli została ustawiona (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Podobnie w przypadku ustawień wartości multiplikatywnych, jeśli występuje mnożnik wysokiej wartości od początku śledzenia, musi też występować mnożnik wartości (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), a mnożnik wysokiej wartości od początku śledzenia musi być ściśle większy od mnożnika wartości (GoalError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Błędy weryfikacji konfiguracji celu kampanii

Konflikt dotyczący zastąpienia określonej wartości docelowej

W przypadku celów „Pozyskiwanie nowych klientów”, jeśli parametr target_option ma wartość TARGET_SPECIFIC (kierowanie tylko na nowych klientów), nie można skonfigurować zastąpień wartości na poziomie kampanii (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Dostosowania stawek nie mają zastosowania, gdy kierujesz reklamy tylko na nowych klientów.

Zastępowanie ustawień nieprawidłowej wartości

Podczas konfigurowania zastąpień ustawień wartości od początku śledzenia na poziomie kampanii, jeśli występuje wysoka wartość od początku śledzenia, musi też występować wartość standardowa (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT), a wysoka wartość od początku śledzenia musi być większa od wartości, jeśli jest ustawiona (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE). Podobnie w przypadku ustawień wartości multiplikatywnych, jeśli występuje mnożnik wysokiej wartości od początku śledzenia, musi też występować mnożnik wartości (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT), a mnożnik wysokiej wartości od początku śledzenia musi być ściśle większy od mnożnika wartości (CampaignGoalConfigError.HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER).

Obsługa typów kampanii o wysokiej wartości od początku śledzenia

Zastąpienia wartości od początku śledzenia i zastąpienia mnożnika wartości od początku śledzenia muszą być ustawione tylko w przypadku obsługiwanych typów kampanii (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE lub CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

Niezgodne cele

Jeśli kampania próbuje jednocześnie zastosować niezgodne cele optymalizacji cyklu życia klienta, pojawia się błąd (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). W tabeli poniżej znajdziesz wykluczające się wzajemnie kombinacje celów, które powodują ten błąd:

Pobieranie celów związanych z cyklem życia

Podobnie jak w przypadku innych zasobów w interfejsie Google Ads API, do pobierania celów i konfiguracji związanych z cyklem życia klienta używaj metod search lub searchStreamGoogleAdsService.

To zapytanie pobiera szczegóły każdego skonfigurowanego Goal na koncie interfejsu Google Ads API:

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

Podobnie to zapytanie pobiera szczegóły każdego CampaignGoalConfig:

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