Registro de cambios

Para recibir anuncios oficiales sobre la API de Google Analytics, suscríbete al grupo de notificaciones de la API de Google Analytics.

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 comparar con un valor en blanco.

2024-10-15 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 brinda 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 los resultados no muestreados con un recuento de eventos grande.

2024-09-18 Se agregó la función de instantánea de cuotas de propiedad

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.

2024-06-28 Se agregó la cuota de "errores del cliente por proyecto y por propiedad"

Ahora hay un límite de 10,000 errores del servidor de la API permitidos por proyecto y 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. Entre los ejemplos de errores que se incluyen en esta cuota, se encuentran el uso de combinaciones incompatibles de dimensiones y métricas, y todos los errores de autenticación.

Si se supera este límite, se bloquearán temporalmente las llamadas a la API adicionales a esa propiedad para el proyecto de Google Cloud asociado hasta que finalice el período de 15 minutos.

14/5/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 Data para admitir 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 enumerar 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.

2024-05-08 Se agregaron tareas de informes, una función de informes asíncronos, a la versión v1alpha de la API de Data.

Con las tareas de informes, puedes iniciar una solicitud asíncrona de larga duración para generar 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 1 alfa de la API de Data:

6/5/2024: Nuevas dimensiones para los eventos clave

Ya están disponibles las dimensiones y métricas para 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 cualquier solicitud de informe que use una métrica obsoleta en la siguiente tabla para que, en su lugar, use la métrica de eventos clave.

Métrica obsoleta Métrica de eventos 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 dimensiones y métricas de eventos clave en los objetos DimensionMetadata y MetricMetadata de la siguiente manera:

  • apiName, uiName y description contienen el nombre de la API del evento de tecla, el nombre de la IU y la descripción.
  • El campo repetido deprecatedApiNames tiene una entrada con el nombre de la API de conversiones obsoleta.

2024-03-25 Se agregaron el grupo de canales principal, la fuente de tráfico manual y las dimensiones específicas de la integración.

Se agregaron al esquema de la API de Data las dimensiones específicas del grupo de canales principal, la fuente de tráfico manual y la integración de CM360, DV360 y SA360.

Dimensiones de público:

  • audienceId ID de público. Es el identificador numérico de un público.

Dimensiones del grupo de canales principal:

  • firstUserPrimaryChannelGroup Primer grupo de canales principal del usuario

  • primaryChannelGroup Grupo de canales principal

  • sessionPrimaryChannelGroup Grupo de canales principal de la sesión

Dimensiones de fuente de tráfico manuales:

  • manualCampaignId ID de la campaña manual

  • manualCampaignName Nombre de la campaña manual

  • manualCreativeFormat Formato de creatividad manual

  • manualMarketingTactic Táctica de marketing manual

  • manualMedium Medio manual

  • manualSource Fuente manual

  • manualSourceMedium Fuente o medio manual

  • manualSourcePlatform Plataforma de origen manual

  • firstUserManualCampaignId ID de la primera campaña manual del usuario

  • firstUserManualCampaignName Nombre de la primera campaña manual del usuario

  • firstUserManualCreativeFormat Primer formato de creatividad manual del usuario

  • firstUserManualMarketingTactic Primera táctica de marketing manual del usuario

  • firstUserManualMedium Primer medio manual del usuario

  • firstUserManualSource Primera fuente manual del usuario

  • firstUserManualSourceMedium Primera fuente o medio manual del usuario

  • firstUserManualSourcePlatform Primera plataforma de origen manual del usuario

  • sessionManualCampaignId ID de la campaña manual de la sesión

  • sessionManualCampaignName Nombre de la campaña manual de la sesión

  • sessionManualCreativeFormat Formato de creatividad manual de la sesión

  • sessionManualMarketingTactic Táctica de marketing manual de la sesión

  • sessionManualMedium Medio manual de la sesión

  • sessionManualSource Fuente manual de la sesión

  • sessionManualSourceMedium Fuente / medio manual de la sesión

  • sessionManualSourcePlatform Plataforma de origen manual de la sesión

