Registro de cambios de la API de informes de Google Analytics

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Actualizamos la API de informes de Google Analytics de forma periódica para brindar funciones nuevas y reparar los defectos detectados en versiones anteriores. En la mayoría de los casos, estos cambios serán transparentes para los desarrolladores de API. Sin embargo, ocasionalmente necesitamos realizar cambios que requieren que los desarrolladores modifiquen sus aplicaciones existentes.

En esta página, se documentan los cambios realizados en la API de informes de Google Analytics que podrían afectar tu aplicación. Recomendamos que los desarrolladores de API revisen esta lista de forma periódica para consultar los nuevos anuncios. También puedes suscribirte a los cambios mediante los feeds que se indican en la sección Suscribirse a continuación.

Suscribirse a registros de cambios relacionados

Incluye todas las API de informes, configuración y colección.

Incluye la API de informes principales, la API de informes de embudos multicanales y la API de informes en tiempo real.

Esta es la versión inicial de la API de actividad del usuario

  • La API de actividad del usuario te permite recuperar todos los datos asociados con un único ID de cliente o de usuario en un período determinado. Su objetivo principal es brindar asistencia a los propietarios que desean proporcionarle acceso automático a los datos de un usuario. Visita la Guía de la API de actividad del usuario para obtener más detalles.

En esta versión, el sistema de cuotas basadas en recursos de la versión 4 de la API de informes de Google Analytics está disponible para todos los clientes de Analytics 360 (Premium).

Esta actualización aumenta la cantidad máxima de filas que se muestran en el conjunto de resultados de la API de informes de Analytics versión 4.

La cantidad máxima de filas que se muestran en el objeto Analytics Reporting API v4 ReportData aumenta de 10,000 a 100,000.

Esta versión agrega una vista previa del sistema de cuotas basadas en recursos para la versión 4 de la API de informes de Google Analytics, que permite usar límites de muestreo más altos para los clientes de Analytics 360 (Premium).

En esta versión, se darán de baja la función Productos relacionados y las dimensiones y métricas asociadas. Revise la referencia de Dimensiones y métricas para obtener la lista completa de definiciones. Consulte la Política de Baja de Datos para obtener más detalles sobre la eliminación de datos:

En esta versión, se darán de baja las siguientes dimensiones y métricas:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

Esta actualización agrega una nueva dimensión a la API. Consulte la referencia de Dimensiones y métricas para obtener la lista completa de definiciones. Esta versión también quita varias dimensiones y métricas que dejarán de estar disponibles. Revise la Política de baja de datos para las API de Google Analytics a fin de comprender el proceso completo de eliminación de datos.

Hora

  • Nueva dimensión ga:dateHourMinute, que combina ga:date, ga:hour y ga:minute.

Eliminación de datos

Esta versión quita las siguientes dimensiones y métricas obsoletas:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

Esta actualización actualiza las métricas y dimensiones existentes en la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Métricas del usuario

Se actualizó el cálculo de las métricas Usuarios y Usuarios activos para contar a los usuarios de manera más eficiente. Es posible que vea un pequeño cambio en sus métricas. Si desea obtener más información, consulte Cómo se identifican los usuarios para las métricas de los usuarios.

Métricas de usuarios afectadas por la actualización del cálculo:

  • ga:users: la cantidad total de usuarios durante el período solicitado.
  • ga:1dayusers: Es la cantidad total de usuarios activos de 1 día para cada día del período solicitado.
  • ga:7dayusers: Es la cantidad total de usuarios activos durante 7 días para cada día del período solicitado.
  • ga:14dayusers: Es la cantidad total de usuarios activos durante 14 días para cada día del período solicitado.
  • ga:30dayusers: Es la cantidad total de usuarios activos durante 30 días para cada día del período solicitado.

Eventos únicos

Estamos a punto de finalizar el período de baja de ga:uniqueEvents. Después del 26 de marzo de 2017, se actualizará la definición de ga:uniqueEvents y se quitará de la API la métrica privada ga:uniqueEventsTemporary. Para obtener más información, consulte los documentos de ayuda de Eventos únicos.

Esta versión agrega una nueva dimensión a la API, mejora los mensajes de error y comienza a aplicar los cambios anunciados anteriormente para las dimensiones y métricas de AdSense.

Dimensiones del usuario

  • Dimensión - ga:userBucket: Para un usuario determinado, la dimensión del bucket de usuarios (valores del 1 al 100) indica el bucket al que se asignó el usuario. Para obtener más información, consulte el artículo Cómo probar las campañas de remarketing.

Mensajes de error

Cuando anteriormente la API mostraba un mensaje de error erróneo, Unknown dimension(s): o Unknown metric(s):, cuando solicitaba datos con condiciones que no se cumplían, ahora muestra el siguiente mensaje: Restricted metric(s): ... can only be queried under certain conditions..

Dimensiones y métricas de AdSense

Las vistas que no están vinculadas a AdSense no podrán consultar dimensiones ni métricas de AdSense. Si consulta estas dimensiones y métricas con vistas no vinculadas a AdSense, se producirá un error.

Esta es una versión de corrección de errores que soluciona un problema con las dimensiones y métricas de AdSense, y anuncia un cambio próximo en estas dimensiones y métricas.

Dimensiones y métricas de AdSense

Esta versión soluciona un problema que comenzó el 7 de enero de 2017 en el que las consultas sobre dimensiones y métricas de AdSense mostraban un error de "Métrica desconocida" para vistas que no están vinculadas a AdSense.

Próximos cambios

A partir del 31 de enero de 2017, las vistas no vinculadas a AdSense no podrán consultar dimensiones ni métricas de AdSense. Si consulta estas dimensiones y métricas con vistas no vinculadas a AdSense, se producirá un error.

Esta versión agrega la siguiente métrica nueva a la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Métricas calculadas

Esta versión incluye compatibilidad con métricas calculadas.

  • Métrica: ga:calcMetric_: El valor de la métrica calculada solicitada, en la que hace referencia al nombre definido por el usuario de la métrica calculada. Ten en cuenta que el tipo de datos de ga:calcMetric_ puede ser FLOAT, INTEGER, CURRENCY o TIME. Para obtener más información, consulta Acerca de las métricas calculadas.

Esta actualización agrega una nueva métrica a la API. También da de baja una métrica existente. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Seguimiento de eventos

La definición de ga:uniqueEvents cambiará para reflejar con mayor precisión la cantidad de eventos únicos. Para afectar este cambio, técnicamente se dará de baja la métrica ga:uniqueEvents actual de acuerdo con nuestra política de baja de datos. Si quieres probar la nueva definición, puedes hacer referencia a la métrica privada ga:uniqueEventsTemporary, que calcula con mayor precisión la cantidad de eventos únicos. También presentaremos una nueva métrica, ga:uniqueDimensionCombinations, que mantiene la definición actual de ga:uniqueEvents. Después del período de baja adecuado (aproximadamente 6 meses), se quitará la métrica privada ga:uniqueEventsTemporary y la métrica original ga:uniqueEvents representará correctamente la cantidad de eventos únicos. Para obtener más información, consulte los documentos de ayuda de Eventos únicos.

Eventos únicos

  • Métrica: ga:uniqueEvents: La definición de ga:uniqueEvents cambiará pronto para reflejar con mayor precisión la cantidad de eventos únicos. Usa ga:uniqueDimensionCombinations si quieres conservar la definición existente. Para obtener más información, consulte los documentos de ayuda de Eventos únicos.
  • Métrica: ga:uniqueDimensionCombinations: Las combinaciones de dimensiones únicas cuentan la cantidad de combinaciones de valores de dimensiones únicas para cada dimensión en un informe. Esto le permite crear dimensiones combinadas (concatenadas) luego del procesamiento, lo que hace posible que los informes sean más flexibles sin tener que actualizar su implementación de seguimiento ni usar ranuras de dimensiones personalizadas adicionales. Para obtener más información, consulte los documentos de ayuda de Eventos únicos.

Prueba de transición: privada

  • Métrica ga:uniqueEventsTemporary: Número de eventos únicos. Esta será la definición nueva de ga:uniqueEvents. Puede usar esta métrica para comprender la definición nueva antes del cambio. Tenga en cuenta que esta métrica es privada y no aparecerá en la Referencia de dimensiones y métricas.

Esta versión agrega nuevas dimensiones y métricas a la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

