Los públicos de Google Analytics 4 te permiten segmentar a los usuarios de las maneras que sean importantes para tu empresa. Con los públicos, puedes agrupar a los usuarios de tu sitio o aplicación en función de atributos compartidos.
Con la versión 1 de la API de datos de Google Analytics, puedes generar exportaciones de públicos, que incluyen una instantánea de los usuarios en el público.
Cómo crear una exportación de público
La API de datos de Google Analytics v1 usa un enfoque asíncrono para crear exportaciones de público. Primero, se necesita una solicitud al método audienceExports.create para crear una exportación de público de usuarios. Luego, se usa el método audienceExports.query para recuperar los usuarios del público.
Además, puedes usar audienceExports.get para recuperar metadatos de configuración sobre una exportación de público específica y audienceExports.list para enumerar todas las exportaciones de público de una propiedad.
Selecciona una entidad de informe
Todos los métodos de la API de datos v1 requieren que el
identificador de la propiedad Google Analytics 4
se especifique dentro de una ruta de solicitud de URL en el formato
properties/GA4_PROPERTY_ID, como los siguientes:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
El informe se genera en función de los datos de eventos de Google Analytics recopilados en la propiedad Google Analytics 4 especificada.
Si usas una de las bibliotecas cliente de la API de datos, no es necesario manipular la ruta de URL de la solicitud de forma manual.
La mayoría de los clientes de la API proporcionan un parámetro property que espera una cadena en forma de properties/GA4_PROPERTY_ID.
Consulta la Guía de inicio rápido para ver ejemplos del uso de las bibliotecas cliente.
Solicita la creación de exportación de público
Para crear una exportación de público, llama al método audienceExports.create con el objeto AudienceExport en una 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
dimensions. Puedes encontrar la lista de dimensiones compatibles con este método en la documentación Esquema de exportación de públicos. En una exportación de público, solo se incluyen los datos de las dimensiones mencionadas en este campo.
Ejemplo de solicitud de creación de exportación de público:
Solicitud HTTP
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 nombre de la exportación de público en el campo name (como properties/1234567/audienceExports/123), que se puede usar en las consultas posteriores para recuperar los usuarios de esta exportación.
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"
}
}
Cómo consultar el estado de preparación de la exportación de públicos
La exportación de públicos puede tardar varios minutos en generarse después de la llamada a audienceExports.create. Para obtener el estado de preparación para una exportación de público, llama al método audienceExports.get.
Usa el nombre de exportación de público (como properties/1234567/audienceExports/123) que recibiste de una respuesta de audienceExports.create para especificar la exportación de públicos.
Ejemplo:
Solicitud HTTP
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 una respuesta. Una vez que se completa la generación de exportación de público, su estado cambia de CREATING a ACTIVE.
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"
}
Para obtener el estado de todas las exportaciones de público, llama al método audienceExports.list.
Cómo recuperar usuarios en una exportación de público
Una vez que se genere la exportación de públicos creada con el método audienceExports.create, llama al método audienceExports.query y especifica el nombre de la exportación de públicos (como properties/1234567/audienceExports/123).
Solicitud HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Si la exportación de públicos está lista, se muestra una respuesta que contiene la lista de usuarios de un público:
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
}
Expectativas de datos para la exportación de públicos
En la siguiente sección, se establecen las expectativas de los datos para las membresías de usuario en las exportaciones de públicos.
Actualidad de los datos
La actualización de los datos de exportación de públicos es el tiempo que tarda Google Analytics en recopilar y procesar eventos y, luego, actualizar la membresía de los usuarios en los públicos. Si todo el proceso tarda 24 horas, la actualización de los datos de Audience Export es de 24 horas. Consulta Actualidad de los datos para obtener más información.
Por ejemplo, si un usuario completa su primera compra y, luego, 7 horas después, creas una exportación de público para el público "Compradores", es casi seguro que el usuario aún no esté en la exportación de público "Compradores". Entre 14 y 38 horas después de la primera compra, es probable que ese usuario esté en las nuevas exportaciones de público.
Las exportaciones de públicos son resúmenes
Las exportaciones de público son listas de usuarios en un público en un resumen en el tiempo. Para el remarketing de Google Ads, Google Analytics exporta de forma automática y continua los usuarios de los públicos a Google Ads. Por el contrario, con las exportaciones de público creadas con la versión 1 de la API de datos, debes crear una exportación de público nueva para ver los usuarios más recientes de ese público.
Las exportaciones de público se crean en función de las membresías de usuario más recientes disponibles. Sin embargo, las exportaciones de públicos pueden tener una actualización de datos de, por ejemplo, 20 horas, lo que significa que se basará en todos los eventos de las 20 horas anteriores al momento actual.
Los datos de membresía más recientes se actualizan una vez al día, por lo general, durante el horario de verano de la zona horaria de la propiedad. Esto significa que una exportación de público para el mismo público a las 9 a.m. y a las 11 a.m. probablemente mostrará los mismos datos, pero una exportación de público a las 3 p.m. puede ser diferente si se incluyen los datos de un día adicional.
Vencimiento de las exportaciones de públicos
Las exportaciones de públicos vencen después de 72 horas. Los usuarios nuevos pueden entrar y salir de un público cada día. Para obtener el resumen más reciente de los usuarios, debes crear exportaciones de público nuevas para cada día.
Límites de usuarios para la exportación de públicos
Cuando el tamaño de un público o una propiedad supera un límite de usuarios, las exportaciones de públicos muestran muestras representativas del público. Estos límites dependen de tu tipo de propiedad (es decir, una propiedad estándar o de 360) y se aplican en cada exportación de público de forma individual. Los usuarios mostrados son usuarios del público solicitado, y los usuarios se consideran usuarios que pueden o no ser miembros del público.
| Tipo de límite | Límites de propiedad estándar | Límites de las propiedades de Analytics 360 |
|---|---|---|
| Máximo de usuarios que se muestran | 2 millones | 200 millones |
| Cantidad máxima de usuarios considerados | 10 millones | 1,000 millones |
Coherencia de la identidad en los informes
La identidad de los informes decide cómo se anula la duplicación de los usuarios en los informes. Las exportaciones de públicos NO cambian en función de la configuración de identidad de los informes. Las exportaciones de públicos siempre identifican a los usuarios por ID de usuario y, luego, ID de dispositivo.
Esto significa que los informes sobre un público pueden mostrar más usuarios que los que muestra la exportación de públicos. Por ejemplo, si la identidad de los informes es "basada en el dispositivo" y se recopila el ID del usuario, los informes no anularán los usuarios duplicados en función del ID del usuario, pero las exportaciones de público anularán los duplicados según el ID del usuario.
Coherencia en el reabastecimiento
Cuando creas un público en Google Analytics y habilitas el remarketing de Google Ads, Google Analytics reabastece ese público en Google Ads con los miembros agregados recientemente. Sin embargo, los informes de Google Analytics y las exportaciones de públicos NO contienen membresías de público reabastecidas. El usuario deberá registrar un evento después de que se cree el público para que los informes y las exportaciones de públicos lo muestren en ese público.
Por ejemplo, si un usuario registra un evento de compra el 20 de junio y tú creas un público "Compradores" el 21 de junio, es probable que debas esperar hasta el 22 de junio para poder ver a ese usuario en las nuevas exportaciones de público. Sin embargo, ese usuario solo estará en la exportación de público si registró algún evento el 21 de junio.