Dimensiones de integración de Campaign Manager 360 (CM360):

  • cm360AccountId ID de la cuenta de CM360

  • cm360AccountName Nombre de la cuenta de CM360

  • cm360AdvertiserId ID del anunciante de CM360

  • cm360AdvertiserName Nombre del anunciante de CM360

  • cm360CampaignId ID de la campaña de CM360

  • cm360CampaignName Nombre de la campaña de CM360

  • cm360CreativeFormat Formato de creatividad de CM360

  • cm360CreativeId ID de la creatividad de CM360

  • cm360CreativeName Nombre de la creatividad de CM360

  • cm360CreativeType Tipo de creatividad de CM360

  • cm360CreativeTypeId ID del tipo de creatividad de CM360

  • cm360CreativeVersion Versión de la creatividad de CM360

  • cm360Medium Medio de CM360

  • cm360PlacementCostStructure Estructura de costos de la posición de CM360

  • cm360PlacementId ID de posición de CM360

  • cm360PlacementName Nombre de la posición de CM360

  • cm360RenderingId ID de renderización de CM360

  • cm360SiteId ID del sitio de CM360

  • cm360SiteName Nombre del sitio de CM360

  • cm360Source Fuente de CM360

  • cm360SourceMedium Fuente o medio de CM360

  • firstUserCm360AccountId Primer ID de la cuenta de CM360 del usuario

  • firstUserCm360AccountName Primer nombre de la cuenta de CM360 del usuario

  • firstUserCm360AdvertiserId Primer ID del anunciante de CM360 del usuario

  • firstUserCm360AdvertiserName Primer nombre del anunciante de CM360 del usuario

  • firstUserCm360CampaignId Primer ID de la campaña de CM360 del usuario

  • firstUserCm360CampaignName Primer nombre de la campaña de CM360 del usuario

  • firstUserCm360CreativeFormat Primer formato de creatividad de CM360 del usuario

  • firstUserCm360CreativeId Primer ID de la creatividad de CM360 del usuario

  • firstUserCm360CreativeName Primer nombre de la creatividad de CM360 del usuario

  • firstUserCm360CreativeType Primer tipo de creatividad de CM360 del usuario

  • firstUserCm360CreativeTypeId Primer ID del tipo de creatividad de CM360 del usuario

  • firstUserCm360CreativeVersion Primera versión de la creatividad de CM360 del usuario

  • firstUserCm360Medium Primer medio de CM360 del usuario

  • firstUserCm360PlacementCostStructure Primera estructura de costos de la posición de CM360 del usuario

  • firstUserCm360PlacementId Primer ID de la posición de CM360 del usuario

  • firstUserCm360PlacementName Primer nombre de la posición de CM360 del usuario

  • firstUserCm360RenderingId Primer ID de renderización de CM360 del usuario

  • firstUserCm360SiteId Primer ID del sitio de CM360 del usuario

  • firstUserCm360SiteName Primer nombre del sitio de CM360 del usuario

  • firstUserCm360Source Primera fuente de CM360 del usuario

  • firstUserCm360SourceMedium Primera fuente o medio de CM360 del usuario

  • sessionCm360AccountId ID de la cuenta de CM360 de la sesión

  • sessionCm360AccountName Nombre de la cuenta de CM360 de la sesión

  • sessionCm360AdvertiserId ID del anunciante de CM360 de la sesión

  • sessionCm360AdvertiserName Nombre del anunciante de CM360 de la sesión

  • sessionCm360CampaignId ID de la campaña de CM360 de la sesión

  • sessionCm360CampaignName Nombre de la campaña de CM360 de la sesión

  • sessionCm360CreativeFormat Formato de creatividad de CM360 de la sesión

  • sessionCm360CreativeId ID de la creatividad de CM360 de la sesión

  • sessionCm360CreativeName Nombre de la creatividad de CM360 de la sesión

  • sessionCm360CreativeType Tipo de creatividad de CM360 de la sesión

  • sessionCm360CreativeTypeId ID del tipo de creatividad de CM360 de la sesión

  • sessionCm360CreativeVersion Versión de la creatividad de CM360 de la sesión

  • sessionCm360Medium Medio de CM360 de la sesión

  • sessionCm360PlacementCostStructure Estructura de costos de la posición de CM360 de la sesión

  • sessionCm360PlacementId ID de posición de CM360 de la sesión

  • sessionCm360PlacementName Nombre de la posición de CM360 de la sesión

  • sessionCm360RenderingId ID de renderización de CM360 de la sesión

  • sessionCm360SiteId ID del sitio de CM360 de la sesión

  • sessionCm360SiteName Nombre del sitio de CM360 de la sesión

  • sessionCm360Source Fuente de CM360 de la sesión

  • sessionCm360SourceMedium Fuente o medio de CM360 de la sesión

