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

Используйте ресурсы 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