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