DoubleClick Bid Manager

  • Dimensión - ga:dbmClickAdvertiser: El nombre del anunciante de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickAdvertiserId: ID del anunciante de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickCreativeId: ID de creatividad de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickExchange: Es el nombre de intercambio de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickExchangeId: Es el ID de intercambio de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickInsertionOrder: Es el nombre del pedido de inserción de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickInsertionOrderId: ID de pedido de inserción de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickLineItem: Es el nombre de la línea de pedido de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickLineItemId: Es el ID de línea de pedido de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmClickSite: Es el nombre del sitio de DBM en el que se mostró la creatividad de DBM y se hizo clic en ella para los clics de DBM que coincidieron con la sesión de Google Analytics (solo Analytics 360 requiere integración con DBM).
  • Dimensión - ga:dbmClickSiteId: ID del sitio de DBM en el que se mostró la creatividad de DBM y se hizo clic en ella para los clics de DBM que coincidieron con la sesión de Google Analytics (solo Analytics 360 requiere integración con DBM).
  • Dimensión - ga:dbmLastEventAdvertiser: Es el nombre del anunciante de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventAdvertiserId: ID del anunciante de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventCreativeId: ID de creatividad de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado a la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventExchange: Es el nombre de intercambio de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventExchangeId: ID de intercambio de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventInsertionOrder: Es el nombre del pedido de inserción de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventInsertionOrderId: ID del pedido de inserción de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventLineItem: Es el nombre de la línea de pedido de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión - ga:dbmLastEventLineItemId: ID de la línea de pedido de DBM del último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión: ga:dbmLastEventSite: Nombre del sitio de DBM en el que se mostró la creatividad de DBM y se hizo clic en ella para el último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Dimensión: ga:dbmLastEventSiteId: ID del sitio de DBM en el que se mostró la creatividad de DBM y se hizo clic en ella para el último evento de DBM (impresión o clic en la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo Analytics 360; requiere integración con DBM).
  • Métrica: ga:dbmCPA: eCPA de ingresos de DBM (solo Analytics 360; requiere integración con DBM).
  • Métrica: ga:dbmCPC: eCPC de ingresos de DBM (solo Analytics 360; requiere integración con DBM).
  • Métrica: ga:dbmCPM: eCPM de ingresos de DBM (solo Analytics 360; requiere integración con DBM).
  • Métrica: ga:dbmCTR - CTR de DBM (solo Analytics 360, requiere integración con DBM).
  • Métrica: ga:dbmClicks: clics totales de DBM (solo Analytics 360; requiere integración con DBM).
  • Métrica: ga:dbmConversions: conversiones totales de DBM (solo Analytics 360, requiere integración con DBM).
  • Métrica: ga:dbmCost: costo de DBM (solo en Analytics 360, requiere integración con DBM).
  • Métrica: ga:dbmImpressions: impresiones totales de DBM (solo Analytics 360; requiere integración con DBM).
  • Métrica: ga:dbmROAS - ROAS de DBM (solo Analytics 360, requiere integración con DBM).
  • Dimensión - ga:dsAdGroup: Grupo de anuncios de DS (solo Analytics 360, requiere integración con DS)
  • Dimensión - ga:dsAdGroupId: ID del grupo de anuncios de DS (solo Analytics 360; requiere integración con DS)
  • Dimensión - ga:dsAdvertiser - Anunciante de DS (solo Analytics 360, requiere integración con DS).
  • Dimensión - ga:dsAdvertiserId: ID del anunciante de DS (solo Analytics 360; requiere integración con DS)
  • Dimensión: ga:dsAgency: Agencia DS (solo Analytics 360, requiere integración con DS)
  • Dimensión - ga:dsAgencyId: ID de agencia de DS (solo Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsCampaign: Campaña de DS (solo para Analytics 360; requiere integración con DS)
  • Dimensión - ga:dsCampaignId: ID de campaña de DS (solo Analytics 360, requiere integración con DS)
  • Dimensión - ga:dsEngineAccount: Cuenta de motor de DS (solo Analytics 360, requiere integración con DS).
  • Dimensión - ga:dsEngineAccountId: ID de cuenta de motor de DS (solo Analytics 360, requiere integración con DS)
  • Dimensión: ga:dsKeyword - Palabra clave de DS (solo Analytics 360, requiere integración con DS).
  • Dimensión - ga:dsKeywordId: ID de palabra clave de DS (solo Analytics 360, requiere integración con DS)
  • ga:dsCPC - Costo de DS para el anunciante por clic (solo Analytics 360, requiere integración con DS)
  • ga:dsCTR - Tasa de clics de DS (solo Analytics 360, requiere integración con DS)
  • ga:dsClicks - Clics de DS (solo Analytics 360, requiere integración con DS)
  • ga:dsCost - Costo de DS (solo Analytics 360; requiere integración con DS).
  • ga:dsImpressions - Impresiones de DS (solo Analytics 360, requiere integración con DS)
  • ga:dsProfit - DS Profie (solo Analytics 360, requiere integración con DS)
  • ga:dsReturnOnAdSpend - Retorno de la inversión publicitaria de DS (solo Analytics 360; requiere integración con DS).
  • ga:dsRevenuePerClick - Ingresos por clic de DS (solo Analytics 360, requiere integración con DS)

Esta versión agrega una nueva dimensión a la API. Esta versión también agrega ciertas restricciones a la combinación de dimensiones que se pueden consultar en conjunto. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Red geográfica

  • Dimensión - ga:continentId: Es el ID de continente de los usuarios, que proviene de las direcciones IP o los ID geográficos de los usuarios.

Restricciones

Las siguientes dimensiones en los siguientes grupos no pueden consultarse con dimensiones en los otros grupos:

  • Visitar el grupo de información de Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grupo experimental de GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grupo de interés
    • ga:interestOtherCategory
  • En el grupo de interés en el mercado
    • ga:interestInMarketCategory
  • Grupo de promoción interna:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • Grupo de interés de desarrollo de la marca:
    • ga:interestAffinityCategory

Esta versión introduce límites y cuotas nuevos. Consulta la documentación de Límites y cuotas para obtener más detalles.

Informa errores

Esta versión comienza a aplicar límites en las solicitudes de informes con errores (5XX).

  • 10 solicitudes fallidas por proyecto, por perfil y por hora
  • 50 solicitudes fallidas por proyecto, por perfil y por día

Límites de tabla dinámica

Esta versión comienza a aplicar límites en las solicitudes dinámicas:

  • Una solicitud de informe ahora puede tener un máximo de 2 pivotes.
  • Un pivote puede tener un máximo de 4 dimensiones.
  • Las dimensiones dinámicas forman parte de la restricción respecto de la cantidad total de dimensiones permitidas en la solicitud.
  • Las métricas dinámicas son parte de la restricción de la cantidad total de métricas permitidas en la solicitud.

Esta versión agrega nuevas dimensiones y métricas a la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Red geográfica

  • Dimensión: ga:metroId: Es el código de tres dígitos del área de mercado designada (DMA) desde donde llegó el tráfico, que proviene de las direcciones IP o los ID geográficos de los usuarios.

DoubleClick for Publishers

  • Métrica: ga:dfpImpressions: Se registra una impresión de anuncios de DFP cada vez que se muestra un anuncio individual en el sitio web. Por ejemplo, si una página con dos bloques de anuncios se visualiza una vez, mostraremos dos impresiones (vinculación de DFP habilitada y Ocultar ingresos de DFP no habilitados).
  • Métrica (ga:dfpCoverage): La cobertura es el porcentaje de solicitudes de anuncios que mostraron, al menos, un anuncio. En general, la cobertura puede ayudar a identificar los sitios donde la cuenta de DFP no puede proporcionar anuncios orientados. (Impresiones de anuncios / Solicitudes de anuncios totales) * 100 (Vinculación de DFP habilitada y Ocultar ingresos de DFP no habilitados).
  • Métrica: ga:dfpMonetizedPageviews: Mide la cantidad total de páginas vistas de la propiedad que se mostraron con un anuncio de la cuenta de DFP vinculada. Tenga en cuenta que una sola página puede tener varios bloques de anuncios (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpImpressionsPerSession: La proporción de impresiones de anuncios de DFP en comparación con sesiones de Analytics (impresiones de anuncios y sesiones de Analytics) (vinculación de DFP habilitada y no habilitada para ingresos de DFP).
  • Métrica: ga:dfpViewableImpressionsPercent: El porcentaje de impresiones de anuncios visibles. Una impresión se considera una impresión visible cuando apareció en los navegadores de los usuarios y tiene la oportunidad de verse (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpClicks: Es la cantidad de veces que se hizo clic en los anuncios de DFP en el sitio (la vinculación de DFP estaba habilitada y no se habilitaron los ingresos de DFP).
  • Métrica: ga:dfpCTR: El porcentaje de páginas vistas que generaron un clic en un anuncio de DFP (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpRevenue. Los ingresos de DFP son una estimación de los ingresos totales por anuncios en función de las impresiones publicadas (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:dfpRevenuePer1000Sessions: Es el total de ingresos estimados de los anuncios de DFP por cada 1,000 sesiones de Analytics. Tenga en cuenta que esta métrica se basa en las sesiones del sitio y no en las impresiones de anuncios (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpECPM: el costo efectivo por cada mil páginas vistas. Son los ingresos de DFP por cada 1,000 páginas vistas (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillImpressions: Las impresiones de reabastecimiento son la suma de todas las impresiones de anuncios de AdSense o de Ad Exchange que se publican como reabastecimiento a través de DFP. Se informa una impresión de anuncios cada vez que se muestra un anuncio individual en el sitio web. Por ejemplo, si una página con dos bloques de anuncios se visualiza una vez, mostraremos dos impresiones (vinculación de DFP habilitada y Ocultar ingresos de DFP no habilitados).
  • Métrica: ga:backfillCoverage: La cobertura de reabastecimiento es el porcentaje de solicitudes de anuncios de reabastecimiento que mostraron al menos un anuncio. En general, la cobertura puede ayudar a identificar los sitios donde la cuenta de publicador no puede proporcionar anuncios orientados. (Impresiones de anuncios / Solicitudes de anuncios totales) * 100. Si tanto AdSense como Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es el promedio ponderado de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillMonetizedPageviews: Mide la cantidad total de páginas vistas de la propiedad que se mostraron con, al menos, un anuncio de las cuentas de reabastecimiento vinculadas. Tenga en cuenta que una sola vista de página monetizada puede incluir varias impresiones de anuncios (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica (ga:backfillImpressionsPerSession): Es la proporción entre las impresiones de anuncios de reabastecimiento y las sesiones de Analytics (impresiones de anuncios y sesiones de Analytics). Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillViewableImpressionsPercent: El porcentaje de impresiones de anuncios de reabastecimiento visibles. Una impresión se considera visible cuando apareció en los navegadores de los usuarios y tuvo la oportunidad de ser vista. Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es el promedio ponderado de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillClicks: La cantidad de veces que se hizo clic en los anuncios de reabastecimiento en el sitio. Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillCTR: Es el porcentaje de impresiones de reabastecimiento que generaron un clic en un anuncio. Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es el promedio ponderado de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillRevenue: Es el total de ingresos estimados de los anuncios de reabastecimiento. Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillRevenuePer1000Sessions: Es el total de ingresos estimados de los anuncios de reabastecimiento por cada 1,000 sesiones de Analytics. Tenga en cuenta que esta métrica se basa en las sesiones del sitio y no en las impresiones de anuncios. Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).
  • Métrica: ga:backfillECPM: el costo efectivo por cada mil páginas vistas. Son los ingresos de reabastecimiento de DFP por cada 1,000 páginas vistas. Si AdSense y Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no están habilitadas).

Esta es una versión de corrección de errores que soluciona un problema con los segmentos y el muestreo.

Segmentos

Esta versión soluciona un problema que provocaba que un subconjunto de solicitudes con el segmento Todos los usuarios (gaid::-1) se contara de forma insuficiente en la API de informes principales V3 y se dividiera en dos segmentos en la API de informes de Analytics V4.

Muestreo

En esta versión, se soluciona un problema en el que un subconjunto de solicitudes de tablas personalizadas mostraba datos de muestra.

Esta es una versión de corrección de errores que soluciona un problema que se producía al realizar solicitudes de la cohorte de la API de informes de Analytics V4.

Solicitudes de cohorte

Las solicitudes de cohorte ahora pueden solicitar todas las dimensiones de cohorte; anteriormente, la API mostraba un error cuando solicitaba las dimensiones ga:acquisition....

LTV de solicitud de valor del ciclo de vida del cliente

Tenga en cuenta que las solicitudes de valor del ciclo de vida del cliente pueden generar informes del valor del ciclo de vida del cliente solo para las vistas de la aplicación.

En esta versión, se anuncia una versión nueva de la API, la API de informes de Analytics V4. Esta nueva API es el método programático más avanzado para acceder a los datos de informes en Google Analytics.

Funciones clave

Google Analytics se basa en una potente infraestructura de informes de datos. La API brinda a los desarrolladores acceso a la potencia de la plataforma de Google Analytics. Estas son algunas de las funciones clave de la API de informes de Analytics V4:

  • Expresiones de métricas: La API te permite solicitar no solo las métricas integradas, sino también las expresiones matemáticas. Por ejemplo, la consecución de objetivos por cantidad de sesiones se puede expresar en la solicitud como ga:goal1completions/ga:sessions.
  • Varios períodos: Se admiten dos períodos, lo que le permite comparar datos de dos períodos en una misma solicitud.
  • Cohortes y valor del ciclo de vida del cliente: La API cuenta con un amplio vocabulario para solicitar informes de valores de cohorte y del ciclo de vida del cliente.
  • Varios segmentos: Ahora puede solicitar varios segmentos en una sola solicitud.

Cómo comenzar

Consulta la documentación para desarrolladores a fin de obtener todos los detalles sobre cómo comenzar a usar la API.

Política de cuotas

La API de informes de Analytics V4 incluye sus propias cuotas y límites. Dado que se trata de una API nueva, estos límites y cuotas están sujetos a cambios.

Migración

Junto con una guía de migración, también ponemos a disposición una biblioteca de compatibilidad de Python en Github.

Dimensiones y métricas

Esta versión también agrega un conjunto de dimensiones y métricas específicas para la API de informes de Analytics V4. Consulte el explorador de métricas y dimensiones para ver las definiciones de las listas completas.

  • Dimensión - ga:cohort: Nombre de la cohorte a la que pertenece un usuario según la definición de cohortes. Según cómo se definan las cohortes, un usuario puede pertenecer a varias cohortes, de manera similar a como un usuario puede pertenecer a varios segmentos.

  • Dimensión - ga:cohortNthDay: Desplazamiento basado en 0 en relación con la fecha de definición de la cohorte. Por ejemplo, si una cohorte se define con la primera fecha de visita como 2015-09-01, entonces para la fecha 2015-09-04, ga:cohortNthDay será 3.

  • ga:cohortNthMonth: compensación del mes basada en 0 relativa a la fecha de definición de la cohorte.

  • Dimensión - ga:cohortNthWeek: Desplazamiento basado en 0 en relación con la fecha de definición de la cohorte.

  • Dimensión - ga:acquisitionTrafficChannel: Canal de tráfico mediante el que se adquirió al usuario. Se extrae de la primera sesión del usuario. El canal de tráfico se calcula según las reglas de agrupación de canales predeterminadas (a nivel de la vista, si está disponible) en el momento de la adquisición de usuarios.

  • Dimensión - ga:acquisitionSource: Es la fuente a través de la cual se adquirió el usuario. Derivados de la primera sesión del usuario.

  • Dimensión - ga:acquisitionMedium: Es el medio a través del cual se adquirió al usuario. Derivados de la primera sesión del usuario.

  • Dimensión - ga:acquisitionSourceMedium: Es el valor combinado de ga:userAcquisitionSource y ga:acquisitionMedium.

  • Dimensión: ga:acquisitionCampaign La campaña a través de la cual se adquirió el usuario. Derivados de la primera sesión del usuario.

  • Métrica: ga:cohortActiveUsers: Esta métrica es relevante en el contexto de las dimensiones de desplazamiento basadas en 0 (ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth). Indica la cantidad de usuarios en la cohorte que están activos en el período correspondiente a la cohorte, que es un día, una semana o un mes. Por ejemplo, para ga:cohortNthWeek = 1, la cantidad de usuarios (en la cohorte) que están activos en la segunda semana. Si una solicitud no tiene ninguno de los valores ga:cohortNthDay, ga:cohortNthWeek o ga:cohortNthMonth, esta métrica tendrá el mismo valor que ga:cohortTotalUsers.

  • Métrica: ga:cohortTotalUsers. Cantidad de usuarios que pertenecen a la cohorte, también conocida como tamaño de cohorte.

  • Métrica: ga:cohortAppviewsPerUser: vistas de la app por usuario de una cohorte.

  • Métrica ga:cohortGoalCompletionsPerUser: Consecuciones de objetivos por usuario para una cohorte

  • Métrica: ga:cohortPageviewsPerUser: Páginas vistas por usuario para una cohorte.

  • Métrica: ga:cohortRetentionRate: Tasa de retención de cohorte.

  • Métrica: ga:cohortRevenuePerUser. Ingresos por usuario para una cohorte.

  • Métrica: ga:cohortVisitDurationPerUser: Duración de la sesión por usuario para una cohorte.

  • Métrica (ga:cohortSessionsPerUser): Sesiones por usuario para una cohorte.

  • Métrica ga:cohortTotalUsersWithLifetimeCriteria: Esto es relevante en el contexto de una solicitud que tiene las dimensiones ga:acquisitionTrafficChannel, ga:acquisitionSource, ga:acquisitionMedium o ga:acquisitionCampaign. Representa la cantidad de usuarios en las cohortes que se adquieren a través del canal, la fuente, el medio o la campaña actuales. Por ejemplo, para ga:acquisitionTrafficChannel=Direct, representa el número de usuarios en la cohorte, que se adquirieron directamente. Si no hay ninguna de las dimensiones mencionadas, su valor es igual a ga:cohortTotalUsers.

  • Métrica ga:cohortAppviewsPerUserWithLifetimeCriteria: Vistas de aplicación por usuario para la dimensión de adquisición de una cohorte.

  • Métrica (ga:cohortGoalCompletionsPerUserWithLifetimeCriteria): Consecuciones de objetivo por usuario para la dimensión de adquisición de una cohorte.

  • Métrica (ga:cohortPageviewsPerUserWithLifetimeCriteria): Páginas vistas por usuario en la dimensión de adquisición de una cohorte.

  • Métrica (ga:cohortRevenuePerUserWithLifetimeCriteria): Ingresos por usuario para la dimensión de adquisición de una cohorte.

  • Métrica: ga:cohortSessionsPerUserWithLifetimeCriteria: Duración de la sesión por usuario para la dimensión de adquisición de una cohorte.

Las dimensiones y métricas del Centro de Datos Sociales dejaron de estar disponibles y solo se registrarán en los datos históricos a partir del 30 de abril de 2016. Después de esta fecha, no aparecerán datos nuevos. Conforme a la Política de Baja de Datos, estas dimensiones y métricas se quitarán después del 30 de septiembre de 2016.

Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Actividades sociales

Estas dimensiones y métricas dejaron de estar disponibles y se quitarán después del 30 de septiembre de 2016. Consulte la Política de Baja de Datos para obtener más detalles sobre la eliminación de datos:

  • Dimensión - ga:socialActivityEndorsingUrl: Para una actividad de centro de datos sociales, esta es la URL de la actividad social (p. ej., la URL de publicación de Google+, la URL de comentario del blog, etcétera).
  • Dimensión - ga:socialActivityDisplayName: En el caso de una actividad de centro de datos sociales, este es el título de la actividad social publicada por los usuarios de redes sociales.
  • Dimensión - ga:socialActivityPost: Para una actividad de centro de datos sociales, es el contenido de la actividad social (p.ej., el contenido de un mensaje publicado en Google+) publicado por usuarios de redes sociales.
  • Dimensión - ga:socialActivityTimestamp: En el caso de una actividad de centro de datos sociales, este es el momento en que la actividad social ocurrió en la red social.
  • Dimensión - ga:socialActivityUserHandle: En el caso de una actividad de centro de datos sociales, corresponde al controlador de redes sociales (p.ej., nombre o ID) de los usuarios que iniciaron la actividad social.
  • Dimensión - ga:socialActivityUserPhotoUrl: Para una actividad de centro de datos sociales, esta es la URL de la foto asociada con los perfiles de redes sociales de los usuarios."
  • Dimensión - ga:socialActivityUserProfileUrl: Para una actividad de centro de datos sociales, esta es la URL de los perfiles de redes sociales de los usuarios asociados.
  • Dimensión - ga:socialActivityTagsSummary: Para una actividad de centro de datos sociales, este es un conjunto de etiquetas separadas por comas asociadas a la actividad social.
  • Dimensión - ga:socialActivityAction: Para una actividad de centro de datos sociales, representa el tipo de acción social (p.ej., votar, comentar, hacer +1, etc.) asociada con la actividad.
  • Dimensión - ga:socialActivityNetworkAction: Para una actividad de centro de datos sociales, es el tipo de acción social y la red social donde se originó la actividad.
  • Dimensión - ga:socialActivityContentUrl: Para una actividad de centro de datos sociales, esta es la URL que comparten los usuarios de redes sociales asociados.
  • Métrica: ga:socialActivities: Cantidad total de actividades en las que se compartió o mencionó una URL de contenido en una red de socios de concentrador de datos sociales.

Esta versión agrega una nueva dimensión a la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Plataforma o dispositivo

  • Dimensión ga:browserSize: Es el tamaño de la vista del puerto de los navegadores de los usuarios. El tamaño del navegador es una dimensión con alcance de sesión que captura las dimensiones iniciales del viewport en píxeles y tiene el formato de ancho X de altura. Por ejemplo, 1920 x 960.

Esta versión agrega un parámetro nuevo a la API.

Incluir filas vacías

  • Esta versión agrega el nuevo parámetro opcional include-empty-rows, que cuando se establece como false filas sin datos se omitirá de la respuesta. El valor predeterminado es true, que es un cambio no rotundo y, por lo tanto, no debe requerir una actualización del código. Consulta la documentación de referencia de la API de informes principales para obtener más detalles.

Esta versión agrega métricas nuevas a la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Usuario

  • Métrica: ga:1dayUsers: cantidad total de usuarios activos de 1 día para cada día del período solicitado. Para consultar esta métrica, se debe especificar, al menos, uno de los valores ga:nthDay, ga:date o ga:day. Para la fecha especificada, el valor que se muestre será el total de usuarios únicos para el período de 1 día que finaliza en esa fecha.
  • Métrica: ga:7dayUsers: la cantidad total de usuarios activos durante 7 días para cada día del período solicitado. Para consultar esta métrica, se debe especificar, al menos, uno de los valores ga:nthDay, ga:date o ga:day. Para la fecha dada, el valor mostrado será el total de usuarios únicos para el período de 7 días que finaliza en esa fecha.
  • Métrica: ga:14dayUsers: la cantidad total de usuarios activos durante 14 días para cada día del período solicitado. Para consultar esta métrica, se debe especificar, al menos, uno de los valores ga:nthDay, ga:date o ga:day. Para la fecha dada, el valor mostrado será el total de usuarios únicos para el período de 14 días que finaliza en esa fecha.
  • Métrica: ga:30dayUsers: la cantidad total de usuarios activos durante 30 días para cada día del período solicitado. Para consultar esta métrica, se debe especificar, al menos, uno de los valores ga:nthDay, ga:date o ga:day. Para la fecha dada, el valor mostrado será el total de usuarios únicos para el período de 30 días que finaliza en esa fecha.

Esta versión agrega métricas nuevas a la API. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

DoubleClick Ad Exchange (AdX)

  • Métrica: ga:adxCTR: es el porcentaje de páginas vistas que generaron un clic en un anuncio de AdX.
  • Métrica: ga:adxClicks: la cantidad de veces que los anuncios de AdX hicieron clic en tu sitio.
  • Métrica (ga:adxCoverage): La cobertura es el porcentaje de solicitudes de anuncios que mostraron, al menos, un anuncio. En general, la cobertura puede ayudarlo a identificar sitios en los que su cuenta de AdX no puede proporcionar anuncios orientados. (Impresiones de anuncios / Solicitudes de anuncios totales) * 100
  • Métrica: ga:adxECPM: el costo efectivo por cada mil páginas vistas. Son los ingresos de AdX por cada 1,000 páginas vistas.
  • Métrica: ga:adxImpressions: Se registra una impresión de anuncios de AdX cada vez que se muestra un anuncio individual en tu sitio web. Por ejemplo, si una página con dos bloques de anuncios se visualiza una vez, mostraremos dos impresiones.
  • Métrica (ga:adxImpressionsPerSession): Es la proporción entre las impresiones de anuncios de AdX y las sesiones de Analytics (impresiones de anuncios y sesiones de Analytics).
  • Métrica: ga:adxMonetizedPageviews: Las páginas vistas monetizadas miden la cantidad total de páginas vistas de tu propiedad que se mostraron con un anuncio de tu cuenta de AdX vinculada. Nota: Una sola página puede tener varios bloques de anuncios.
  • Métrica - ga:adxRevenue: es el total de ingresos estimados de los anuncios de AdX.
  • Métrica: ga:adxRevenuePer1000Sessions: Es el total de ingresos estimados de los anuncios de AdX por cada 1,000 sesiones de Analytics. Tenga en cuenta que esta métrica se basa en las sesiones de su sitio y no en las impresiones de anuncios.
  • Métrica: ga:adxViewableImpressionsPercent: El porcentaje de impresiones de anuncios visibles. Una impresión se considera visible cuando apareció en el navegador de un usuario y tuvo la oportunidad de ser vista.

En esta versión, se darán de baja las dimensiones o métricas existentes. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Dimensiones obsoletas

Estas dimensiones dejaron de estar disponibles. Consulte la Política de Baja de Datos para obtener más detalles sobre la eliminación de datos:

  • Dimensión - ga:adSlotPosition: Usa ga:adSlot en su lugar.
  • Dimensión - ga:nextPagePath: Usa ga:pagePath en su lugar.
  • Dimensión - ga:nextContentGroupXX: Usa ga:contentGroupXX en su lugar.

Esta versión agrega una nueva dimensión a la API. Consulte la sección Referencia de dimensiones y métricas para obtener la lista completa de dimensiones y métricas.

AdWords

  • Dimensión - ga:adQueryWordCount: La cantidad de palabras de la búsqueda.

Esta versión agrega nuevas dimensiones a la API. Consulte la sección Referencia de dimensiones y métricas para obtener la lista completa de dimensiones y métricas.

Plataforma o dispositivo

  • Dimensión - ga:dataSource: Es la fuente de datos de un hit. Los hits enviados desde ga.js y analytics.js se registran como "web". Los hits enviados desde los SDK para dispositivos móviles se registran como "aplicación". Estos valores se pueden anular.
  • Dimensión ga:searchAfterDestinationPage: Es la página que el usuario visitó después de realizar una búsqueda interna en su sitio.

En esta versión, se agregan nuevas dimensiones y métricas a la API y se dan de baja dos métricas existentes. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Comercio electrónico

  • Métrica: ga:transactionsPerUser: La cantidad total de transacciones dividida por la cantidad total de usuarios.
  • Métrica: ga:revenuePerUser: Es el total de ingresos de venta proporcionados en la transacción, sin incluir el envío ni los impuestos, dividido por la cantidad total de usuarios.

Usuario

  • Métrica ga:sessionsPerUser: La cantidad total de sesiones dividida por la cantidad total de usuarios.

Red geográfica

  • Dimensión ga:cityId: Los ID de ciudad de los usuarios, según las direcciones IP o los ID geográficos.
  • Dimensión ga:countryIsoCode, el código ISO de país de los usuarios, que deriva de direcciones IP o ID geográficos. Los valores se proporcionan como un código ISO-3166-1 alpha-2.
  • Dimensión - ga:regionId: Es el ID de región de los usuarios, que deriva de direcciones IP o ID geográficos. En EE.UU., una región es un estado, como Nueva York.
  • Dimensión ga:regionIsoCode, el código ISO de región de los usuarios, que deriva de direcciones IP o ID geográficos. Los valores se proporcionan como un código ISO-3166-2.
  • Dimensión ga:subContinentCode: Código de subcontinente de usuarios, derivado de direcciones IP o ID geográficos. Por ejemplo, la Polinesia o el Norte de Europa. Los valores se proporcionan como un código M.49 de las Naciones Unidas.

DoubleClick Campaign Manager

  • Métrica: ga:dcmROAS: retorno de la inversión publicitaria (ROAS) de DCM (solo con recargo).

Métricas obsoletas

Estas métricas dejaron de estar disponibles. Consulte la Política de Baja de Datos para obtener detalles sobre la eliminación de datos: + Métrica - ga:dcmROI - En su lugar, use ga:dcmROAS. + Métrica: ga:dcmMargen. En su lugar, usa ga:dcmROAS.

En esta versión, se agrega una métrica nueva a la API y se dan de baja dos métricas existentes. Consulte la referencia de Dimensiones y métricas para obtener una lista completa de definiciones.

AdWords

  • Métrica: ga:ROAS: el retorno de la inversión publicitaria (ROAS) es el total de ingresos de la transacción y el valor del objetivo dividido por el costo publicitario derivado.

Dimensiones y métricas obsoletas

Estas dimensiones y métricas dejaron de estar disponibles. Consulte la Política de Baja de Datos para obtener detalles sobre la eliminación de datos: + Métrica - ga:ROI - En su lugar, use ga:ROAS. + Métrica: ga:margin. En su lugar, usa ga:ROAS.

Esta versión agrega métricas nuevas a la API. Consulte la referencia de Dimensiones y métricas para obtener una lista completa de definiciones.

AdSense

  • Métrica: ga:adsenseCoverage: El porcentaje de solicitudes de anuncios que mostraron al menos un anuncio.
  • Métrica: ga:adsenseViewableImpressionPercent: El porcentaje de impresiones visibles.

Este lanzamiento incluye una nueva métrica de sesión, una nueva dimensión de fuentes de tráfico y nuevas dimensiones y métricas de DoubleClick Campaign Manager.

Dimensiones y métricas

Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Sesión

  • Métrica: ga:hits: cantidad total de hits enviados a Google Analytics. Esta métrica suma todos los tipos de hits (p.ej., página vista, evento, momento, etcétera).

Fuentes de tráfico

  • Dimensión ga:campaignCode, cuando se utiliza el seguimiento de campaña manual, es el valor del parámetro de seguimiento de la campaña utm_id.

DoubleClick Campaign Manager

  • Dimensión - ga:dcmClickAd: Es el nombre del anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickAdId: Es el ID de anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickAdType: Es el nombre del tipo de anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickAdTypeId: Es el ID de tipo de anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickAdvertiser: Es el nombre del anunciante de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickAdvertiserId: Es el ID de anunciante de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickCampaign: Es el nombre de la campaña de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickCampaignId: ID de la campaña de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo)
  • Dimensión - ga:dcmClickCreative: Es el nombre de la creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickCreativeId: Es el ID de creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickCreativeType: Es el nombre del tipo de creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickCreativeTypeId: Es el ID de tipo de creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickCreativeVersion: Versión de la creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickRenderingId: ID de procesamiento de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickSite: Es el nombre del sitio en el que se mostró la creatividad de DCM y se hizo clic para que coincida con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmClickSiteId: ID del sitio de DCM en el que se mostró la creatividad de DCM y se hizo clic en ella para obtener un clic de DCM que coincida con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickSitePlacement: Es el nombre de la posición en el sitio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickSitePlacementId: Es el ID de posición del sitio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmClickSpotId: Es el ID de configuración de Floodlight de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo con recargo).
  • Dimensión - ga:dcmFloodlightActivity: Es el nombre de la actividad de Floodlight de DCM asociada con la conversión de Floodlight (solo premium).
  • Dimensión - ga:dcmFloodlightActivityAndGroup: Es el nombre de la actividad de Floodlight de DCM y el nombre del grupo asociado con la conversión de Floodlight (solo con recargo).
  • Dimensión - ga:dcmFloodlightActivityGroup: Es el nombre del grupo de actividades de Floodlight de DCM asociado con la conversión de Floodlight (solo con recargo).
  • Dimensión - ga:dcmFloodlightActivityGroupId: ID del grupo de actividades de Floodlight de DCM asociado con la conversión de Floodlight (solo con Premium).
  • Dimensión - ga:dcmFloodlightActivityId: Es el ID de actividad de Floodlight de DCM asociado con la conversión de Floodlight (solo con recargo).
  • Dimensión - ga:dcmFloodlightAdvertiserId: ID del anunciante de Floodlight de DCM asociado con la conversión de Floodlight (solo con recargo).
  • Dimensión - ga:dcmFloodlightSpotId: Es el ID de configuración de Floodlight de DCM asociado con la conversión de Floodlight (solo con recargo).
  • Dimensión: ga:dcmLastEventAd: Es el nombre del anuncio de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventAdId: ID del anuncio de DCM del último evento de DCM (impresión o clic dentro de la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo)
  • Dimensión: ga:dcmLastEventAdType: Es el nombre del tipo de anuncio de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventAdTypeId: ID del tipo de anuncio de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo)
  • Dimensión: ga:dcmLastEventAdvertiser: Es el nombre del anunciante de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventAdvertiserId: ID del anunciante de DCM del último evento de DCM (impresión o clic dentro de la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo)
  • Dimensión - ga:dcmLastEventAttributionType: Hay dos valores posibles (Clickthrough y ViewThrough). Si el último evento de DCM asociado a la sesión de Google Analytics fue un clic, el valor será ClickThrough. Si el último evento de DCM asociado a la sesión de Google Analytics fue una impresión de anuncios, el valor será Viewthrough (solo con recargo).
  • Dimensión: ga:dcmLastEventCampaign: Es el nombre de la campaña de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventCampaignId: ID de la campaña de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo)
  • Dimensión - ga:dcmLastEventCreative: Nombre de la creatividad de DCM del último evento de DCM (impresión o clic dentro de la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo)
  • Dimensión: ga:dcmLastEventCreativeId: ID de creatividad de DCM del último evento de DCM (impresión o clic dentro de la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo)
  • Dimensión - ga:dcmLastEventCreativeType: Nombre del tipo de creatividad de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo)
  • Dimensión - ga:dcmLastEventCreativeTypeId: Es el ID de tipo de creatividad de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventCreativeVersion: Versión de la creatividad de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo)
  • Dimensión: ga:dcmLastEventRenderingId: ID de procesamiento de DCM del último evento de DCM (impresión o clic dentro de la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo)
  • Dimensión: ga:dcmLastEventSite: Es el nombre del sitio en el que se mostró la creatividad de DCM y se hizo clic en ella para el último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventSiteId: ID del sitio de DCM donde se mostró la creatividad de DCM y se hizo clic en ella para el último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventSitePlacement: Es el nombre de la posición de sitio de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo).
  • Dimensión: ga:dcmLastEventSitePlacementId: ID de posición del sitio de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociado con la sesión de Google Analytics (solo con recargo)
  • Dimensión: ga:dcmLastEventSpotId: ID de configuración de Floodlight de DCM del último evento de DCM (impresión o clic en la ventana de visualización de DCM) asociada con la sesión de Google Analytics (solo con recargo)
  • Métrica: ga:dcmFloodlightQuantity: La cantidad de conversiones de Floodlight de DCM (solo con recargo).
  • Métrica: dcmFloodlightRevenue: Ingresos de Floodlight de DCM (solo con recargo).

