Cele cyklu życia

Aby skonfigurować cele związane z cyklem życia klienta, skorzystaj z 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 cyklu życia klienta na koncie konwersji Google Ads, a nie bezpośrednio na koncie Google Ads. Nadal musisz jednak na koncie ustawić cele cyklu ż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.

Segmentowanie odbiorców

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:
    • Powiąż 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.

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

Element UserListCustomerType może być przypisany tylko do 1 listy użytkowników, ale z listą użytkowników może być powiązanych wiele instancji UserListCustomerType, o ile nie występują konflikty między wystąpieniami UserListCustomerType. Próba przypisania do tej samej listy użytkowników instancji UserListCustomerType z tymi kombinacjami customer_type_category spowoduje błąd UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

customer_type_category od opublikowania Druga customer_type_category
KUPUJĄCY CONVERTED_LEADS
KUPUJĄCY QUALIFIED_LEADS
KUPUJĄCY CART_ABANDONERS
CONVERTED_LEADS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CONVERTED_LEADS
DISENGAGED_CUSTOMERS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CART_ABANDONERS

W interfejsie Google Ads API v16

Ustaw na 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 w interfejsie Google Ads API nie można go zmienić.

Zasoby współdzielone

Do stycznia 2025 r., kiedy nastąpi wycofanie interfejsu Google Ads API w wersji 16, 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 lub nowszej spowoduje modyfikację instancji CustomerLifecycleGoal w wersji 16 lub starszej i na odwrót.

Oto jak mapowane są pola w tych 2 zasobach:

Zmiana pola „CustomerLifecycleGoal” w wersji 16 Skutek uboczny w przypadku kolumny „UserListCustomerType” w wersji 17
lifecycle_goal_customer_definition_settings.existing_user_lists Tworzy lub usuwa instancje UserListCustomerType. Pole user_list zawiera nazwę zasobu powiązanej listy użytkowników.
Zmiana właściwości „UserListCustomerType” w wersji 17 Skutek uboczny w polu „CustomerLifecycleGoal” w wersji 16
tworzyć i usuwać instancje UserListCustomerType. Poszczególne nazwy zasobów zostaną dodane do listy lub usunięte z niej.lifecycle_goal_customer_definition_settings.existing_user_lists
Tworzenie i usuwanie instancji UserListCustomerType, w których parametr customer_type_category ma wartość HIGH_VALUE_CUSTOMERS Poszczególne nazwy zasobów zostaną dodane do listy lub usunięte z niej.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists

Konfigurowanie celów cyklu życia kampanii

Aby skonfigurować cel cyklu życia na poziomie kampanii, utwórz lub zaktualizuj 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 klientem.

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

TARGET_ALL_EQUALLY
Kampania kieruje reklamy w równym stopniu do nowych i dotychczasowych klientów. 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.

value_settings są takie same jak 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

Analogicznie, to zapytanie 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
Wstecz
Cele kampanii