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

Используйте ресурсы CustomerLifecycleGoal и CampaignLifecycleGoal API Google Рекламы, чтобы настроить цели, связанные с жизненным циклом клиента. Начиная с версии 15, API Google Рекламы поддерживает цели по привлечению клиентов , что позволяет эффективно привлекать новых клиентов с помощью кампаний Google Реклама в поисковой сети и кампаний с максимальной эффективностью.

Если в вашей учетной записи Google Рекламы используется отслеживание конверсий в нескольких аккаунтах, вам необходимо настроить цели жизненного цикла клиента в учетной записи клиента-конверсии Google Рекламы , а не непосредственно в своей учетной записи Google Рекламы. Однако вам все равно следует установить цели жизненного цикла кампании в своем аккаунте. Это похоже на то, как вы управляете другими целями при использовании отслеживания конверсий в нескольких аккаунтах.

Обработка операций создания и обновления (только для версии 15)

В Google Ads API v15 операции, поддерживаемые в CustomerLifecycleGoalService и CampaignLifecycleGoalService немного отличаются от других сервисов Google Ads API. Вместо отдельных операций create и update в CustomerLifecycleGoalOperation и CampaignLifecycleGoalOperation версии 15 имеется только операция create , и вы указываете свое намерение с помощью update_mask следующим образом:

  • Чтобы создать цель жизненного цикла с помощью версии 15, заполните create целью, но не задавайте ее resource_name и не задавайте update_mask операции.

  • Чтобы обновить цель жизненного цикла с помощью версии 15, заполните create этой целью, задайте resource_name цели и задайте update_mask , чтобы перечислить поля, которые вы хотите обновить.

Настройка целей жизненного цикла клиента

На уровне клиента настройте цель жизненного цикла, создав или обновив 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 .
  • Начиная с v17:
    • Свяжите каждый список пользователей с одной или несколькими категориями, создав 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

В Google Ads API v16 и более ранних версиях

Задайте следующие поля в 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
Назад
Цели кампании