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 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 jego resource_name ani update_mask .

  • Aby zaktualizować cel cyklu życia za pomocą wersji 15, wypełnij pole create wybranym celem resource_name celu i ustaw update_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 kolekcji CustomerLifecycleGoal
  • 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.
.

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:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists oznacza które listy użytkowników zawierają obecnych klientów.

  2. 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
Wstecz
Cele kampanii