Guía para desarrolladores sobre las audiencias de remarketing

En este documento se describe cómo utilizar la API de administración para gestionar las audiencias de remarketing de Google Analytics.

Introducción

La API de administración permite ejecutar las solicitudes create, get, list, update y patch para las audiencias de remarketing en una propiedad de Google Analytics. Para obtener más información sobre cómo funcionan 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, list, patch y update, pero estos son los casos prácticos clave:

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 referencia de la API para obtener información detallada sobre el método list para el recurso de audiencias de remarketing.

Crear una audiencia de remarketing nueva

Para crear una audiencia de remarketing para 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.
    • Se puede establecer linkedAdAccounts[].type en ADWORDS_LINKS.
  4. Para las opciones, utiliza la colección Segmentos con el fin de establecer la propiedad segment de includudeConditions. Si vas a crear una audiencia basada en el estado, haz lo mismo para excludeConditions. Consulta también la referencia sobre segmentos para saber cómo definir un segmento.
    • includeConditions puede incluir, de manera opcional, valores para membershipDurationDays y daysToLookBack
    • Si quieres, puedes establecer excludeConditions.exclusionDuration en 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 agregar 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 cambiar 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 cambiar.
  2. Cambia los campos editables que quieras, llama a la solicitud update y transfiere el objeto "audience" cambiado.