Este lanzamiento incluye la incorporación de las nuevas dimensiones y métricas de agrupación de contenido.

Dimensiones y métricas

Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Agrupación de contenido

  • Dimensión - ga:landingContentGroupXX: Es el primer grupo de contenido coincidente en la sesión de un usuario.
  • Dimensión - ga:nextContentGroupXX: Hace referencia al grupo de contenido que se visitó después de otro grupo de contenido.
  • Dimensión - ga:contentGroupXX: Grupo de contenido de una propiedad. Un grupo de contenido es una colección de contenido que proporciona una estructura lógica y que se puede determinar mediante el código de seguimiento o la coincidencia de regex del título y la URL de la página, o reglas predefinidas.
  • Dimensión - ga:previousContentGroupXX: Hace referencia al grupo de contenido que se visitó antes de otro grupo de contenido.
  • Métrica: ga:contentGroupUniqueViewsXX: La cantidad de páginas diferentes (únicas) dentro de una sesión para el grupo de contenido especificado. Esto tiene en cuenta tanto pagePath como pageTitle para determinar la unicidad.

Esta versión incluye una nueva condición dateOfSession para Segmentos y se agregaron nuevas dimensiones y métricas de Comercio electrónico mejorado.

Segmentos

Los segmentos ahora admiten una nueva condición dateOfSession que puede restringir un segmento a un grupo de usuarios que inició una sesión dentro de un período determinado. Si desea obtener más detalles, consulte la Guía para desarrolladores de segmentos.