Dimensiones de la integración de Google Display & Video 360 (DV360):

  • dv360AdvertiserId ID del anunciante de DV360

  • dv360AdvertiserName Nombre del anunciante de DV360

  • dv360CampaignId ID de la campaña de DV360

  • dv360CampaignName Nombre de la campaña de DV360

  • dv360CreativeFormat Formato de creatividad de DV360

  • dv360CreativeId ID de la creatividad de DV360

  • dv360CreativeName Nombre de la creatividad de DV360

  • dv360ExchangeId ID del mercado de intercambio de DV360

  • dv360ExchangeName Nombre del mercado de intercambio de DV360

  • dv360InsertionOrderId ID del pedido de inserción de DV360

  • dv360InsertionOrderName Nombre del pedido de inserción de DV360

  • dv360LineItemId ID de línea de pedido de DV360

  • dv360LineItemName Nombre de la línea de pedido de DV360

  • dv360Medium Medio de DV360

  • dv360PartnerId ID de socio de DV360

  • dv360PartnerName Nombre del socio de DV360

  • dv360Source Fuente de DV360

  • dv360SourceMedium Fuente y medio de DV360

  • firstUserDv360AdvertiserId Primer ID del anunciante de DV360 del usuario

  • firstUserDv360AdvertiserName Primer nombre del anunciante de DV360 del usuario

  • firstUserDv360CampaignId Primer ID de la campaña de DV360 del usuario

  • firstUserDv360CampaignName Primer nombre de la campaña de DV360 del usuario

  • firstUserDv360CreativeFormat Primer formato de creatividad de DV360 del usuario

  • firstUserDv360CreativeId ID de la primera creatividad de DV360 del usuario

  • firstUserDv360CreativeName Nombre de la primera creatividad de DV360 del usuario

  • firstUserDv360ExchangeId ID del primer mercado de intercambio de DV360 del usuario

  • firstUserDv360ExchangeName Nombre del primer mercado de intercambio de DV360 del usuario

  • firstUserDv360InsertionOrderId ID del primer pedido de inserción de DV360 del usuario

  • firstUserDv360InsertionOrderName Nombre del primer pedido de inserción de DV360 del usuario

  • firstUserDv360LineItemId ID del primer concepto de DV360 del usuario

  • firstUserDv360LinteItemName Nombre del primer movimiento de DV360 del usuario

  • firstUserDv360Medium Primer medio de DV360 del usuario

  • firstUserDv360PartnerId ID del primer socio de DV360 del usuario

  • firstUserDv360PartnerName Nombre del primer socio de DV360 del usuario

  • firstUserDv360Source Primera fuente de DV360 del usuario

  • firstUserDv360SourceMedium Primera fuente o medio de DV360 del usuario

  • sessionDv360AdvertiserId ID del anunciante de DV360 de la sesión

  • sessionDv360AdvertiserName Nombre del anunciante de DV360 de la sesión

  • sessionDv360CampaignId ID de la campaña de DV360 de la sesión

  • sessionDv360CampaignName Nombre de la campaña de DV360 de la sesión

  • sessionDv360CreativeFormat Formato de creatividad de DV360 de la sesión

  • sessionDv360CreativeId ID de la creatividad de DV360 de la sesión

  • sessionDv360CreativeName Nombre de la creatividad de DV360 de la sesión

  • sessionDv360ExchangeId ID del mercado de intercambio de DV360 de la sesión

  • sessionDv360ExchangeName Nombre del mercado de intercambio de DV360 de la sesión

  • sessionDv360InsertionOrderId ID del pedido de inserción de DV360 de la sesión

  • sessionDv360InsertionOrderName Nombre del pedido de inserción de DV360 de la sesión

  • sessionDv360LineItemId ID de línea de pedido de DV360 de la sesión

  • sessionDv360LineItemName Nombre de la línea de pedido de DV360 de la sesión

  • sessionDv360Medium Medio de DV360 de la sesión

  • sessionDv360PartnerId ID de socio de DV360 de la sesión

  • sessionDv360PartnerName Nombre del socio de DV360 de la sesión

  • sessionDv360Source Fuente de DV360 de la sesión

  • sessionDv360SourceMedium Fuente o medio de DV360 de la sesión

Dimensiones de la integración de Google Search Ads 360 (SA360):

  • firstUserSa360AdGroupId ID del primer grupo de anuncios de SA360 del usuario

  • firstUserSa360AdGroupName Nombre del primer grupo de anuncios de SA360 del usuario

  • firstUserSa360CampaignId ID de la primera campaña de SA360 del usuario

  • firstUserSa360CampaignName Primera campaña de SA360 del usuario

  • firstUserSa360CreativeFormat Primer formato de creatividad de SA360 del usuario

  • firstUserSa360EngineAccountId ID de la primera cuenta de motor de SA360 del usuario

  • firstUserSa360EngineAccountName Nombre de la primera cuenta de motor de SA360 del usuario

  • firstUserSa360EngineAccountType Tipo de la primera cuenta de motor de SA360 del usuario

  • firstUserSa360KeywordText Texto de la primera palabra clave de SA360 del usuario

  • firstUserSa360ManagerAccountId ID de la primera cuenta de administrador de SA360 del usuario

  • firstUserSa360ManagerAccountName Nombre de la primera cuenta de administrador de SA360 del usuario

  • firstUserSa360Medium Primer medio de SA360 del usuario

  • firstUserSa360Query Primera búsqueda de SA360 del usuario

  • firstUserSa360Source Primera fuente de SA360 del usuario

  • firstUserSa360SourceMedium Primera fuente o medio de SA360 del usuario

  • sa360AdGroupId ID del grupo de anuncios de SA360

  • sa360CampaignId ID de la campaña de SA360

  • sa360AdGroupName Nombre del grupo de anuncios de SA360

  • sa360CampaignName Campaña de SA360

  • sa360CreativeFormat Formato de creatividad de SA360

  • sa360EngineAccountId ID de la cuenta de motor de SA360

  • sa360EngineAccountName Nombre de la cuenta de motor de SA360

  • sa360EngineAccountType Tipo de cuenta de motor de SA360

  • sa360KeywordText Texto de palabra clave de SA360

  • sa360ManagerAccountId ID de la cuenta de administrador de SA360

  • sa360ManagerAccountName Nombre de la cuenta de administrador de SA360

  • sa360Medium Medio de SA360

  • sa360Query Consulta de SA360

  • sa360Source Fuente de SA360

  • sa360SourceMedium Fuente y medio de SA360

  • sessionSa360AdGroupId ID del grupo de anuncios de SA360 de la sesión

  • sessionSa360CampaignId ID de la campaña de SA360 de la sesión

  • sessionSa360ManagerAccountId ID de la cuenta de administrador de SA360 de la sesión

  • sessionSa360ManagerAccountName Nombre de la cuenta de administrador de SA360 de la sesión

  • sessionSa360SourceMedium Fuente y medio de SA360 de la sesión

