Используйте ресурсы CustomerLifecycleGoal
и CampaignLifecycleGoal
API Google Ads для настройки целей, связанных с жизненным циклом клиента. API Google Ads поддерживает цели привлечения клиентов для эффективного привлечения новых клиентов через поисковые кампании Google Ads и кампании с максимальной эффективностью.
Если в вашем аккаунте Google Ads используется отслеживание конверсий между аккаунтами, вам необходимо настроить цели жизненного цикла клиента в аккаунте конверсий Google Ads, а не непосредственно в нём. Однако цели жизненного цикла кампании всё равно следует настроить в аккаунте. Это аналогично управлению другими целями при использовании отслеживания конверсий между аккаунтами.
Настройте цели жизненного цикла клиента
На уровне клиента настройте цель жизненного цикла, создав или обновив объект CustomerLifecycleGoal
. В аккаунте Google Ads может быть не более одного CustomerLifecycleGoal
. Поле customer_acquisition_goal_value_settings.value
определяет дополнительную корректировку ценности, добавляемую к первой конверсии покупки нового клиента. Поле customer_acquisition_goal_value_settings.high_lifetime_value
определяет инкрементную ценность конверсии для новых клиентов с высокой ценностью. Значение High lifetime Value должно быть больше значения Value, если оно задано.
Сегментируйте свою аудиторию
Для сегментации аудитории по целям жизненного цикла клиента необходимо использовать ресурс UserListCustomerType
. Необходимо связать каждый список пользователей с одной или несколькими категориями, создав ресурс UserListCustomerType
для каждой комбинации списка пользователей и категории.
Используйте UserListCustomerTypeService
для создания экземпляров UserListCustomerType
. Если вы ранее заполнили поле CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
, то ваша учётная запись уже будет содержать соответствующие экземпляры UserListCustomerType
.
UserListCustomerTypeService
поддерживает только операции create
и remove
, поэтому, если вы хотите обновить существующий UserListCustomerType
, вам необходимо удалить его, а затем создать новый с необходимыми обновлениями.
Тип UserListCustomerType
может быть назначен только одному списку пользователей, но customer_type_category
одним списком пользователей может быть связано несколько экземпляров UserListCustomerType
при условии отсутствия конфликтов между ними. Попытка назначить экземпляры UserListCustomerType
со следующими комбинациями UserListCustomerType
одному и тому же списку пользователей приведёт к ошибке UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
:
Первая customer_type_category | Вторая customer_type_category |
---|---|
ПОКУПАТЕЛИ | CONVERTED_LEADS |
ПОКУПАТЕЛИ | КВАЛИФИЦИРОВАННЫЕ_ЛИДЫ |
ПОКУПАТЕЛИ | CART_ABANDONERS |
CONVERTED_LEADS | КВАЛИФИЦИРОВАННЫЕ_ЛИДЫ |
ОТКЛЮЧЕННЫЕ_КЛИЕНТЫ | CONVERTED_LEADS |
ОТКЛЮЧЕННЫЕ_КЛИЕНТЫ | КВАЛИФИЦИРОВАННЫЕ_ЛИДЫ |
ОТКЛЮЧЕННЫЕ_КЛИЕНТЫ | CART_ABANDONERS |
Настройте цели жизненного цикла кампании
На уровне кампании настройте цель жизненного цикла, создав или обновив объект 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
для цели на уровне клиента. Используйте эти параметры на уровне кампании, чтобы переопределить значения для конкретной кампании.
Цели удержания
Цели удержания клиентов разработаны для повышения их лояльности и высокой ценности на протяжении всего срока службы (LTV) в вашем бизнесе. Они предлагают различные режимы работы в рамках кампаний «Максимальная эффективность» , позволяя вам таргетироваться на конкретные сегменты существующих клиентов.
Прежде чем создавать цель удержания, необходимо выполнить предварительные условия, описанные в разделе «О цели удержания» . В их число входят наличие кампании «Максимальная эффективность» и списка пользователей Customer Match.
Чтобы создать цель удержания, необходимо сначала инициализировать GoalService и отправить запрос с помощью метода mutate_goals
для создания новой цели.
def create_goal(client: GoogleAdsClient, customer_id: str) -> None:
"""Sends an API request to add a new Goal.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
"""
goal_operation: GoalOperation = client.get_type("GoalOperation")
goal = goal_operation.create
goal.retention_goal_settings.value_settings.additional_value = 50.0
goal.retention_goal_settings.value_settings.additional_high_lifetime_value = 100.0
goal_service = client.get_service("GoalService")
goal_service.mutate_goals(
customer_id=customer_id, operations=[goal_operation]
)
Это создаст новую цель удержания на уровне учётной записи для указанного клиентского аккаунта, которая будет применена ко всем его кампаниям. По умолчанию эта цель будет нацелена на всех пользователей из ваших списков электронных адресов.
Эту цель можно переопределить с помощью настроек на уровне кампании, используя CampaignGoalConfig
. После определения цели на уровне аккаунта используйте её resource_name
для создания CampaignGoalConfig
с помощью метода mutate_campaign_goal_configs
в CampaignGoalConfigService
.
def create_campaign_goal_config(
client: GoogleAdsClient,
customer_id: str,
goal_resource_name: str,
campaign_resource_name: str
) -> None:
"""Sends an API request to add a new CampaignGoalConfig.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
goal_resource_name: the resource name of an existing Goal.
campaign_resource_name: the resource name of an existing Campaign.
"""
operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
goal_config = operation.create
goal_config.campaign = campaign_resource_name
goal_config.goal = goal_resource_name
# Note that the target_option will be set to TARGET_ALL by default. In order
# to set it to TARGET_SPECIFIC your account must be allowlisted.
#
# goal_config.campaign_retention_settings.target_option = (
# client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
# )
campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
campaign_goal_config_service.mutate_campaign_goal_configs(
customer_id=customer_id, operations=[operation]
)
Если параметр campaign_retention_settings.target_option
не задан, по умолчанию будет установлено значение TARGET_ALL
. Возможность установки значения TARGET_SPECIFIC
доступна только пользователям из списка разрешённых пользователей.
Получить цели жизненного цикла
Как и в случае с другими ресурсами API Google Ads, используйте методы search
или searchStream
сервиса GoogleAdsService
для извлечения целей жизненного цикла.
Следующий запрос извлекает сведения о каждой CustomerLifecycleGoal
в аккаунте Google Ads:
SELECT
customer_lifecycle_goal.owner_customer,
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