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:

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

  2. 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 febrero 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 estos parámetros de 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
Anterior
Objetivos de la campaña