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

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:

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 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:

  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 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 solo linkedForeignAccount.
    • linkedAdAccounts[].type se puede configurar como ADWORDS_LINKS, DBM_LINKS, MCC_LINKS o OPTIMIZE.
  4. Usa la colección Segmentos a fin de obtener opciones para establecer la propiedad segment de includeConditions y, si creas un público basado en el estado, haz lo mismo para excludeConditions. Consulte también la referencia de los 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ú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:

  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.