Listas de público recurrentes

En este documento, se describen las listas de público recurrentes, que son un función avanzada de la versión 1 de la API de datos de Google Analytics. Para ver una introducción a la función de exportación de listas de público consulta la guía de aspectos básicos sobre la exportación de públicos.

Las listas de público recurrentes producen listas de público diariamente como las membresías del público cambien para garantizar que estés trabajando con los datos más recientes.

Las listas de público normales (no recurrentes) son listas estáticas de usuarios del público en el momento en que se genera la lista.

Crear una nueva lista de público todos los días

Procesar los datos del público de un día y actualizarlos lleva una cantidad variable de tiempo membresía. No hay forma de asegurarse de que los datos de la lista de público se actualicen en 24 horas.

Por ejemplo, incluso si solicita una lista de público a la misma hora todos los días, algunos días, la lista de público será la misma como el día anterior y otros días, la lista de público será diferente contienen un día adicional de cambios en la membresía.

Las listas de público se basan en datos de eventos de un día anterior al más reciente cambios en las membresías. Si creas una lista de público antes de la membresía diaria actualizaciones, usará datos de los dos días anteriores. Si creas un público después de que se actualicen los miembros a diario, se usarán los datos de de ayer.

Encuestar periódicamente una lista de público recurrente

Las listas de público recurrentes solo producen listas de público cuando se agrega un día adicional de que los datos estén disponibles. Esto elimina las conjeturas a la hora de decidir cuándo crear nuevos Listas de público. En su lugar, puedes hacer una encuesta económica a la Lista de público recurrente a lo largo del día para ver si hay más datos disponibles.

Cómo crear una lista de público recurrente

Para crear una lista de público recurrente, llama al recurringAudienceLists.create con el RecurringAudienceList objeto de una solicitud. Se requieren los siguientes parámetros:

• Un nombre de público válido en el audience con el formato properties/{propertyId}/audiences/{audienceId}. Puedes usar la audiences.list de la API de Google Analytics Admin v1 para obtener este valor. El Audience.name de la respuesta audiences.list contiene el nombre del público.
• Se incluye una lista válida de las dimensiones del dimensions . La lista de dimensiones admitidas por este método se puede encontrar en la Consulta la documentación sobre el esquema de exportación de públicos. Solo se incluyen los datos de las dimensiones mencionadas en este campo en una lista de público.

A continuación, se incluye un ejemplo de una solicitud de creación de una lista de público recurrente:

Solicitud HTTP

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

Una respuesta del método recurringAudienceLists.create contiene lo siguiente: en el campo name (como properties/1234567/recurringAudienceLists/123), que se puede utilizar en las consultas posteriores para recuperar los metadatos de configuración para esta lista de público recurrente. Además, los metadatos de configuración contienen nombres de recursos para instancias de listas de público creado para esta lista de público recurrente.

Respuesta HTTP

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Metadatos de configuración de la encuesta

Usa el recurringAudienceLists.get método para recuperar metadatos de configuración sobre un lista de público recurrente. Los metadatos de configuración contienen nombres de recursos para instancias de listas de público creado para esta lista de público recurrente.

Por ejemplo:

Solicitud HTTP

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

Una instancia de RecurringAudienceList se devuelve como respuesta. Contiene los metadatos de configuración, que incluyen nombres de recursos para instancias de listas de público creado para esta lista de público recurrente.

Respuesta HTTP

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Puedes usar recurringAudienceLists.list para enumerar todas las listas de público recurrentes de una propiedad.

Usar webhooks para recibir notificaciones asíncronas sobre listas de público nuevas

En lugar de sondear periódicamente los metadatos de configuración sobre un de público recurrente mediante el recurringAudienceLists.get puedes recibir notificaciones de webhook de forma asíncrona cuando un público lista esté disponible.

Para configurar las notificaciones de webhook, especifica la webhookNotification cuando crees una nueva lista de público recurrente.

Sigue la guía de Async audience lists with webhooks para obtener más información sobre el uso de webhooks en la versión 1 de la API de datos de Google Analytics.

Recupera usuarios en una exportación de público

Para recuperar usuarios en una exportación de públicos, llama al audienceExports.query y especifica el nombre de la exportación de públicos recuperado de los metadatos de configuración proporcionados por recurringAudienceLists.get o recurringAudienceLists.list.

Solicitud HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Si la exportación de públicos está lista, aparecerá una respuesta con la lista de usuarios de un público de muestra:

Respuesta HTTP

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}