2024-03-06 Se agregó compatibilidad con los públicos de usuarios inactivos en la función Exportación de públicos.

La función de 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. Entre los ejemplos de públicos de usuarios inactivos, se incluyen "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.

2024-02-28 Las exportaciones de público 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, junto con el User-ID, se pueden enviar a Google Analytics en el etiquetado para mejorar la medición. Para obtener más información, consulta Recopilación de datos proporcionados por el usuario.

2024-01-30 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 Data 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 de forma asíncrona notificaciones de webhook cuando una lista de público esté disponible.

18/01/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 búsqueda 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.

2023-12-13 Parámetros personalizados centrados en el artículo

Ahora se pueden incluir dimensiones personalizadas centradas en el artículo 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.

2023-12-05 Las listas de público están disponibles en la versión beta de la API de Data v1 como exportaciones de público

La función Listas de público se renombró como Exportaciones de público y se agregó a la versión beta de la API de Data v1.

Se agregaron los siguientes métodos a la versión beta de la API de Data v1:

2023-11-28 Se agregó samplingMetadatas a la respuesta del informe

Se agregó samplingMetadatas a ResponseMetaData. Esta colección contendrá un objeto SampleMetadata para cada período en la solicitud para el que se muestrearon los resultados. Google Analytics solo aplicará el muestreo cuando prevea que los límites de cardinalidad reducirán la calidad de los datos.

2023-11-28 Se agregó la función de exportación recurrente de listas de público a la versión alfa de la API de Data 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 Data v1.

Esta función te permite generar listas de público a diario 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 del público más recientes.

2023-10-13 Se agregó compatibilidad con los públicos que tienen duraciones de membresía de 1 día

Ahora, la función de exportación de listas de público admite públicos con duraciones de membresía de 1 día.

2023-09-12 Reglas de ordenamiento predeterminado 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 ordenamiento que los otros métodos de informes de la API de Data: el ordenamiento 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

2023-08-15 Se agregó la dimensión isLimitedAdTracking al esquema de exportación de la lista de público

  • isLimitedAdTracking Es el parámetro de configuración de Limitar el seguimiento de anuncios del dispositivo. Los valores posibles son true, false y (not set).

    Para obtener más información, consulta Dimensiones de las listas de público.

2023-08-15 Se agregaron la dimensión currencyCode y la métrica itemDiscountAmount

  • currencyCode Es el código de moneda local (según el estándar ISO 4217) del evento de comercio electrónico. Por ejemplo, “USD” o “GBP”.

  • itemDiscountAmount Es 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 del elemento "discount".

Para obtener más información, consulta el esquema de informes de la API de Data.

2023-08-10 Se agregó la dimensión isAdsPersonalizationAllowed al esquema de exportación de la lista de público

  • isAdsPersonalizationAllowed Indica si se permite la personalización de anuncios. Si un usuario es apto para la personalización de anuncios, isAdsPersonalizationAllowed devuelve true. Si un usuario no es apto para la personalización de anuncios, isAdsPersonalizationAllowed devuelve false.

    Para obtener más información, consulta Dimensiones de las listas de público.

2023-07-10 Listas de público

Se agregó compatibilidad con las listas de público a la versión alfa de la API de Data v1. Las listas de público incluyen una instantánea de los usuarios que componen el público en el momento de la creación de la lista.

Se agregaron los siguientes métodos a la versión alfa de la API de Data v1:

2023-05-19 Grupos de canales personalizados

Se agregó compatibilidad con los grupos de canales personalizados a la API de Data.

2023-05-11 Se modificó la cuota de tokens.

Se actualizó el sistema de cuotas de la API de Data para permitir cargos más precisos.

