Los públicos en Google Analytics te permiten segmentar a tus usuarios de formas significativas para tu empresa. Con los públicos, puedes agrupar a los usuarios de tu sitio o aplicación en función de atributos compartidos.
Puedes exportar tus públicos, incluida una instantánea de sus usuarios, con la API de Data.
Consulta la guía Expectativas de los datos de exportación de público para obtener información importante sobre los datos que ves en las exportaciones de público.
Descripción general
Realiza las siguientes solicitudes a la API de Data para crear y consultar una exportación de público:
- Llama al método
audienceExports.createpara crear una exportación de público. - Se llama al método
audienceExports.querypara recuperar los usuarios del público.
Para obtener más información, puedes llamar a audienceExports.get para recuperar los metadatos de configuración sobre una exportación de público específica y a audienceExports.list para enumerar todas tus exportaciones de público para una propiedad específica.
Selecciona una entidad de informes
Todos los métodos de la API de Data requieren que se especifique el identificador de la propiedad de Google Analytics dentro de una ruta de solicitud de URL, en el formato 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 Data, no es necesario que cambies la ruta de acceso de la URL de la solicitud. La mayoría de los clientes de la API proporcionan un parámetro property que espera una cadena con el formato properties/GA_PROPERTY_ID. Consulta la guía de inicio rápido para ver ejemplos del uso de las bibliotecas cliente.
Crea una exportación de público
Para crear una exportación de público, llama al método audienceExports.create con el objeto AudienceExport en tu solicitud. Se requieren los siguientes parámetros:
- Un nombre de público válido en el campo
audience, con el formatoproperties/{propertyId}/audiences/{audienceId}. Puedes usar el métodoaudiences.listde la versión 1 de la API de Google Analytics Admin para obtener este valor. El campoAudience.namede la respuestaaudiences.listcontiene el nombre del público. - Una lista válida de dimensiones en el campo
dimensionsLa lista de dimensiones admitidas por este método se puede encontrar en la documentación del esquema de exportación de públicos. En la exportación de públicos, solo se incluyen los datos de las dimensiones mencionadas en este campo.
A continuación, se muestra una solicitud de ejemplo para crear una exportación de público:
Solicitud HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
La respuesta del método audienceExports.create contiene el nombre de la exportación de público en el campo name, por ejemplo, properties/1234567/audienceExports/123.
Esta es una respuesta de ejemplo:
Respuesta HTTP
{
"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 los usuarios de la exportación del público.
Consulta el estado de preparación de la exportación de público
La generación de la exportación de público puede tardar varios minutos después de la llamada a audienceExports.create.
Puedes verificar el estado de preparación de una exportación de público llamando al método audienceExports.get.
Usa el nombre de la exportación del público de una respuesta audienceExports.create para especificar la exportación del público en tu solicitud.
A continuación, se muestra una solicitud de ejemplo:
Solicitud HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
El estado de preparación de una exportación de público se muestra en el campo state de la respuesta. Una vez que se completa la generación de la exportación del público, su estado cambia de CREATING a ACTIVE.
Esta es una respuesta de ejemplo:
Respuesta HTTP
{
"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 método audienceExports.list.
Cómo recuperar usuarios de una exportación de público
Una vez que se genere la exportación de público, llama al método audienceExports.query y especifica el name de la exportación de público en la solicitud.
A continuación, se muestra una solicitud de ejemplo:
Solicitud HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Si la exportación del público está lista, esta llamada devuelve la lista de usuarios del público.
Esta es una respuesta de ejemplo:
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
}