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 pozyskiwanie klientów
efektywnych celów
pozyskiwanie nowych klientów za pomocą kampanii Google Ads w sieci wyszukiwania i kampanii Performance Max
kampanie.
Jeśli na swoim koncie Google Ads używasz śledzenia konwersji dla wielu kont, musi skonfigurować cele cyklu życia klienta w konwersji Google Ads, z konta zamiast bezpośrednio na konto Google Ads. Nadal należy ustawić celów cyklu życia kampanii. To podobnie jak w przypadku zarządzać innymi celami, gdy używasz śledzenie konwersji dla wielu kont.
Obsługa operacji tworzenia i aktualizacji (tylko w wersji 15)
W interfejsie Google Ads API w wersji 15 operacje obsługiwane
CustomerLifecycleGoalService
i
CampaignLifecycleGoalService
nieco różnią się od innych funkcji interfejsu Google Ads API. Zamiast oddzielnych
Operacje create
i update
, wersja v15
CustomerLifecycleGoalOperation
.
oraz
CampaignLifecycleGoalOperation
.
masz tylko operację create
, a intencję wskazujesz za pomocą funkcji
update_mask
w następujący sposób:
Aby utworzyć cel cyklu życia przy użyciu wersji 15, wypełnij pole
create
celem, ale nie ustawiaj jegoresource_name
aniupdate_mask
.Aby zaktualizować cel cyklu życia za pomocą wersji 15, wypełnij pole
create
wybranym celemresource_name
celu i ustawupdate_mask
tak, by wyświetlała pola, które chcesz zaktualizować.
Skonfiguruj cele związane z cyklem życia klienta
Skonfiguruj cel cyklu życia na poziomie klienta, tworząc lub aktualizując
CustomerLifecycleGoal
Przydatność
najwyżej jeden CustomerLifecycleGoal
na konto Google Ads.
Pole customer_acquisition_goal_value_settings.value
określa dodatkowe
dostosowania wartości, które 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.
Segmentowanie odbiorców
Od wersji 17 interfejsu Google Ads API musisz używać
UserListCustomerType
zasób do podziału na segmenty
pod kątem celów związanych z cyklem życia klienta. Konfiguruję odbiorców bezpośrednio w
zasób CustomerLifecycleGoal
jest
wycofane. Oto szczegóły:
- Przed wersją 17:
- Dodaj listy użytkowników do kolekcji
existing_user_lists
w kolekcjiCustomerLifecycleGoal
- Dodaj listy użytkowników do kolekcji
- Od wersji 17:
- Powiąż każdą listę użytkowników z co najmniej jedną kategorią, tworząc
UserListCustomerType
dla każdej kombinacji listy użytkowników i kategorii.
- Powiąż każdą listę użytkowników z co najmniej jedną kategorią, tworząc
W interfejsie Google Ads API w wersji 17 i nowszych
Użyj
UserListCustomerTypeService
do
utwórz UserListCustomerType
instancji.
Jeśli masz już wypełnione pola
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
konto będzie już zawierać powiązane pole UserListCustomerType
instancji.
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.
Element 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 występują konflikty między UserListCustomerType
instancji. Próbuję przypisać UserListCustomerType
instancji z zastosowaniem funkcji
następujące kombinacje
customer_type_category
.
do tej samej listy użytkowników, przyniesie efekt
UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
błąd:
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 następujące pola na swoim koncie
CustomerLifecycleGoal
:
lifecycle_goal_customer_definition_settings.existing_user_lists
oznacza które listy użytkowników zawierają obecnych klientów.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
wskazuje, które listy użytkowników zawierają klientów o dużej wartości od początku śledzenia. Ty może odczytać to pole, ale nie można go zmienić w interfejsie Google Ads API.
Zachowanie udostępnionych zasobów
Pamiętaj, że do czasu wycofania interfejsu Google Ads API w wersji 16 w styczniu 2025 r.
UserListCustomerType
, a pola podziału odbiorców na segmenty są włączone
CustomerLifecycleGoal
są współużytkowanymi, co oznacza, że podczas tworzenia
UserListCustomerType
instancja w wersji 17 i nowszych będzie skutkować zmianami
do instancji CustomerLifecycleGoal
w wersjach v16 i starszych, a także
wokół nas.
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 powiązany zasób listy użytkowników
imię i nazwisko.
|
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
|
Utwórz lub usuń instancje UserListCustomerType , w których
Wartość „customer_type_category ” to
HIGH_VALUE_CUSTOMERS
|
Poszczególne nazwy zasobów zostaną dodane do
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
Skonfiguruj cele cyklu życia kampanii
Aby skonfigurować cel cyklu życia na poziomie kampanii, utwórz lub zaktualizuj
CampaignLifecycleGoal
Przydatność
najwyżej jeden CampaignLifecycleGoal
na kampanię.
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.
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. Jest to ustawienie domyślne. w trybie optymalizacji.
BID_HIGHER_FOR_NEW_CUSTOMERS
- Kampania jest kierowana zarówno na nowych, jak i dotychczasowych klientów, ale ustala wyższe stawki za
klienci, którzy według prognozy są nowi i nie znajdują się w żadnej
existing_user_lists
TARGET_NEW_CUSTOMERS
- Kampania jest kierowana tylko na nowych klientów.
Wartości value_settings
są takie same jak
customer_acquisition_goal_value_settings
na cel 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