Objetivos del ciclo de vida

Usa CustomerLifecycleGoal y CampaignLifecycleGoal recursos de la La API de Google Ads para configurar objetivos relacionados con el ciclo de vida del cliente A partir de la versión 15, La API de Google Ads admite la adquisición de clientes objetivos para adquirir clientes nuevos con tus campañas de Búsqueda y de máximo rendimiento de Google Ads campañas.

Si tu cuenta de Google Ads utiliza el seguimiento de conversiones de múltiples cuentas, debes configurar los objetivos del ciclo de vida del cliente en la cuenta de cliente de conversiones de Google Ads en lugar de hacerlo directamente en tu cuenta de Google Ads. Aún debes establecer los objetivos de ciclo de vida de una campaña en tu cuenta. Esto es similar a cómo administrar otros objetivos cuando utiliza el seguimiento de conversiones de múltiples cuentas.

Configura los objetivos del ciclo de vida del cliente

A nivel del cliente, configura un objetivo de ciclo de vida creando o actualizando un CustomerLifecycleGoal Puede haber un máximo de un CustomerLifecycleGoal por cuenta de Google Ads. El campo customer_acquisition_goal_value_settings.value define el ajuste de valor adicional que se agregará a la conversión de la primera compra de un cliente nuevo. Puedes lee el customer_acquisition_goal_value_settings.high_lifetime_value de objetivo, pero este campo es inmutable en la API de Google Ads.

Cómo segmentar a tus públicos

A partir de la versión 17 de la API de Google Ads, debes usar el recurso UserListCustomerType para segmentar tus públicos para los objetivos del ciclo de vida del cliente. La configuración de públicos directamente en el recurso CustomerLifecycleGoal dejó de estar disponible. Estos son los detalles:

  • Antes de la versión 17:
    • Agrega listas de usuarios a la colección existing_user_lists de un CustomerLifecycleGoal.
  • A partir de la versión 17:
    • Para asociar cada lista de usuarios con una o más categorías, crea un UserListCustomerType para cada combinación de lista de usuarios y categoría.

En la API de Google Ads v17 y versiones posteriores

Usa UserListCustomerTypeService para crear instancias de UserListCustomerType. Si ya propagaste el campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, tu cuenta ya contendrá instancias de UserListCustomerType relacionadas.

UserListCustomerTypeService solo admite create y remove. operaciones, así que si quieres actualizar un UserListCustomerType existente, deberás debes quitarlo y, luego, crea uno nuevo con las actualizaciones necesarias.

Un UserListCustomerType solo se puede asignar a una lista de usuarios, pero una lista de usuarios puede tener varias instancias de UserListCustomerType asociadas siempre que no haya conflictos entre las instancias de UserListCustomerType. Si intentas asignar instancias de UserListCustomerType con las siguientes combinaciones de customer_type_category a la misma lista de usuarios, se producirá un error UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Primeros customer_type_category Segundo customer_type_category
COMPRADORES CONVERTED_LEADS
COMPRADORES QUALIFIED_LEADS
COMPRADORES CART_ABANDONERS
CONVERTED_LEADS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CONVERTED_LEADS
DISENGAGED_CUSTOMERS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CART_ABANDONERS

En la versión 16 de la API de Google Ads

Configura los siguientes campos en el bucket CustomerLifecycleGoal:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists indica qué listas de usuarios contienen clientes existentes.

  2. El lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists indica qué listas de usuarios contienen clientes con un alto valor del ciclo de vida del cliente. Puedes leer este campo, pero es inmutable en la API de Google Ads.

Comportamiento de los recursos compartidos

Hasta que la versión 16 de la API de Google Ads deje de estar disponible en enero de 2025, es importante recordar que UserListCustomerType y los campos de segmentación de público en CustomerLifecycleGoal son un recurso compartido, lo que significa que crear instancias nuevas de UserListCustomerType en la versión 17 y versiones posteriores provocará modificaciones en tu instancia de CustomerLifecycleGoal en la versión 16 y versiones anteriores, y viceversa.

A continuación, se muestra cómo se asignan los campos de los dos recursos:

Mutación del campo "CustomerLifecycleGoal" en la versión 16 Efecto secundario en "UserListCustomerType" en la versión 17
lifecycle_goal_customer_definition_settings.existing_user_lists Crea o quita instancias de UserListCustomerType. El El campo user_list contiene el recurso de lista de usuarios asociado de la fuente de datos.
Mutación de "UserListCustomerType" en la versión 17 Efecto secundario en el campo "CustomerLifecycleGoal" en la versión 16
Crea o quita instancias de UserListCustomerType. Los nombres de los recursos individuales se agregarán o quitarán de lifecycle_goal_customer_definition_settings.existing_user_lists.
Crea o quita instancias de UserListCustomerType, en las que las customer_type_category se estableció en HIGH_VALUE_CUSTOMERS Los nombres de los recursos individuales se agregarán o quitarán de la base de datos lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists

Cómo configurar los objetivos del ciclo de vida de la campaña

A nivel de la campaña, configura un objetivo de ciclo de vida creando o actualizando un CampaignLifecycleGoal Puede haber como máximo un CampaignLifecycleGoal por campaña.

El campo customer_acquisition_goal_settings de un objetivo a nivel de la campaña te permite Establecer el modo de optimización de la campaña y anular la configuración de los valores del objetivo principal del cliente.

optimization_mode puede ser uno de los siguientes valores:

TARGET_ALL_EQUALLY
La campaña se segmenta de la misma manera para los clientes nuevos y existentes. Este es el modo de optimización predeterminado.
BID_HIGHER_FOR_NEW_CUSTOMERS
La campaña se segmenta para clientes nuevos y existentes, pero establece ofertas más altas para los clientes que se predice que son nuevos y no se encuentran en ninguno de los existing_user_lists.
TARGET_NEW_CUSTOMERS
La campaña solo se segmenta para clientes nuevos.

Las value_settings son las mismas que las customer_acquisition_goal_value_settings sobre el objetivo a nivel del cliente. Usar estas opciones configuración a nivel de la campaña para anular los valores de una campaña específica.

Cómo recuperar los objetivos del ciclo de vida

Al igual que con otros recursos de la API de Google Ads, usa los métodos search o searchStream de GoogleAdsService para recuperar los objetivos del ciclo de vida.

La siguiente consulta recupera los detalles de cada CustomerLifecycleGoal en una cuenta de Google Ads:

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

Del mismo modo, la siguiente consulta recupera los detalles de cada 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