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 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_listsw ramachCustomerLifecycleGoal.
- Dodawanie list użytkowników do kolekcji
- Od wersji 17:
- Połącz każdą listę użytkowników z co najmniej 1 kategorią, tworząc
UserListCustomerTypedla każdej kombinacji listy użytkowników i kategorii.
- Połącz każdą listę użytkowników z co najmniej 1 kategorią, tworząc
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:
customer_type_category od opublikowania |
Drugi 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 w wersji 16
Ustaw w swoim koncie CustomerLifecycleGoal te pola:
lifecycle_goal_customer_definition_settings.existing_user_listswskazuje, które listy użytkowników zawierają dotychczasowych klientów.Pole
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_listswskazuje, 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 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 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 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 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. 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 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