Dimensiones y métricas

Consulte la referencia de Dimensiones y métricas para obtener la lista completa de definiciones de Comercio electrónico mejorado.

Comercio electrónico mejorado

  • Dimensión ga:internalPromotionCreative: Es el contenido creativo diseñado para una promoción.
  • Dimensión - ga:internalPromotionId: Es el ID que utiliza para la promoción.
  • Dimensión - ga:internalPromotionName: Es el nombre de la promoción.
  • Dimensión ga:internalPromotionPosition: Es la posición de la promoción en la página web o en la pantalla de la aplicación.
  • Dimensión - ga:orderCouponCode: Código del cupón a nivel del pedido.
  • Dimensión ga:productBrand: Es el nombre de la marca con la que se vende el producto.
  • Dimensión ga:productCategoryHierarchy: Es la categoría jerárquica en la que se clasifica el producto (Comercio electrónico mejorado).
  • Dimensión: ga:productCategoryLevelXX: Nivel (1-5) en la jerarquía de categoría de producto, comenzando por la parte superior
  • Dimensión - ga:productCouponCode: Código del cupón a nivel del producto.
  • Dimensión - ga:productListName: Es el nombre de la lista de productos en la que aparece.
  • Dimensión - ga:productListPosition: Es la posición del producto en la lista de productos.
  • Dimensión - ga:productVariant: La variación específica de un producto, p.ej., XS, S, M y L para el tamaño o rojo, azul, verde y negro para el color
  • Dimensión - ga:checkoutOptions: opciones de usuario especificadas durante el proceso de confirmación de la compra, p.ej., FedEx, DHL, UPS para envíos o Visa, MasterCard, American Express para opciones de pago. Esta dimensión debe usarse junto con la etapa de Shopping.
  • Dimensión - ga:shoppingStage: Varias etapas de la experiencia de compra que los usuarios completaron en una sesión, p.ej., PRODUCT_VIEW, ADD_TO_CART, CHECKOUT, etc.
  • Métrica: ga:internalPromotionCTR: La tasa en la que los usuarios hicieron clic para ver la promoción interna (cantidad de clics/cantidad de veces que apareció la promoción).
  • Métrica: ga:internalPromotionClicks: La cantidad de clics en una promoción interna.
  • Métrica: ga:internalPromotionViews: La cantidad de vistas de una promoción interna.
  • Métrica: ga:localProductRefundAmount: Importe de reembolso para un producto determinado en la moneda local.
  • Métrica: ga:localRefundAmount: Es el importe total del reembolso de la transacción en la moneda local.
  • Métrica: ga:productAddsToCart: Cantidad de veces que se agregó el producto al carrito de compras.
  • Métrica ga:productCheckouts: Indica la cantidad de veces que se incluyó el producto en el proceso de confirmación de la compra.
  • Métrica: ga:productDetailViews: Cantidad de veces que los usuarios vieron la página de detalles del producto.
  • Métrica: ga:productListClicks: Cantidad de veces que los usuarios hicieron clic en el producto cuando apareció en la lista de productos.
  • Métrica: ga:productListViews: Cantidad de veces que el producto apareció en una lista de productos.
  • Métrica: ga:productListCTR: La tasa en la que los usuarios hicieron clic en el producto en una lista de productos.
  • Métrica: ga:productRefunds: Cantidad de veces que se emitió un reembolso por el producto.
  • Métrica (ga:productRefundAmount): Importe total del reembolso asociado con el producto.
  • Métrica ga:productRemovesFromCart: Indica la cantidad de veces que se quitó el producto de los carritos de compras.
  • Métrica - ga:productRevenuePerPurchase: Ingreso promedio por producto (comúnmente usado con el código del cupón del producto).
  • Métrica (ga:buyToDetailRate): Compras únicas divididas por las vistas de las páginas de detalles del producto.
  • Métrica (ga:cartToDetailRate): Es la cantidad de productos agregados dividida por las vistas de los detalles del producto.
  • Métrica: ga:quantityAddedToCart: Cantidad de unidades de productos agregadas al carrito.
  • Métrica ga:quantityCheckedOut: Número de unidades de productos incluidas en el registro de salida.
  • Métrica: ga:quantityRefunded: Cantidad de unidades de productos reembolsadas.
  • Métrica: ga:quantityRemovedFromCart: Cantidad de unidades de productos quitadas del carrito.
  • Métrica: ga:refundAmount: Es el importe de la moneda reembolsado por una transacción.
  • Métrica: ga:totalRefunds: Cantidad de reembolsos que se emitieron.

