Cele cyklu życia

Aby skonfigurować cele związane z cyklem życia klienta, skorzystaj z zasobów CustomerLifecycleGoal i CampaignLifecycleGoal interfejsu Google Ads API. Od wersji 15 interfejs Google Ads API obsługuje cele związane z pozyskiwaniem klientów do efektywnego pozyskiwania nowych klientów za pomocą kampanii Google Ads w sieci wyszukiwania i kampanii Performance Max.

Jeśli używasz na koncie Google Ads śledzenia konwersji dla wielu kont, cele związane z cyklem życia klienta musisz skonfigurować na koncie klienta konwersji Google Ads, a nie bezpośrednio na koncie Google Ads. Mimo to ustawiasz na koncie cele cyklu życia kampanii. Przypomina to zarządzanie innymi celami podczas korzystania ze śledzenia konwersji dla wielu kont.

Obsługa operacji tworzenia i aktualizacji (tylko w wersji 15)

W wersji 15 interfejsu Google Ads API operacje obsługiwane w interfejsach CustomerLifecycleGoalService i CampaignLifecycleGoalService różnią się nieco od innych usług w interfejsie Google Ads API. Zamiast osobnych operacji create i update wersje v15 CustomerLifecycleGoalOperation i CampaignLifecycleGoalOperation zawierają tylko operację create, a intencje możesz wskazać za pomocą parametru update_mask w ten sposób:

  • Aby utworzyć cel cyklu życia przy użyciu wersji 15, wypełnij cel create, ale nie ustawiaj jego resource_name ani nie ustawiaj update_mask operacji.

  • Aby zaktualizować cel cyklu życia za pomocą wersji 15, wypełnij pole create celem, ustaw resource_name celu, a update_mask ustaw listę pól, które chcesz zaktualizować.

Skonfiguruj cele związane z cyklem życia klienta

Aby skonfigurować cel cyklu życia na poziomie klienta, utwórz lub zaktualizuj 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ć customer_acquisition_goal_value_settings.high_lifetime_value celu, ale tego pola nie można zmienić w interfejsie Google Ads API.

Segmentowanie odbiorców

Od wersji interfejsu Google Ads API w wersji 17 do podziału odbiorców na segmenty pod kątem celów związanych z cyklem życia klienta musisz używać zasobu UserListCustomerType. Funkcja konfigurowania list odbiorców bezpośrednio w zasobie CustomerLifecycleGoal została wycofana. Oto szczegóły:

  • Przed wersją 17:
    • Dodaj listy użytkowników do kolekcji existing_user_lists elementu 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 i nowszych

Użyj opcji UserListCustomerTypeService, aby utworzyć instancje UserListCustomerType. Jeśli pole CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists zostało już wypełnione, Twoje konto będzie zawierać 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
NABIORCY CONVERTED_LEADS
NABIORCY QUALIFIED_LEADS
NABIORCY CART_ABANDONERS
CONVERTED_LEADS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CONVERTED_LEADS
DISENGAGED_CUSTOMERS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CART_ABANDONERS

W interfejsie Google Ads API w wersji 16 lub starszej

Ustaw na koncie CustomerLifecycleGoal te pola:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists wskazuje, które listy użytkowników zawierają obecnych 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ć.

Zachowanie udostępnionych zasobów

Pamiętaj, że do momentu wycofania interfejsu Google Ads API w wersji 16 w styczniu 2025 r. pamiętaj, że UserListCustomerType i pola podziału odbiorców w CustomerLifecycleGoal są wspólnymi zasobami, co oznacza, że utworzenie nowych instancji UserListCustomerType w wersji 17 i nowszych spowoduje modyfikację instancji CustomerLifecycleGoal w wersji 16 i starszych i odwrotnie.

Oto jak są mapowane pola tych 2 zasobów:

Mutacja pola „CustomerLifecycleGoal” w wersji 16 Efekt uboczny na `UserListCustomerType` w wersji 17
lifecycle_goal_customer_definition_settings.existing_user_lists Tworzy lub usuwa UserListCustomerType instancje. Pole user_list zawiera nazwę zasobu powiązanej listy użytkowników.
Mutacja `UserListCustomerType` w wersji 17 Efekt uboczny na polu „CustomerLifecycleGoal” w wersji 16
Utwórz lub usuń UserListCustomerType instancję. Poszczególne nazwy zasobów zostaną dodane do lifecycle_goal_customer_definition_settings.existing_user_lists lub z niego usunięte
Utwórz lub usuń instancje UserListCustomerType, w których customer_type_category ma wartość HIGH_VALUE_CUSTOMERS Poszczególne nazwy zasobów zostaną dodane do lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists lub z niego usunięte

Skonfiguruj cele cyklu życia kampanii

Aby skonfigurować cel cyklu życia na poziomie kampanii, utwórz lub zaktualizuj CampaignLifecycleGoal. W kampanii można podać maksymalnie 1 CampaignLifecycleGoal.

Pole customer_acquisition_goal_settings celu na poziomie kampanii pozwala ustawić tryb optymalizacji kampanii i zastąpić ustawienia wartości celu z nadrzędnego celu klienta.

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

TARGET_ALL_EQUALLY
Kampania jest kierowana w równym stopniu na nowych i obecnych klientów. To domyślny tryb optymalizacji.
BID_HIGHER_FOR_NEW_CUSTOMERS
Kampania jest kierowana zarówno na nowych, jak i dotychczasowych klientów, ale ustala wyższe stawki dla klientów, którzy według prognozy są nowi i nie należą do żadnego z tych klientów: existing_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. Te ustawienia na poziomie kampanii służą do zastępowania wartości w konkretnej kampanii.

Pobieranie celów cyklu życia

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

To zapytanie pobiera szczegółowe informacje o każdym elemencie 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 pobiera szczegóły każdego obiektu 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