Se actualizó la cantidad de tokens que se cobran por cada solicitud en función del cambio de cuota y se reequilibró de manera que se permita una mayor cantidad de consultas de informes simples, a la vez que se cobran significativamente más tokens de cuota por los informes de períodos 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 las 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 Nuevo límite
Tokens de Core por propiedad y por día 25,000 200,000
Tokens de Core por propiedad y por hora 5,000 40,000
Tokens de núcleos por proyecto, por propiedad y por hora 1.750 14,000
Tokens en tiempo real por propiedad y por día 25,000 200,000
Tokens por propiedad por hora en tiempo real 5,000 40,000
Tokens en tiempo real por proyecto, por propiedad y por hora 1.750 14,000
Tokens de embudo por propiedad y por día 25,000 200,000
Tokens de embudo por propiedad y por hora 5,000 40,000
Tokens de embudo por proyecto, propiedad y hora 1.750 14,000

Propiedades de Analytics 360

Nombre de la cuota Límite anterior Nuevo límite
Tokens de Core por propiedad y por día 250,000 2,000,000
Tokens de Core por propiedad y por hora 50,000 400,000
Tokens de núcleos por proyecto, por propiedad y por hora 17,500 140,000
Tokens en tiempo real por propiedad y por día 250,000 2,000,000
Tokens por propiedad por hora en tiempo real 50,000 400,000
Tokens en tiempo real por proyecto, por propiedad y por hora 17,500 140,000
Tokens de embudo por propiedad y por día 250,000 2,000,000
Tokens de embudo por propiedad y por hora 50,000 400,000
Tokens de embudo por proyecto, propiedad y hora 17,500 140,000

2023-03-02 Se agregaron dimensiones de fecha.

  • dayOfWeekName Nombre del día de la semana. Día de la semana en inglés. Esta dimensión tiene valores de Sunday, Monday, etcétera.

  • isoWeek semana ISO del año. Número de semana ISO, donde cada semana comienza el lunes. Para obtener más información, consulta https://en.wikipedia.org/wiki/ISO_week_date. Entre los valores de ejemplo, se incluyen 01, 02 y 53.

  • Año ISO isoYear. Es el año ISO del evento. Para obtener más información, consulta https://en.wikipedia.org/wiki/ISO_week_date. Entre los valores de ejemplo, se incluyen 2022 y 2023.

  • isoYearIsoWeek Semana ISO del año ISO. Son los valores combinados de isoWeek y isoYear. Entre los valores de ejemplo, se incluyen 201652 y 201701.

  • yearMonth Año y mes. Son los valores combinados de year y month. Entre los valores de ejemplo, se incluyen 202212 o 202301.

  • yearWeek Semana del año. Son los valores combinados de year y week. Entre los valores de ejemplo, se incluyen 202253 o 202301.

2023-02-27 Se agregaron dimensiones de comercio electrónico.

  • itemListPosition Posició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.

  • itemLocationID Es el ID de ubicación del artículo. Es la ubicación física asociada con el elemento (p.ej., la ubicación de la tienda física). Se recomienda usar el ID de lugar de Google que corresponde 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" del array de artículos.

  • itemPromotionCreativeSlot Es el espacio para la creatividad de promoción del artículo. Es el nombre del espacio para la creatividad de promoción asociado al elemento. Esta dimensión se puede especificar en el etiquetado con el parámetro creative_slot a nivel del evento o del elemento. Si el parámetro se especifica a nivel del evento y del artículo, se usa el parámetro a nivel del artículo.

2023-02-21 Se agregó la dimensión "Página de destino y cadena de consulta".

  • landingPagePlusQueryString Pá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 está obsoleta y se actualizará para que no devuelva una cadena de consulta el 14 de mayo de 2023.

2023-01-28 Se agregaron las métricas "Vistas por usuario" y "Usuarios que se desplazaron".

  • screenPageViewsPerUser Vistas por usuario. Es la cantidad de pantallas de la app o páginas web que vieron tus usuarios por usuario activo. Se registran las vistas repetidas de una página o pantalla individual. (screen_view + page_view events) / active users.

  • scrolledUsers Usuarios que se desplazaron Indica la cantidad de usuarios únicos que se desplazaron hacia abajo por, al menos, el 90% de la página.

2023-01-23 Se agregaron las dimensiones "Continente" y "ID de continente".

  • continent Es el continente. Indica el continente de donde proviene la actividad del usuario. Por ejemplo, Americas o Asia.

  • continentId ID del continente. Es el ID geográfico del continente desde el que se originó la actividad del usuario, derivado de su dirección IP.

2023-01-23 Se agregó la dimensión "ID del filtro de datos de prueba".

  • testDataFilterId 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.

2022-10-18 Se agregaron las métricas de Google Ads.

  • Clics en los anuncios de advertiserAdClicks Es la cantidad total de veces que los usuarios hicieron clic en un anuncio para llegar a la propiedad.
  • advertiserAdCost Costo de los anuncios. Es el importe total que pagó por sus anuncios.
  • advertiserAdCostPerClick Costo 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.
  • advertiserAdCostPerConversion Costo por conversión. El costo por conversión es el costo del anuncio dividido por la cantidad de conversiones.
  • Impresiones de anuncios de advertiserAdImpressions. Es la cantidad total de impresiones.
  • returnOnAdSpend Retorno de la inversión publicitaria. El retorno de la inversión publicitaria (ROAS) son los ingresos totales divididos por el costo de los anuncios del anunciante.

