Используйте ресурсы CustomerLifecycleGoal
и CampaignLifecycleGoal
API Google Рекламы, чтобы настроить цели, связанные с жизненным циклом клиента. API Google Рекламы поддерживает цели по привлечению клиентов , позволяющие эффективно привлекать новых клиентов с помощью кампаний Google Реклама в поисковой сети и кампаний с максимальной эффективностью.
Если в вашей учетной записи Google Рекламы используется отслеживание конверсий в нескольких аккаунтах, вам необходимо настроить цели жизненного цикла клиента в учетной записи конверсий Google Рекламы , а не непосредственно в учетной записи Google Рекламы. Однако вам все равно следует установить цели жизненного цикла кампании в своем аккаунте. Это похоже на то, как вы управляете другими целями при использовании отслеживания конверсий в нескольких аккаунтах.
Настройка целей жизненного цикла клиента
На уровне клиента настройте цель жизненного цикла, создав или обновив CustomerLifecycleGoal
. В каждом аккаунте Google Рекламы может быть не более одного CustomerLifecycleGoal
. Поле customer_acquisition_goal_value_settings.value
определяет дополнительную корректировку стоимости, добавляемую к первой конверсии покупки нового клиента. Вы можете прочитать значение customer_acquisition_goal_value_settings.high_lifetime_value
цели, но это поле является неизменяемым в Google Ads API.
Сегментируйте свою аудиторию
Начиная с API Google Рекламы 17, вы должны использовать ресурс UserListCustomerType
, чтобы сегментировать свою аудиторию в соответствии с целями жизненного цикла клиента. Настройка аудиторий непосредственно в ресурсе CustomerLifecycleGoal
устарела. Вот подробности:
- До версии 17:
- Добавьте списки пользователей в
existing_user_lists
объектаCustomerLifecycleGoal
.
- Добавьте списки пользователей в
- Начиная с версии 17:
- Свяжите каждый список пользователей с одной или несколькими категориями, создав
UserListCustomerType
для каждой комбинации списка пользователей и категории.
- Свяжите каждый список пользователей с одной или несколькими категориями, создав
В Google Ads API 17 и более поздних версиях
Используйте UserListCustomerTypeService
для создания экземпляров UserListCustomerType
. Если вы уже заполнили поле CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
, то ваша учетная запись уже будет содержать связанные экземпляры UserListCustomerType
.
UserListCustomerTypeService
поддерживает только операции create
и remove
, поэтому, если вы хотите обновить существующий UserListCustomerType
вам нужно будет удалить его, а затем создать новый с необходимыми обновлениями.
UserListCustomerType
может быть назначен только одному списку пользователей, но список пользователей может иметь несколько связанных экземпляров UserListCustomerType
, если между экземплярами UserListCustomerType
нет конфликтов . Попытка назначить экземпляры UserListCustomerType
со следующими комбинациями customer_type_category
одному и тому же списку пользователей приведет к ошибке UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
:
Первая customer_type_category | Вторая customer_type_category |
---|---|
ПОКУПАТЕЛИ | CONVERTED_LEADS |
ПОКУПАТЕЛИ | QUALIFIED_LEADS |
ПОКУПАТЕЛИ | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
ОТКЛЮЧЕННЫЕ_КЛИЕНТЫ | CONVERTED_LEADS |
ОТКЛЮЧЕННЫЕ_КЛИЕНТЫ | QUALIFIED_LEADS |
ОТКЛЮЧЕННЫЕ_КЛИЕНТЫ | CART_ABANDONERS |
В API Google Рекламы 16.
Задайте следующие поля в CustomerLifecycleGoal
своей учетной записи:
lifecycle_goal_customer_definition_settings.existing_user_lists
указывает, какие списки пользователей содержат существующих клиентов.Поле
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
указывает, какие списки пользователей содержат клиентов с высокой пожизненной ценностью. Вы можете прочитать это поле, но оно неизменяемо в Google Ads API.
Поведение общего ресурса
До прекращения поддержки Google Ads API v16 в январе 2025 года важно помнить, что UserListCustomerType
и поля сегментации аудитории в CustomerLifecycleGoal
являются общим ресурсом. Это означает, что создание новых экземпляров UserListCustomerType
в версии 17 и более поздних версиях приведет к изменениям вашего экземпляра CustomerLifecycleGoal
в версии 16 и более поздних версиях. раньше и наоборот.
Вот как сопоставляются поля на двух ресурсах:
Изменение поля CustomerLifecycleGoal в версии 16. | Побочный эффект для UserListCustomerType в версии 17 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists | Создает или удаляет экземпляры UserListCustomerType . Поле user_list содержит имя связанного ресурса списка пользователей. |
Мутация UserListCustomerType в версии 17 | Побочный эффект в поле CustomerLifecycleGoal в версии 16 |
---|---|
Создайте или удалите экземпляры UserListCustomerType . | Имена отдельных ресурсов будут добавлены или удалены из списка lifecycle_goal_customer_definition_settings.existing_user_lists . |
Создайте или удалите экземпляры UserListCustomerType , где для customer_type_category установлено значение HIGH_VALUE_CUSTOMERS | Названия отдельных ресурсов будут добавлены или удалены из списка lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists . |
Настройка целей жизненного цикла кампании
На уровне кампании настройте цель жизненного цикла, создав или обновив CampaignLifecycleGoal
. В каждой кампании может быть не более одной CampaignLifecycleGoal
.
Поле customer_acquisition_goal_settings
цели на уровне кампании позволяет вам установить режим оптимизации кампании, а также переопределить настройки значений из родительской цели клиента.
optimization_mode
может быть одним из следующих значений:
-
TARGET_ALL_EQUALLY
- Кампания в равной степени ориентирована на новых и существующих клиентов. Это режим оптимизации по умолчанию.
-
BID_HIGHER_FOR_NEW_CUSTOMERS
- Кампания ориентирована как на новых, так и на существующих клиентов, но ставки выше для клиентов, которые, по прогнозам, будут новыми и не входят ни в один из
existing_user_lists
. -
TARGET_NEW_CUSTOMERS
- Кампания нацелена только на новых клиентов.
value_settings
совпадает с параметром customer_acquisition_goal_value_settings
для цели на уровне клиента. Используйте эти настройки на уровне кампании, чтобы переопределить значения для конкретной кампании.
Получение целей жизненного цикла
Как и в случае с другими ресурсами Google Ads API, используйте методы search
или searchStream
GoogleAdsService
для получения целей жизненного цикла.
Следующий запрос получает сведения о каждой цели CustomerLifecycleGoal
в аккаунте Google Рекламы:
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
Аналогично, следующий запрос получает сведения о каждой 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