Guía para desarrolladores sobre las audiencias de remarketing

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 una propiedad 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

Para enumerar todas las audiencias de remarketing de una propiedad:

  1. Recupera accountId y webPropertyId mediante la API de administración o el Explorador de cuentas.
  2. Ejecuta el método list del recurso de audiencias de remarketing.

Consulta la guía de referencia de la API para obtener información detallada sobre el método list del recurso de audiencias de remarketing.

Crear una audiencia de remarketing nueva

Para crear una audiencia de remarketing de una propiedad:

  1. Recupera accountId y webPropertyId mediante la API de administración o el Explorador de cuentas.
  2. Recupera el ID de vista (perfil) de la propiedad linkedViews [] mediante la API de administración o el Explorador de cuentas.
  3. Recupera un ID de cuenta de AdWords de la propiedad linkedAdAccounts.linkedAccountId mediante la colección Enlaces de AdWords.
    • La propiedad linkedAdAccounts[] solo admite un objeto linkedForeignAccount.
    • linkedAdAccounts[].type puede configurarse como ADWORDS_LINKS, DBM_LINKS, MCC_LINKS u OPTIMIZE.
  4. Utiliza la colección Segmentos con las opciones para configurar la propiedad segment de includeConditions. Si vas a crear una audiencia basada en el estado, haz lo mismo con excludeConditions. Consulta también la guía de referencia sobre segmentos para saber cómo definir un segmento.
    • includeConditions puede incluir, de manera opcional, valores para membershipDurationDays y daysToLookBack.
    • Si quieres, puedes configurar excludeConditions.exclusionDuration como PERMANENT.
  5. 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.

Cambiar una audiencia de remarketing que ya existe

Para modificar una audiencia de remarketing que ya existe en una propiedad:

  1. Si ya tienes el ID de la audiencia de remarketing, puedes llamar a la solicitud get. De lo contrario, llama a la solicitud list y selecciona la audiencia que quieras modificar.
  2. Modifica los campos editables que quieras, llama a la solicitud update y transfiere el objeto "audience" cambiado.