2022-10-17 Se agregaron métricas centradas en el artículo.

  • Se agregaron itemsAddedToCart artículos al carrito. Es la cantidad de unidades que se agregaron al carrito para un solo artículo.
  • itemsCheckedOut artículos pagados. Es la cantidad de unidades pagadas de un solo artículo.
  • itemsClickedInList Artículos en los que se hizo clic incluidos en la lista. Es la cantidad de unidades en las que se hizo clic en la lista para un solo artículo.
  • itemsClickedInPromotion Artículos en los que se hizo clic incluidos en la promoción. Indica la cantidad de unidades en las que se hizo clic en la promoción de un solo artículo.
  • itemsViewed artículos vistos. Es la cantidad de unidades vistas de un solo artículo.
  • itemsViewedInList Artículos vistos incluidos en la lista. Es la cantidad de unidades que se vieron en la lista de un solo artículo.
  • itemsViewedInPromotion Artículos vistos incluidos en la promoción. Indica la cantidad de unidades que se vieron en la promoción de un solo artículo.

2022-09-13 Anuncio de cambios en la compatibilidad del esquema.

El 1 de diciembre de 2022, se producirán los siguientes cambios que generarán interrupciones:

  1. Las dimensiones centradas en el artículo, como itemName, se están volviendo incompatibles con las métricas centradas en el evento, como eventCount. Las dimensiones centradas en el artículo seguirán siendo compatibles con las métricas centradas en el artículo, como itemRevenue, las métricas basadas en el usuario, como activeUsers, y las métricas basadas en la sesión, como sessions.

  2. Las dimensiones de atribución, como source, se están volviendo incompatibles con algunas métricas centradas en el evento, como eventCount. Las dimensiones de atribución seguirán siendo compatibles con las métricas atribuibles, como conversions, las métricas basadas en el usuario, como activeUsers, y las métricas basadas en la sesión, como sessions.

  3. Las dimensiones que incluyen la cadena de consulta, como pagePathPlusQueryString, solo serán compatibles con un conjunto limitado de dimensiones y métricas.

2022-09-01: Se realizaron cambios en las cuotas.

  • Se quitaron las cuotas de Requests per day, Requests Per Minute y Requests Per Minute Per User de la API de Data.

  • Se agregó la cuota de Tokens Per Project Per Property Per Hour a la API.

  • Cada solicitud consume cuota para Tokens Per Property Per Hour y Tokens Per Project Per Property Per Hour.

    Consulta la documentación sobre cuotas para obtener información detallada sobre las cuotas nuevas.

2022-08-03 Se agregaron dimensiones de SA360 con alcance de sesión.

  • sessionSa360AdGroupName 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.

  • sessionSa360CampaignName Campaña de SA360 de la sesión. Es el nombre de la campaña de Search Ads 360 que generó esta sesión.

  • sessionSa360CreativeFormat Formato de creatividad de SA360 de la sesión. Es el tipo de creatividad en Search Ads 360 que generó esta sesión. Por ejemplo, "Anuncio de búsqueda responsivo" o "Anuncio de texto expandido".

  • sessionSa360EngineAccountId ID de la cuenta de motor de SA360 de la sesión. Es el ID de la cuenta de motor de SA360 que generó esta sesión.

  • sessionSa360EngineAccountName Nombre de la cuenta de motor de SA360 de la sesión. Es el nombre de la cuenta de motor en SA360 que generó esta sesión.

  • sessionSa360EngineAccountType Tipo de cuenta de motor de SA360 de la sesión. Es el tipo de cuenta de motor en Search Ads 360 que generó esta sesión. Por ejemplo, "Google Ads", "Bing" o "Baidu".

  • sessionSa360Keyword Es el texto de la 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.

  • sessionSa360Medium Medio 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”.

  • sessionSa360Query Consulta de SA360 de la sesión. Es la búsqueda de Search Ads 360 que generó esta sesión.

  • sessionSa360Source Fuente 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 sessionCampaignId y sessionCampaignName ahora admiten campañas de Search Ads 360.

2022-07-11 Se agregaron métricas del porcentaje de conversiones.

Porcentaje de conversiones

  • sessionConversionRate Es el porcentaje de sesiones en las que se activó cualquier evento de conversión.

  • userConversionRate Es el porcentaje de usuarios que activaron cualquier evento de conversión.

Métricas de porcentaje de conversiones para una conversión

  • sessionConversionRate:event_name Es el porcentaje de sesiones en las que se activó un evento de conversión específico.

  • userConversionRate:event_name Es el porcentaje de usuarios que activaron un evento de conversión específico.

2022-05-05 Se agregó la función de informes de embudo al canal alfa.

  • Se agregó el método runFunnelReport a 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 datos de Google Analytics para enviar tus comentarios sobre esta API.

2022-02-16 Se agregaron dimensiones nuevas.