Esta actualización incluye una corrección de errores para los nombres de los encabezados de columnas, así como la adición de dimensiones y métricas nuevas.

Dimensiones y métricas

Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Sistema

  • Dimensión - ga:sourcePropertyDisplayName: Es el nombre visible de la propiedad fuente de las propiedades de lista completa. Esto solo es válido para las propiedades de lista completa.
  • Dimensión - ga:sourcePropertyTrackingId: Es el ID de seguimiento de la propiedad fuente de las propiedades de lista completa. Esto solo es válido para las propiedades de lista completa.

Agrupación de canales

  • Dimensión - ga:channelGrouping: Es la agrupación de canales predeterminada que se comparte dentro de la vista (perfil).
  • Dimensión - ga:correlationModelId: ID del modelo de correlación para productos relacionados
  • Dimensión - ga:queryProductId: ID del producto que se consulta.
  • Dimensión - ga:queryProductName: Nombre del producto que se consulta.
  • Dimensión - ga:queryProductVariation: Variación del producto que se consulta.
  • Dimensión - ga:relatedProductId: ID del producto relacionado.
  • Dimensión - ga:relatedProductName: Nombre del producto relacionado.
  • Dimensión - ga:relatedProductVariation: Variación del producto relacionado.
  • Métrica: ga:correlationScore: Puntuación de correlación para productos relacionados.
  • Métrica: ga:queryProductQuantity: Cantidad del producto que se consulta.
  • Métrica - ga:relatedProductQuantity: cantidad del producto relacionado.

Corrección del nombre de la columna de encabezado

  • Se produjo un error en la versión 2014-04- Ahora muestra correctamente la misma dimensión o el mismo nombre de métrica que se usó en la solicitud.

Esta versión incluye la adición y el cambio de nombre de dimensiones y métricas. Consulte la referencia de Dimensiones y métricas para ver la lista completa de definiciones.

Dimensiones y métricas nuevas

Se agregaron las siguientes dimensiones a la API de Core Reporting:

AdWords

  • Dimensión: ga:isTrueViewVideoAd, Yes o No: Indica si el anuncio es un anuncio de video TrueView de AdWords.

Hora

  • Dimensión - ga:nthHour: Índice de cada hora en el período especificado. El índice para la primera hora del primer día (es decir, la fecha de inicio) en el período es 0, 1 para la hora siguiente, y así sucesivamente.

Dimensiones y métricas renombradas

Se cambió el nombre de todas las métricas y dimensiones basadas en visitor y visit para usar user y session respectivamente.

Se cambió el nombre de las siguientes dimensiones y métricas. Consulte la Política de Baja de Datos para obtener detalles sobre el cambio de nombre de los datos:

Público

  • Dimensión - ga:visitorAgeBracket: Usa ga:userAgeBracket en su lugar.
  • Dimensión - ga:visitorGender: Usa ga:userGender en su lugar.

Comercio electrónico

  • Métrica: ga:transactionRevenuePerVisit. Usa ga:transactionRevenuePerSession en su lugar.
  • Métrica: ga:transactionsPerVisit. Usa ga:transactionsPerSession en su lugar.

Seguimiento de eventos

  • Métrica: ga:eventsPerVisitWithEvent. Usa ga:eventsPerSessionWithEvent en su lugar.
  • Métrica: ga:visitsWithEvent. Usa ga:sessionsWithEvent en su lugar.

Conversiones de objetivos

  • Métrica: ga:goalValuePerVisit. Usa ga:goalValuePerSession en su lugar.
  • Métrica: ga:percentVisitsWithSearch. Usa ga:percentSessionsWithSearch en su lugar.
  • Métrica: ga:searchVisits. Usa ga:searchSessions en su lugar.

Seguimiento de página

  • Métrica: ga:pageviewsPerVisit. Usa ga:pageviewsPerSession en su lugar.

Sesión

  • Dimensión - ga:visitLength: Usa ga:sessionDurationBucket en su lugar.
  • Métrica: ga:avgTimeOnSite. Usa ga:avgSessionDuration en su lugar.
  • Métrica: ga:timeOnSite. Usa ga:sessionDuration en su lugar.
  • Métrica: ga:visitBounceRate. Usa ga:bounceRate en su lugar.
  • Métrica: ga:visits. Usa ga:sessions en su lugar.

Interacciones sociales

  • Dimensión - ga:socialInteractionNetworkActionVisit: Usa ga:socialInteractionNetworkActionSession en su lugar.
  • Métrica: ga:socialInteractionsPerVisit. Usa ga:socialInteractionsPerSession en su lugar.

Usuario

  • Dimensión - ga:daysSinceLastVisit: Usa ga:daysSinceLastSession en su lugar.
  • Dimensión - ga:visitCount: Usa ga:sessionCount en su lugar.
  • Dimensión - ga:visitorType: Usa ga:userType en su lugar.
  • Dimensión - ga:visitsToTransaction: Usa ga:sessionsToTransaction en su lugar.
  • Métrica: ga:newVisits. Usa ga:newUsers en su lugar.
  • Métrica: ga:percentNewVisits. Usa ga:percentNewSessions en su lugar.
  • Métrica: ga:visitors. Usa ga:users en su lugar.

Segmentos: API de Core Reporting v2.4 y v3.0

Compatibilidad con nuevos segmentos en la API de Core Reporting.

  • El parámetro segment ahora admite segmentos de usuario y de secuencia. Los segmentos de nivel de usuario y nivel de sesión creados en la interfaz web se pueden consultar con el parámetro segment.
  • Hay una nueva sintaxis disponible para usar con el parámetro segment. Para obtener más información, consulte la Guía para desarrolladores de segmentos.
  • El prefijo dynamic:: dejó de estar disponible. Se recomienda que migres a la sintaxis nueva lo antes posible.

Esta actualización incluye un nuevo formato de respuesta para la tabla de datos, así como la adición y la baja de dimensiones y métricas (consulte la Referencia de dimensiones y métricas para obtener la lista completa de definiciones).

Resultado de la tabla de datos

Para facilitar la representación de los datos de Google Analytics mediante las visualizaciones de los gráficos de Google, la API puede, de manera opcional, mostrar un objeto de tabla de datos en la respuesta.

  • Se agregó un parámetro de búsqueda opcional output a la API. Se puede usar para seleccionar el formato de salida de los datos de Analytics en la respuesta, que es JSON de forma predeterminada. Si se configura como datatable, se incluye una propiedad dataTable que contiene un objeto de tabla de datos en la respuesta. Este objeto se puede usar directamente con Google Charts. Consulta la referencia de la API de Core Reporting para obtener más detalles.

Dimensiones y métricas nuevas

Se agregaron las siguientes dimensiones y métricas a la API de Core Reporting:

Hora

  • Dimensión - ga:minute: Muestra el minuto en la hora. Los valores posibles se encuentran entre 00 y 59.
  • Dimensión - ga:nthMinute: Índice de cada minuto del período especificado. Índice para el primer minuto del primer día (es decir, fecha de inicio) en el período es 0, 1 para el minuto siguiente, y así sucesivamente.

Público

  • Dimensión - ga:visitorAgeBracket: Grupo etario del visitante.
  • Dimensión - ga:visitorGender: Género del visitante.
  • Dimensión - ga:interestAffinityCategory: Indica que es más probable que los usuarios estén interesados en obtener información sobre la categoría especificada.
  • Dimensión - ga:interestInMarketCategory: Indica que es más probable que los usuarios estén listos para comprar productos o servicios en la categoría especificada.
  • Dimensión - ga:interestOtherCategory: Indica que es más probable que los usuarios estén interesados en obtener información sobre la categoría especificada y que estén más listos para comprar.

Dimensiones y métricas permitidas en los segmentos

Estas dimensiones y métricas ahora se pueden usar en segmentos:

  • Dimensión - ga:sourceMedium: Valores combinados de ga:source y ga:medium.
  • Métrica (ga:localItemRevenue): Ingresos del producto en moneda local.

Dimensiones y métricas obsoletas

Estas dimensiones y métricas dejaron de estar disponibles. Consulte la Política de Baja de Datos para obtener más detalles sobre la eliminación de datos:

  • Dimensión - ga:isMobile: Usa ga:deviceCategory en su lugar (p.ej., ga:deviceCategory==mobile).
  • Dimensión - ga:isTablet: Usa ga:deviceCategory en su lugar (p.ej., ga:deviceCategory==tablet).
  • Métrica: ga:entranceBounceRate. Usa ga:visitBounceRate en su lugar.

Esta versión agrega nuevas dimensiones y métricas a la API. Consulte la referencia de Dimensiones y métricas para obtener una lista completa de definiciones.

AdSense

  • Se agregó el acceso a los datos de AdSense:

    • Cumplido - ga:adsenseRevenue: ingresos totales provenientes de anuncios de AdSense.
    • Cumplido - ga:adsenseAdUnitsViewed: Es la cantidad de bloques de anuncios de AdSense vistos. Un bloque de anuncios es un conjunto de anuncios que se muestran como resultado de un fragmento de código de anuncio de AdSense. Detalles: https://support.google.com/adsense/answer/32715.
    • Cumplido - ga:adsenseAdsViewed: Es la cantidad de anuncios de AdSense vistos. Se pueden mostrar varios anuncios en un bloque de anuncios.
    • Cumplido - ga:adsenseAdsClicks: Es la cantidad de veces que los anuncios de AdSense en su sitio recibieron clics.
    • Cumplido - ga:adsensePageImpressions: Es la cantidad de páginas vistas durante las cuales se mostró un anuncio de AdSense. Una impresión de página puede tener varios bloques de anuncios.
    • Cumplido - ga:adsenseCTR - Es el porcentaje de impresiones de página que generaron un clic en un anuncio de AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions).
    • Cumplido - ga:adsenseECPM: costo estimado por cada mil impresiones de página. Son los ingresos de AdSense por cada 1,000 impresiones de páginas. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000).
    • Cumplido - ga:adsenseExits - La cantidad de sesiones que finalizaron cuando un usuario hizo clic en un anuncio de AdSense.

Hora

  • Atenuar ga:isoYear - El año ISO de la visita. Detalles: http://en.wikipedia.org/wiki/ISO_week_date. ga:isoYear solo debe usarse con ga:isoWeek, ya que ga:week representa el calendario gregoriano.
  • Atenuar ga:isoYearIsoWeek - Valores combinados de ga:isoYear y ga:isoWeek

AdWords

Nuevas funciones de control de tamaño de muestra y fechas relativas

Fechas relativas
  • Se agregó compatibilidad con fechas relativas a la API de Core Reporting. today, yesterday y NdaysAgo ahora son valores válidos para los parámetros de búsqueda start-date y end-date.
  • El uso de estos valores determinará automáticamente el período en función de la fecha actual en el momento en que se realiza la consulta y en la zona horaria de la vista (perfil) especificada en la consulta. Consulta la referencia de la API para obtener más detalles.
Nivel de muestreo
  • Se introdujo un parámetro nuevo, samplingLevel, que le permite establecer el nivel de muestreo (es decir, la cantidad de visitas utilizadas para calcular el resultado) para una consulta de informe. Los valores permitidos son: DEFAULT, FASTER y HIGHER_PRECISION.
  • Se agregaron 2 campos nuevos a la respuesta de la API: sampleSize y sampleSpace. Puede usar estos valores para calcular el porcentaje de visitas que se utilizaron para una respuesta de muestra.
  • Consulta la Referencia de la API y el Muestreo para obtener más detalles.

