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. A partir de la versión 15, la API de Google Ads admite objetivos de adquisición de clientes para adquirir clientes nuevos de manera eficiente mediante tus campañas de Búsqueda y de máximo rendimiento de Google Ads.

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

Controla las operaciones de creación y actualización (solo para la versión v15)

Sugerencia: La versión 16 de la API de Google Ads quitó el comportamiento único de las operaciones de modificación del objetivo de ciclo de vida. Si usas la versión 16, crea y actualiza los objetivos de ciclo de vida con el enfoque estándar.

En la versión 15 de la API de Google Ads, las operaciones admitidas en CustomerLifecycleGoalService y CampaignLifecycleGoalService difieren un poco de otros servicios de la API de Google Ads. En lugar de tener operaciones create y update separadas, la versión 15 de CustomerLifecycleGoalOperation y CampaignLifecycleGoalOperation solo tienen una operación create, y puedes indicar tu intent con la update_mask de la siguiente manera:

• Para crear un objetivo de ciclo de vida con la versión 15, propaga create con el objetivo, pero no establezcas su resource_name ni el update_mask de la operación.

• Para actualizar un objetivo de ciclo de vida con la versión 15, propaga create con el objetivo, establece el resource_name del objetivo y update_mask para enumerar los campos que deseas actualizar.

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, como máximo, un CustomerLifecycleGoal por cuenta de Google Ads. El campo customer_acquisition_goal_value_settings.value define el ajuste de valor adicional que se debe 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.

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 y alcanzar 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 una CustomerLifecycleGoal.
• A partir de la versión 17:
  • Asocia cada lista de usuarios con una o más categorías. Para ello, crea un UserListCustomerType para cada combinación de lista de usuarios y categoría.

Advertencia: UserListCustomerType y los campos de segmentación de público de CustomerLifecycleGoal son un recurso compartido, lo que significa que si creas nuevas instancias de UserListCustomerType en la versión 17, se modificarán tu instancia de CustomerLifecycleGoal en la versión 16 y viceversa. Recomendamos a los usuarios que migren a UserListCustomerType en la versión 17 lo antes posible.

En la versión 17 de la API de Google Ads y posteriores

Usa UserListCustomerTypeService para crear instancias de UserListCustomerType. Si ya completaste el campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, tu cuenta ya contendrá instancias 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.

Una UserListCustomerType solo se puede asignar a una lista de usuarios, pero una lista de usuarios puede tener varias instancias de UserListCustomerType asociadas siempre y cuando 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 mostrará 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 y versiones anteriores

Configura los siguientes campos en el 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 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 API de Google Ads v16 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 nuevas instancias de UserListCustomerType en la versión 17 y posteriores provocará modificaciones en tu instancia de CustomerLifecycleGoal en la versión 16 y anteriores, y viceversa.

A continuación, se muestra cómo se asignan los campos en 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 UserListCustomerType instancias. El campo user_list contiene el nombre del recurso de la lista de usuarios asociada.

Mutación de "UserListCustomerType" en la versión 17	Efecto secundario en el campo "CustomerLifecycleGoal" de la versión 16
Crea o quita UserListCustomerType instancias.	Se agregarán nombres de recursos individuales a lifecycle_goal_customer_definition_settings.existing_user_lists o se quitarán de allí.
Crear o quitar instancias de UserListCustomerType, en las que customer_type_category se establece en HIGH_VALUE_CUSTOMERS	Se agregarán nombres de recursos individuales a lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists o se quitarán de allí.

Configura los objetivos de ciclo de vida de la campaña

A nivel de la campaña, crea o actualiza un CampaignLifecycleGoal para configurar un objetivo de ciclo de vida. 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 configurar el modo de optimización de la campaña y anular la configuración de valores del objetivo principal del cliente.

El 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 orienta a clientes nuevos y existentes, pero establece ofertas más altas para los clientes que se predice que son nuevos y que no están en 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.

Recupera los objetivos del ciclo de vida

Al igual que con otros recursos de la API de Google Ads, utiliza los métodos search o searchStream de GoogleAdsService para recuperar objetivos de 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

De manera similar, 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