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

Используйте ресурсы CustomerLifecycleGoal и CampaignLifecycleGoal API Google Ads для настройки целей, связанных с жизненным циклом клиента. API Google Ads поддерживает цели привлечения клиентов для эффективного привлечения новых клиентов через ваши кампании Google Ads в поиске, товарах и Performance Max.

Если в вашем аккаунте 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 может быть назначен только одному списку пользователей, но список пользователей может иметь несколько связанных экземпляров UserListCustomerType , если между ними нет конфликтов . Попытка назначить экземпляры UserListCustomerType со следующими комбинациями customer_type_category одному UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES UserListCustomerType

Первая customer_type_category	Вторая customer_type_category
ПОКУПАТЕЛИ	КОНВЕРТИРОВАННЫЕ_ЛИДЫ
ПОКУПАТЕЛИ	КВАЛИФИЦИРОВАННЫЕ_ЛИДЫ
ПОКУПАТЕЛИ	CART_ABANDONERS
КОНВЕРТИРОВАННЫЕ_ЛИДЫ	КВАЛИФИЦИРОВАННЫЕ_ЛИДЫ
НЕВОВЛЕЧЕННЫЕ КЛИЕНТЫ	КОНВЕРТИРОВАННЫЕ_ЛИДЫ
НЕВОВЛЕЧЕННЫЕ КЛИЕНТЫ	КВАЛИФИЦИРОВАННЫЕ_ЛИДЫ
НЕВОВЛЕЧЕННЫЕ КЛИЕНТЫ	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 для цели на уровне клиента. Используйте эти настройки на уровне кампании, чтобы переопределить значения для конкретной кампании.

Цели по удержанию клиентов

Примечание: Цели по удержанию клиентов применимы только к кампаниям Performance Max .

Цели по удержанию клиентов разработаны для повышения лояльности и пожизненной ценности клиента (LTV) в вашем бизнесе. В рамках кампаний Performance Max предлагаются различные режимы, позволяющие ориентироваться на определенные сегменты существующих клиентов.

Перед созданием цели удержания необходимо выполнить предварительные условия, описанные в разделе «О цели удержания» . Это включает в себя наличие кампании Performance Max и списка пользователей 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]
    )

Это создаст новую цель удержания на уровне учетной записи для указанного клиентского аккаунта, которая будет применяться ко всем его кампаниям. По умолчанию эта цель будет нацелена на всех пользователей в ваших списках пользователей Customer Match.

Эту цель можно переопределить с помощью настроек уровня кампании, используя 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 on the appropriate
    # allowlist.
    #
    # 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