Para ver los anuncios oficiales de la API de Google Analytics, suscríbete a Grupo de notificaciones de la API de Google Analytics.
28/06/2024 Se agregó “errores de cliente por proyecto y por propiedad” cuota
Ahora hay un límite de 10,000 errores del servidor de la API por proyecto, por
en un período de 15 minutos. Esto incluye todas las solicitudes que generen un
con cualquier código que no sea 500
ni 200
. Ejemplos de errores que caen
por debajo de esta cuota: si se usan
combinaciones de dimensiones y métricas incompatibles,
errores de autenticación.
Si se supera este límite, se realizarán más llamadas de la API a esa propiedad bloqueado temporalmente para el proyecto de Google Cloud asociado hasta los 15 minutos finaliza el período.
14/5/2024 Se agregó la función Comparaciones
Con Comparaciones, puedes puedes evaluar subconjuntos de tus datos en paralelo.
Los métodos principales de informes de la API de datos v1beta se actualizan para admitir la
comparisons
que, cuando se incluye, especifica la configuración de las comparaciones
solicitado.
En una solicitud, puedes especificar una comparación básica si proporcionas el elemento dimensionFilter
expresión de llamada con una solicitud o usar una comparación guardada proporcionando la
el nombre del recurso de comparación
comparison
.
El método getMetadata se actualizó a
enumerar todas las comparaciones guardadas disponibles para una propiedad en la
comparisons
de respuesta de la llamada.
Cuando se especifica al menos una comparación en una solicitud, la respuesta
contener la columna comparison
que identifica cada comparación.
Por el momento, las comparaciones guardadas solo se pueden crear con la API de IU de Analytics.
8/5/2024 Se agregaron las tareas de informes, una función de informes asíncrona, a la API de datos v1alpha.
Con las tareas de informes, puedes iniciar una solicitud asíncrona de larga duración para crear un informe personalizado con los datos de eventos de Google Analytics.
Se agregaron a la API de datos los siguientes métodos de manipulación de tareas de informes v1alpha:
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
6/5/2024 Dimensiones nuevas para eventos clave
Dimensiones y métricas para las claves eventos ya están disponibles.
Modifica tus solicitudes de informes que usen la dimensión isConversionEvent
para
usa la dimensión isKeyEvent
en su lugar.
Modifica las solicitudes de informes que usen una métrica obsoleta en el si quieres usar la Métrica de eventos clave en su lugar.
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 una clave. evento en tus solicitudes de informes.
La respuesta del método properties/getMetadata
refleja la introducción
de las dimensiones y métricas del evento clave en DimensionMetadata
y
MetricMetadata
de la siguiente manera:
apiName
,uiName
ydescription
contienen el nombre de la API del evento clave. el nombre y la descripción de la IU.- El campo repetido
deprecatedApiNames
tiene una entrada con el valor obsoleto. el nombre de la API de conversión.
25/03/2024 Se agregó el grupo de canales principal, la fuente de tráfico manual y de la integración y dimensiones específicas.
Grupo de canales principal, fuente de tráfico manual e integración de CM360, DV360 y SA360 dimensiones específicas agregadas al esquema de la API de datos.
Dimensiones del público:
audienceId
ID de público. Es el identificador numérico de un público.
Dimensiones principales del grupo de canales:
firstUserPrimaryChannelGroup
Primer grupo de canales principal del usuarioprimaryChannelGroup
Grupo de canales principalsessionPrimaryChannelGroup
Grupo de canales principal de la sesión
Dimensiones manuales de la fuente de tráfico:
manualCampaignId
ID de la campaña manualmanualCampaignName
Nombre de la campaña manualmanualCreativeFormat
Formato de creatividad manualmanualMarketingTactic
Táctica de marketing manualmanualMedium
Medio manualmanualSource
Fuente manualmanualSourceMedium
Fuente o medio manualmanualSourcePlatform
Plataforma de origen manualfirstUserManualCampaignId
ID de la primera campaña manual del usuariofirstUserManualCampaignName
Nombre de la primera campaña manual del usuariofirstUserManualCreativeFormat
Primer formato de creatividad manual del usuariofirstUserManualMarketingTactic
Primera táctica de marketing manual del usuariofirstUserManualMedium
Primer medio manual del usuariofirstUserManualSource
Primera fuente manual del usuariofirstUserManualSourceMedium
Primera fuente / primer medio manual del usuariofirstUserManualSourcePlatform
Primera plataforma de origen manual del usuariosessionManualCampaignId
ID de campaña manual de la sesiónsessionManualCampaignName
Nombre de la campaña manual de la sesiónsessionManualCreativeFormat
Formato de creatividad manual de la sesiónsessionManualMarketingTactic
Táctica de marketing manual de la sesiónsessionManualMedium
Medio manual de la sesiónsessionManualSource
Fuente manual de la sesiónsessionManualSourceMedium
Fuente o medio manual de la sesiónsessionManualSourcePlatform
Plataforma de origen manual de la sesión
Dimensiones de integración de Campaign Manager 360 (CM360):
cm360AccountId
ID de la cuenta de CM360cm360AccountName
Nombre de la cuenta de CM360cm360AdvertiserId
ID del anunciante de CM360cm360AdvertiserName
Nombre del anunciante de CM360cm360CampaignId
ID de la campaña de CM360cm360CampaignName
nombre de la campaña de CM360cm360CreativeFormat
formato de creatividad de CM360cm360CreativeId
ID de la creatividad de CM360cm360CreativeName
Nombre de la creatividad de CM360cm360CreativeType
tipo de creatividad de CM360cm360CreativeTypeId
ID del tipo de creatividad de CM360cm360CreativeVersion
versión de la creatividad de CM360cm360Medium
Medio de CM360cm360PlacementCostStructure
Estructura de costos de la posición de CM360cm360PlacementId
ID de posición de CM360cm360PlacementName
nombre de la posición de CM360cm360RenderingId
ID de renderización de CM360cm360SiteId
ID del sitio de CM360cm360SiteName
Nombre del sitio de CM360cm360Source
fuente de CM360cm360SourceMedium
Fuente o medio de CM360firstUserCm360AccountId
Primer ID de la cuenta de CM360 del usuariofirstUserCm360AccountName
Nombre de la primera cuenta de CM360 del usuariofirstUserCm360AdvertiserId
Primer ID del anunciante de CM360 del usuariofirstUserCm360AdvertiserName
Primer nombre del anunciante de CM360 del usuariofirstUserCm360CampaignId
ID de la primera campaña de CM360 del usuariofirstUserCm360CampaignName
Nombre de la primera campaña de CM360 del usuariofirstUserCm360CreativeFormat
Primer formato de creatividad de CM360 del usuariofirstUserCm360CreativeId
Primer ID de la creatividad de CM360 del usuariofirstUserCm360CreativeName
Nombre del primer usuario de la creatividad de CM360firstUserCm360CreativeType
Primer tipo de creatividad de CM360 del usuariofirstUserCm360CreativeTypeId
Primer ID de tipo de creatividad de CM360 del usuariofirstUserCm360CreativeVersion
Primera versión de la creatividad de CM360 del usuariofirstUserCm360Medium
Primer medio de CM360 del usuariofirstUserCm360PlacementCostStructure
Estructura de costos de la posición de CM360 del primer usuariofirstUserCm360PlacementId
Primer ID de posición de CM360 del usuariofirstUserCm360PlacementName
Nombre de la primera posición de CM360 del usuariofirstUserCm360RenderingId
Primer ID de renderización de CM360 del usuariofirstUserCm360SiteId
Primer ID del sitio de CM360 del usuariofirstUserCm360SiteName
Nombre del primer sitio de CM360 del usuariofirstUserCm360Source
Primera fuente de CM360 del usuariofirstUserCm360SourceMedium
Primera fuente o medio de CM360 del usuariosessionCm360AccountId
ID de la cuenta de CM360 de la sesiónsessionCm360AccountName
Nombre de la cuenta de CM360 de la sesiónsessionCm360AdvertiserId
ID del anunciante de CM360 de la sesiónsessionCm360AdvertiserName
Nombre del anunciante de CM360 de la sesiónsessionCm360CampaignId
ID de campaña de CM360 de la sesiónsessionCm360CampaignName
Nombre de la campaña de CM360 de la sesiónsessionCm360CreativeFormat
Formato de creatividad de CM360 de la sesiónsessionCm360CreativeId
ID de la creatividad de CM360 de la sesiónsessionCm360CreativeName
Nombre de la creatividad de CM360 de la sesiónsessionCm360CreativeType
Tipo de creatividad de CM360 de la sesiónsessionCm360CreativeTypeId
ID del tipo de creatividad de CM360 de la sesiónsessionCm360CreativeVersion
Versión de la creatividad de CM360 de la sesiónsessionCm360Medium
Medio de CM360 de la sesiónsessionCm360PlacementCostStructure
Estructura de costos de la posición de CM360 de la sesiónsessionCm360PlacementId
ID de posición de CM360 de la sesiónsessionCm360PlacementName
Nombre de la posición de CM360 de la sesiónsessionCm360RenderingId
ID de renderización de CM360 de la sesiónsessionCm360SiteId
ID del sitio de CM360 de la sesiónsessionCm360SiteName
Nombre del sitio de CM360 de la sesiónsessionCm360Source
Fuente de CM360 de la sesiónsessionCm360SourceMedium
Fuente o medio de CM360 de la sesión
Certificación de Dimensiones de integración de Video 360 (DV360):
dv360AdvertiserId
ID del anunciante de DV360dv360AdvertiserName
Nombre del anunciante de DV360dv360CampaignId
ID de la campaña de DV360dv360CampaignName
Nombre de la campaña de DV360dv360CreativeFormat
formato de creatividad de DV360dv360CreativeId
ID de la creatividad de DV360dv360CreativeName
Nombre de la creatividad de DV360dv360ExchangeId
ID de mercado de intercambio de DV360dv360ExchangeName
Nombre del mercado de intercambio de DV360dv360InsertionOrderId
ID del pedido de inserción de DV360dv360InsertionOrderName
Nombre del pedido de inserción de DV360dv360LineItemId
ID de línea de pedido de DV360dv360LineItemName
Nombre de la línea de pedido de DV360Medio de DV360:
dv360Medium
dv360PartnerId
ID de socio de DV360dv360PartnerName
Nombre del socio de DV360dv360Source
fuente de DV360dv360SourceMedium
Fuente o medio de DV360firstUserDv360AdvertiserId
Primer ID del anunciante de DV360 del usuariofirstUserDv360AdvertiserName
Nombre del primer anunciante de DV360 del usuariofirstUserDv360CampaignId
ID de la primera campaña de DV360 del usuariofirstUserDv360CampaignName
Nombre de la primera campaña de DV360 del usuariofirstUserDv360CreativeFormat
Primer formato de creatividad de DV360 del usuariofirstUserDv360CreativeId
Primer ID de la creatividad de DV360 del usuariofirstUserDv360CreativeName
Nombre del primer usuario de la creatividad de DV360firstUserDv360ExchangeId
ID del primer intercambio de DV360 del usuariofirstUserDv360ExchangeName
Nombre del primer intercambio de DV360 del usuariofirstUserDv360InsertionOrderId
ID del primer pedido de inserción de DV360 del usuariofirstUserDv360InsertionOrderName
Nombre del primer pedido de inserción de DV360 del usuariofirstUserDv360LineItemId
ID de la primera línea de pedido de DV360 del usuariofirstUserDv360LinteItemName
Nombre de la primera línea de pedido de DV360 del usuariofirstUserDv360Medium
Primer medio de DV360 del usuariofirstUserDv360PartnerId
Primer ID de socio de DV360 del usuariofirstUserDv360PartnerName
Nombre del primer socio de DV360 del usuariofirstUserDv360Source
Primera fuente de DV360 del usuariofirstUserDv360SourceMedium
Primera fuente o medio de DV360 del usuariosessionDv360AdvertiserId
ID del anunciante de DV360 de la sesiónsessionDv360AdvertiserName
Nombre del anunciante de DV360 de la sesiónsessionDv360CampaignId
ID de campaña de DV360 de la sesiónsessionDv360CampaignName
Nombre de la campaña de DV360 de la sesiónsessionDv360CreativeFormat
Formato de creatividad de DV360 de la sesiónsessionDv360CreativeId
ID de la creatividad de DV360 de la sesiónsessionDv360CreativeName
Nombre de la creatividad de DV360 de la sesiónsessionDv360ExchangeId
ID de mercado de intercambio de DV360 de la sesiónsessionDv360ExchangeName
Nombre del mercado de intercambio de DV360 de la sesiónsessionDv360InsertionOrderId
ID del pedido de inserción de DV360 de la sesiónsessionDv360InsertionOrderName
Nombre del pedido de inserción de DV360 de la sesiónsessionDv360LineItemId
ID de línea de pedido de DV360 de la sesiónsessionDv360LineItemName
Nombre de la línea de pedido de DV360 de la sesiónsessionDv360Medium
Medio de DV360 de la sesiónsessionDv360PartnerId
ID de socio de DV360 de la sesiónsessionDv360PartnerName
Nombre del socio de DV360 de la sesiónsessionDv360Source
Fuente de DV360 de la sesiónsessionDv360SourceMedium
Fuente o medio de DV360 de la sesión
Dimensiones de integración de Google Search Ads 360 (SA360):
firstUserSa360AdGroupId
ID del primer grupo de anuncios de SA360 del usuariofirstUserSa360AdGroupName
Nombre del primer grupo de anuncios de SA360 del usuariofirstUserSa360CampaignId
ID de la primera campaña de SA360 del usuariofirstUserSa360CampaignName
Primera campaña de SA360 del usuariofirstUserSa360CreativeFormat
Primer formato de creatividad de SA360 del usuariofirstUserSa360EngineAccountId
ID de la primera cuenta de motor de SA360 del usuariofirstUserSa360EngineAccountName
Nombre de la primera cuenta de motor de SA360 del usuariofirstUserSa360EngineAccountType
Primer tipo de cuenta de motor de SA360 del usuariofirstUserSa360KeywordText
Primer texto de palabra clave de SA360 del usuariofirstUserSa360ManagerAccountId
Primer ID de la cuenta de administrador de SA360 del usuariofirstUserSa360ManagerAccountName
Nombre de la primera cuenta de administrador de SA360 del usuariofirstUserSa360Medium
Primer medio de SA360 del usuariofirstUserSa360Query
Primera consulta de SA360 del usuariofirstUserSa360Source
Primera fuente de SA360 del usuariofirstUserSa360SourceMedium
Primera fuente o medio de SA360 del usuariosa360AdGroupId
ID del grupo de anuncios de SA360sa360CampaignId
ID de campaña de SA360sa360AdGroupName
Nombre del grupo de anuncios de SA360sa360CampaignName
campaña de SA360sa360CreativeFormat
Formato de creatividad de SA360sa360EngineAccountId
ID de la cuenta de motor de SA360sa360EngineAccountName
Nombre de la cuenta de motor de SA360sa360EngineAccountType
Tipo de cuenta de motor de SA360sa360KeywordText
Texto de palabra clave de SA360sa360ManagerAccountId
ID de la cuenta de administrador de SA360sa360ManagerAccountName
Nombre de la cuenta de administrador de SA360sa360Medium
Medio de SA360sa360Query
consulta de SA360sa360Source
Fuente de SA360sa360SourceMedium
Fuente o medio de SA360sessionSa360AdGroupId
ID del grupo de anuncios de SA360 de la sesiónsessionSa360CampaignId
ID de campaña de SA360 de la sesiónsessionSa360ManagerAccountId
ID de la cuenta de administrador de SA360 de la sesiónsessionSa360ManagerAccountName
Nombre de la cuenta de administrador de SA360 de la sesiónsessionSa360SourceMedium
Fuente o medio de SA360 de la sesión
6/3/2024 Compatibilidad con los públicos de usuarios inactivos en las exportaciones de públicos.
La función Exportación de públicos es más compatible con 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 su sitio web por siete días. Ejemplos de Entre los públicos de usuarios inactivos, se incluyen “compradores inactivos durante 7 días” y “compradores inactivos por 7 días” usuarios" y “Usuarios sin notificaciones en 7 días”. Para obtener más información sobre las sugerencias públicos, 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 muestran el ID del usuario especificado en el etiquetado, incluso si Los datos proporcionados por el usuario están activados en tu propiedad. Si se trata de datos proporcionados por el usuario la recopilación de imágenes, los datos proporcionados por el usuario y User-ID pueden enviarse 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.
30/01/2024: Compatibilidad con notificaciones de webhook para listas de público y listas de público recurrentes en la versión alfa de la API de datos v1.
AudienceList.webhookNotification
y RecurringAudienceList.webhookNotification
se pueden especificar campos cuando creas una lista de público (con properties.audienceLists.create).
o una lista de público recurrente (mediante properties.recurringAudienceLists.create).
Esta función te permite recibir notificaciones de webhook de forma asíncrona. cuando haya una lista de público disponible.
18/01/2024 Se mejoró la compatibilidad para 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.
Dimensiones como pagePathPlusQueryString
, unifiedPageScreen
y pageLocation
y fullPageUrl
ahora son compatibles con muchos campos adicionales, como
sessionSource
, browser
, city
y landingPage
.
Las dimensiones que incluyen el componente de minutos ahora son compatibles con la mayoría
. Las dimensiones como minute
, nthMinute
y dateHourMinute
ahora son
y son compatibles con un conjunto
similar de campos adicionales.
Consulta el artículo Dimensiones y Explorador de métricas para obtener información completa sobre la compatibilidad.
13/12/2023 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 datos de Analytics 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 la sección Dimensiones y Métricas para obtener más información 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.
El nombre de la función Listas de público cambió a Exportaciones de públicos y agregadas a la versión 1 de la API de datos versión beta.
Se agregaron los siguientes métodos a la versión beta de la API de datos v1:
28/11/2023 Se agregó samplingMetadatas
a la respuesta del informe
Se agregó samplingMetadatas
a
ResponseMetaData
Esta colección
contienen un SampleMetadata
para cada período de la solicitud en el que se hayan
muestreo. Google Analytics
aplicará el muestreo solo cuando prevea que los límites de cardinalidad
reducir la calidad de los datos.
28/11/2023 Se agregó la función de exportación recurrente de listas de público a la API de datos versión 1 alfa
Se agregó properties.recurringAudienceLists.create
,
properties.recurringAudienceLists.create
,
properties.recurringAudienceLists.list
a la API de datos versión 1 alfa.
Esta funcionalidad te permite crear a diario listas de público como las membresías. Las listas de público recurrentes garantizan que estés trabajando con los resultados más recientes de las membresías del público.
8/11/2023 Se agregó la exportación de listas de público a la funcionalidad de Hojas de cálculo para la API de Data v1 alfa
Se agregó properties.audienceLists.exportSheet
de la API de Data v1 alfa, que te permite exportar una lista de público a
Google Sheets.
13/10/2023 Se agregó compatibilidad con públicos con duraciones de membresía de 1 día
Los públicos con duraciones de membresía de 1 día ahora se admiten en el Funcionalidad de exportación de listas de público.
12/09/2023 Reglas de orden predeterminadas de AudienceList
De forma predeterminada, los informes creados con la funcionalidad de exportación de listas de público seguir las mismas reglas de orden que los otros métodos de generación de informes de la API de datos: el orden será descendente por la primera columna y, luego, por la segunda columna, etcétera.
Antes de este cambio, es posible que recibieras el siguiente informe:
deviceId | isAdsPersonalizationAllowed |
---|---|
ABC | verdadero |
DAC | falso |
ABC | falso |
AAA | verdadero |
Luego 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úblicos
isLimitedAdTracking
Es la configuración del límite de seguimiento de anuncios del dispositivo. Valores posibles incluyen:true
,false
y(not set)
.Para obtener más información, consulta el artículo Dimensiones de la lista de público.
15/08/2023 Se agregó la dimensión currencyCode
y la métrica itemDiscountAmount
currencyCode
El código de moneda local (según el estándar ISO 4217) del Evento de comercio electrónico. Por ejemplo, “USD” o "PNG".itemDiscountAmount
Es el valor monetario de los descuentos en artículos en eventos de comercio electrónico. Esta métrica se completa en el etiquetado con el valor de “discount” item.
Si deseas 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
isAdsPersonalizationAllowed
¿Se permite la personalización de anuncios? Si un usuario es apto para la personalización de anunciosisAdsPersonalizationAllowed
muestratrue
. Si un usuario no está apto para la personalización de anuncios,isAdsPersonalizationAllowed
muestrafalse
.Para obtener más información, consulta el artículo Dimensiones de la lista de público.
10/07/2023: Listas de público
Se agregó compatibilidad con las listas de público a la versión 1 de la API de datos. alfa. Las listas de público incluyen un resumen de los usuarios que forman parte del público. en el momento de crear la lista de público.
Se agregaron los siguientes métodos a la API de datos versión 1 alfa:
19/05/2023 Grupos de canales personalizados
Grupos de canales personalizados asistencia agregada a la API de datos.
11/5/2023 Cambios en la cuota de tokens.
El sistema de cuotas de la API de datos se actualizó para permitir una mayor precisión cargos.
Se actualizó la cantidad de tokens cobrados por cada solicitud. de acuerdo con el cambio de cuota y se rebalancea de manera que permita una mayor de informes simples, y se cobra mucho más tokens de cuota para informes de fechas extensas.
Después de este cambio, si bien el cargo de algunas solicitudes seguirá siendo el mismo, habrá un aumento notable en los cargos para consultas más complicadas. Por ejemplo, las solicitudes de más de 6 meses de datos pueden cobrar 1,000 o más. los 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, 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, 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, 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, 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 |
2 de marzo de 2023 Se agregaron las dimensiones de fecha.
dayOfWeekName
Nombre del día de la semana. El día de la semana en inglés. Esta dimensión tiene valores deSunday
,Monday
, etcétera.isoWeek
semana ISO del año. Número de semana ISO, en el que 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 incluyen01
,02
y53
isoYear
año ISO. 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 incluyen2022
y2023
isoYearIsoWeek
semana ISO del año ISO. Los valores combinados deisoWeek
yisoYear
. Entre los valores de ejemplo, se incluyen201652
y201701
yearMonth
anuales por mes. Los valores combinados deyear
ymonth
. Entre los valores de ejemplo, se incluyen202212
o202301
.yearWeek
año por semana. Los valores combinados deyear
yweek
. Entre los valores de ejemplo, se incluyen202253
o202301
.
27/02/2023 Se agregaron dimensiones de comercio electrónico.
Posición de la lista de artículos:
itemListPosition
. 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 "índice" del array de artículos.itemLocationID
: ID de ubicación del artículo. Indica la ubicación física asociada con el artículo (p.ej., la ubicación de la tienda física). Se recomienda usar el Google Place ID 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 atributo 'location_id' del array de artículos.itemPromotionCreativeSlot
Espacio para la creatividad de promoción del artículo. Es el nombre del espacio para la creatividad promocional asociado con el artículo. Esta dimensión se puede especificar en el etiquetado mediante el parámetrocreative_slot
a nivel del evento o del artículo. Si el parámetro se especifica en las propiedades a nivel del artículo, se usa el parámetro a nivel del artículo.
21-02-2023 Se agregó "Página de destino y cadena de búsqueda" dimensión.
landingPagePlusQueryString
Página de destino + cadena de búsqueda Indica 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 no mostrar una cadena de consulta el 14 de mayo de 2023.
28/01/2023 Se agregaron “Vistas por usuario” y “Usuarios desplazados” métricas.
screenPageViewsPerUser
vistas por usuario. Es la cantidad de pantallas de una aplicación o de páginas web que vieron tus usuarios por cada usuario activo. Se registran las vistas repetidas de una página o pantalla individual.(screen_view + page_view events) / active users
.scrolledUsers
Usuarios desplazados. Es la cantidad de usuarios únicos que se desplazaron hacia abajo, al menos, por el 90% de la página.
23-01-2023 Se agregaron "Continent", "ID del continente" dimensiones.
continent
Continente. Indica el continente de donde proviene la actividad del usuario. Por ejemplo,Americas
oAsia
.ID de continente
continentId
. Es el ID geográfico del continente de donde proviene la actividad del usuario, según su dirección IP.
23/1/2023 Se agregó el “ID de filtro de datos de prueba”. dimensión.
testDataFilterId
ID de 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 las métricas de Google Ads.
advertiserAdClicks
Clics en los anuncios. 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 del anuncio dividido por los clics en el anuncio y, a menudo, se abrevia como CPC.advertiserAdCostPerConversion
Costo por conversión. El costo por conversión es el costo de los anuncios dividido por las conversiones.advertiserAdImpressions
impresiones de anuncios. Es la cantidad total de impresiones.returnOnAdSpend
: Retorno de la inversión publicitaria. El retorno de la inversión publicitaria (ROAS) es el total de ingresos dividido por el costo publicitario del anunciante.
17/10/2022 Se agregaron métricas centradas en el artículo.
itemsAddedToCart
artículos se agregaron al carrito. Indica la cantidad de unidades de un solo artículo que se agregaron al carrito.- Se pagaron
itemsCheckedOut
artículos. Indica la cantidad de unidades que se pagaron en un solo artículo. itemsClickedInList
elementos en los que se hizo clic en la lista. Indica la cantidad de unidades en las que se hizo clic en la lista para un solo elemento.- Se hizo clic en
itemsClickedInPromotion
artículos 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
elementos vistos Indica la cantidad de unidades que se vieron para un solo artículo.itemsViewedInList
elementos vistos en la lista Indica la cantidad de unidades de un solo artículo que se vieron en la lista.itemsViewedInPromotion
Artí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-09-2022 Anuncio de cambios en la compatibilidad del esquema.
El 1 de diciembre de 2022, se producirán los siguientes cambios rotundos:
Las dimensiones centradas en el artículo, como
itemName
, son incompatibles con métricas centradas en el evento, comoeventCount
. Las dimensiones centradas en el artículo se mantendrán Es compatible con métricas centradas en el artículo, comoitemRevenue
, y métricas basadas en el usuario. comoactiveUsers
, y métricas basadas en la sesión, comosessions
.Las dimensiones de atribución, como
source
, son cada vez más incompatibles con algunas métricas centradas en el evento, comoeventCount
. Las dimensiones de atribución seguirán compatible con métricas atribuibles, comoconversions
, métricas basadas en usuarios comoactiveUsers
, y métricas basadas en la sesión, comosessions
.Dimensiones que incluyen la cadena de consulta, como
pagePathPlusQueryString
solo serán compatibles con un conjunto limitado de dimensiones y métricas.
Para obtener más información, consulta la explicación detallada sobre los cambios de compatibilidad.
1/9/2022 Cambios en la cuota.
Requests per day
,Requests Per Minute
yRequests Per Minute Per User
se quitan de la API de datos.Se agregó la cuota
Tokens Per Project Per Property Per Hour
a la API.Cada solicitud consume la cuota de
Tokens Per Property Per Hour
yTokens Per Project Per Property Per Hour
Ver la documentación de Cuotas para obtener información detallada sobre las nuevas cuotas.
3 de agosto de 2022 Se agregaron dimensiones de SA360 centradas en la sesión.
sessionSa360AdGroupName
Nombre del grupo de anuncios de SA360 de la sesión. Indica 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 Indica 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
: Es el ID de la cuenta de motor de SA360 de la sesión. Es el ID de la cuenta de motor en SA360 que generó esta sesión.sessionSa360EngineAccountName
Nombre de la cuenta de motor de SA360 de la sesión. Indica 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. Indica el tipo de cuenta de motor en Search Ads 360 que generó esta sesión. Por ejemplo, "google ads", "bing" o "baidu".sessionSa360Keyword
Texto 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.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. Indica la fuente del tráfico de Search Ads 360 que generó esta sesión. Por ejemplo, "example.com". o "google".Las dimensiones
sessionCampaignId
ysessionCampaignName
ahora son compatibles con las campañas de Search Ads 360.
11/07/2022 Se agregaron métricas de 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 algún evento de conversión.
Métricas del 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.
5 de mayo de 2022 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 en la estabilidad alfa con la intención de recopilar comentarios sobre sintaxis y capacidades antes de ingresar a la versión beta. Completa el Comentarios sobre los informes de embudos de la API de datos de Google Analytics para enviar comentarios sobre esta API.
16-02-2022 Se agregaron dimensiones nuevas.
Utilización manual de contenido
firstUserManualAdContent
Primer contenido de anuncio manual del usuario El contenido del anuncio que primero adquirió al usuario. Se propaga mediante el parámetroutm_content
.firstUserManualTerm
Primer término manual del usuario. El término que primero adquirió del usuario. Se propaga mediante el parámetroutm_term
.manualAdContent
Contenido del anuncio manual El contenido del anuncio atribuido al de conversión. Se propaga mediante el parámetroutm_content
.manualTerm
Término manual. Indica el término que se atribuyó al evento de conversión. Se propaga mediante el parámetroutm_term
.sessionManualAdContent
Contenido del anuncio manual de la sesión. El contenido del anuncio que dirigió a una sesión. Se propaga mediante el parámetroutm_content
.sessionManualTerm
Término manual de la sesión. Es el término que generó una sesión. Se propaga mediante el parámetroutm_term
.
Análisis de fallas
crashAffectedUsers
Usuarios afectados por fallas. La cantidad de usuarios que registraron una falla en esta fila del informe.crashFreeUsersRate
Tasa de usuarios que no experimentaron fallas.
Aplicación/Web
averageSessionDuration
La duración promedio (en segundos) de las sesiones.newVsReturning
Usuarios nuevos o recurrentes.screenPageViewsPerSession
vistas por sesión.landingPage
Página de destino. La ruta de la página y la cadena de consulta asociada la primera vista de página en una sesión.platformDeviceCategory
La plataforma y el tipo de dispositivo en los que se se ejecutó el sitio web o la aplicación para dispositivos móviles.
App para dispositivos móviles
averagePurchaseRevenuePerUser
Es el promedio de ingresos de compras por usuario.firstTimePurchaserConversionRate
El porcentaje de usuarios activos que realizaron su primera compra.firstTimePurchasersPerNewUser
La cantidad promedio de compradores nuevos por usuario nuevo.dauPerMau
DAU / MAU. Es el porcentaje continuo de usuarios activos de 30 días que también los usuarios activos durante 1 día.dauPerWau
DAU / WAU. Es el porcentaje continuo de usuarios activos durante 7 días que tienen las siguientes características: también los usuarios activos durante 1 día.wauPerMau
WAU / MAU. Es el porcentaje continuo de usuarios activos de 30 días que usuarios activos durante 7 días.purchaserConversionRate
El porcentaje de usuarios activos que realizaron 1 o más transacciones de compra.transactionsPerPurchaser
Transacciones por comprador.
Campaña de Google Ads
firstUserGoogleAdsCampaignType
El tipo de campaña de Google Ads campaña que primero adquirió al usuario.googleAdsCampaignType
El tipo de campaña de Google Ads se atribuyó al evento de conversión.sessionGoogleAdsCampaignType
El tipo de campaña de Google Ads que condujo a esta sesión.
7 de septiembre de 2021 Se agregaron nuevas dimensiones de fecha y hora.
dateHourMinute
Los valores combinados con formato de fecha, hora y minuto como AAAAMMDDHHMM.minute
El minuto de dos dígitos de la hora en la que se registró el evento.nthMinute
Indica la cantidad de minutos transcurridos desde el inicio del período.
7 de septiembre de 2021 Se agregaron nuevas dimensiones completadas por parámetros de evento.
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
: Es 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 de un juego para un evento.linkClasses
Es el atributo de clase HTML de un vínculo de salida.linkDomain
: Es el dominio de destino del vínculo de salida.linkId
Es el atributo de ID de HTML 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 a través del cual se activó un evento.outbound
Muestra "true" Si el vínculo dirige a un sitio no forma parte del dominio de su propiedad.pageLocation
El protocolo, el nombre de host, la ruta de la página y la cadena de consulta para la Web páginas visitadas.pageReferrer
: Es la URL de referencia completa, incluidos el nombre de host y la ruta de acceso.percentScrolled
: Es el porcentaje hacia abajo en la página que se desplazó el usuario. (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
La URL del video.visible
Muestra "true" si el contenido es visible.unifiedPagePathScreen
La ruta de la página (Web) o la clase de pantalla (aplicación) en la que se registró el evento.
2021-09-07 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 muestra el ruta de la página y cadena de consulta en la que se registró el evento.
Anuncio de próximos cambios:
firstUserTrafficOrigin
El origen del tráfico que primero adquirió al usuario. No dependas de que este campo muestre la palabra "Manual" para el tráfico que utiliza AUA; este campo se actualizará y dejará de mostrar 'Manual' para volver '(no establecido)' para el próximo lanzamiento de una función.sessionTrafficOrigin
El origen del tráfico de la campaña de la sesión. No dependas de que este campo muestre la palabra "Manual" para el tráfico que utiliza AUA; este campo se actualizará y dejará de mostrar 'Manual' para volver '(no establecido)' para el próximo lanzamiento de una función.trafficOrigin
El origen del tráfico de la campaña del evento de conversión. No dependas de que este campo muestre la palabra "Manual" para el tráfico que utiliza AUA; este campo se actualizará y dejará de mostrar 'Manual' para volver '(no establecido)' para el próximo lanzamiento de una función.
2021-09-07 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-07-2021 Cambios en los informes En tiempo real.
Ahora es posible especificar los rangos de minutos de datos de eventos que se leerán
el minuteRanges
parámetro de runRealtimeReport
.
21-07-2021 Dimensiones nuevas de la agrupación de canales.
Se agregaron nuevas dimensiones de agrupación de canales al esquema de informes de la API de datos:
firstUserDefaultChannelGrouping
Primera agrupación de canales predeterminada del usuariodefaultChannelGrouping
Agrupación de canales predeterminada.
Cambios en el esquema de la API 2021-06-10.
Se agrega la dimensión
minutesAgo
al esquema en tiempo real de la API de datos y se puede que se usa en las consultas al métodorunRealtimeReport
. Esta dimensión contiene la cantidad de minutos anteriores a los que se llevó a cabo un evento de los datos recopilados. 00 es el minuto actual y 01 significa el minuto anterior.Se agregó la dimensión
googleAdsCreativeId
al esquema de la API de datos. Esta contiene el ID de la creatividad de Google Ads atribuida al de conversión.Se agregó la dimensión
sessionGoogleAdsCreativeId
al esquema de la API de datos. Esta contiene el ID de la creatividad de Google Ads que genera una sesión en tu sitio web o aplicación.Se cambió el nombre de la dimensión
firstUserCreativeId
afirstUserGoogleAdsCreativeId
en el esquema de la API de datos. Esta dimensión contiene el ID de la cuenta de Google Ads de una creatividad que primero adquirió al usuario.
9/4/2021 Se lanzó la versión beta 1 de la API de datos de Google Analytics.
El extremo de la API se actualizó a
https://analyticsdata.googleapis.com/v1beta
.runReport
,runPivotReport
,batchRunReports
ybatchRunPivotReports
métodos ahora aceptan el ID de una propiedad Google Analytics 4 enproperty
parámetro de la ruta de URL en lugar del campoentity
del cuerpo de la solicitud:POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports
Las bibliotecas cliente de la API se actualizaron para usar el nuevo extremo de la API.
2021-02-19 Cambios en la paginación.
El tamaño predeterminado de las respuestas del informe aumentó de 10 a 10,000 filas de eventos de datos no estructurados.
Valor de
"limit" : -1
que se usó para indicar un intento de recuperar todo ya no se admiten las filas en RunReportRequest.El valor máximo del campo
limit
se 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 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
.
8 de febrero de 2021 Se agregaron nuevas dimensiones de la campaña.
Se agregaron nuevas dimensiones de campaña al esquema de la API:
campaignId
, campaignName
y googleAdsAccountName
googleAdsAdGroupId
, googleAdsAdGroupName
y googleAdsAdNetworkType
,
source
, trafficOrigin
8 de febrero de 2021 dayOfWeek
, week
cambia la dimensión.
El valor de la dimensión
dayOfWeek
ahora comienza con 0. de 1.El valor de la dimensión
week
ahora comienza con 01 y muestra un valor un número del 01 al 53. Cada semana comienza el domingo. El 1 de enero siempre es semanal 1.
28/01/2021 Se agregaron variantes de agregación para 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-01-2021 Se agregaron nuevas dimensiones de fecha y hora.
Se agregaron las siguientes dimensiones nuevas al esquema de la 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. Los límites de cuota para No se modificaron los tokens de cuota de propiedad por hora y por día.
9-11-2020 Se borró el método getUniversalMetadata
.
Se borró el método getUniversalMetadata
. Usa
getMetadata. La cantidad máxima de un año
por solicitud a la API.
2 de noviembre de 2020 Se agregó un método de informes en tiempo real.
Consulta Cómo crear un informe En tiempo real para ver ejemplos y runRealtimeReport del 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 el uso. instrucciones y muestras de código.
13/10/2020 El nombre de las propiedades App + Web cambió a Google Analytics 4 (GA4).
2020-10-08 Se agregó el método getMetadata
a la API.
El método getMetadata devuelve una vista personalizada disponibles para el ID de propiedad GA4 especificado, así como Metadatos universales.
8 de octubre de 2020 Las dimensiones y métricas personalizadas están disponibles en los informes.
Consulta la documentación del esquema de la API para ver la documentación sobre las dimensiones personalizadas. y métricas. Esta actualización incluye métricas y dimensiones personalizadas centradas en el evento, como las siguientes: y Dimensiones personalizadas centradas en el usuario.