Crea una exportación de público

Públicos en Google Analytics te permiten segmentar a tus usuarios de formas significativas para tu empresa. Con públicos, puedes agrupar a los usuarios de tu sitio o aplicación según atributos.

Puedes exportar tus públicos, incluido un resumen de sus usuarios, mediante la herramienta API de datos:

Consulta las expectativas relacionadas con los datos para la exportación de públicos. para obtener información importante sobre los datos que ves en las exportaciones de públicos.

Descripción general

Realiza las siguientes solicitudes a la API de datos para crear y consultar una exportación de público:

1. Llama a audienceExports.create. para crear una exportación de públicos.
2. Llama a audienceExports.query. se usa para recuperar los usuarios del público.

Para obtener más información, puedes llamar a audienceExports.get a recuperar metadatos de configuración sobre una exportación de público específica audienceExports.list a Enumera todas tus exportaciones de públicos para una propiedad específica.

Seleccionar una entidad denunciante

Todos los métodos de la API de Data requieren la propiedad de Google Analytics identificador que se especificará dentro de una ruta de solicitud de URL, en el formato de properties/GA_PROPERTY_ID. Por ejemplo:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

El informe se genera en función de los datos de eventos de Google Analytics recopilados en la propiedad de Google Analytics especificada.

Si usas una de las bibliotecas cliente de la API de datos, no necesitas cambiar la ruta de la URL de la solicitud. La mayoría de los clientes de la API proporcionan un property. que espera una cadena con el formato properties/GA_PROPERTY_ID. Consulta Guía de inicio rápido para ver ejemplos de cómo usar bibliotecas cliente.

Crea una exportación de público

Para crear una exportación de públicos, llama al método audienceExports.create con el comando AudienceExport objeto de tu solicitud. Se requieren los siguientes parámetros:

• Un nombre de público válido en audience con el formato properties/{propertyId}/audiences/{audienceId}. Puedes usa el 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.
• Una lista válida de dimensiones en 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 los los datos de las dimensiones mencionadas en este campo se incluyen en un exportar.

A continuación, se incluye una solicitud de ejemplo para crear una exportación de públicos:

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

Una respuesta del método audienceExports.create contiene el valor de en el campo name, por ejemplo, properties/1234567/audienceExports/123. Esta es una respuesta de ejemplo:

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

Puedes usar name para consultar a los usuarios en la exportación de públicos.

Consultar el estado de preparación de la exportación de públicos

Es posible que la exportación de públicos tarde varios minutos después de la audienceExports.create llamada.

Para verificar el estado de preparación de una exportación de público, llama al audienceExports.get.

Usa el nombre de exportación de público de una respuesta audienceExports.create para especificar la exportación de públicos en tu solicitud.

A continuación, se incluye una solicitud de ejemplo:

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

El estado de preparación para una exportación de público se muestra en el campo state. de la respuesta. Una vez que se completa la generación de exportación de públicos, su estado cambios de CREATING a ACTIVE.

Esta es una respuesta de ejemplo:

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

Puedes obtener el estado de todas las exportaciones de públicos llamando al audienceExports.list .

Recupera usuarios de una exportación de público

Una vez que se genere la exportación de públicos, llama al método audienceExports.query y especifica el el name de la exportación de público en la solicitud.

A continuación, se incluye una solicitud de ejemplo:

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

Si la exportación del público está lista, la llamada muestra la lista de usuarios del público.

Esta es una respuesta de ejemplo:

{
  "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
}