Guía para desarrolladores sobre los públicos de remarketing

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:

Enumerar públicos de remarketing

Para enumerar todos los públicos de remarketing de una propiedad, sigue estos pasos:

  1. Usa la API de Management o el Explorador de cuentas para recuperar accountId y webPropertyId.
  2. 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:

  1. Usa la API de Management o el Explorador de cuentas para recuperar accountId y webPropertyId.
  2. Utiliza la API de Management o el Explorador de cuentas para recuperar el ID de vista (perfil) de la propiedad linkedViews [].
  3. 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 sola linkedForeignAccount.
    • linkedAdAccounts[].type se puede establecer en ADWORDS_LINKS, DBM_LINKS, MCC_LINKS o OPTIMIZE.
  4. Usa la colección Segmentos para ver las opciones a fin de establecer la propiedad segment de includeConditions y, si creas un público basado en estados, haz lo mismo para excludeConditions. También, consulta la referencia de segmentos para definir un segmento.
    • De manera opcional, includeConditions puede tener valores para membershipDurationDays y daysToLookBack.
    • De manera opcional, excludeConditions.exclusionDuration se puede configurar como PERMANENT.
  5. 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:

  1. Si ya tienes un ID de público de remarketing, puedes llamar a get. De lo contrario, puedes llamar a list y seleccionar el público que deseas actualizar.
  2. Actualiza cualquiera de los campos que admiten escritura y llama a update y pasa el objeto de público actualizado.