Cele cyklu życia

Aby skonfigurować cele związane z cyklem życia klienta, użyj zasobów CustomerLifecycleGoal i CampaignLifecycleGoal w interfejsie Google Ads API. Interfejs Google Ads API obsługuje cele pozyskiwania klientów, które umożliwiają efektywne pozyskiwanie nowych klientów za pomocą kampanii w sieci wyszukiwania, kampanii produktowych i kampanii Performance Max w Google Ads.

Jeśli na Twoim koncie Google Ads jest używane śledzenie konwersji dla wielu kont, musisz skonfigurować cele związane z cyklem życia klienta na koncie konwersji Google Ads, a nie bezpośrednio na koncie Google Ads. Cele związane z cyklem życia kampanii należy jednak nadal ustawiać na swoim koncie. Podobnie zarządzasz innymi celami, gdy używasz śledzenia konwersji dla wielu kont.

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

Na poziomie klienta skonfiguruj cel związany z cyklem życia, tworząc lub aktualizując CustomerLifecycleGoal. Na każdym koncie Google Ads może być co najwyżej 1 cel CustomerLifecycleGoal. Pole customer_acquisition_goal_value_settings.value określa dodatkową korektę wartości, którą należy dodać do konwersji polegającej na pierwszym zakupie przez nowego klienta. Pole customer_acquisition_goal_value_settings.high_lifetime_value określa przyrostową wartość konwersji w przypadku nowych klientów o wysokiej wartości. Jeśli jest ustawiona, wysoka wartość od początku śledzenia powinna być większa niż wartość.

Segmentowanie odbiorców

Aby segmentować odbiorców na potrzeby celów związanych z cyklem życia klienta, musisz użyć zasobu UserListCustomerType. Każda lista użytkowników musi być powiązana z co najmniej 1 kategorią. W tym celu utwórz UserListCustomerType dla każdej kombinacji listy użytkowników i kategorii.

Aby utworzyć UserListCustomerType instancje, użyj UserListCustomerTypeService. Jeśli wcześniej wypełniłeś pole CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, które jest już wycofane, Twoje konto będzie już zawierać powiązane instancje UserListCustomerType.

UserListCustomerTypeService obsługuje tylko create i remove operacje. Jeśli chcesz zaktualizować istniejącą instancję UserListCustomerType, musisz ją usunąć, a następnie utworzyć nową z odpowiednimi zmianami.

Instancję UserListCustomerType można przypisać tylko do 1 listy użytkowników, ale lista użytkowników może mieć wiele powiązanych instancji UserListCustomerType pod warunkiem, że 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 spowoduje błąd UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Pierwsza customer_type_category	Druga customer_type_category
PURCHASERS	CONVERTED_LEADS
PURCHASERS	QUALIFIED_LEADS
PURCHASERS	CART_ABANDONERS
CONVERTED_LEADS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CONVERTED_LEADS
DISENGAGED_CUSTOMERS	QUALIFIED_LEADS
DISENGAGED_CUSTOMERS	CART_ABANDONERS
LOYALTY_TIER_X_MEMBERS	LOYALTY_TIER_Y_MEMBERS

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

Na poziomie kampanii możesz skonfigurować ustawienia celu pozyskiwania klientów, by tworząc lub aktualizując CampaignLifecycleGoal. W przypadku pozyskiwania klientów na każdą kampanię może przypadać co najwyżej 1 cel CampaignLifecycleGoal. Pamiętaj, że inne typy celów, np. cele dotyczące utrzymania klientów, są konfigurowane osobno.

Pole customer_acquisition_goal_settings celu na poziomie kampanii umożliwia ustawienie trybu optymalizacji kampanii oraz zastąpienie ustawień wartości z nadrzędnego celu klienta.

Wartość optimization_mode może być jedną z tych wartości:

TARGET_ALL_EQUALLY

Kampania kieruje reklamy na nowych i obecnych klientów w równym stopniu. Jest to domyślny tryb optymalizacji.

BID_HIGHER_FOR_NEW_CUSTOMERS

Kampania kieruje reklamy zarówno na nowych, jak i obecnych klientów, ale stosuje wyższe stawki w przypadku klientów, którzy według prognoz są nowi i nie znajdują się na żadnej z list existing_user_lists.

TARGET_NEW_CUSTOMERS

Kampania kieruje reklamy tylko na nowych klientów.

value_settings są takie same jak customer_acquisition_goal_value_settings w przypadku celu na poziomie klienta. Użyj tych ustawień na poziomie kampanii, aby zastąpić wartości w przypadku konkretnej kampanii.

Cele dotyczące utrzymania klientów

Uwaga: cele dotyczące utrzymania klientów mają zastosowanie tylko do kampanii Performance Max.

Cele dotyczące utrzymania klientów mają zwiększać lojalność klientów i zapewniać Twojej firmie wysoką wartość od początku śledzenia. Są one dostępne w różnych trybach w ramach kampanii Performance Max, co pozwala Ci kierować reklamy na konkretne segmenty odbiorców złożone z obecnych klientów.

Zanim utworzysz cel dotyczący utrzymania klientów, musisz spełnić wymagania wstępne opisane w artykule Cele dotyczące utrzymania klientów. Obejmuje to m.in. posiadanie kampanii Performance Max i listy użytkowników w ramach kierowania na listę klientów.

Aby utworzyć cel dotyczący utrzymania klientów, musisz najpierw zainicjować GoalService i wysłać żądanie za pomocą metody mutate_goals, aby utworzyć nowy cel.

def create_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new 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.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]
    )

Spowoduje to utworzenie nowego celu dotyczącego utrzymania klientów na poziomie konta dla określonego konta klienta, który będzie stosowany do wszystkich jego kampanii. Domyślnie ten cel będzie kierowany na wszystkich użytkowników na listach użytkowników w ramach kierowania na listę klientów.

Ten cel można zastąpić ustawieniami na poziomie kampanii za pomocą CampaignGoalConfig. Gdy masz już cel na poziomie konta, użyj jego resource_name, aby utworzyć CampaignGoalConfig za pomocą mutate_campaign_goal_configs metody w CampaignGoalConfigService.

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

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

    # Note that the target_option will be set to TARGET_ALL by default. In order
    # to set it to TARGET_SPECIFIC your account must be on the appropriate
    # allowlist.
    #
    # 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]
    )

Jeśli nie ustawisz wartości campaign_retention_settings.target_option , domyślnie będzie ona mieć wartość TARGET_ALL. Opcja ustawienia wartości TARGET_SPECIFIC jest dostępna tylko dla użytkowników na odpowiedniej liście dozwolonych.

Pobieranie celów związanych z cyklem życia

Podobnie jak w przypadku innych zasobów w interfejsie Google Ads API, do pobierania celów związanych z cyklem życia użyj metod search lub searchStream GoogleAdsService.

To zapytanie pobiera szczegóły każdego celu CustomerLifecycleGoal na koncie Google Ads:

SELECT
  customer_lifecycle_goal.owner_customer,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal

Podobnie to zapytanie pobiera szczegóły każdego celu 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