Correcciones de errores

  • Ahora, ga:adwordsCustomerID muestra correctamente el ID de cliente de AdWords de 10 dígitos que corresponde a AccountInfo.customerId de la API de AdWords. Esta corrección permite unir los datos de Analytics con varias cuentas de AdWords.

Como parte del lanzamiento de nuevos segmentos, lanzaremos los siguientes cambios en la API de Core Reporting.

  • El parámetro segment ahora admite el nuevo ID alfanumérico para segmentos avanzados personalizados, que se muestra en la colección de segmentos de la API de administración.
  • Los ID numéricos actuales para los segmentos personalizados ya no están disponibles. Estos ID heredados seguirán siendo compatibles durante 6 meses. Recomendamos que las aplicaciones que guardan ID de segmento de usuarios cambien a los nuevos ID alfanuméricos. Una vez que finalice el período de baja, cualquier consulta con los ID numéricos anteriores mostrará un error.
  • Actualmente, solo se podrán consultar los segmentos de nivel de visita creados en la interfaz web a través del parámetro segment.
  • Los segmentos predeterminados existentes con ID numéricos negativos no se verán afectados. Sin embargo, los nuevos segmentos predeterminados no son compatibles por el momento.

Esta versión agrega nuevas dimensiones y métricas a la API. Consulte la referencia de Dimensiones y métricas para obtener una lista completa de definiciones.

Seguimiento de aplicaciones

  • Estos datos se encuentran en los informes del perfil de aplicación:
    • Atenuar ga:appId: el ID de la aplicación.
    • Atenuado - ga:appInstallerId: ID del instalador (p.ej., Google Play Store) desde donde se descargó la aplicación. De forma predeterminada, el ID del instalador de la app se establece según el método PackageManager#getInstallerPackageName.
    • Atenuación: ga:appName: Es el nombre de la aplicación.
    • Atenuación: ga:appVersion: Es la versión de la aplicación.
    • Atenuación: ga:exitScreenName: Es el nombre de la pantalla cuando el usuario sale de la aplicación.
    • Atenuación: ga:landingScreenName: Es el nombre de la primera pantalla vista.
    • Atenuado: ga:screenDepth: Es la cantidad de visitas a una pantalla por sesión informadas como una string. Puede ser útil para los histogramas.
    • Atenuación (ga:screenName): Es el nombre de la pantalla.
    • Cumplido - ga:avgScreenviewDuration - La cantidad promedio de tiempo que los usuarios pasaron en una pantalla en segundos.
    • Met - ga:timeOnScreen: Es el tiempo que se dedica a ver la pantalla actual.
    • Cumplido - ga:screenviews: es la cantidad total de visitas a una pantalla. Usa esto en lugar de ga:appviews.
    • Cumplido - ga:uniqueScreenviews: Es la cantidad de ga:screenviews diferentes (únicos) de una sesión. Usa esto en lugar de ga:uniqueAppviews.
    • Cumplido - ga:screenviewsPerSession: cantidad promedio de ga:screenviews por sesión. Usa esto en lugar de ga:appviewsPerVisit.

Funciones obsoletas

Las siguientes métricas dejaron de estar disponibles. En su lugar, usa el nuevo nombre de la métrica.

  • Cumplido - ga:appviews - Utiliza ga:screenviews en su lugar.
  • Cumplido - ga:uniqueAppviews - Utiliza ga:uniqueScreenviews en su lugar.
  • Cumplido - ga:appviewsPerVisit - Utiliza ga:screenviewsPerSession en su lugar.

Variables o columnas personalizadas

  • Acceso a dimensiones y métricas personalizadas:

    • Atenuar - ga:dimensionXX - El nombre de la dimensión personalizada solicitada, donde XX hace referencia al número o índice de la dimensión personalizada.
    • Cumplido - ga:metricXX: nombre de la métrica personalizada solicitada, en la que XX hace referencia al número o índice de la métrica personalizada.

Cambios en la documentación

Se cambió el nombre de la siguiente dimensión y métrica de variable personalizada. Este es solo un cambio en la documentación, no será necesario que actualice sus consultas.

  • ga:customVarName(n)ga:customVarNameXX
  • ga:customVarValue(n)ga:customVarValueXX

Comercio electrónico

  • Atenuar ga:currencyCode: Código de moneda local de la transacción basado en la norma ISO 4217.
  • Cumplido - ga:localItemRevenue: Ingresos del producto en la moneda local.
  • Cumplido - ga:localTransactionRevenue: ingresos por transacciones en la moneda local.
  • Cumplido - ga:localTransactionShipping: costo de envío de la transacción en la moneda local
  • Cumplido - ga:localTransactionTax: impuesto sobre las transacciones en la moneda local.

Excepciones

  • Estos datos provienen del seguimiento de excepciones.
    • Atenuar ga:exceptionDescription: la descripción de la excepción
    • Cumplido - ga:exceptionsPerScreenview: cantidad de excepciones generadas dividida por la cantidad de visitas a una pantalla.
    • Cumplido - ga:fatalExceptionsPerScreenview: Es la cantidad de excepciones fatales que se dividen por la cantidad de visitas a una pantalla.

Conversiones de objetivos

  • Atenuación: ga:goalCompletionLocation: Es la ruta de la página o el nombre de pantalla que coincidieron con cualquier logro de objetivo de tipo de destino.
  • Atenuación: ga:goalPreviousStep1: Es la ruta de la página o el nombre de pantalla que coincidieron con cualquier objetivo de tipo de destino, un paso antes de la ubicación de finalización del objetivo.
  • Atenuación: ga:goalPreviousStep2: Es la ruta de la página o el nombre de pantalla que coincidieron con cualquier objetivo de tipo de destino, dos pasos antes de la ubicación de finalización del objetivo.
  • Atenuación: ga:goalPreviousStep3: Es la ruta de la página o el nombre de pantalla que coincidieron con cualquier objetivo de tipo de destino, tres pasos antes de la ubicación de finalización del objetivo.

Cambios en la documentación

Se cambió el nombre de las siguientes dimensiones y métricas de Objetivos. Este es solo un cambio en la documentación, no será necesario que actualice sus consultas.

  • ga:goal(n)AbandonRatega:goalXXAbandonRate
  • ga:goal(n)Abandonsga:goalXXAbandons
  • ga:goal(n)Completionsga:goalXXCompletions
  • ga:goal(n)ConversionRatega:goalXXConversionRate
  • ga:goal(n)Startsga:goalXXStarts
  • ga:goal(n)Valuega:goalXXValue
  • ga:searchGoal(n)ConversionRatega:searchGoalXXConversionRate
  • Cumplido - ga:percentSearchRefinements: Es el porcentaje de veces que se perfecciona (es decir, la transición) entre las palabras clave de búsqueda interna de una sesión.

