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 unCustomerLifecycleGoal
.
- Agrega listas de usuarios a la colección
- 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.
- Para asociar cada lista de usuarios con una o más categorías, crea un
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
:
lifecycle_goal_customer_definition_settings.existing_user_lists
indica qué listas de usuarios contienen clientes existentes.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