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 pestaña Conversiones cliente en su cuenta de Google Ads, en lugar de hacerlo directamente en su 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.

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

En la versión 15 de la API de Google Ads, las operaciones admitidas en las CustomerLifecycleGoalService y CampaignLifecycleGoalService difieren levemente de otros servicios de la API de Google Ads. En lugar de tener conjuntos Las operaciones create y update (v15) CustomerLifecycleGoalOperation y CampaignLifecycleGoalOperation solo tienen una operación create, y puedes indicar tu intent usando el 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 una sola 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 establece el update_mask para enumerar campos que quieras 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 en , máximo, un CustomerLifecycleGoal por cuenta de Google Ads. El customer_acquisition_goal_value_settings.value define la capa adicional ajuste de valor para 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, debe utilizar la UserListCustomerType recurso para segmentar a tus públicos para los objetivos del ciclo de vida del cliente. Configura públicos directamente en el recurso CustomerLifecycleGoal está obsoleto. Estos son los detalles:

• Antes de la versión v17:
  • 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 versión 17 de la API de Google Ads y posteriores

Usa el UserListCustomerTypeService a crear instancias de UserListCustomerType. Si ya completaste los datos CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists , tu cuenta ya contendrá UserListCustomerType relacionados individuales.

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 La lista de usuarios puede tener varias instancias de UserListCustomerType asociadas siempre y cuando no haya conflictos entre UserListCustomerType individuales. Si intentas asignar instancias de UserListCustomerType con el las siguientes combinaciones de customer_type_category a la misma lista de usuarios Error de UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

En la versión 16 de la API de Google Ads y versiones anteriores

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. Tú puede leer este campo, pero es inmutable en la API de Google Ads.

Comportamiento de los recursos compartidos

Es importante recordar que, hasta que desaparezca la versión 16 de la API de Google Ads en enero de 2025, UserListCustomerType y los campos de segmentación de público en CustomerLifecycleGoal son un recurso compartido, lo que significa que crear nuevos UserListCustomerType de instancias de la versión 17 y posteriores generarán modificaciones a tu instancia de CustomerLifecycleGoal en la versión v16 y anteriores, y la otra alrededor.

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

Configura 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 en máximo, una 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.

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. Esta es la opción predeterminada modo de optimización.

BID_HIGHER_FOR_NEW_CUSTOMERS

La campaña se orienta a clientes nuevos y existentes, pero establece ofertas más altas para clientes que se predice que serán nuevos y que no están en uno 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.

Recupera los objetivos del ciclo de vida

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

La siguiente consulta recupera los detalles de cada CustomerLifecycleGoal en un 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

Asimismo, 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