Cele cyklu życia

Zapoznaj się z dokumentami CustomerLifecycleGoal oraz CampaignLifecycleGoal zasobów Interfejs Google Ads API do konfigurowania celów związanych z cyklem życia klienta. Od wersji 15 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, cele związane z cyklem życia klienta musisz skonfigurować na koncie klienta śledzenia 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. Przydatność najwyżej jeden CustomerLifecycleGoal na konto Google Ads. 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. Dostępne opcje przeczytaj customer_acquisition_goal_value_settings.high_lifetime_value celu, ale tego pola nie można zmienić w interfejsie Google Ads API.

Dzielenie list 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 jedną lub kilkoma kategoriami, 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 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 create i remove operacji, więc jeśli chcesz zaktualizować istniejący UserListCustomerType, musisz je usunąć, a potem utworzyć nowy z wymaganymi aktualizacjami.

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. 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.

Zachowanie udostępnionych zasobów

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:

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.

Dzięki polu customer_acquisition_goal_settings celu na poziomie kampanii możesz: ustawić tryb optymalizacji kampanii i zastąpić ustawienia wartości od celu klienta nadrzędnego.

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 grup existing_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 ustawieniami na poziomie kampanii, aby zastąpić wartości w wybranej kampanii.

Pobieranie celów cyklu życia

Podobnie jak w przypadku innych zasobów interfejsu Google Ads API, użyj search lub searchStream metody pobierania GoogleAdsService celów cyklu życia.

To zapytanie pobiera szczegóły każdego pola CustomerLifecycleGoal w Konto 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 poniższe zapytanie pobiera szczegóły każdego 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