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 jegoresource_name
ani nie ustawiajupdate_mask
operacji.Aby zaktualizować cel cyklu życia za pomocą wersji 15, wypełnij pole
create
celem, ustawresource_name
celu, aupdate_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
elementuCustomerLifecycleGoal
.
- Dodaj listy użytkowników do kolekcji
- 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.
- Powiąż każdą listę użytkowników z co najmniej 1 kategorią, tworząc
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:
lifecycle_goal_customer_definition_settings.existing_user_lists
wskazuje, które listy użytkowników zawierają obecnych klientów.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