Términos y contenido manuales

  • firstUserManualAdContent Primer contenido del anuncio manual del usuario. Es el contenido del anuncio con el que se adquirió al usuario por primera vez. Se propaga mediante el parámetro utm_content.

  • firstUserManualTerm Primer término manual del usuario. Es el término con el que se adquirió al usuario por primera vez. Se propaga mediante el parámetro utm_term.

  • manualAdContent Contenido del anuncio manual. Es el contenido del anuncio que se atribuyó al evento de conversión. Se propaga mediante el parámetro utm_content.

  • manualTerm Término manual. Es el término que se atribuyó al evento de conversión. Se propaga mediante el parámetro utm_term.

  • sessionManualAdContent Contenido del anuncio manual de la sesión. Es el contenido del anuncio que generó una sesión. Se propaga mediante el parámetro utm_content.

  • sessionManualTerm Es el término manual de la sesión. Es el término que generó una sesión. Se propaga mediante el parámetro utm_term.

Análisis de fallas

  • crashAffectedUsers Usuarios afectados por fallas. Es la cantidad de usuarios que registraron una falla en esta fila del informe.

  • crashFreeUsersRate Tasa de usuarios que no experimentaron fallas.

App/Web

  • averageSessionDuration Es la duración promedio (en segundos) de las sesiones de los usuarios.

  • newVsReturning Usuarios nuevos o recurrentes

  • screenPageViewsPerSession Vistas por sesión.

  • landingPage Pá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.

  • platformDeviceCategory La plataforma y el tipo de dispositivo en los que se ejecutó tu sitio web o aplicación para dispositivos móviles.

App para dispositivos móviles

  • averagePurchaseRevenuePerUser Promedio de ingresos por compras de cada usuario.

  • firstTimePurchaserConversionRate Es el porcentaje de usuarios activos que hicieron su primera compra.

  • firstTimePurchasersPerNewUser Es la cantidad promedio de compradores de primera vez por usuario nuevo.

  • dauPerMau DAU / MAU. Es el porcentaje continuo de usuarios activos durante los últimos 30 días que también son usuarios activos por un día.

  • dauPerWau DAU / WAU. Es el porcentaje continuo de usuarios activos de 7 días que también son usuarios activos de 1 día.

  • wauPerMau WAU / MAU. Es el porcentaje continuo de usuarios activos durante los últimos 30 días que también son usuarios activos durante los últimos 7 días.

  • purchaserConversionRate Es el porcentaje de usuarios activos que realizaron 1 o más transacciones de compra.

  • transactionsPerPurchaser Transacciones por comprador.

Campaña de Google Ads

  • firstUserGoogleAdsCampaignType Es el tipo de campaña de la campaña de Google Ads que adquirió al usuario por primera vez.

  • googleAdsCampaignType Es el tipo de campaña de la campaña de Google Ads a la que se atribuye el evento de conversión.

  • sessionGoogleAdsCampaignType Es el tipo de campaña de la campaña de Google Ads que generó esta sesión.

2021-09-07 Se agregaron nuevas dimensiones de fecha y hora.

  • dateHourMinute Son los valores combinados de fecha, hora y minutos con el formato AAAAMMDDHHMM.

  • minute Minuto de dos dígitos de la hora en que se registró el evento.

  • nthMinute Es la cantidad de minutos transcurridos desde el inicio del período.

7/9/2021: Se agregaron nuevas dimensiones que se propagan con parámetros de eventos.

  • achievementId Es el ID del logro en un juego para un evento.

  • character Es el personaje de un jugador en un juego para un evento.

  • fileExtension La extensión del archivo descargado.

  • fileName Es la ruta de la página del archivo descargado.

  • groupId Es el ID del grupo de jugadores en un juego para un evento.

  • linkClasses Es el atributo HTML class de un vínculo de salida.

  • linkDomain Es el dominio de destino del vínculo de salida.

  • linkId Es el atributo HTML id de un vínculo de salida o una descarga de archivo.

  • linkText Es el texto del vínculo de la descarga del archivo.

  • linkUrl Es la URL completa de un vínculo de salida o una descarga de archivo.

  • method Es el método por el que se activó un evento.

  • outbound Devuelve "true" si el vínculo lleva a un sitio que no forma parte del dominio de la propiedad.

  • pageLocation El protocolo, el nombre de host, la ruta de la página y la cadena de búsqueda de las páginas web visitadas.

  • pageReferrer Es la URL de referencia completa, incluido el nombre de host y la ruta de acceso.

  • percentScrolled Es el porcentaje de desplazamiento del usuario hacia abajo en la página (por ejemplo, "90").

  • searchTerm Es el término que buscó el usuario.

  • videoProvider Es la fuente del video (por ejemplo, "youtube").

  • videoTitle Es el título del video.

  • videoUrl URL del video

  • visible Devuelve "true" si el contenido es visible.

  • unifiedPagePathScreen Es la ruta de la página (Web) o la clase de pantalla (aplicación) en la que se registró el evento.

2021-09-07: Se realizaron cambios en el esquema de la API.

