Cele cyklu życia

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

Jeśli Twoje konto Google Ads korzysta ze śledzenia 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. Nadal musisz jednak na koncie ustawić cele związane z cyklem życia kampanii. Jest to podobne do zarządzania innymi celami przy użyciu ś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 jednym koncie Google Ads może być maksymalnie 1 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. Możesz odczytać wartość customer_acquisition_goal_value_settings.high_lifetime_value celu, ale to pole jest niemodyfikowalne w interfejsie Google Ads API.

Dzielenie odbiorców na segmenty

Od wersji 17 interfejsu Google Ads API musisz używać zasobu UserListCustomerType do segmentowania odbiorców na potrzeby celów związanych z cyklem życia klienta. Konfigurowanie list odbiorców bezpośrednio w zasobie CustomerLifecycleGoal zostało wycofane. Oto szczegóły:

• Przed wersją 17:
  • Dodawanie list użytkowników do kolekcji existing_user_lists w ramach CustomerLifecycleGoal.
• Od wersji 17:
  • Połącz każdą listę użytkowników z co najmniej 1 kategorią, tworząc UserListCustomerType dla każdej kombinacji listy użytkowników i kategorii.

W interfejsie Google Ads API w wersji 17 lub nowszej

Użyj funkcji UserListCustomerTypeService, aby utworzyć instancje UserListCustomerType. Jeśli pole CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists zostało już wypełnione, na Twoim koncie będą już obecne powiązane wystąpienia UserListCustomerType.

Funkcja 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 wymaganymi zmianami.

UserListCustomerType może być przypisany tylko do jednej 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 instancji UserListCustomerType za pomocą następujących kombinacji customer_type_category do tej samej listy użytkowników spowoduje błąd UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

W interfejsie Google Ads API w wersji 16

Ustaw w swoim koncie CustomerLifecycleGoal te pola:

1. lifecycle_goal_customer_definition_settings.existing_user_lists wskazuje, które listy użytkowników zawierają dotychczasowych klientów.

2. Pole lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists wskazuje, które listy użytkowników zawierają klientów o wysokiej wartości od początku śledzenia. Możesz odczytać to pole, ale nie możesz go zmienić w interfejsie Google Ads API.

Zasoby współdzielone

Do czasu wycofania wersji 16 interfejsu Google Ads API w lutym 2025 r. pamiętaj, że pola UserListCustomerType i segmentacja odbiorców w CustomerLifecycleGoal to zasoby współdzielone. Oznacza to, że tworzenie nowych instancji UserListCustomerType w wersji 17 i później spowoduje modyfikację instancji CustomerLifecycleGoal w wersji 16 i wcześniej, a także odwrotnie.

Oto jak mapowane są pola w tych 2 zasobach:

Konfigurowanie celów związanych z cyklem życia

Na poziomie kampanii skonfiguruj cel związany z cyklem życia, tworząc lub aktualizując CampaignLifecycleGoal. W przypadku każdej kampanii można utworzyć maksymalnie 1 CampaignLifecycleGoal.

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

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

TARGET_ALL_EQUALLY

Kampania kieruje reklamy tak, aby równą liczbę nowych i obecnych klientów. Jest to domyślny tryb optymalizacji.

BID_HIGHER_FOR_NEW_CUSTOMERS

Kampania jest kierowana do nowych i obecnych klientów, ale stawki są wyższe w przypadku klientów, którzy według prognozy są nowi i nie należą do żadnej z grupexisting_user_lists.

TARGET_NEW_CUSTOMERS

Kampania jest kierowana tylko na nowych klientów.

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

Pobieranie celów cyklu życia

Podobnie jak w przypadku innych zasobów w interfejsie Google Ads API, do pobierania celów cyklu życia używaj metod search lub searchStream interfejsu GoogleAdsService.

Z zapytania poniżej można pobrać szczegóły każdego CustomerLifecycleGoal na koncie Google Ads:

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

Podobnie zapytanie poniżej zwraca szczegóły każdego rekordu 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