En este documento, se describe cómo utilizar la API de Management para administrar los públicos de remarketing de Google Analytics.
Introducción
La API de Management te permite create
, get
, delete
, list
, update
y patch
públicos de remarketing para una propiedad de Google Analytics. Para obtener más información sobre cómo funcionan los públicos de remarketing, consulta el artículo del Centro de ayuda Acerca de los públicos de remarketing en Analytics.
Casos de uso
El recurso de público de remarketing admite las funciones get, delete, list, patch y update, pero los casos de uso clave son los siguientes:
- Enumera los públicos de remarketing.
- Crea un público de remarketing nuevo.
- Actualiza un público de remarketing existente.
Enumerar públicos de remarketing
Para enumerar todos los públicos de remarketing de una propiedad, sigue estos pasos:
- Usa la API de Management o el Explorador de cuentas para recuperar
accountId
ywebPropertyId
. - Ejecuta el método
list
del recurso de públicos de remarketing.
Consulta la referencia de la API para obtener detalles del método list
para el recurso de público de remarketing.
Crea un público de remarketing nuevo
Si deseas crear un público de remarketing nuevo para una propiedad, sigue estos pasos:
- Usa la API de Management o el Explorador de cuentas para recuperar
accountId
ywebPropertyId
. - Utiliza la API de Management o el Explorador de cuentas para recuperar el ID de vista (perfil) de la propiedad
linkedViews []
. - Utiliza la colección Vinculaciones con Google Ads para recuperar el ID de una cuenta de Google Ads para
linkedAdAccounts.linkedAccountId
.- Actualmente, la propiedad
linkedAdAccounts[]
está limitada a una solalinkedForeignAccount
. linkedAdAccounts[].type
se puede establecer enADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
oOPTIMIZE
.
- Actualmente, la propiedad
- Usa la colección Segmentos para ver las opciones a fin de establecer la propiedad
segment
deincludeConditions
y, si creas un público basado en estados, haz lo mismo paraexcludeConditions
. También, consulta la referencia de segmentos para definir un segmento.- De manera opcional,
includeConditions
puede tener valores paramembershipDurationDays
ydaysToLookBack
. - De manera opcional,
excludeConditions.exclusionDuration
se puede configurar comoPERMANENT
.
- De manera opcional,
- Ejecuta el método
insert
del recurso de públicos de remarketing.
La API te permite crear dos tipos de públicos: SIMPLE
y STATE_BASED
. Para los públicos con SIMPLE
, solo necesitas crear el audienceDefinition
con un segment
positivo, sin un operador NOT (el carácter !
). Si deseas incluir una condición de exclusión, debes definir una statebasedDefinition
. Consulta Públicos basados en el estado para obtener más información. Consulta el ejemplo de referencia para obtener más detalles.
Cómo actualizar un público de remarketing existente
Para actualizar un público de remarketing existente de una propiedad, sigue estos pasos:
- Si ya tienes un ID de público de remarketing, puedes llamar a
get
. De lo contrario, puedes llamar alist
y seleccionar el público que deseas actualizar. - Actualiza cualquiera de los campos que admiten escritura y llama a
update
y pasa el objeto de público actualizado.