Cambios en las dimensiones existentes:

  • unifiedPageScreen En 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 las que se registró el evento.

Anuncio de próximos cambios:

  • firstUserTrafficOrigin Es el origen del tráfico que primero adquirió al usuario. No dependas de que este campo devuelva "Manual" para el tráfico que usa UTM. Este campo se actualizará para devolver "(not set)" en lugar de "Manual" en el próximo lanzamiento de una función.

  • sessionTrafficOrigin Es 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. Este campo se actualizará para devolver "(not set)" en lugar de "Manual" en el próximo lanzamiento de una función.

  • trafficOrigin Es 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. Este campo se actualizará para devolver "(not set)" en lugar de "Manual" en el próximo lanzamiento de una función.

2021-09-07 Se agregó el método checkCompatibility a la API.

El método checkCompatibility enumera las dimensiones y métricas que se pueden agregar a una solicitud de informe y mantener la compatibilidad.

2021-07-21: Se realizaron cambios en los informes en tiempo real.

Ahora es posible especificar los rangos de minutos de los datos de eventos que se leerán con el parámetro minuteRanges del método runRealtimeReport.

2021-07-21 Se agregaron nuevas dimensiones de agrupación de canales.

Se agregaron nuevas dimensiones de agrupación de canales al esquema de informes de la API de Data:

  • firstUserDefaultChannelGrouping Es la primera agrupación de canales predeterminada del usuario.

  • defaultChannelGrouping Agrupación de canales predeterminada.

10/06/2021: Se realizaron cambios en el esquema de la API.

  • Se agregó la dimensión minutesAgo al esquema en tiempo real de la API de Data, y se puede usar en las consultas al método runRealtimeReport. Esta dimensión contiene la cantidad de minutos que pasaron desde que se recopiló un evento. El 00 es el minuto actual y el 01 significa el minuto anterior.

  • Se agregó la dimensión googleAdsCreativeId al esquema de la API de Data. Esta dimensión contiene el ID de la creatividad de Google Ads que se atribuyó al evento de conversión.

  • Se agregó la dimensión sessionGoogleAdsCreativeId al esquema de la API de Data. Esta dimensión contiene el ID de la creatividad de Google Ads que generó una sesión en tu sitio web o aplicación.

  • Se cambió el nombre de la dimensión firstUserCreativeId a firstUserGoogleAdsCreativeId en el esquema de la API de Data. Esta dimensión contiene el ID de la creatividad de Google Ads con la que se adquirió al usuario por primera vez.

2021-04-09 Se lanzó la versión beta de la API de Google Analytics Data v1.

  • Se actualizó el extremo de la API a https://analyticsdata.googleapis.com/v1beta.

  • Los métodos runReport, runPivotReport, batchRunReports y batchRunPivotReports ahora aceptan el ID de una propiedad Google Analytics 4 en el parámetro property de la ruta de URL en lugar del campo entity de un cuerpo de solicitud:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • Se actualizaron las bibliotecas cliente de la API para usar el nuevo extremo de la API.

2021-02-19 Se realizaron 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" : -1 que se usaba para indicar un intento de recuperar todas las filas ya no se admite en RunReportRequest.

  • El valor máximo del campo limit se establece en 100000. Usa la paginación para recuperar informes que contengan más de 100,000 filas.

2021-02-08 Se agregaron nuevas dimensiones y métricas de comercio electrónico.

Se agregaron nuevas dimensiones y métricas de comercio electrónico al esquema de la 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.

2021-02-08 Se agregaron nuevas dimensiones de la campaña.

Se agregaron nuevas dimensiones de la campaña al esquema de la API: campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

2021-02-08 Cambios en las dimensiones dayOfWeek y week.

  • El valor de la dimensión dayOfWeek ahora comienza con 0 en lugar de 1.

  • El valor de la dimensión week ahora comienza con 01 y devuelve un número de dos dígitos del 01 al 53. Cada semana comienza el domingo. El 1 de enero siempre se incluye en la semana 01.

2021-01-28 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.

2021-01-28 Se agregaron nuevas dimensiones de fecha y hora.

Se agregaron las siguientes dimensiones nuevas al esquema de la API: hour, nthHour, nthYear, 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 cambiaron los límites de cuota para los tokens de cuota de propiedad por hora y por día.

2020-11-09 Se borró el método getUniversalMetadata.

Se borró el método getUniversalMetadata. Usa getMetadata. Se quitó el rango de fechas 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 Cómo crear un informe en tiempo real para ver ejemplos y runRealtimeReport para obtener 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.

2020-10-13 Las propiedades App + Web cambiaron su nombre a Google Analytics 4 (GA4).

2020-10-08 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 de Universal Analytics.

2020-10-08 Las dimensiones y métricas personalizadas están disponibles en los informes.

Consulta la documentación del esquema de la API para obtener información sobre las dimensiones y métricas personalizadas. Esta actualización incluye métricas y dimensiones personalizadas centradas en el evento, así como dimensiones personalizadas centradas en el usuario.