Para recibir anuncios oficiales de la API de Google Analytics, suscríbete al grupo de notificaciones de la API de Google Analytics.
14-09-2026 Se agregó compatibilidad con consultas conversacionales en la versión alfa v1
Se agregó el método properties.chat para interactuar con los datos de Google Analytics a través de consultas en lenguaje natural.
- El cuerpo de la solicitud acepta una consulta, un ID de sesión opcional para continuar una conversación anterior y un parámetro
returnPropertyQuotaopcional. - La
respuesta
devuelve datos de respuesta de chat estructurados en objetos
ResponseBlock, el ID de sesión y los detalles de la cuota de tokens de propiedad conPropertyChatQuota, si se solicita. - El permiso de OAuth
https://www.googleapis.com/auth/analytics.chatbot.readproporciona acceso de lectura al métodoproperties.chat.
14 de septiembre de 2026 Se agregaron motivos de truncamiento de datos a las respuestas de los informes
Se agregó el campo dataTruncationReasons a ResponseMetaData en v1 beta y v1 alfa. Cuando se truncan los datos de un informe, este campo incluirá
una lista de objetos DataTruncationReason
que incluyen el tipo de truncamiento, un mensaje descriptivo y
las fechas afectadas.
23/4/2026 Se agregó compatibilidad con los informes de conversiones en la versión alfa v1.
Se agregó compatibilidad para recuperar datos del informe de rendimiento de las conversiones con el método runReport en la versión alfa de la API de datos v1. Esto te permite acceder a los mismos datos de conversiones disponibles en la IU de Google Analytics en Publicidad > Rendimiento de conversiones.
- Se agregó el campo
ConversionSpecaRunReportRequest, lo que permite filtrar las conversiones conconversionActions(IDs de acciones de conversión) y seleccionar unAttributionModel(DATA_DRIVENoLAST_CLICK). - Se agregó el campo
SectionaResponseMetaDatapara identificar si los datos del informe provienen de informes estándar (SECTION_REPORT) o de informes de conversiones (SECTION_ADVERTISING).
Se actualizó el método getMetadata en la versión alfa de la API de datos v1 para proporcionar información para los informes de conversiones:
- Se agregó el campo
conversionsa la respuesta, que devuelve una lista de objetosConversionMetadataque asignan IDs de acciones de conversión a nombres visibles. - Se agregó el campo
sectionsaDimensionMetadatayMetricMetadatapara identificar si un campo específico es compatible con los informes estándar, el registro de conversiones o ambos.
20-10-2024 Se agregó el tipo de filtro de dimensión EmptyFilter.
Con el filtro de dimensión EmptyFilter, puedes crear condiciones de filtrado para compararlas con un valor en blanco.
15-10-2024 Se agregó la función de nivel de muestreo al método reportTasks.
Con el campo samplingLevel del método properties.runReportTask, puedes controlar el nivel de muestreo del informe.
Esta función otorga a las propiedades de Google Analytics 360 acceso a límites de muestreo más altos de 1,000 millones de eventos. Además, los límites de muestreo se pueden establecer en UNSAMPLED
para obtener resultados sin muestreo de recuentos de eventos grandes.
18-09-2024 Se agregó la función de instantánea de cuotas de propiedades
Con el método properties.getPropertyQuotasSnapshot, puedes obtener una instantánea actual de todas las cuotas de propiedad organizadas por categoría de cuota para una propiedad determinada.
28/6/2024 Se agregó la cuota de "errores del cliente por proyecto por propiedad".
Ahora hay un límite de 10,000 errores de servidor de la API permitidos por proyecto y por
propiedad en un período de 15 minutos. Esto incluye todas las solicitudes que generan una
respuesta con cualquier código que no sea 500 o 200. Ejemplos de errores que se incluyen en esta cuota: uso de combinaciones de dimensiones y métricas incompatibles, todos los errores de autenticación.
Si se supera este límite, las llamadas a la API adicionales a esa propiedad se bloquearán temporalmente para el proyecto de Google Cloud asociado hasta que finalice el período de 15 minutos.
14-05-2024 Se agregó la función Comparaciones
Con las comparaciones, puedes evaluar subconjuntos de tus datos en paralelo.
Se actualizaron los métodos de informes principales de la versión beta de la API de datos para que admitan el campo comparisons que, cuando se incluye, especifica la configuración de las comparaciones solicitadas.
En una solicitud, puedes especificar una comparación básica, proporcionando la expresión dimensionFilter
con una solicitud, o usar una comparación guardada proporcionando el
nombre del recurso de la comparación en el campo
comparison.
Se actualizó el método getMetadata para
mostrar todas las comparaciones guardadas disponibles para una propiedad en el campo de respuesta
comparisons.
Cuando se especifica al menos una comparación en una solicitud, la respuesta contendrá la columna comparison que identifica cada comparación.
Actualmente, las comparaciones guardadas solo se pueden crear con la IU de Google Analytics.
8/5/2024 Se agregaron tareas de informes, una función de informes asíncronos, a la versión v1alpha de la API de datos.
Con las tareas de informes, puedes iniciar una solicitud asíncrona de larga duración para crear un informe personalizado de tus datos de eventos de Google Analytics.
Se agregaron los siguientes métodos de manipulación de tareas de informes a la versión v1alpha de la API de Data:
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
6/5/2024 Nuevas dimensiones para los eventos clave
Ya están disponibles las dimensiones y las métricas de los eventos clave.
Modifica las solicitudes de informes que usan la dimensión isConversionEvent para que usen la dimensión isKeyEvent en su lugar.
Modifica las solicitudes de informes que usen una métrica obsoleta de la siguiente tabla para que, en su lugar, usen la métrica de eventos clave.
| Métrica obsoleta | Métrica de evento clave |
|---|---|
advertiserAdCostPerConversion |
advertiserAdCostPerKeyEvent |
conversions |
keyEvents |
firstTimePurchaserConversionRate |
firstTimePurchaserRate |
purchaserConversionRate |
purchaserRate |
sessionConversionRate |
sessionKeyEventRate |
userConversionRate |
userKeyEventRate |
Realiza modificaciones similares en cualquier uso de las métricas de eventos clave para un evento clave en tus solicitudes de informes.
La respuesta del método properties/getMetadata refleja la introducción
de las dimensiones y métricas de los eventos clave en los objetos DimensionMetadata y
MetricMetadata de la siguiente manera:
apiName,uiNameydescriptioncontienen el nombre de la API, el nombre de la IU y la descripción del evento clave.- El campo repetido
deprecatedApiNamestiene una entrada con el nombre de la API de conversión obsoleto.
25/3/2024 Se agregaron las dimensiones específicas de la integración, la fuente de tráfico manual y el grupo de canales principal.
Se agregaron al esquema de la API de datos las dimensiones específicas de la integración de CM360, DV360 y SA360, la fuente de tráfico manual y el grupo de canales principal.
Dimensiones del público:
audienceIdID de público. Es el identificador numérico de un público.
Dimensiones del grupo de canales principal:
firstUserPrimaryChannelGroupPrimer grupo de canales principal del usuarioprimaryChannelGroupGrupo de canales principalsessionPrimaryChannelGroupGrupo de canales principal de la sesión
Dimensiones de fuente de tráfico manuales:
manualCampaignIdID de la campaña manualmanualCampaignNameNombre de la campaña manualmanualCreativeFormatFormato de creatividad manualmanualMarketingTacticTáctica de marketing manualmanualMediumMedio manualmanualSourceFuente manualmanualSourceMediumFuente y medio manualmanualSourcePlatformPlataforma de origen manualfirstUserManualCampaignIdID de la primera campaña manual del usuariofirstUserManualCampaignNameNombre de la primera campaña manual del usuariofirstUserManualCreativeFormatPrimer formato de creatividad del manual de instruccionesfirstUserManualMarketingTacticPrimera táctica de marketing del manual de instruccionesfirstUserManualMediumPrimer medio manual de instruccionesfirstUserManualSourcePrimera fuente del manual de instruccionesfirstUserManualSourceMediumPrimera fuente/primer medio manual de instruccionesfirstUserManualSourcePlatformPrimera plataforma de origen del manual de instruccionessessionManualCampaignIdID de la campaña manual de la sesiónsessionManualCampaignNameNombre de la campaña manual de la sesiónsessionManualCreativeFormatFormato de creatividad manual de la sesiónsessionManualMarketingTacticTáctica de marketing manual de la sesiónsessionManualMediumMedio manual de la sesiónsessionManualSourceFuente manual de la sesiónsessionManualSourceMediumFuente/medio manual de la sesiónsessionManualSourcePlatformPlataforma de origen manual de la sesión
Dimensiones de la integración de Campaign Manager 360 (CM360):
cm360AccountIdID de cuenta de CM360cm360AccountNameNombre de la cuenta de CM360cm360AdvertiserIdID del anunciante de CM360cm360AdvertiserNameNombre del anunciante de CM360cm360CampaignIdID de la campaña de CM360cm360CampaignNameNombre de la campaña de CM360cm360CreativeFormatFormato de creatividad de CM360ID de la creatividad de CM360 de
cm360CreativeIdcm360CreativeNameNombre de la creatividad de CM360cm360CreativeTypeTipo de creatividad de CM360cm360CreativeTypeIdID del tipo de creatividad de CM360cm360CreativeVersionVersión de la creatividad de CM360cm360MediumMedio de CM360cm360PlacementCostStructureEstructura de costos de la posición de CM360ID de posición de CM360 de
cm360PlacementIdcm360PlacementNameNombre de la posición de CM360cm360RenderingIdID de renderización de CM360cm360SiteIdID del sitio de CM360Nombre del sitio de CM360 de
cm360SiteNameFuente de CM360 de
cm360Sourcecm360SourceMediumFuente o medio de CM360firstUserCm360AccountIdPrimer ID de cuenta de CM360 del usuariofirstUserCm360AccountNamePrimer nombre de la cuenta de CM360 del usuariofirstUserCm360AdvertiserIdPrimer ID del anunciante de CM360 del usuariofirstUserCm360AdvertiserNamePrimer nombre del anunciante de CM360 del usuariofirstUserCm360CampaignIdPrimer ID de la campaña de CM360 del usuariofirstUserCm360CampaignNamePrimer nombre de la campaña de CM360 del usuariofirstUserCm360CreativeFormatPrimer formato de creatividad de CM360 del usuariofirstUserCm360CreativeIdID de la primera creatividad de CM360 del usuariofirstUserCm360CreativeNamePrimer nombre de la creatividad de CM360 del usuariofirstUserCm360CreativeTypePrimer tipo de creatividad de CM360 del usuariofirstUserCm360CreativeTypeIdPrimer ID del tipo de creatividad de CM360 del usuariofirstUserCm360CreativeVersionPrimera versión de la creatividad de CM360 del usuariofirstUserCm360MediumPrimer medio de CM360 del usuariofirstUserCm360PlacementCostStructurePrimera estructura de costos de la posición de CM360 del usuariofirstUserCm360PlacementIdPrimer ID de la posición de CM360 del usuariofirstUserCm360PlacementNamePrimer nombre de la posición de CM360 del usuariofirstUserCm360RenderingIdPrimer ID de renderización de CM360 del usuariofirstUserCm360SiteIdPrimer ID del sitio de CM360 del usuariofirstUserCm360SiteNamePrimer nombre del sitio de CM360 del usuariofirstUserCm360SourcePrimera fuente de CM360 del usuariofirstUserCm360SourceMediumPrimera fuente o medio de CM360 del usuariosessionCm360AccountIdID de cuenta de CM360 de la sesiónsessionCm360AccountNameNombre de la cuenta de CM360 de la sesiónsessionCm360AdvertiserIdID del anunciante de CM360 de la sesiónsessionCm360AdvertiserNameNombre del anunciante de CM360 de la sesiónsessionCm360CampaignIdID de la campaña de CM360 de la sesiónsessionCm360CampaignNameNombre de la campaña de CM360 de la sesiónsessionCm360CreativeFormatFormato de creatividad de CM360 de la sesiónsessionCm360CreativeIdID de la creatividad de CM360 de la sesiónsessionCm360CreativeNameNombre de la creatividad de CM360 de la sesiónsessionCm360CreativeTypeTipo de creatividad de CM360 de la sesiónsessionCm360CreativeTypeIdID del tipo de creatividad de CM360 de la sesiónsessionCm360CreativeVersionVersión de la creatividad de CM360 de la sesiónsessionCm360MediumMedio de CM360 de la sesiónsessionCm360PlacementCostStructureEstructura de costos de la posición de CM360 de la sesiónsessionCm360PlacementIdID de posición de CM360 de la sesiónsessionCm360PlacementNameNombre de la posición de CM360 de la sesiónsessionCm360RenderingIdID de renderización de CM360 de la sesiónsessionCm360SiteIdID del sitio de CM360 de la sesiónsessionCm360SiteNameNombre del sitio de CM360 de la sesiónsessionCm360SourceFuente de CM360 de la sesiónsessionCm360SourceMediumFuente o medio de CM360 de la sesión
Dimensiones de la integración de Google Display & Video 360 (DV360):
dv360AdvertiserIdID del anunciante de DV360dv360AdvertiserNameNombre del anunciante de DV360dv360CampaignIdID de la campaña de DV360dv360CampaignNameNombre de la campaña de DV360dv360CreativeFormatFormato de creatividad de DV360dv360CreativeIdID de la creatividad de DV360dv360CreativeNameNombre de la creatividad de DV360dv360ExchangeIdID del mercado de intercambio de DV360dv360ExchangeNameNombre del mercado de intercambio de DV360dv360InsertionOrderIdID del pedido de inserción de DV360dv360InsertionOrderNameNombre del pedido de inserción de DV360dv360LineItemIdID de línea de pedido de DV360dv360LineItemNameNombre de la línea de pedido de DV360dv360MediumMedio de DV360ID de socio de DV360 de
dv360PartnerIddv360PartnerNameNombre del socio de DV360dv360SourceFuente de DV360Fuente o medio de DV360 de
dv360SourceMediumfirstUserDv360AdvertiserIdID de anunciante de DV360 del primer usuariofirstUserDv360AdvertiserNamePrimer nombre del anunciante de DV360 del usuariofirstUserDv360CampaignIdID de la primera campaña de DV360 del usuariofirstUserDv360CampaignNamePrimer nombre de la campaña de DV360 del usuariofirstUserDv360CreativeFormatPrimer formato de creatividad de DV360 del usuariofirstUserDv360CreativeIdID de la primera creatividad de DV360 del usuariofirstUserDv360CreativeNameNombre de la primera creatividad de DV360 del usuariofirstUserDv360ExchangeIdID del primer mercado de intercambio de DV360 del usuariofirstUserDv360ExchangeNameNombre del primer mercado de intercambio de DV360 del usuariofirstUserDv360InsertionOrderIdID de pedido de inserción de DV360 del primer usuariofirstUserDv360InsertionOrderNameNombre del primer pedido de inserción de DV360 del usuariofirstUserDv360LineItemIdID de artículo pedido de DV360 del primer usuariofirstUserDv360LinteItemNameNombre de la primera línea de pedido de DV360 del usuariofirstUserDv360MediumPrimer medio de DV360 del usuariofirstUserDv360PartnerIdID del primer socio de DV360 del usuariofirstUserDv360PartnerNameNombre del primer socio de DV360 del usuariofirstUserDv360SourcePrimera fuente de DV360 del usuariofirstUserDv360SourceMediumPrimera fuente o medio de DV360 del usuariosessionDv360AdvertiserIdID del anunciante de DV360 de la sesiónsessionDv360AdvertiserNameNombre del anunciante de DV360 de la sesiónsessionDv360CampaignIdID de la campaña de DV360 de la sesiónsessionDv360CampaignNameNombre de la campaña de DV360 de la sesiónsessionDv360CreativeFormatFormato de creatividad de DV360 de la sesiónsessionDv360CreativeIdID de la creatividad de DV360 de la sesiónsessionDv360CreativeNameNombre de la creatividad de DV360 de la sesiónsessionDv360ExchangeIdID de mercado de intercambio de DV360 de la sesiónsessionDv360ExchangeNameNombre del mercado de intercambio de DV360 de la sesiónsessionDv360InsertionOrderIdID del pedido de inserción de DV360 de la sesiónsessionDv360InsertionOrderNameNombre del pedido de inserción de DV360 de la sesiónsessionDv360LineItemIdID de artículo pedido de DV360 de la sesiónsessionDv360LineItemNameNombre de la línea de pedido de DV360 de la sesiónsessionDv360MediumMedio de DV360 de la sesiónsessionDv360PartnerIdID de socio de DV360 de la sesiónsessionDv360PartnerNameNombre del socio de DV360 de la sesiónsessionDv360SourceFuente de DV360 de la sesiónsessionDv360SourceMediumFuente o medio de DV360 de la sesión
Dimensiones de la integración de Google Search Ads 360 (SA360):
firstUserSa360AdGroupIdID del primer grupo de anuncios de SA360 del usuariofirstUserSa360AdGroupNameNombre del primer grupo de anuncios de SA360 del usuariofirstUserSa360CampaignIdID de la primera campaña de SA360 del usuariofirstUserSa360CampaignNamePrimera campaña de SA360 del usuariofirstUserSa360CreativeFormatPrimer formato de creatividad de SA360 del usuariofirstUserSa360EngineAccountIdID de cuenta de motor de SA360 del primer usuariofirstUserSa360EngineAccountNameNombre de la primera cuenta de motor de SA360 del usuariofirstUserSa360EngineAccountTypePrimer tipo de cuenta de motor de SA360 del usuariofirstUserSa360KeywordTextTexto de palabra clave de SA360 del primer usuariofirstUserSa360ManagerAccountIdID de la primera cuenta de administrador de SA360 del usuariofirstUserSa360ManagerAccountNameNombre de la primera cuenta de administrador de SA360 del usuariofirstUserSa360MediumPrimer medio de SA360 del usuariofirstUserSa360QueryPrimera búsqueda de SA360 del usuariofirstUserSa360SourcePrimera fuente de SA360 del usuariofirstUserSa360SourceMediumPrimera fuente o medio de SA360 del usuariosa360AdGroupIdID del grupo de anuncios de SA360ID de la campaña de SA360 de
sa360CampaignIdsa360AdGroupNameNombre del grupo de anuncios de SA360Campaña de SA360 de
sa360CampaignNamesa360CreativeFormatFormato de creatividad de SA360sa360EngineAccountIdID de cuenta de motor de SA360sa360EngineAccountNameNombre de la cuenta de motor de SA360sa360EngineAccountTypeTipo de cuenta de motor de SA360sa360KeywordTextTexto de palabra clave de SA360ID de cuenta de administrador de SA360 de
sa360ManagerAccountIdsa360ManagerAccountNameNombre de la cuenta de administrador de SA360sa360MediumMedio de SA360sa360QueryConsulta de SA360sa360SourceFuente de SA360sa360SourceMediumFuente o medio de SA360sessionSa360AdGroupIdID del grupo de anuncios de SA360 de la sesiónsessionSa360CampaignIdID de campaña de SA360 de la sesiónsessionSa360ManagerAccountIdID de cuenta de administrador de SA360 de la sesiónsessionSa360ManagerAccountNameNombre de la cuenta de administrador de SA360 de la sesiónsessionSa360SourceMediumFuente y medio de SA360 de la sesión
6 de marzo de 2024 Se agregó compatibilidad con los públicos de usuarios inactivos en las exportaciones de públicos.
La función Exportación de públicos admite mejor la exportación de públicos de usuarios inactivos. Los usuarios ingresan a estos públicos sin un evento apto. Por ejemplo, el usuario puede ingresar al público si no visita tu sitio web durante siete días. Algunos ejemplos de públicos de usuarios inactivos son "Compradores inactivos durante 7 días", "Usuarios inactivos durante 7 días" y "Usuarios sin notificaciones durante 7 días". Para obtener más información sobre esos públicos sugeridos, consulta Públicos sugeridos.
28-02-2024 Las exportaciones de públicos devuelven el ID de usuario especificado en el etiquetado.
Las exportaciones de públicos ahora devuelven el ID de usuario especificado en el etiquetado, incluso si los datos proporcionados por el usuario están activados para tu propiedad. Si la recopilación de datos proporcionados por el usuario está activada, estos datos se pueden enviar a Google Analytics junto con el ID de usuario en el etiquetado para mejorar la medición. Para obtener más información, consulta Recopilación de datos proporcionados por el usuario.
30-01-2024 Se agregó compatibilidad con las notificaciones de webhook para las listas de público y las listas de público recurrentes en la versión alfa de la API de datos v1.
Los campos AudienceList.webhookNotification
y RecurringAudienceList.webhookNotification
se pueden especificar cuando se crea una lista de público (con properties.audienceLists.create)
o una lista de público recurrente (con properties.recurringAudienceLists.create).
Esta función te permite recibir notificaciones de webhook de forma asíncrona cuando una lista de público está disponible.
18/1/2024 Se mejoró la compatibilidad con las dimensiones que incluyen la cadena de consulta o el componente de minutos.
Las dimensiones que incluyen la cadena de consulta ahora son compatibles con la mayoría de los campos.
Las dimensiones como pagePathPlusQueryString, unifiedPageScreen, pageLocation y fullPageUrl ahora son compatibles con muchos campos adicionales, incluidos sessionSource, browser, city y landingPage.
Las dimensiones que incluyen el componente de minutos ahora son compatibles con la mayoría de los campos. Las dimensiones como minute, nthMinute y dateHourMinute ahora son compatibles con un conjunto similar de campos adicionales.
Consulta el Explorador de dimensiones y métricas de GA4 para obtener información completa sobre la compatibilidad.
13/12/2023 Parámetros personalizados centrados en el artículo
Ahora, las dimensiones personalizadas centradas en el artículo se pueden incluir en las consultas de la API de Analytics Data con la siguiente sintaxis:
| Nombre genérico de la API | Descripción |
|---|---|
| customItem:parameter_name | Dimensión personalizada centrada en el artículo para parameter_name |
Consulta las dimensiones y métricas de la API para obtener más información.
5/12/2023 Las listas de público están disponibles en la versión beta de la API de datos v1 como exportaciones de públicos
Se cambió el nombre de la función Listas de públicos a Exportaciones de públicos y se agregó a la versión beta de la API de datos v1.
Se agregaron los siguientes métodos a la versión beta 1 de la API de datos:
28/11/2023 Se agregó samplingMetadatas para informar la respuesta
Se agregó samplingMetadatas a
ResponseMetaData. Esta colección contendrá un objeto SampleMetadata por cada período de la solicitud para el que se muestrearon los resultados. Google Analytics
aplicará el muestreo solo cuando prevea que los límites de cardinalidad
reducirán la calidad de los datos.
28/11/2023 Se agregó la función de exportación recurrente de listas de públicos a la versión alfa de la API de datos v1
Se agregaron los métodos properties.recurringAudienceLists.create, properties.recurringAudienceLists.create y properties.recurringAudienceLists.list a la versión alfa de la API de datos v1.
Esta funcionalidad te permite producir listas de público diariamente a medida que cambian las membresías de público. Las listas de público recurrentes garantizan que trabajes con los resultados de membresía de público más recientes.
13/10/2023 Se agregó compatibilidad con públicos con duraciones de la membresía de 1 día.
La función de exportación de listas de público ahora admite públicos con duraciones de la membresía de 1 día.
12-09-2023 Reglas de orden predeterminadas de AudienceList
De forma predeterminada, los informes creados con la función de exportación de listas de público siguen las mismas reglas de orden que los demás métodos de informes de la API de datos: el orden será descendente por la primera columna, luego descendente por la segunda columna, etcétera.
Antes de este cambio, es posible que hayas recibido el siguiente informe:
| deviceId | isAdsPersonalizationAllowed |
|---|---|
| ABC | verdadero |
| DAC | falso |
| ABC | falso |
| AAA | verdadero |
Después de este cambio, recibirás el siguiente informe:
| deviceId | isAdsPersonalizationAllowed |
|---|---|
| AAA | verdadero |
| ABC | falso |
| ABC | verdadero |
| DAC | falso |
15-08-2023 Se agregó la dimensión isLimitedAdTracking al esquema de exportación de la lista de público.
isLimitedAdTrackingEs la configuración del límite de seguimiento de anuncios del dispositivo. Los valores posibles sontrue,falsey(not set).Para obtener más información, consulta el artículo Dimensiones de las listas de público.
15/8/2023 Se agregaron la dimensión currencyCode y la métrica itemDiscountAmount
currencyCodeEs el código de moneda local (según el estándar ISO 4217) del evento de comercio electrónico. Por ejemplo, "USD" o "GBP".itemDiscountAmountEs el valor monetario de los descuentos de artículos en los eventos de comercio electrónico. Esta métrica se completa en el etiquetado con el parámetro de artículo "discount".
Para obtener más información, consulta el esquema de informes de la API de datos.
10-08-2023 Se agregó la dimensión isAdsPersonalizationAllowed al esquema de exportación de la lista de públicos.
isAdsPersonalizationAllowedIndica si se permite la personalización de anuncios. Si un usuario es apto para la personalización de anuncios,isAdsPersonalizationAlloweddevuelvetrue. Si un usuario no es apto para la personalización de anuncios,isAdsPersonalizationAlloweddevuelvefalse.Para obtener más información, consulta el artículo Dimensiones de las listas de público.
10-07-2023 Listas de público
Se agregó compatibilidad con las listas de públicos a la versión alfa de la API de datos v1. Las listas de público incluyen una instantánea de los usuarios del público en el momento en que se creó la lista.
Se agregaron los siguientes métodos a la versión alfa de la API de datos v1:
19/5/2023 Grupos de canales personalizados
Se agregó compatibilidad con los grupos de canales personalizados a la API de datos.
11-05-2023 Cambios en la cuota de tokens.
Se actualizó el sistema de cuotas de la API de datos para permitir cargos más precisos.
La cantidad de tokens que se cobran por cada solicitud se actualizó en función del cambio de cuota y se reequilibró de manera que se permita una mayor cantidad de consultas de informes simples, mientras que se cobran significativamente más tokens de cuota por los informes de fechas grandes.
Después de este cambio, si bien el cargo por algunas solicitudes seguirá siendo el mismo, habrá un aumento notable en los cargos por consultas más complejas. Por ejemplo, las solicitudes de más de 6 meses de datos pueden cobrar 1,000 o más tokens de cuota.
Propiedades estándar
| Nombre de la cuota | Límite anterior | Límite nuevo |
|---|---|---|
| Tokens principales por propiedad por día | 25,000 | 200,000 |
| Tokens principales por propiedad por hora | 5,000 | 40,000 |
| Tokens principales por proyecto, por propiedad y por hora | 1.750 | 14,000 |
| Tokens en tiempo real por propiedad por día | 25,000 | 200,000 |
| Tokens en tiempo real por propiedad por hora | 5,000 | 40,000 |
| Tokens en tiempo real por proyecto, por propiedad y por hora | 1.750 | 14,000 |
| Tokens de embudo por propiedad por día | 25,000 | 200,000 |
| Tokens de embudo por propiedad por hora | 5,000 | 40,000 |
| Tokens de embudo por proyecto, por propiedad y por hora | 1.750 | 14,000 |
Propiedades de Analytics 360
| Nombre de la cuota | Límite anterior | Límite nuevo |
|---|---|---|
| Tokens principales por propiedad por día | 250,000 | 2,000,000 |
| Tokens principales por propiedad por hora | 50,000 | 400,000 |
| Tokens principales por proyecto, por propiedad y por hora | 17,500 | 140,000 |
| Tokens en tiempo real por propiedad por día | 250,000 | 2,000,000 |
| Tokens en tiempo real por propiedad por hora | 50,000 | 400,000 |
| Tokens en tiempo real por proyecto, por propiedad y por hora | 17,500 | 140,000 |
| Tokens de embudo por propiedad por día | 250,000 | 2,000,000 |
| Tokens de embudo por propiedad por hora | 50,000 | 400,000 |
| Tokens de embudo por proyecto, por propiedad y por hora | 17,500 | 140,000 |
2023-03-02 Se agregaron dimensiones de fecha.
dayOfWeekNameNombre del día de la semana. El día de la semana en inglés. Esta dimensión tiene valores deSunday,Monday, etcétera.isoWeekSemana ISO del año. Es el número de semana ISO, en el que cada semana comienza el lunes. Para obtener más detalles, consulta https://en.wikipedia.org/wiki/ISO_week_date. Entre los valores de ejemplo, se incluyen01,02y53.Año ISO
isoYear. Es el año ISO del evento. Para obtener más detalles, consulta https://en.wikipedia.org/wiki/ISO_week_date. Los valores de ejemplo incluyen2022y2023.isoYearIsoWeekSemana ISO del año ISO. Los valores combinados deisoWeekyisoYear. Los valores de ejemplo incluyen201652y201701.yearMonthAño y mes. Son los valores combinados deyearymonth. Entre los valores de ejemplo, se incluyen202212o202301.yearWeekSemana del año. Son los valores combinados deyearyweek. Entre los valores de ejemplo, se incluyen202253o202301.
27/2/2023 Se agregaron dimensiones de comercio electrónico.
itemListPositionPosición de la lista de artículos. Indica la posición de un artículo (p. ej., un producto que vende) en una lista. Esta dimensión se completa en el etiquetado con el parámetro "index" del array de artículos.itemLocationIDEs el ID de ubicación del artículo. Es la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponda al elemento asociado. También se puede usar un ID de ubicación personalizado. Este campo se propaga en el etiquetado con el parámetro "location_id" en el array de artículos.itemPromotionCreativeSlotEspacio para la creatividad de promoción del artículo. Indica el nombre del espacio para la creatividad de promoción asociado al artículo. Esta dimensión se puede especificar en el etiquetado con el parámetrocreative_slota nivel del evento o del artículo. Si el parámetro se especifica tanto a nivel del evento como del artículo, se utiliza el parámetro a nivel del artículo.
21/2/2023 Se agregó la dimensión "Página de destino y cadena de consulta".
landingPagePlusQueryStringPágina de destino + cadena de consulta. Es la ruta de la página y la cadena de consulta asociadas con la primera vista de página en una sesión.
Este campo reemplaza la dimensión landingPage, que dejó de estar disponible y se actualizará para que no devuelva una cadena de consulta el 14 de mayo de 2023.
28/1/2023 Se agregaron las métricas "Vistas por usuario" y "Usuarios que se desplazaron".
screenPageViewsPerUservistas por usuario. Es la cantidad de pantallas de la app o páginas web que vieron los usuarios por usuario activo. Se registran las vistas repetidas de una página o pantalla individual.(screen_view + page_view events) / active users.scrolledUsersUsuarios que se desplazaron por la página. Indica la cantidad de usuarios únicos que se desplazaron hacia abajo por, al menos, el 90% de la página.
23/1/2023 Se agregaron las dimensiones "Continente" y "ID de continente".
continentContinente. Indica el continente de donde proviene la actividad del usuario. Por ejemplo,AmericasoAsia.continentIdID del continente. Es el ID geográfico del continente donde se originó la actividad del usuario, según su dirección IP.
23/1/2023 Se agregó el ID de la dimensión "Filtro de datos de prueba".
testDataFilterIdEs el ID del filtro de datos de prueba. Es el identificador numérico de un filtro de datos en estado de prueba. Puede utilizar filtros de datos para incluir o excluir datos del evento de sus informes, según los valores de los parámetros de eventos. Para obtener más información, consulta https://support.google.com/analytics/answer/10108813.
18/10/2022 Se agregaron métricas de anuncios.
advertiserAdClicksclics en los anuncios Es la cantidad total de veces que los usuarios hicieron clic en un anuncio para llegar a la propiedad.advertiserAdCostCosto de los anuncios. Es el importe total que pagó por sus anuncios.advertiserAdCostPerClickCosto por clic de los anuncios El costo por clic de los anuncios es el costo de los anuncios dividido por los clics en los anuncios y, a menudo, se abrevia como CPC.advertiserAdCostPerConversionCosto por conversión. El costo por conversión es el costo del anuncio dividido por las conversiones.advertiserAdImpressionsimpresiones de anuncios. Es la cantidad total de impresiones.returnOnAdSpendRetorno de la inversión publicitaria El retorno de la inversión publicitaria (ROAS) se calcula dividiendo los ingresos totales por el costo publicitario del anunciante.
17/10/2022 Se agregaron métricas centradas en el artículo.
- Se agregaron
itemsAddedToCartartículos al carrito. Indica la cantidad de unidades de un solo artículo que se agregaron al carrito. - Se pagaron
itemsCheckedOutartículos. Indica la cantidad de unidades pagadas de un solo artículo. itemsClickedInListArtículos en los que se hizo clic incluidos en la lista. Indica la cantidad de unidades de un solo artículo en las que se hizo clic en una lista.itemsClickedInPromotionArtículos en los que se hizo clic incluidos en la promoción. Indica la cantidad de unidades de un solo artículo en las que se hizo clic en la promoción.- Se vieron
itemsViewedelementos. Indica la cantidad de unidades vistas de un solo artículo. itemsViewedInListArtículos vistos incluidos en la lista. Indica la cantidad de unidades de un solo artículo que se vieron en una lista.itemsViewedInPromotionArtículos vistos incluidos en la promoción. Indica la cantidad de unidades de un solo artículo que se vieron en la promoción.
13/9/2022: Anuncio de cambios en la compatibilidad de esquemas.
El 1 de diciembre de 2022, se producirán los siguientes cambios rotundos:
Las dimensiones centradas en el artículo, como
itemName, dejarán de ser compatibles con las métricas centradas en el evento, comoeventCount. Las dimensiones centradas en el artículo seguirán siendo compatibles con las métricas centradas en el artículo, comoitemRevenue, las métricas basadas en el usuario, comoactiveUsers, y las métricas basadas en la sesión, comosessions.Las dimensiones de atribución, como
source, se están volviendo incompatibles con algunas métricas centradas en el evento, comoeventCount. Las dimensiones de atribución seguirán siendo compatibles con las métricas atribuibles, comoconversions, las métricas basadas en el usuario, comoactiveUsers, y las métricas basadas en la sesión, comosessions.Las dimensiones que incluyen la cadena de consulta, como
pagePathPlusQueryString, solo serán compatibles con un conjunto limitado de dimensiones y métricas.
01-09-2022 Cambios en las cuotas.
Las cuotas de
Requests per day,Requests Per MinuteyRequests Per Minute Per Userse quitan de la API de datos.Se agregó la cuota de
Tokens Per Project Per Property Per Houra la API.Cada solicitud consume cuota para
Tokens Per Property Per HouryTokens Per Project Per Property Per Hour.Consulta la documentación de cuotas para obtener información detallada sobre las cuotas nuevas.
3/8/2022 Se agregaron dimensiones de SA360 con alcance de sesión.
sessionSa360AdGroupNameEs el nombre del grupo de anuncios de SA360 de la sesión. Es el nombre del grupo de anuncios de Search Ads 360 que generó esta sesión.sessionSa360CampaignNameCampaña de SA360 de la sesión Es el nombre de la campaña de Search Ads 360 que generó esta sesión.sessionSa360CreativeFormatEs el formato de creatividad de SA360 de la sesión. Es el tipo de creatividad de Search Ads 360 que generó esta sesión. Por ejemplo, "Anuncio de búsqueda responsivo" o "Anuncio de texto expandido".sessionSa360EngineAccountIdID de cuenta de motor de SA360 de la sesión. Es el ID de la cuenta de motor de SA360 que generó esta sesión.sessionSa360EngineAccountNameNombre de la cuenta de motor de SA360 de la sesión. Es el nombre de la cuenta de motor de SA360 que generó esta sesión.sessionSa360EngineAccountTypeTipo de cuenta de motor de SA360 de la sesión. Es el tipo de cuenta de motor de Search Ads 360 que generó esta sesión. Por ejemplo, "google ads", "bing" o "baidu".sessionSa360KeywordTexto de palabra clave de SA360 de la sesión. Es la palabra clave del motor de búsqueda de Search Ads 360 que generó esta sesión.sessionSa360MediumMedio de SA360 de la sesión. Es la palabra clave del motor de búsqueda de Search Ads 360 que generó esta sesión. Por ejemplo, "cpc".sessionSa360QueryConsulta de SA360 de la sesión Es la búsqueda de Search Ads 360 que generó esta sesión.sessionSa360SourceFuente de SA360 de la sesión. Es la fuente del tráfico de Search Ads 360 que generó esta sesión. Por ejemplo, "example.com" o "google".Las dimensiones
sessionCampaignIdysessionCampaignNameahora admiten campañas de Search Ads 360.
11/7/2022 Se agregaron métricas de porcentaje de conversiones.
Porcentaje de conversiones
sessionConversionRateEs el porcentaje de sesiones en las que se activó cualquier evento de conversión.userConversionRateEs el porcentaje de usuarios que activaron cualquier evento de conversión.
Métricas de porcentaje de conversiones para una conversión
sessionConversionRate:event_nameEs el porcentaje de sesiones en las que se activó un evento de conversión específico.userConversionRate:event_nameIndica el porcentaje de usuarios que activaron un evento de conversión específico.
5/5/2022 Se agregó la funcionalidad de informes de embudo al canal Alfa.
Se agregó el método
runFunnelReporta la versión v1alpha de la API, que devuelve un informe de embudo personalizado de tus datos de eventos de Google Analytics.Este método se introduce durante el período de estabilidad de la versión alfa con la intención de reunir comentarios sobre la sintaxis y las funciones antes de proceder a la versión beta. Completa los comentarios del informe sobre el embudo de la API de Google Analytics Data para enviar tus comentarios sobre esta API.
16/2/2022 Se agregaron dimensiones nuevas.
Término y contenido manuales
firstUserManualAdContentPrimer contenido del anuncio del manual de instrucciones. Es el contenido del anuncio que adquirió al usuario por primera vez. Se completa con el parámetroutm_content.firstUserManualTermPrimer término del manual de instrucciones. Es el término que adquirió al usuario por primera vez. Se completa con el parámetroutm_term.manualAdContentContenido del anuncio manual. Es el contenido del anuncio que se atribuyó al evento de conversión. Se propaga con el parámetroutm_content.manualTermTérmino manual. Indica el término que se atribuyó al evento de conversión. Se completa con el parámetroutm_term.sessionManualAdContentContenido del anuncio manual de la sesión. Es el contenido del anuncio que generó una sesión. Se propaga con el parámetroutm_content.sessionManualTermTérmino manual de la sesión. Es el término que generó una sesión. Se completa con el parámetroutm_term.
Análisis de fallas
crashAffectedUsersUsuarios afectados por fallas. Es la cantidad de usuarios que registraron una falla en esta fila del informe.crashFreeUsersRateTasa de usuarios que no experimentaron fallas.
App/Web
averageSessionDurationEs la duración promedio (en segundos) de las sesiones de los usuarios.newVsReturningUsuarios nuevos y recurrentesscreenPageViewsPerSessionVistas por sesión.landingPagePágina de destino. Es la ruta de la página y la cadena de consulta asociadas con la primera vista de página en una sesión.platformDeviceCategoryEs la plataforma y el tipo de dispositivo en los que se ejecutó tu sitio web o app para dispositivos móviles.
App para dispositivos móviles
averagePurchaseRevenuePerUser: Es el promedio de ingresos por compras de cada usuario.firstTimePurchaserConversionRateEs el porcentaje de usuarios activos que hicieron su primera compra.firstTimePurchasersPerNewUserEs la cantidad promedio de compradores nuevos por cada usuario nuevo.dauPerMauDAU / MAU. Es el porcentaje continuo de usuarios activos de 30 días que también son usuarios activos de 1 día.dauPerWauDAU / WAU. Es el porcentaje continuo de usuarios activos de 7 días que también son usuarios activos de 1 día.wauPerMauWAU / MAU. Es el porcentaje continuo de usuarios activos de 30 días que también son usuarios activos de 7 días.purchaserConversionRateEs el porcentaje de usuarios activos que realizaron 1 o más transacciones de compra.transactionsPerPurchaserTransacciones por comprador.
Campaña de Google Ads
firstUserGoogleAdsCampaignTypeEs el tipo de campaña de Google Ads con la que se adquirió al usuario por primera vez.googleAdsCampaignTypeEs el tipo de campaña de Google Ads atribuida al evento de conversión.sessionGoogleAdsCampaignTypeEs el tipo de campaña de Google Ads que generó esta sesión.
7/9/2021 Se agregaron nuevas dimensiones de fecha y hora.
dateHourMinute: Son los valores combinados de fecha, hora y minuto con el formato AAAAMMDDHHMM.minute: Es el minuto de dos dígitos de la hora en que se registró el evento.nthMinuteEs la cantidad de minutos transcurridos desde el inicio del período.
7/9/2021 Se agregaron nuevas dimensiones propagadas por parámetros de evento.
achievementIdEs el ID del logro en un juego para un evento.characterEs el personaje de un jugador en un juego para un evento.fileExtensionEs la extensión del archivo descargado.fileName: Es la ruta de la página del archivo descargado.groupIdEs el ID del grupo de jugadores en un juego para un evento.linkClassesEs el atributo HTML class de un vínculo de salida.linkDomainEs el dominio de destino del vínculo de salida.linkIdEs el atributo HTML id de un vínculo de salida o una descarga de archivo.linkTextEs el texto del vínculo de la descarga de archivo.linkUrlEs la URL completa de un vínculo de salida o una descarga de archivo.methodEs el método por el que se activó un evento.outboundDevuelve "true" si el vínculo lleva a un sitio que no forma parte del dominio de la propiedad.pageLocationEl protocolo, el nombre de host, la ruta de la página y la cadena de consulta de las páginas web visitadas.pageReferrer: Es la URL de referencia completa, incluidos el nombre de host y la ruta de acceso.percentScrolledEs el porcentaje en el que el usuario se desplazó por la página hacia abajo (por ejemplo, "90").searchTermEs el término que buscó el usuario.videoProviderEs la fuente del video (por ejemplo, "YouTube").videoTitleEs el título del video.videoUrlEs la URL del video.visibleDevuelve "true" si el contenido es visible.unifiedPagePathScreen: Es la ruta de la página (Web) o la clase de pantalla (app) en la que se registró el evento.
7 de septiembre de 2021: Cambios en el esquema de API.
Cambios en las dimensiones existentes:
unifiedPageScreenEn el caso de los eventos generados en la Web, esta dimensión ahora devuelve la ruta de la página y la cadena de consulta en la que se registró el evento.
Anuncio de los próximos cambios:
firstUserTrafficOriginEs el origen del tráfico que adquirió al usuario por primera vez. No dependas de que este campo devuelva "Manual" para el tráfico que usa UTM, ya que este campo se actualizará y devolverá "(not set)" en lugar de "Manual" para el lanzamiento de una próxima función.sessionTrafficOriginEs el origen del tráfico de la campaña de la sesión. No dependas de que este campo devuelva "Manual" para el tráfico que usa UTM, ya que este campo se actualizará y devolverá "(not set)" en lugar de "Manual" para el lanzamiento de una próxima función.trafficOriginEs el origen del tráfico de la campaña del evento de conversión. No dependas de que este campo devuelva "Manual" para el tráfico que usa UTM, ya que este campo se actualizará y devolverá "(not set)" en lugar de "Manual" para el lanzamiento de una próxima función.
7 de septiembre de 2021 Se agregó el método checkCompatibility a la API.
checkCompatibility
enumera las dimensiones y métricas que se pueden agregar a una solicitud de informe y
mantener la compatibilidad.
21/7/2021 Cambios en los informes en tiempo real.
Ahora es posible especificar los intervalos de minutos de los datos de eventos que se leerán con el parámetro minuteRanges del método runRealtimeReport.
21/7/2021 Nuevas dimensiones de agrupación de canales.
Se agregaron nuevas dimensiones de agrupación de canales al esquema de informes de la API de datos:
firstUserDefaultChannelGroupingPrimera agrupación de canales predeterminada del usuario.defaultChannelGroupingAgrupación de canales predeterminada.
10/6/2021 Cambios en el esquema de API.
Se agregó la dimensión
minutesAgoal esquema en tiempo real de la API de datos y se puede usar en las consultas al métodorunRealtimeReport. Esta dimensión contiene la cantidad de minutos que transcurrieron desde que se recopiló un evento. 00 es el minuto actual y 01 significa el minuto anterior.Se agregó la dimensión
googleAdsCreativeIdal esquema de API de datos. Esta dimensión contiene el ID de la creatividad del anuncio de Google Ads que se atribuyó al evento de conversión.Se agregó la dimensión
sessionGoogleAdsCreativeIdal esquema de API de datos. Esta dimensión contiene el ID de la creatividad del anuncio de Google Ads que generó una sesión en tu sitio web o app.Se cambió el nombre de la dimensión
firstUserCreativeIdafirstUserGoogleAdsCreativeIden el esquema de la API de datos. Esta dimensión contiene el ID de la creatividad de Google Ads con la que se adquirió al usuario por primera vez.
9 de abril de 2021 Se lanzó la versión beta de la API de Google Analytics Data v1.
El endpoint de API se actualizó a
https://analyticsdata.googleapis.com/v1beta.Los métodos
runReport,runPivotReport,batchRunReportsybatchRunPivotReportsahora aceptan el ID de una propiedad Google Analytics 4 en el parámetropropertyde la ruta de URL en lugar del campoentitydel cuerpo de una solicitud:POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReportsSe actualizaron las bibliotecas cliente de la API para usar el nuevo extremo de la API.
19-02-2021 Cambios en la paginación.
El tamaño predeterminado de la respuesta del informe aumentó de 10 a 10,000 filas de datos de eventos.
El valor
"limit" : -1que se usó para indicar un intento de recuperar todas las filas ya no se admite en RunReportRequest.El valor máximo del campo
limitse establece en100000. Usa la paginación para recuperar informes que contengan más de 100,000 filas.
8 de febrero de 2021 Nuevas dimensiones y métricas de comercio electrónico.
Se agregaron nuevas dimensiones y métricas de comercio electrónico al esquema de API:
Dimensiones: adFormat, adSourceName, adUnitName, itemBrand,
itemCategory, itemCategory2, itemCategory3, itemCategory4,
itemCategory5 itemId, itemListId, itemListName, itemName,
itemPromotionCreativeName, itemPromotionId, itemPromotionName,
orderCoupon, transactionId.
Métricas: adUnitExposure, addToCarts, cartToViewRate, checkouts,
ecommercePurchases, firstTimePurchasers, itemListClickThroughRate,
itemListClicks, itemListViews, itemPromotionClickThroughRate,
itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity,
itemRevenue, itemViews, publisherAdClicks,
publisherAdImpressions, totalPurchasers.
8/2/2021 Se agregaron nuevas dimensiones de campaña.
Se agregaron nuevas dimensiones de campaña al esquema de API:
campaignId, campaignName, googleAdsAccountName,
googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType,
source, trafficOrigin
8 de febrero de 2021: Se realizaron cambios en las dimensiones dayOfWeek y week.
El valor de la dimensión
dayOfWeekahora comienza con 0 en lugar de 1.El valor de la dimensión
weekahora comienza con 01 y devuelve un número de dos dígitos del 01 al 53. Las semanas comienzan el domingo. El 1 de enero siempre se incluye en la semana 01.
28/1/2021 Se agregaron variantes de agregación para las métricas personalizadas.
Cada métrica personalizada que registra una propiedad crea tres variantes de métricas de la API: una suma, un promedio y un recuento.
28/1/2021 Se agregaron nuevas dimensiones de fecha y hora.
Se agregaron las siguientes dimensiones nuevas al esquema de API:
hour, nthHour, nthYear y dateHour.
28-01-2021 La API de datos redujo los tokens de cuota que se cobran por consulta.
La API de datos redujo los tokens de cuota que se cobran por consulta. No se modificaron los límites de cuota para los tokens de cuota de propiedad por hora y por día.
9 de noviembre de 2020 Se borró el método getUniversalMetadata.
Se borró el método getUniversalMetadata. Usa
getMetadata. Se quitó el período máximo de un año por solicitud a la API.
2020-11-02 Se agregó un método de informes en tiempo real.
Consulta Crea un informe en tiempo real para ver ejemplos y runRealtimeReport para consultar la documentación de referencia de REST.
19-10-2020 Se actualizaron los artefactos de la biblioteca cliente.
Se actualizaron los artefactos de la biblioteca cliente junto con las instrucciones de uso y las muestras de código.
13/10/2020 Se cambió el nombre de las propiedades App + Web a Google Analytics 4 (GA4).
8/10/2020 Se agregó el método getMetadata a la API.
El método getMetadata devuelve las dimensiones y métricas personalizadas disponibles para el ID de propiedad de GA4 especificado, así como los metadatos universales.
8/10/2020 Las dimensiones y métricas personalizadas están disponibles en los informes.
Consulta la documentación del esquema de API para obtener información sobre las dimensiones y métricas personalizadas. Esta actualización incluye dimensiones y métricas personalizadas centradas en el evento, así como dimensiones personalizadas centradas en el usuario.