Se usó la API de Cloud Translation para traducir esta página.

Objetivos del ciclo de vida

Usa los recursos CustomerLifecycleGoal y CampaignLifecycleGoal de la API de Google Ads para configurar objetivos relacionados con el ciclo de vida del cliente. La API de Google Ads admite objetivos de adquisición de clientes para adquirir clientes nuevos de manera eficiente a través de tus campañas de Búsqueda y de máximo rendimiento de Google Ads.

Si tu cuenta de Google Ads utiliza el seguimiento de conversiones de múltiples cuentas, debes configurar los objetivos de ciclo de vida del cliente en la cuenta de conversiones de Google Ads en lugar de hacerlo directamente en tu cuenta de Google Ads. Sin embargo, debes establecer objetivos del ciclo de vida de la campaña en tu cuenta. Esto es similar a la forma en que administras otros objetivos cuando utilizas el seguimiento de conversiones de múltiples cuentas.

Configura los objetivos de 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 leer el customer_acquisition_goal_value_settings.high_lifetime_value del objetivo, pero este campo es inmutable en la API de Google Ads.

Segmenta 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:
- Asocia cada lista de usuarios con una o más categorías creando 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 operaciones create y remove, por lo que, si deseas actualizar un UserListCustomerType existente, deberás quitarlo y, luego, crear 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 archivo CustomerLifecycleGoal de tu cuenta:

lifecycle_goal_customer_definition_settings.existing_user_lists indica qué listas de usuarios contienen clientes existentes.
El campo lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists indica qué listas de usuarios contienen clientes con un valor del ciclo de vida alto. 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 campo `user_list` contiene el nombre del recurso de la lista de usuarios asociado.

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`.
Crear o quitar instancias de `UserListCustomerType`, en las que `customer_type_category` esté configurado como `HIGH_VALUE_CUSTOMERS`	Los nombres de los recursos individuales se agregarán o quitarán de `lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists`.

Cómo configurar los objetivos de 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, así como anular la configuración de valor del objetivo de cliente superior.

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.

Los value_settings son los mismos que los customer_acquisition_goal_value_settings en el objetivo a nivel del cliente. Usa esta configuración a nivel de la campaña para anular los valores de una campaña específica.

Cómo recuperar los objetivos de 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

Objetivos de la campaña