En este documento, se describe cómo usar la API de Management para administrar los públicos de remarketing de Google Analytics.
Introducción
La API de Management te permite segmentar los públicos de remarketing de create
, get
, delete
, list
, update
y patch
para una propiedad de Google Analytics. Si deseas 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 obtener, borrar, listas, parches y actualizar, pero los casos de uso clave son los siguientes:
- Genere una lista de 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 Públicos de remarketing.
Consulta la referencia de la API a fin de 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 de Google Ads para obtener el ID de una cuenta de Google Ads para la
linkedAdAccounts.linkedAccountId
.- Actualmente, la propiedad
linkedAdAccounts[]
está limitada a un sololinkedForeignAccount
. linkedAdAccounts[].type
se puede configurar comoADWORDS_LINKS
,DBM_LINKS
,MCC_LINKS
oOPTIMIZE
.
- Actualmente, la propiedad
- Usa la colección Segmentos a fin de obtener opciones para establecer la propiedad
segment
deincludeConditions
y, si creas un público basado en el estado, haz lo mismo paraexcludeConditions
. Consulte también la referencia de los 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úblico de remarketing.
La API te permite crear dos tipos de públicos: SIMPLE
y STATE_BASED
. Para los públicos 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 un statebasedDefinition
. Consulta Públicos basados en el estado para obtener más información. Consulta el ejemplo de referencia para obtener información detallada.
Cómo actualizar un público de remarketing existente
Sigue estos pasos para actualizar un público de remarketing existente de una propiedad:
- 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.