En este documento se describe cómo utilizar la API de administración para gestionar audiencias de remarketing de Google Analytics.
Introducción
La API de administración permite crear (create
), obtener (get
), eliminar (delete
), enumerar (list
), actualizar (update
) y parchear (patch
) audiencias de remarketing de las propiedades de Google Analytics. Para obtener más información sobre el funcionamiento de las audiencias de remarketing, consulta el artículo Información sobre las audiencias de remarketing en Analytics en el Centro de Ayuda.
Casos prácticos
El recurso de audiencia de remarketing admite las solicitudes get, delete, list, patch y update, pero se utiliza básicamente para:
- Enumerar audiencias de remarketing.
- Crear audiencias de remarketing.
- Modificar audiencias de remarketing que ya existen.
Enumerar audiencias de remarketing
Para enumerar todas las audiencias de remarketing de una propiedad:
- Recupera
accountId
ywebPropertyId
mediante la API de administración o el Explorador de cuentas. - Ejecuta el método
list
del recurso de audiencia de remarketing.
Consulta la guía de referencia de la API para obtener información detallada sobre el método list
del recurso de audiencia de remarketing.
Crear audiencias de remarketing
Para crear una audiencia de remarketing de una propiedad:
- Recupera
accountId
ywebPropertyId
mediante la API de administración o el Explorador de cuentas. - Recupera el ID de vista (perfil) de la propiedad
linkedViews []
mediante la API de administración o el Explorador de cuentas. - Recupera un ID de cuenta de Google Ads de
linkedAdAccounts.linkedAccountId
mediante la colección Enlaces de Google Ads.- La propiedad
linkedAdAccounts[]
solo admite un objetolinkedForeignAccount
. - Se puede asignar
ADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
uOPTIMIZE
alinkedAdAccounts[].type
.
- La propiedad
- Utiliza la colección Segmentos con las opciones para configurar la propiedad
segment
deincludeConditions
. Si vas a crear una audiencia basada en el estado, haz lo mismo conexcludeConditions
. Consulta también la guía de referencia sobre segmentos para saber cómo definirlos.includeConditions
puede incluir, de manera opcional, valores paramembershipDurationDays
ydaysToLookBack
.- Si quieres, puedes asignar el valor
PERMANENT
aexcludeConditions.exclusionDuration
.
- Ejecuta el método
insert
del recurso de audiencia de remarketing.
La API permite crear dos tipos de audiencias: SIMPLE
y STATE_BASED
. En el caso de las audiencias SIMPLE
, solo tienes que construir audienceDefinition
con un segment
positivo, sin el operador NOT (es decir, el carácter !
). Si quieres añadir una condición de exclusión, tienes que definir statebasedDefinition
. Para obtener más información, consulta Audiencias basadas en estado y el ejemplo de referencia.
Modificar audiencias de remarketing que ya existen
Para modificar una audiencia de remarketing que ya existe en una propiedad:
- Si ya tienes el ID de la audiencia de remarketing, puedes llamar a la solicitud
get
. De lo contrario, llama a la solicitudlist
y selecciona la audiencia que quieras modificar. - Modifica los campos editables que quieras, llama a la solicitud
update
y transfiere el objeto "audience" cambiado.