Цели жизненного цикла

Используйте ресурсы 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 своей учетной записи:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists указывает, какие списки пользователей содержат существующих клиентов.

  2. Поле 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