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 suresource_name
ni elupdate_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 elresource_name
del objetivo y establece elupdate_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 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 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
:
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 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. 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:
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
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" de la versión 16 |
---|---|
Crea o quita UserListCustomerType instancias.
|
Los nombres de los recursos individuales se agregarán o quitarán de la base de datos
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
|
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