Seguimiento de página

  • Cumplido - ga:pageValue: es el valor promedio de esta página o de un conjunto de páginas. El valor de la página es ((ingresos de transacciones + valor total del objetivo) dividido por las páginas vistas únicas para la página o el conjunto de páginas.

Plataforma o dispositivo

  • Estos datos se obtienen de la string de usuario-agente HTTP.

    • Atenuar ga:deviceCategory: El tipo de dispositivo: computadora de escritorio, tablet o dispositivo móvil.
    • Atenuar - ga:isTablet: indica las visitas a tablets. Los valores posibles son Yes o No.
    • Atenuación: ga:mobileDeviceMarketingName: nombre de marketing utilizado para el dispositivo móvil.

Interacciones sociales

  • Estos datos provienen del seguimiento de interacciones sociales en el sitio.

    • Atenuación: ga:socialEngagementType. Tipo de participación. Los valores posibles son Socially Engaged o Not Socially Engaged.

Hora

  • Atenuar ga:dateHour - Valores combinados de ga:date y ga:hour
  • Atenuar ga:dayOfWeekName - El nombre del día de la semana (en inglés)
  • Atenuar ga:isoWeek - El número de semana ISO, donde cada semana comienza con un lunes. Detalles: http://en.wikipedia.org/wiki/ISO_week_date.
  • Atenuar ga:yearMonth - Valores combinados de ga:year y ga:month
  • Atenuar ga:yearWeek - Valores combinados de ga:year y ga:week

Fuentes de tráfico

  • Atenuación: ga:fullReferrer: Es la URL de referencia completa, incluidos el nombre de host y la ruta de acceso.
  • Atenuar ga:sourceMedium: los valores combinados de ga:source y ga:medium
  • En esta versión, se agregaron 5 métricas nuevas de velocidad del sitio:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • Esta versión agrega un nuevo segmento predeterminado para el Tráfico de tablets, gaid::-13.

Esta versión agrega nuevas dimensiones y métricas a la API. Consulte la referencia de Dimensiones y métricas para ver las definiciones.

Seguimiento de aplicaciones

  • Estos datos se encuentran en los informes del SDK de seguimiento de aplicaciones para dispositivos móviles:
    • Cumplido - ga:uniqueAppviews: cantidad de vistas de la aplicación por sesión.
    • Cumplido - 'ga:appviews: la cantidad total de vistas de la app.
    • Cumplido - ga:appviewsPerVisit: cantidad promedio de vistas de la aplicación por sesión.

Fuentes de tráfico

  • Atenuación: ga:socialNetwork: Es una string que representa el nombre de la red social. Esto puede estar relacionado con la red social de referencia para las fuentes de tráfico o con la red social para las actividades de centro de datos sociales. Por ejemplo, Google+, Blogger, reddit, etc.
  • Atenuar - ga:hasSocialSourceReferral: indica las visitas que llegaron al sitio desde una fuente social (es decir, una red social como Google+, Facebook, Twitter, etc.). Los valores posibles son "Sí" o "No", y la primera letra debe escribirse con mayúscula.

Actividades sociales

  • Estos datos provienen de la actividad externa importada de socios de Social Data Hub.
    • Atenuado: ga:socialActivityDisplayName: para una actividad de centro de datos sociales, esta string representa el título de la actividad social publicada por el usuario de la red social.
    • Atenuado: ga:socialActivityEndorsingUrl: para una actividad de centro de datos sociales, esta string representa la URL de la actividad social (p.ej., la URL de publicación de Google+, la URL de comentario del blog, etc.)
    • Atenuar - ga:socialActivityPost - Para una actividad de centro de datos sociales, esta cadena representa el contenido de la actividad social publicada por el usuario de la red social (p.ej., el contenido del mensaje de una publicación de Google+)
    • Atenuado: ga:socialActivityTimestamp: para una actividad de centro de datos sociales, esta string representa cuándo ocurrió la actividad social en la red social.
    • Atenuado: ga:socialActivityUserPhotoUrl: para una actividad de centro de datos sociales, esta string representa la URL de la foto asociada con el perfil de red social del usuario.
    • Atenuado: ga:socialActivityUserProfileUrl: para una actividad de centro de datos sociales, esta string representa la URL del perfil de red social del usuario asociado.
    • Atenuado: ga:socialActivityContentUrl: para una actividad de centro de datos sociales, esta string representa la URL que comparte el usuario de la red social asociada.
    • Atenuar - ga:socialActivityTagsSummary - Para una actividad de centro de datos sociales, es un conjunto de etiquetas separadas por comas asociadas a la actividad social.
    • Atenuado: ga:socialActivityUserHandle: para una actividad de centro de datos sociales, esta string representa el controlador de la red social (es decir, el nombre) del usuario que inició la actividad social.
    • Atenuar ga:socialActivityAction: para una actividad de centro de datos sociales, esta string representa el tipo de acción social asociada con la actividad (p.ej., voto, comentario, +1, etc.).
    • Atenuado: ga:socialActivityNetworkAction: para una actividad de centro de datos sociales, esta string representa el tipo de acción social y la red social en la que se originó la actividad.
    • Cumplido - ga:socialActivities: recuento de actividades en las que se compartió o mencionó una URL de contenido en una red de socios de concentrador de datos sociales

Interacciones sociales

  • Estos datos provienen del seguimiento de interacciones sociales en el sitio.
    • Atenuar - ga:socialInteractionAction - En el caso de las interacciones sociales, es una string que representa la acción social de la que se realiza un seguimiento (p. ej., +1, me gusta, favoritos).
    • Atenuado: ga:socialInteractionNetwork: para las interacciones sociales, una string que representa la red social a la que se le realiza el seguimiento (p.ej., Google, Facebook, Twitter, LinkedIn)
    • Atenuar ga:socialInteractionNetworkAction: para interacciones sociales, una string que representa la concatenación de ga:socialInteractionNetwork y ga:socialInteractionAction de las que se está realizando un seguimiento (p.ej., Google: +1, Facebook: me gusta)
    • Atenuar ga:socialInteractionTarget: para interacciones sociales, es una string que representa la URL (o recurso) que recibe la acción de red social.
    • Cumplido - ga:socialInteractions - Es la cantidad total de interacciones sociales en tu sitio.
    • Cumplido - ga:uniqueSocialInteractions: es la cantidad total de interacciones sociales únicas en su sitio. Según el par de valores ga:socialInteractionNetwork y ga:socialInteractionAction
    • Reunión: ga:socialInteractionsPerVisit-ga:socialInteractions/ga:uniqueSocialInteractions Es la cantidad promedio de interacciones sociales por visita a su sitio.

Ubicación geográfica o red

  • Atenuado: ga:metro: el área de mercado designada (DMA) de donde proviene el tráfico.

Seguimiento de página

  • Atenuar ga:pagePathLevel1: Esta dimensión incluye una lista completa de pagePaths en el primer nivel jerárquico de pagePath.
  • Atenuar ga:pagePathLevel2: Esta dimensión incluye una lista completa de pagePaths en el segundo nivel jerárquico de pagePath.
  • Atenuado: ga:pagePathLevel3: Esta dimensión incluye una lista completa de pagePaths en el tercer nivel jerárquico de pagePath.
  • Atenuar ga:pagePathLevel4: Esta dimensión incluye una lista completa de pagePaths en el cuarto nivel jerárquico de pagePath. Todos los niveles adicionales en la jerarquía pagePath también se incluyen en esta dimensión.

Seguimiento de excepciones

  • Estos datos provienen de datos de seguimiento de excepciones.

    • Cumplido - ga:exceptions - La cantidad de excepciones que se enviaron a Google Analytics.
    • Cumplido - ga:fatalExceptions: la cantidad de excepciones en las que isFatal se establece como verdadera.

Tiempos de usuario

  • Estos datos provienen de los datos de sincronización de los usuarios.

    • Atenuar ga:userTimingCategory: string para categorizar todas las variables de tiempo del usuario en grupos lógicos a fin de facilitar la generación de informes.
    • Atenuación: ga:userTimingLabel: Es una string para indicar el nombre de la acción del recurso al que se le realiza un seguimiento.
    • Atenuar ga:userTimingVariable: String que se puede usar para agregar flexibilidad en la visualización de los tiempos del usuario en los informes.
    • Atenuado: ga:userTimingValue es la cantidad de milisegundos transcurridos desde el envío a Google Analytics.
    • Cumplido - ga:userTimingSample: Es la cantidad de muestras que se enviaron.
    • Cumplido - ga:avgUserTimingValue: Es el valor de sincronización promedio del usuario. ga:userTimiingValue/ga:userTimiingSample

Dispositivo / plataforma

  • Estos datos provienen del usuario-agente de los datos recopilados.
    • Atenuado: ga:mobileDeviceBranding. Indica el fabricante del dispositivo móvil o el nombre de la marca (por ejemplo, Samsung, HTC, Verizon o T-Mobile).
    • Atenuado - ga:mobileDeviceModel - Modelo de dispositivo móvil (ejemplo: Nexus S)
    • Atenuar ga:mobileInputSelector: Selector usado en el dispositivo móvil (ejemplos: pantalla táctil, joystick, rueda de clic o pluma stylus)
    • Dim - ga:mobileDeviceInfo: Es el nombre de la marca, el modelo y el nombre comercial que se utiliza para identificar el dispositivo móvil.

Correcciones de errores

  • La API ahora procesa correctamente los caracteres UTF-8 en un filtro o segmento dinámico.

Esta versión permite que las cuentas premium de Google Analytics accedan a hasta 50 variables personalizadas.

Esta versión corrige 2 errores:

Correcciones de errores

  • Los filtros de consulta que contienen caracteres especiales dentro de expresiones regulares ya no muestran errores del servidor.

  • La combinación de un filtro de métrica con un segmento avanzado ya no muestra un error.

Esta versión agrega nuevas métricas de velocidad del sitio a la API.

Métricas nuevas

  • Se agregaron las siguientes métricas de velocidad del sitio:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

Consulte la referencia de Dimensiones y métricas para ver las definiciones.

Recordatorio de baja de la versión 2.3 de la API

  • La versión 2.3 de la API de exportación de datos dejó de estar disponible durante 2 meses. En aproximadamente 4 meses más, cerraremos este servicio y solo admitiremos las nuevas versiones de la API de Core Reporting 3.0 y 2.4.

  • Te recomendamos que migres tus aplicaciones a la versión 3.0.

  • En 4 meses, las solicitudes al feed de datos XML versión 2.3 heredada se reenviarán a la versión 2.4 y mostrarán una respuesta XML de versión 2.4. En ese momento, se aplicarán todas las políticas de cuotas de la versión 2.4 a las solicitudes de esta última.

  • Todas las solicitudes para la versión 2.3 de JSON o la biblioteca cliente de JavaScript de datos de Google que usa el resultado de la versión 2.3 de JSON mostrarán códigos de estado 404.

  • Para obtener la cuota completa, las versiones 3.0 y 2.4 requieren que registres tu aplicación en la Consola de API de Google y que uses una clave de API (o un token OAuth 2.0) en cada solicitud.

Corregimos un pequeño error con ga:visitLength. Esta dimensión ahora muestra los datos correctos.

Esta actualización afecta a todos los desarrolladores de la API de Google Analytics. Anuncia dos versiones nuevas de la API, requiere que las aplicaciones se registren, introduce una nueva política de cuotas y cambia el nombre de la API a la API de Core Reporting. Por último, deja de estar disponible la versión 2.3 de la API de exportación de datos existente.

Versión 3.0

  • La versión 3.0 de la API de informes principales es la última versión principal de nuestra API y no es compatible con versiones anteriores. Todo el desarrollo futuro de la API se realizará en esta versión.

  • Nuevas funciones

    • El nuevo resultado basado en JSON reduce el tamaño de la respuesta aproximadamente 10 veces respecto del resultado XML anterior.
    • Nuevas bibliotecas cliente de la API de Google compatibles con Java, JavaScript, Python, PHP, Ruby y .NET.
    • Compatibilidad con la API de Google Discovery.
    • Compatibilidad con OAuth 2.0 como la nueva forma recomendada de autorizar usuarios
  • Actualizaciones

    • URL nueva para realizar solicitudes: https://www.googleapis.com/analytics/v3/data/ga….
    • Se requieren tokens de registro y de desarrollador.
    • Todas las solicitudes de datos de configuración se deben realizar a través de la API de Management.

Versión 2.4

  • La versión 2.4 de la API de informes principales es una actualización menor que, en su mayoría, es compatible con la versión 2.3 de la API de exportación de datos existente.

  • Actualizaciones

    • Nueva URL para realizar solicitudes: https://www.googleapis.com/analytics/v2.4/data…
    • Se requieren tokens de registro y de desarrollador.
    • Salida XML coherente con la versión 2.3, por lo que las otras bibliotecas cliente de datos de Google existentes seguirán funcionando.
    • El código de error de los errores de cuota cambió de 503 a 403
    • Las respuestas JSON no son compatibles.
    • No se admite la biblioteca cliente de JavaScript de datos de Google.
    • No hay ningún feed de cuenta. Todas las solicitudes de datos de configuración se deben realizar a través de la API de Management.

Registro

  • Todas las aplicaciones compiladas con la API de Google Analytics deben estar registradas como un proyecto a través de la Consola de API de Google.

  • Cada solicitud a la API debe incluir una clave de API o, para OAuth 2.0, un ID de cliente y un secreto de cliente.

Política de cuotas

  • La siguiente cuota se aplica a las API de Anlaytics (API de Management y API de exportación de datos)

    • 50,000 solicitudes por proyecto por día
    • 10 consultas por segundo (QPS) por dirección IP
  • La siguiente cuota se aplica a la API de exportación de datos

    • 10.000 solicitudes diarias por perfil
    • 10 solicitudes simultáneas por perfil
  • Para aplicaciones no registradas, proporcionamos una cuota de gracia muy baja que permite realizar una pequeña cantidad de pruebas.

Bajas

  • Esta versión también anuncia la baja de la versión 2.3 y el próximo cierre del feed de la cuenta en la API de exportación de datos. En 6 meses:

    • Las solicitudes al feed de datos XML de la versión 2.3 se reenviarán a la versión 2.4 y mostrarán una respuesta de la versión 2.4. En ese momento, se aplicarán todas las políticas de cuotas de la versión 2.4 a las solicitudes de esta última.

    • Las solicitudes al resultado JSON de la versión 2.3 no serán compatibles con la respuesta de la versión 2.4 y mostrarán códigos de estado 404 Not Found. Si necesitas una respuesta JSON, actualiza a la versión 3.0.

    • Las solicitudes al Feed de la cuenta en la API de exportación de datos mostrarán los códigos de estado 404 Not Found. Todas las solicitudes de datos de configuración se deben realizar a través de la API de Management.

Esta versión agrega datos más recientes de AdWords y más combinaciones para las dimensiones y métricas de AdWords.

  • Los datos de AdWords ahora se actualizan en una hora. Antes de que los datos se actualizaran a diario.

  • Flexibilizamos algunas restricciones de combinaciones válidas con los datos de AdWords.

Hace algunas semanas, hicimos un cambio para inhabilitar las consultas a la API que solicitaron ga:adGroup o ga:adContent con ga:impressions, ya que esta combinación mostró 0. Con este cambio, la combinación ya está disponible y se corrigió para mostrar los datos correctos.

Esta versión corrige algunas combinaciones no válidas de dimensiones y métricas

Se corrigieron las combinaciones de métricas y dimensiones no válidas.

  • El mes pasado, anunciamos algunos cambios que se realizarán en la API para inhabilitar algunas consultas no válidas en el feed de datos que no muestran datos. Realizamos esos cambios a la API y las siguientes combinaciones no son válidas:

    • Las dimensiones del producto no se pueden combinar con las métricas de transacciones.
    • ga:adContent o ga:adGroup no se pueden combinar con ga:impressions.

    En lugar de mostrar una respuesta con 0 resultados, la API ahora muestra un código de error 400 para todas las consultas que solicitan estas combinaciones.

En esta versión, se da de baja el valor del intervalo de confianza en las métricas.

Intervalo de confianza dejará de estar disponible

  • Si aún no lo hizo, deje de usar los valores del intervalo de confianza para las métricas. Con esta versión, el feed de datos de la API de exportación de datos muestra 0.0 para todos los valores de intervalo de confianza. En un mes aproximadamente, eliminaremos por completo este atributo de todos los elementos de las métricas.

    Para determinar si se muestreó una respuesta, usa el campo containsSampledData en la respuesta.

Esta actualización agrega 3 métricas nuevas y actualiza el valor de retorno de dos.

Nuevas actualizaciones de datos

  • Agregamos 3 métricas nuevas relacionadas con el rendimiento de la velocidad del sitio a la API:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

Actualizaciones de métricas

  • Para especificar los valores de moneda en los filtros, debe especificar el valor real que se pasa desde el código de seguimiento (p.ej., 1 unidad ahora se especificará como 1).

  • ga:CTR ahora muestra el porcentaje real (p.ej., un valor del 2% se muestra como 2).

Esta versión mejora el rendimiento del feed de datos y agrega datos nuevos:

Mejora del rendimiento

  • Esta versión mejora la latencia del feed de datos entre un 30% y un 35%.

Nuevas actualizaciones de datos

  • Actualizamos la lista de dimensiones y métricas que se permiten en los segmentos avanzados. Consulta la lista actualizada para asegurarte de que tus solicitudes sean válidas.

Próximos cambios

  • Actualmente, debe especificar un valor de filtro de moneda como microunidades (p. ej., 1 unidad de moneda se especifica como 1000000). En un futuro cercano, deberá especificar el valor real que se pasó desde el código de seguimiento (por ejemplo, 1 unidad ahora se especificará como 1).

  • Actualmente, ga:CTR es un percent y muestra el valor 0.02. En un futuro cercano, esto cambiará y mostrará el porcentaje real (p.ej., 2).

Esta versión agrega más datos al feed de datos:

Nuevas actualizaciones de datos

  • Se agregó la siguiente dimensión de tiempo: ga:dayOfWeek

  • Se agregó la siguiente métrica de búsqueda interna: ga:percentVisitsWithSearch

  • Se agregaron las siguientes métricas de seguimiento de eventos:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

Próximos cambios

Actualmente, la API muestra 401 códigos de estado para varios problemas de autorización. En las próximas semanas, el estado 401 se usará exclusivamente para tokens no válidos, lo que les brinda a los desarrolladores una forma de controlar esta excepción en particular.

Esta versión agrega muchos más datos al feed de datos:

Nuevas actualizaciones de datos

  • Se modificó el cálculo de ga:visitors para mostrar la cantidad de visitantes únicos en el período y ahora admite más combinaciones de dimensiones y métricas.

  • Se agregaron 10 dimensiones de AdWords nuevas: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl y ga:adDestinationUrl.

  • Se agregó la métrica ga:organicSearches al grupo de campañas.

  • Se agregó la métrica ga:searchResultViews al grupo de búsqueda interno del sitio.

  • Se agregaron 3 dimensiones nuevas basadas en el tiempo: ga:nthDay, ga:nthWeek, ga:nthMonth.

  • Se cambiaron las agrupaciones de dimensiones y métricas para reflejar mejor los atributos que representan.

Nuevas métricas calculadas

Las siguientes métricas calculadas derivan de cálculos que usan las métricas base. Nota: Cada nombre con (n) admite valores del 1 al 20.

  • Basado en objetivos: ga:costPerConversion, ga:costPerGoalConversion, ga:costPerTransaction, ga:goal(n)AbandonRate, ga:goal(n)Abandons, ga:goal(n)ConversionRate, ga:goalAbandonRateAll, ga:goalAbandonsAll, ga:goalConversionRateAll, ga:goalValueAllPerSearch, ga:goalValuePerVisit.

  • Basado en el contenido: ga:entranceBounceRate, ga:visitBounceRate, ga:entranceRate, ga:exitRate, ga:pageviewsPerVisit, ga:avgTimeOnPage, ga:avgTimeOnSite y ga:avgEventValue.

  • Búsqueda interna en el sitio: ga:avgSearchDepth, ga:avgSearchDuration, ga:avgSearchResultViews, ga:searchGoalConversionRateAll, ga:searchGoal(n)ConversionRate y ga:searchExitRate.

  • Comercio electrónico: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

Esta versión agrega una nueva función al feed de datos:

Nuevas funciones

  • Se agregó un nuevo elemento XML que permite a los usuarios saber si se muestrearon los datos. true. Este elemento siempre mostrará si los datos se muestrearon o no con true o false. Las bibliotecas de Java y JavaScript también se actualizaron con métodos de ayuda para acceder a este elemento.

Esta versión corrige 2 errores:

Correcciones de errores

  • Anteriormente, se agregaba un operador OR a una expresión de filtro con una dimensión (es decir, ga:keyword==store,ga:keyword==bar) podrían generar valores diferentes que si cada filtro se aplicara de forma individual en varias consultas. Esto se corrigió y el uso del operador OR ahora muestra valores coherentes.

  • Algunos de los mensajes de error de la API para filtros no válidos se actualizaron a fin de que NO incluyan si una dimensión o un filtro de métrica causó el error (aunque se seguirá mostrando la expresión de filtro infractora).

Esta versión corrige 3 errores:

Correcciones de errores

  • Se corrigió un problema de codificación en la biblioteca cliente de JavaScript. Seguimiento de problemas de Analytics

  • Se corrigió un error que impedía que el feed de la cuenta no recibiera una respuesta incorrecta sobre el nombre, la ruta del objetivo, el valor de comparación del objetivo o el tipo de comparación del objetivo.

  • No es válida para OR una dimensión y una métrica del parámetro de filtro de consulta del feed de datos. Por ejemplo: ga:source==google,ga:visits>5. El mensaje de error de esta consulta no válida se actualizó y dice: Cannot OR dimension filter(s) with metric filter.

Esta versión agrega datos nuevos y corrige un error:

Nuevas funciones

  • Se agregaron las siguientes 5 dimensiones a la nueva categoría D8. Adwords:

    • ga:adwordsAdGroupId: Corresponde al AdGroup.id de la API de AdWords.
    • ga:adwordsCampaignId: corresponde al Campaign.id de la API de AdWords
    • ga:adwordsCreativeId: Corresponde al Ad.id de la API de AdWords.
    • ga:adwordsCriteriaId: corresponde al Criterion.id de la API de AdWords.
    • ga:adwordsCustomerId: corresponde a la AccountInfo.customerId de la API de AdWords

Correcciones de errores

  • Se solucionó un problema por el cual el feed de la cuenta no mostraba datos si uno de los perfiles tenía un objetivo o un paso mal configurado.

Esta versión agrega varias funciones nuevas y corrige un error:

Nuevas funciones

  • Se mejoró el segmento predeterminado de iPhone (gaid::-11) para que ahora genere informes de todos los dispositivos móviles. El ID es el mismo que antes (-11), pero el nombre del segmento ahora es Mobile Traffic.

  • La tasa de muestreo utilizada por la API ahora es la misma que la interfaz web. Esto acerca los datos de los informes de muestra a la interfaz web y aumenta la coherencia entre ambos.

  • La política de cuotas se actualizó para garantizar que todos los usuarios reciban un acceso equitativo a los recursos. Consulta nuestra documentación sobre la política de cuotas para obtener más detalles. La nueva política es:

    • Una sola propiedad web puede hacer un máximo de 10,000 solicitudes cada 24 horas.
    • Una aplicación solo puede realizar 10 solicitudes en un período de 1 segundo.
    • Una aplicación solo puede tener 4 solicitudes pendientes en un momento determinado.
  • Se flexibilizaron algunas restricciones en las combinaciones de dimensiones y métricas. ga:nextPagePath y ga:previousPagePath ahora son parte del grupo D3. Content. El grupo D8. Custom Variable ahora se llama D6. Custom Variable. Consulte la guía de referencia actualizada para conocer las nuevas combinaciones.

Correcciones de errores

  • Se corrigió un error relacionado con la manera en que la API informa el valor confidenceInterval para las métricas. Anteriormente, los intervalos de confianza podían tener un valor de INF o un número del 0 al 1. Ahora todos los intervalos de confianza tendrán un valor de INF o un número mayor o igual a 0.

  • ga:itemQuantity y ga:uniquePurchases se intercambiaron anteriormente y mostraron el valor del otro. Ahora están corregidos para mostrar los datos correctos.

Recordatorio de la baja de Dimensiones y métricas

  • Si aún no lo hizo, deje de usar las dimensiones y métricas que dejaron de estar disponibles anteriormente.

Esta versión incluye varias funciones nuevas:

Esta versión aumenta el número de versión principal a 2

  • Algunas funciones requieren el uso de las bibliotecas cliente más recientes. Se ofrece compatibilidad oficial para Java y Javascript. Es posible que aún no se hayan actualizado las bibliotecas de terceros.

    • Para solicitar la versión 2, agregue el encabezado GData-Version: 2 a cada solicitud de cuenta o feed de datos. Para obtener más información, consulte la documentación.
    • Se agregó un nuevo espacio de nombres XML a los feeds de cuenta y de datos:
      xmlns:ga='http://schemas.google.com/ga/2009'
  • La API ahora admite la versión 2 del protocolo de datos de Google.

Compatibilidad con segmentación avanzada

  • Parámetro de consulta de segmentos dinámicos:

    • ...&segment=dynamic::expresión
    • permite crear segmentos avanzados "sobre la marcha".
    • expresión puede ser cualquier dimensión o métrica, y debe seguir la misma sintaxis que los filtros.
  • Parámetro de consulta de segmentos personalizados y predeterminados:

    • ...&segment=gaid::número
    • donde el número es un ID que hace referencia a un segmento avanzado definido en la interfaz web de Google Analytics.
    • Puede encontrar el ID en el feed de la cuenta.
  • El feed de la cuenta describe los datos del segmento mediante los siguientes elementos y atributos XML:

    • ga:visitorType==Returning Visitor
  • El feed de datos también proporciona un elemento XML que indica si se aplicó un segmento en la solicitud de la API.

  • Obtenga más detalles sobre los segmentos avanzados en nuestra documentación.

Nuevos datos disponibles del objetivo

  • Objetivos de tipo de participación y destino disponibles en el feed de la cuenta:

  • Se agregaron 48 métricas nuevas para los objetivos 5 a 20, que siguen la convención goal(n)Completions, en la que (n) es un número entre 1 y 20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value
  • Se actualizaron GoalCompletionAll, GoalStartsAll y GoalValueAll para responder a los nuevos datos del objetivo.

Nuevos datos de variables personalizadas

  • Todas las variables personalizadas recopiladas por cada perfil se agregaron como un nuevo elemento XML al feed de la cuenta:

  • Se agregaron 10 dimensiones nuevas para las variables personalizadas. Siguen la convención customVar(n), en la que (n) puede ser un número entre 1 y 5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

Dimensiones y métricas obsoletas que se quitarán.

  • Si todavía no lo hizo, deje de usar las dimensiones y métricas que dejaron de estar disponibles anteriormente. Se eliminarán pronto y, si se solicitan, mostrarán errores de nuestra API.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Se cambió el nombre de las siguientes dimensiones:

    • ga:countOfVisits ahora es ga:visitCount.
    • ga:countOfVisitsToATransaction ahora es ga:visitsToTransaction.

En esta versión, se agregan funciones nuevas y se darán de baja algunas funciones antiguas:

  • Las siguientes dimensiones y métricas dejaron de estar disponibles. Los quitaremos de manera permanente de nuestra API en un mes. Asegúrate de actualizar tu código para que las aplicaciones no se fallen:

    • ga:recuentoDeVisitas
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits
  • Se cambió el nombre de las siguientes dimensiones:

    • ga:countOfVisits ahora es ga:visitCount
    • ga:countOfVisitsToATransaction ahora es ga:visitsToTransaction
  • Todos los datos de seguimiento de eventos ahora se exponen como dos grupos nuevos:

    D7. Eventos (Dimensiones) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. Eventos (métricas) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

  • Los datos generales de navegación del sitio ahora se exponen en las siguientes dimensiones:

    D6. Navegación * ga:previousPagePath * ga:nextPagePath

  • La navegación de la página de destino ahora se expone en las siguientes dimensiones:

    D3. Contenido * ga:landingPagePath * ga:secondPagePath

  • La longitud máxima de las expresiones regulares en el parámetro de búsqueda de filtro del feed de datos aumentó de 32 a 128 caracteres.

  • El informe Duración de la visita (que se encuentra a través de la IU en Visitantes > Lealtad del visitante) ahora se expone a través de la nueva dimensión:

    • ga:visitLength

Esta versión actualiza la API de exportación de datos de Google Analytics de la siguiente manera:

  • Se flexibilizaron algunas restricciones en las combinaciones de dimensiones y métricas. Ahora puedes consultar la mayoría de las dimensiones a nivel del visitante y el contenido juntas; por ejemplo, ga:pagePath y ga:source ahora son una combinación válida. Consulta la guía de referencia actualizada para estas nuevas combinaciones: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • La cantidad total de filas que se pueden solicitar en una solicitud aumentó a 10,000. La cantidad predeterminada de filas que se muestran sigue siendo 1,000, pero ahora se puede aumentar mediante la configuración del parámetro de búsqueda max-results.

  • El feed de cuenta ahora muestra dos nuevos elementos de datos para cada ID de tabla (moneda y zona horaria).

  • A partir de ahora, las consultas de datos deben incluir al menos una métrica válida.

  • Se implementaron todos los cambios de baja anteriores.

Esta versión quita las funciones obsoletas de nuestra versión Beta privada:

  • Las solicitudes de feed de la cuenta dejarán de admitir un nombre de usuario. En cambio, solo aceptará solicitudes en el siguiente formato:
    https://www.google.com/analytics/feeds/accounts/default

  • Se quitarán las siguientes métricas y dejarán de funcionar. En su lugar, proporcionamos instrucciones sobre cómo calcular estos valores aquí: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costo por conversión
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • Se cambió el nombre de las siguientes dimensiones y métricas. Los nombres anteriores ya no funcionarán. Verifique que esté usando los nombres oficiales en nuestra documentación: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    .