Registro de cambios de la API de Google Analytics Core Reporting

Actualizamos de forma periódica la API de Core Reporting de Google Analytics para ofrecer funciones nuevas y reparar los defectos descubiertos en versiones anteriores. En la mayoría de los casos, estos cambios serán transparentes para los desarrolladores de API. Sin embargo, a veces necesitamos realizar cambios que requieran que los desarrolladores modifiquen sus aplicaciones existentes.

En esta página, se documentan los cambios realizados en la API de Google Analytics Core Reporting que podrían afectar tu aplicación. Recomendamos que los desarrolladores de API verifiquen esta lista de forma periódica para ver si hay nuevos anuncios. También puedes suscribirte a los cambios a través de los feeds que se indican en la sección Suscribirse que aparece más abajo.

Suscribirse a registros de cambios relacionados

Incluye todas las APIs de recopilación, configuración y informes.

Incluye la API de Core Reporting, la API de Multi-Channel Funnels Reporting y la API de Realtime Reporting.

Esta es la versión inicial de la API de User Activity

  • La API de User Activity te permite recuperar todos los datos asociados con un único ID de cliente o User-ID durante un intervalo de fechas determinado. Su objetivo principal es ayudar a los propietarios de las propiedades que desean brindarle acceso automatizado de los datos de un usuario directamente a ese usuario. Visita la Guía de API de User Activity para obtener más detalles.

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

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

En esta versión, se incluye una vista previa del sistema de cuotas basadas en recursos para la API de Google Analytics Reporting v4, que permite utilizar umbrales de muestreo más altos para los clientes de Analytics 360 (Premium).

En esta versión, la función Productos relacionados y las dimensiones y métricas asociadas dejarán de estar disponibles. Revisa la Referencia de dimensiones y métricas para ver la lista completa de definiciones. Consulta la Política de Baja de Datos para obtener detalles sobre la eliminación de datos:

En esta versión, se dan 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

En esta versión, se agrega una dimensión nueva a la API. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones. En esta versión, también se quitan varias dimensiones y métricas que dejaron de estar disponibles. Revisa la Política de Baja de Datos para las APIs de Google Analytics para comprender todo el proceso de eliminación de datos.

Tiempo

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

Eliminación de datos

En esta versión, se quitan las siguientes dimensiones y métricas que dejaron de estar disponibles:

  • 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 versión actualiza las métricas y dimensiones existentes en la API. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Métricas del usuario

Se actualizó el cálculo de las métricas Usuarios y Usuarios activos para que el recuento de usuarios sea más eficiente. Es posible que veas un pequeño cambio en las métricas. Si deseas obtener más información, consulta Cómo se identifica a los usuarios para las métricas de usuarios.

Actualización de las métricas del usuario afectadas por el cálculo:

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

Eventos únicos

Nos acercamos al final del 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á la métrica privada ga:uniqueEventsTemporary de la API. Para obtener más información, consulta los documentos de ayuda de Eventos únicos.

En esta versión, se agrega una nueva dimensión a la API, se mejoran los mensajes de error y se comienzan a aplicar los cambios anunciados anteriormente para las dimensiones y métricas de AdSense.

Dimensiones del usuario

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

Mensajes de error

Antes, 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 vinculadas que no sean de AdSense no podrán buscar dimensiones y métricas de AdSense. Se producirá un error si realizas consultas de estas dimensiones y métricas con vistas vinculadas que no sean de AdSense.

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 próximo cambio en ellas.

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 de dimensiones y métricas de AdSense mostraban un error de "Métrica desconocida" para las vistas no vinculadas a AdSense.

Próximos cambios

A partir del 31/1/2017, las vistas que no estén vinculadas a AdSense no podrán buscar dimensiones ni métricas de AdSense. Se producirá un error si realizas consultas de estas dimensiones y métricas con vistas vinculadas que no sean de AdSense.

Esta versión agrega la siguiente métrica nueva a la API. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Métricas calculadas

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

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

En esta versión, se agrega una métrica nueva a la API. También da de baja una métrica existente. Revisa la Referencia de dimensiones y métricas para obtener 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 modificar este cambio, técnicamente daremos 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, consulta 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. En su lugar, usa ga:uniqueDimensionCombinations si deseas conservar la definición existente. Para obtener más información, consulta los documentos de ayuda de Eventos únicos.
  • Métrica ga:uniqueDimensionCombinations: Combinaciones de dimensiones únicas registra la cantidad de combinaciones únicas de valores de dimensiones 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, consulta los documentos de ayuda de Eventos únicos.

Prueba de transición: privada

  • Métrica: ga:uniqueEventsTemporary: Cantidad de eventos únicos; esta será la nueva definición de ga:uniqueEvents. Puedes usar esta métrica para comprender la definición nueva antes del cambio. Ten en cuenta que esta métrica es privada y no se mostrará en la Referencia de dimensiones y métricas.

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

DoubleClick Bid Manager

  • Dimensión: ga:dbmClickAdvertiser: nombre del anunciante de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en 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 en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickCreativeId: ID de la creatividad de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickExchange: nombre del intercambio de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickExchangeId: ID de intercambio de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickInsertionOrder: Nombre del pedido de inserción de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickInsertionOrderId: ID del pedido de inserción de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickLineItem: nombre de la línea de pedido de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickLineItemId: ID de línea de pedido de DBM del clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmClickSite: Nombre del sitio de DBM en el que se mostró la creatividad de DBM y se hizo clic en ella para el clic de DBM que coincide con la sesión de Google Analytics (solo en 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 el clic de DBM que coincide con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmLastEventAdvertiser: 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 en 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 en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmLastEventCreativeId: ID de la creatividad 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 en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmLastEventExchange: Nombre del 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 en 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 en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmLastEventInsertionOrder: Nombre del pedido de inserción de DBM del último evento de DBM (impresión o clic dentro de la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo en 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 dentro de la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmLastEventLineItem: 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 en Analytics 360, requiere integración con DBM).
  • Dimensión: ga:dbmLastEventLineItemId: ID de 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 en 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 dentro de la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo en 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 dentro de la ventana de visualización de DBM) asociado con la sesión de Google Analytics (solo en Analytics 360, requiere integración con DBM).
  • Métrica: ga:dbmCPA: eCPA de ingresos de DBM (solo en Analytics 360, requiere integración con DBM)
  • Métrica: ga:dbmCPC: CPCA de ingresos de DBM (solo en 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 en Analytics 360, requiere integración con DBM)
  • Métrica: ga:dbmClicks: Clics totales de DBM (solo en Analytics 360, requiere integración con DBM)
  • Métrica: ga:dbmConversions: Conversiones totales de DBM (solo en 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 en Analytics 360; requiere integración con DBM)
  • Métrica: ga:dbmROAS: ROAS de DBM (solo en Analytics 360, requiere integración con DBM)
  • Dimensión: ga:dsAdGroup: grupo de anuncios de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsAdGroupId: ID del grupo de anuncios de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsAdvertiser: anunciante de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsAdvertiserId: ID del anunciante de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsAgency: agencia de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsAgencyId: ID de la agencia de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsCampaign: campaña de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsCampaignId: ID de campaña de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsEngineAccount: cuenta de motor de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsEngineAccountId: ID de la cuenta del motor de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsKeyword: palabra clave de DS (solo en Analytics 360; requiere integración con DS).
  • Dimensión: ga:dsKeywordId: ID de palabra clave de DS (solo en Analytics 360; requiere integración con DS).
  • ga:dsCPC: Costo por clic de DS al anunciante (solo en Analytics 360; requiere integración con DS).
  • ga:dsCTR - Tasa de clics de DS (solo en Analytics 360; requiere integración con DS)
  • ga:dsClicks: Clics de DS (solo en Analytics 360; requiere integración con DS)
  • ga:dsCost: Costo de DS (solo en Analytics 360; requiere integración con DS)
  • ga:dsImpressions: Impresiones de DS (solo en Analytics 360; requiere integración con DS)
  • ga:dsProfit: DS Profie (solo en Analytics 360; requiere integración con DS)
  • ga:dsReturnOnAdSpend: Retorno de la inversión publicitaria de DS (solo en Analytics 360; requiere integración con DS)
  • ga:dsRevenuePerClick: Ingresos por clic de DS (solo en Analytics 360; requiere integración con DS)

Esta versión agrega una dimensión nueva a la API. En esta versión, también se agregan ciertas restricciones para la combinación de dimensiones que se pueden consultar juntas. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Red geográfica

  • Dimensión: ga:continentId: ID de continente de los usuarios, según las direcciones IP o los IDs geográficos de los usuarios.

Restricciones

Las siguientes dimensiones de los siguientes grupos no se pueden consultar con las dimensiones de los otros grupos:

  • Visitar el grupo de información de Shopping.
    • ga:checkoutOptions
    • ga:shoppingStage
  • Grupo de experimentos de GWO
    • ga:experimentVariant
    • ga:experimentId
  • Grupo de interés
    • ga:interestOtherCategory
  • 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 para el desarrollo de la marca:
    • ga:interestAffinityCategory

En esta versión, se presentan nuevos límites y cuotas. Consulta la documentación de Límites y cuotas para obtener más detalles.

Informa errores

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

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

Límites dinámicos

En esta versión, se comienza a aplicar límites en las solicitudes de pivot:

  • Una solicitud de informe ahora puede tener un máximo de 2 pivot.
  • Una tabla dinámica puede tener un máximo de 4 dimensiones.
  • Las dimensiones dinámicas son parte de la restricción sobre la cantidad total de dimensiones permitidas en la solicitud.
  • Las metrics dinámicas forman parte de la restricción sobre la cantidad total de métricas permitidas en la solicitud.

Esta versión agrega dimensiones y métricas nuevas a la API. Revisa la Referencia de dimensiones y métricas para obtener 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 la que llegó el tráfico, derivado de las direcciones IP o los IDs geográficos de los usuarios.

DoubleClick for Publishers

  • Métrica: ga:dfpImpressions: Se informa una impresión de anuncios de DFP cada vez que se muestra un anuncio individual en el sitio web. Por ejemplo, si se visualiza una vez una página con dos unidades de anuncios, mostraremos dos impresiones (vinculación de DFP habilitada y opción Ocultar ingresos de DFP no habilitada).
  • 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 / Total de solicitudes de anuncios) × 100 (La vinculación de DoubleClick está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpMonetizedPageviews: Mide la cantidad total de vistas de página en la propiedad que se mostraron con un anuncio de la cuenta de DoubleClick vinculada. Ten en cuenta que una sola página puede tener varias unidades de anuncios (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpImpressionsPerSession: Proporción entre las impresiones de anuncios de DoubleClick y las sesiones de Analytics (impresiones de anuncios / sesiones de Analytics) (vinculación de DoubleClick habilitada y oculta los ingresos de DFP no habilitados)
  • Métrica: ga:dfpViewableImpressionsPercent: 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 ser vista (la vinculación a 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 anuncios de DFP en el sitio (se habilitó la vinculación de DoubleClick y la opción Ocultar ingresos de DFP no habilitada).
  • Métrica: ga:dfpCTR: Porcentaje de vistas de página que generaron clics en un anuncio de DFP (se habilitó la vinculación de DoubleClick y la opción Ocultar ingresos de DFP sin habilitar)".
  • Métrica: ga:dfpRevenue: Los ingresos de DFP son una estimación de los ingresos publicitarios totales en función de las impresiones publicadas (la vinculación de DFP está habilitada y la opción Ocultar ingresos de DFP no está habilitada).
  • Métrica: ga:dfpRevenuePer1000Sessions: Indica el total de ingresos estimados provenientes de anuncios de DFP por cada 1,000 sesiones de Analytics. Ten en cuenta que esta métrica se basa en las sesiones en el sitio, no en las impresiones de anuncios (si se habilitó la vinculación a DFP y la opción Ocultar ingresos de DoubleClick si no están habilitadas).
  • Métrica: ga:dfpECPM: Es el costo efectivo por cada mil vistas de página. Es el total de ingresos de DFP por cada 1,000 vistas de página (no se habilitó la vinculación de DoubleClick y la opción Ocultar ingresos de DoubleClick).
  • Métrica (ga:backfillImpressions): Las impresiones de reabastecimiento son la suma de todas las impresiones de anuncios de AdSense o de Rendimiento de anuncios que se publicaron 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 se visualiza una vez una página con dos unidades de anuncios, mostraremos dos impresiones (vinculación de DFP habilitada y opción Ocultar ingresos de DFP no habilitada).
  • 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 en los que la cuenta del publicador no puede proporcionar anuncios segmentados. (Impresiones de anuncios / Total de solicitudes de anuncios) * 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 Ad Manager no está habilitada).
  • Métrica: ga:backfillMonetizedPageviews: Mide la cantidad total de vistas de página en la propiedad que se mostraron con al menos un anuncio de las cuentas de reabastecimiento vinculadas. Ten 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á habilitada).
  • Métrica: ga:backfillImpressionsPerSession: Es la proporción entre impresiones de anuncios de reabastecimiento y sesiones de Analytics (impresiones de anuncios / sesiones de Analytics). Si tanto AdSense como Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de AdSense está habilitada y la opción para ocultar los ingresos de DoubleClick si están inhabilitadas).
  • Métrica: ga:backfillViewableImpressionsPercent: Es el porcentaje de impresiones de anuncios de reabastecimiento que eran visibles. Una impresión se considera una impresión visible cuando apareció en los navegadores de los usuarios y tuvo la oportunidad de ser vista. Si tanto AdSense como Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica representa 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 habilitada).
  • Métrica: ga:backfillClicks: Es la cantidad de veces que se hizo clic en los anuncios de reabastecimiento en el sitio. Si tanto AdSense como 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 para ocultar los ingresos de DoubleClick si están inhabilitadas).
  • Métrica: ga:backfillCTR: Porcentaje de impresiones de reabastecimiento que generaron clics en un anuncio. Si tanto AdSense como Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica representa 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 habilitada).
  • Métrica: ga:backfillRevenue: Indica los ingresos totales estimados que provienen de anuncios de reabastecimiento. Si tanto AdSense como 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 para ocultar los ingresos de DoubleClick si están inhabilitadas).
  • Métrica: ga:backfillRevenuePer1000Sessions: Indica los ingresos totales estimados provenientes de anuncios de reabastecimiento por cada 1,000 sesiones de Analytics. Ten en cuenta que esta métrica se basa en las sesiones en el sitio y no en las impresiones de anuncios. Si tanto AdSense como Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de AdSense está habilitada y la opción para ocultar los ingresos de DoubleClick si están inhabilitadas).
  • Métrica: ga:backfillECPM: Es el costo efectivo por cada mil vistas de página. Son los ingresos de reabastecimiento de DFP por cada 1,000 vistas de página. Si tanto AdSense como Ad Exchange proporcionan anuncios de reabastecimiento, esta métrica es la suma de las dos cuentas de reabastecimiento (la vinculación de AdSense está habilitada y la opción para ocultar los ingresos de DoubleClick si están inhabilitadas).

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

Segmentos

En esta versión, se soluciona un problema que causaba que un subconjunto de solicitudes con el segmento Todos los usuarios (gaid::-1) se contara por debajo del recuento en la API de Core Reporting V3 y se dividiera en dos segmentos en la API de informes de Analytics versión 4.

Muestreo

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

Esta es una versión de corrección de errores que soluciona un problema cuando se realizan 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 al solicitar las dimensiones ga:acquisition....

LTV de solicitud de valor del ciclo de vida del cliente

Ten en cuenta que las solicitudes de valor del ciclo de vida del cliente pueden generar informes de valores del ciclo de vida del cliente únicamente para las vistas de aplicaciones.

En esta versión, se anuncia una nueva versión de la API, la API de Analytics Reporting 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 infraestructura de informes de datos potente. La API les brinda a los desarrolladores acceso a la potencia de la plataforma de Google Analytics. Algunas funciones clave de la API de Analytics Reporting V4 incluyen las siguientes:

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

Getting Started

Consulte la documentación para desarrolladores para ver todos los detalles sobre cómo comenzar a usar la API.

Política de cuotas

La API de Analytics Reporting V4 viene con sus propias cuotas y límites. Como se trata de una API nueva, los límites y las cuotas están sujetos a cambios.

Migración

Junto con una guía de migración, también ofrecemos una biblioteca de compatibilidad con Python en GitHub.

Dimensiones y métricas

Esta versión también agrega un conjunto de dimensiones y métricas específicamente para la API de Analytics Reporting V4. Consulta el explorador de dimensiones y métricas para ver las definiciones completas de la lista.

  • Dimensión (ga:cohort): Es el 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 cómo un usuario puede pertenecer a varios segmentos.

  • Dimensión: ga:cohortNthDay: compensación de día basada en 0 en relación con la fecha de definición de la cohorte. Por ejemplo, si una cohorte se define con la fecha de la primera visita 2015-09-01, para la fecha 2015-09-04, ga:cohortNthDay será 3.

  • ga:cohortNthMonth: Es la compensación mensual basada en 0 en relación con la fecha de definición de la cohorte.

  • Dimensión: ga:cohortNthWeek: compensación de semana basada en 0 en relación con la fecha de definición de la cohorte.

  • Dimensión: ga:acquisitionTrafficChannel: canal de tráfico a través del cual 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án disponibles) en el momento de la adquisición de usuarios.

  • Dimensión: ga:acquisitionSource: Es la fuente a través de la que se adquirió al usuario. Derivan de la primera sesión del usuario.

  • Dimensión: ga:acquisitionMedium: Es el medio a través del cual se adquirió al usuario. Derivan 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 Es la campaña a través de la cual se adquirió al usuario. Derivan 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 al enésimo día, semana o mes de la cohorte. Por ejemplo, en el caso de ga:cohortNthWeek = 1, indica 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: Es la cantidad de usuarios que pertenecen a la cohorte, también conocido como tamaño de la cohorte.

  • Métrica: ga:cohortAppviewsPerUser: Vistas de apps por usuario para una cohorte.

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

  • Métrica: ga:cohortPageviewsPerUser: Vistas de página por usuario para una cohorte.

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

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

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

  • Métrica: ga:cohortSessionsPerUser: Sesiones por usuario de una cohorte.

  • Métrica: ga:cohortTotalUsersWithLifetimeCriteria: 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 actual. Por ejemplo, en el caso de ga:acquisitionTrafficChannel=Direct, representa la cantidad de usuarios de la cohorte que se adquirieron directamente. Si no aparece ninguna de las dimensiones mencionadas, su valor es igual a ga:cohortTotalUsers.

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

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

  • Métrica: ga:cohortPageviewsPerUserWithLifetimeCriteria: Vistas de página por usuario para la dimensión de adquisición de una cohorte.

  • Métrica: ga:cohortRevenuePerUserWithLifetimeCriteria: Ingresos por usuario de 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 informarán sobre los datos históricos a partir del 30 de abril de 2016. Después de esa fecha, no se mostrarán datos nuevos. Según la Política de Baja de Datos, estas dimensiones y métricas se quitarán después del 30 de septiembre de 2016.

Revisa la Referencia de dimensiones y métricas para obtener 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. Consulta la Política de Baja de Datos para obtener detalles sobre la eliminación de datos:

  • Dimensión: ga:socialActivityEndorsingUrl: En el caso de una actividad del centro de datos sociales, es la URL de la actividad social (p. ej., la URL de la entrada de Google+, la URL del comentario del blog, etcétera).
  • Dimensión (ga:socialActivityDisplayName): En el caso de una actividad de centro de datos sociales, es el título de la actividad que publican los usuarios de redes sociales.
  • Dimensión: ga:socialActivityPost: En el caso de una actividad de centro de datos sociales, es el contenido de la actividad social (p.ej., el contenido de un mensaje publicado en Google+) que publican los usuarios de redes sociales.
  • Dimensión (ga:socialActivityTimestamp): En el caso de una actividad de centro de datos sociales, es el momento en que ocurrió la actividad en la red social.
  • Dimensión: ga:socialActivityUserHandle: En el caso de una actividad de centro de datos sociales, es el identificador de red social (p.ej., nombre o ID) de los usuarios que iniciaron la actividad social.
  • Dimensión: ga:socialActivityUserPhotoUrl: En el caso de una actividad del centro de datos sociales, se trata de la URL de la foto asociada con los perfiles de las redes sociales de los usuarios.
  • Dimensión (ga:socialActivityUserProfileUrl): En el caso de una actividad de centro de datos sociales, es la URL de los perfiles de redes sociales de los usuarios asociados.
  • Dimensión: ga:socialActivityTagsSummary: En el caso de una actividad de centro de datos sociales, se trata de un conjunto de etiquetas separadas por comas asociadas con la actividad social.
  • Dimensión (ga:socialActivityAction): En el caso de una actividad de centro de datos sociales, representa el tipo de acción social (p.ej., voto, comentario, +1, etc.) asociada con la actividad.
  • Dimensión (ga:socialActivityNetworkAction): En el caso de una actividad de centro de datos sociales, es el tipo de acción social y red social en la que se originó.
  • Dimensión (ga:socialActivityContentUrl): En el caso de una actividad de centro de datos sociales, 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 del centro de datos sociales.

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

Plataforma o dispositivo

  • Dimensión (ga:browserSize): Corresponde al tamaño del viewport de los navegadores de los usuarios. El tamaño del navegador es una dimensión centrada en la sesión que captura las dimensiones iniciales del viewport en píxeles y tiene el formato de ancho X alto. Por ejemplo, 1920 × 960.

En esta versión, se agrega un parámetro nuevo a la API.

Incluir filas vacías

  • En esta versión, se agrega el nuevo parámetro opcional include-empty-rows, que, cuando se establece en false, se omitirán de la respuesta las filas sin datos. El valor predeterminado es true, que es un cambio no rotundo y, por lo tanto, no debería requerir una actualización de código. Consulta la documentación de referencia de la API de Core Reporting para obtener más detalles.

En esta versión se agregan métricas nuevas a la API. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Usuario

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

En esta versión se agregan métricas nuevas a la API. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

DoubleClick Ad Exchange (AdX)

  • Métrica: ga:adxCTR: Porcentaje de vistas de página que generaron un clic en un anuncio de AdX.
  • Métrica: ga:adxClicks: Es la cantidad de veces que se hizo clic en anuncios de AdX 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 los sitios donde su cuenta de AdX no puede proporcionar anuncios orientados. (Impresiones de anuncios / Total de solicitudes de anuncios) * 100
  • Métrica: ga:adxECPM: Es el costo efectivo por cada mil vistas de página. Corresponde a tus ingresos de AdX por cada 1,000 vistas de página.
  • Métrica: ga:adxImpressions: Se informa una impresión de anuncios de AdX cada vez que se muestra un anuncio individual en su sitio web. Por ejemplo, si una página con dos unidades de anuncios se visualiza una vez, mostraremos dos impresiones.
  • Métrica: ga:adxImpressionsPerSession: Es la proporción entre impresiones de anuncios de AdX y sesiones de Analytics (impresiones de anuncios / sesiones de Analytics).
  • Métrica: ga:adxMonetizedPageviews: Las vistas de página monetizadas miden la cantidad total de vistas de página en tu propiedad que se mostraron con un anuncio de tu cuenta de AdX vinculada. Nota: Una sola página puede tener varias unidades de anuncios.
  • Métrica: ga:adxRevenue: Indica el total de ingresos estimados provenientes de los anuncios de AdX.
  • Métrica: ga:adxRevenuePer1000Sessions: Indica el total de ingresos estimados provenientes de anuncios de AdX por cada 1,000 sesiones de Analytics. Ten en cuenta que esta métrica se basa en las sesiones en tu sitio y no en las impresiones de anuncios.
  • Métrica: ga:adxViewableImpressionsPercent: Porcentaje de impresiones de anuncios que fueron visibles. Una impresión se considera una impresión visible cuando apareció en el navegador de un usuario y tuvo la oportunidad de ser vista.

En esta versión, se dan de baja las dimensiones o métricas existentes. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Dimensiones obsoletas

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

  • Dimensión (ga:adSlotPosition): Utiliza ga:adSlot en su lugar.
  • Dimensión (ga:nextPagePath): Utiliza ga:pagePath en su lugar.
  • Dimensión (ga:nextContentGroupXX): Utiliza ga:contentGroupXX en su lugar.

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

AdWords

  • Dimensión ga:adQueryWordCount: es la cantidad de palabras incluidas en la búsqueda.

En esta versión se agregan nuevas dimensiones a la API. Revisa la 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 "app". 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 tu sitio.

En esta versión, se agregan dimensiones y métricas nuevas a la API, y dos métricas existentes dan de baja. Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

ECommerce

  • Métrica: ga:transactionsPerUser: Es la cantidad total de transacciones dividida por la cantidad total de usuarios.
  • Métrica: ga:revenuePerUser: Son los ingresos totales por ventas que se proporcionaron en la transacción, sin incluir el envío ni los impuestos, divididos por la cantidad total de usuarios.

Usuario

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

Red geográfica

  • Dimensión ga:cityId: Son los IDs de ciudad de los usuarios, según las direcciones IP o los IDs geográficos.
  • Dimensión: ga:countryIsoCode: Es el código ISO del país de los usuarios, según las direcciones IP o los IDs geográficos. Los valores se proporcionan como un código ISO-3166-1 alfa-2.
  • Dimensión (ga:regionId): Indica el ID de región de los usuarios, según las direcciones IP o los IDs geográficos. En EE.UU., una región es un estado, como Nueva York.
  • Dimensión: ga:regionIsoCode: Es el código ISO de la región de los usuarios, derivado de las direcciones IP o los IDs geográficos. Los valores se proporcionan como un código ISO-3166-2.
  • Dimensión: ga:subContinentCode: el código del subcontinente de los usuarios, según las direcciones IP o los IDs geográficos. Por ejemplo, la Polinesia o Europa septentrional. Los valores se proporcionan como un código UN M.49.

DoubleClick Campaign Manager

  • Métrica: ga:dcmROAS: Retorno de la inversión publicitaria (ROAS) de DCM (solo premium)

Métricas obsoletas

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

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

AdWords

  • Métrica: ga:ROAS: El retorno de la inversión publicitaria (ROAS) es el total de ingresos por 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. Revisa la Política de Baja de Datos para obtener detalles sobre la eliminación de datos: + Métrica - ga:ROI - Usa ga:ROAS en su lugar. + Métrica: ga:margin: Usa ga:ROAS en su lugar.

En esta versión se agregan métricas nuevas a la API. Consulta la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

AdSense

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

Esta actualización 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

Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Sesión

  • Métrica: ga:hits: Cantidad total de hits que se enviaron a Google Analytics. Esta métrica suma todos los tipos de hits (p.ej., vistas de página, evento, tiempos, etcétera).

Fuentes de tráfico

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

DoubleClick Campaign Manager

  • Dimensión (ga:dcmClickAd): Nombre del anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión (ga:dcmClickAdId): ID del anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmClickAdType: Nombre del tipo de anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión - ga:dcmClickAdTypeId: ID del tipo de anuncio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión - ga:dcmClickAdvertiser: nombre del anunciante de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión - ga:dcmClickAdvertiserId: ID del anunciante de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmClickCampaign: nombre de la campaña de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • 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 Premium).
  • Dimensión (ga:dcmClickCreative): Nombre de la creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión ga:dcmClickCreativeId: ID de la creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión (ga:dcmClickCreativeType): Nombre del tipo de creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión ga:dcmClickCreativeTypeId: ID del tipo de creatividad de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • 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 Premium).
  • Dimensión: ga:dcmClickRenderingId: ID de renderización de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmClickSite: Es el nombre del sitio en el que se mostró la creatividad de DCM y se hizo clic en ella para el clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • 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 el clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión - ga:dcmClickSitePlacement: Nombre de la posición del sitio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmClickSitePlacementId: ID de posición de sitio de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión - ga:dcmClickSpotId: ID de configuración de Floodlight de DCM del clic de DCM que coincide con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmFloodlightActivity: Nombre de la actividad de Floodlight de DCM asociado con la conversión de Floodlight (solo premium).
  • Dimensión (ga:dcmFloodlightActivityAndGroup): Nombre de la actividad de Floodlight de DCM y nombre del grupo asociados con la conversión de Floodlight (solo Premium).
  • Dimensión: ga:dcmFloodlightActivityGroup: nombre del grupo de actividades de Floodlight de DCM asociado con la conversión de Floodlight (solo premium).
  • Dimensión: ga:dcmFloodlightActivityGroupId: ID del grupo de actividades de Floodlight de DCM asociado con la conversión de Floodlight (solo premium).
  • Dimensión: ga:dcmFloodlightActivityId: ID de actividad de Floodlight de DCM asociado con la conversión de Floodlight (solo premium).
  • Dimensión: ga:dcmFloodlightAdvertiserId: ID del anunciante de Floodlight de DCM asociado con la conversión de Floodlight (solo premium).
  • Dimensión: ga:dcmFloodlightSpotId: ID de configuración de Floodlight de DCM asociado con la conversión de Floodlight (solo premium).
  • Dimensión: ga:dcmLastEventAd: 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 premium).
  • Dimensión: ga:dcmLastEventAdId: ID 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 Premium).
  • Dimensión: ga:dcmLastEventAdType: 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 premium).
  • 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 Premium).
  • 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 Premium).
  • Dimensión: ga:dcmLastEventAdvertiserId: ID 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 Premium).
  • Dimensión - ga:dcmLastEventAttributionType - Hay dos valores posibles (Clickthrough y Viewthrough) Si el último evento de DCM asociado con la sesión de Google Analytics fue un clic, el valor será Clickthrough. Si el último evento de DCM asociado con la sesión de Google Analytics fue una impresión de anuncios, el valor será posimpresión (solo Premium).
  • Dimensión: ga:dcmLastEventCampaign: Nombre de la campaña 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 Premium).
  • 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) asociado con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmLastEventCreative: Nombre de la 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 Premium).
  • Dimensión: ga:dcmLastEventCreativeId: ID de la 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 Premium).
  • 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 Premium).
  • Dimensión: ga:dcmLastEventCreativeTypeId: ID 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 Premium).
  • 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) asociado con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmLastEventRenderingId: ID de renderización 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 Premium).
  • 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) asociado con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmLastEventSiteId: ID del sitio de DCM 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) asociado con la sesión de Google Analytics (solo Premium).
  • Dimensión: ga:dcmLastEventSitePlacement: Nombre de la 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 Premium).
  • 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 premium).
  • 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) asociado con la sesión de Google Analytics (solo Premium).
  • Métrica: ga:dcmFloodlightQuantity: Es la cantidad de conversiones de Floodlight de DCM (solo con recargo).
  • Métrica: dcmFloodlightRevenue: Ingresos de Floodlight de DCM (solo premium).

En esta versión, se agregaron las nuevas dimensiones y métricas de agrupación de contenido.

Dimensiones y métricas

Revisa la Referencia de dimensiones y métricas para obtener 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 que puede determinarse a través de un código de seguimiento, una coincidencia de regex del título o la URL de la página, o bien reglas predefinidas.
  • Dimensión (ga:previousContentGroupXX): Se refiere al grupo de contenido que se visitó antes que otro grupo de contenido.
  • Métrica: ga:contentGroupUniqueViewsXX: Número de páginas diferentes (únicas) dentro de una sesión para el grupo de contenido especificado. Se tienen en cuenta tanto pagePath como pageTitle para determinar la unicidad.

Esta versión incluye una nueva condición dateOfSession para Segmentos y la incorporación de 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 iniciaron una sesión en un período determinado. Consulta la Guía para desarrolladores de Segmentos a fin de obtener más detalles.

Dimensiones y métricas

Consulte la Referencia de dimensiones y métricas para obtener la lista completa de definiciones para el Comercio electrónico mejorado.

Comercio electrónico mejorado

  • Dimensión: ga:internalPromotionCreative: contenido de la creatividad diseñado para una promoción.
  • Dimensión (ga:internalPromotionId): Es el ID que usas 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 la pantalla de la aplicación.
  • Dimensión (ga:orderCouponCode): Es el 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 (de 1 a 5) en la jerarquía de categorías de productos, comenzando por la parte superior.
  • Dimensión (ga:productCouponCode): Es el 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 el producto.
  • Dimensión (ga:productListPosition): Es la posición del producto en la lista de productos.
  • Dimensión (ga:productVariant): Es la variación específica de un producto, p.ej., XS, S, M y L para el tamaño, o rojo, azul, verde o negro para los colores.
  • Dimensión (ga:checkoutOptions): Indica las opciones del usuario especificadas durante el proceso de confirmación de la compra, p.ej., Puedes usar FedEx, DHL o UPS para opciones de entrega, o Visa, Mastercard o American Express para las opciones de pago. Esta dimensión se debe usar junto con la etapa de compra.
  • Dimensión (ga:shoppingStage): Indica las distintas 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: Es el porcentaje de usuarios que hicieron clic para ver la promoción interna (cantidad de clics / cantidad de veces que apareció la promoción).
  • Métrica: ga:internalPromotionClicks: Es la cantidad de clics en una promoción interna.
  • Métrica: ga:internalPromotionViews: Es la cantidad de vistas de una promoción interna.
  • Métrica: ga:localProductRefundAmount: Importe del reembolso de un producto determinado en la moneda local.
  • Métrica: ga:localRefundAmount: Importe total del reembolso de la transacción en la moneda local.
  • Métrica: ga:productAddsToCart: Cantidad de veces que el producto se agregó al carrito de compras.
  • Métrica: ga:productCheckouts: Cantidad de veces que se incluyó el producto en el proceso de confirmación de la compra.
  • Métrica: ga:productDetailViews: Es la 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: Es la tasa a la que los usuarios hicieron clic en el producto de una lista de productos.
  • Métrica: ga:productRefunds: Es la 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: Cantidad de veces que se quitó el producto de los carritos de compras.
  • Métrica: ga:productRevenuePerPurchase: Indica el promedio de ingresos del producto por compra (se suele usar con el código del cupón de producto).
  • Métrica: ga:buyToDetailRate: Compras únicas divididas por las vistas de las páginas de detalles de los productos.
  • Métrica: ga:cartToDetailRate: Agregados a productos divididos por las vistas de los detalles del producto.
  • Métrica: ga:quantityAddedToCart: Cantidad de unidades de producto que se agregaron al carrito.
  • Métrica: ga:quantityCheckedOut: Cantidad de unidades de producto incluidas en la confirmación de la compra.
  • Métrica: ga:quantityRefunded: Cantidad de unidades de producto reembolsadas.
  • Métrica: ga:quantityRemovedFromCart: Cantidad de unidades de productos que se quitaron del carrito.
  • Métrica (ga:refundAmount): Indica el importe de moneda reembolsado de 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 incorporación de dimensiones y métricas nuevas.

Dimensiones y métricas

Revisa la Referencia de dimensiones y métricas para obtener la lista completa de definiciones.

Sistema

  • Dimensión: ga:sourcePropertyDisplayName: nombre visible de la propiedad fuente de las propiedades de datos integrados. Solo es válido para las propiedades de datos integrados.
  • Dimensión: ga:sourcePropertyTrackingId: ID de seguimiento de la propiedad fuente de las propiedades de datos integrados. Solo es válido para las propiedades de datos integrados.

Agrupación de canales

  • Dimensión (ga:channelGrouping): Es la agrupación de canales predeterminada que se comparte en la vista (perfil).
  • Dimensión (ga:correlationModelId): ID de modelo de correlación de los 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 de los 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 del encabezado

  • Se produjo un error en la versión del 16/04/2014. Si consultó por una dimensión o métrica obsoleta, la API mostrará los encabezados de columna con esa dimensión o métrica de reemplazo. Ahora muestra correctamente el mismo nombre de dimensión o métrica que se usó en la solicitud.

En esta versión, se incluye la adición y el cambio de nombre de las dimensiones y métricas. Revisa la Referencia de dimensiones y métricas para obtener 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.

Tiempo

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

Cambio de nombre de dimensiones y métricas

Todas las métricas y dimensiones basadas en visitantes y visitas cambiaron de nombre para que usen user y session, respectivamente.

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

Público

  • Dimensión (ga:visitorAgeBracket): Utiliza ga:userAgeBracket en su lugar.
  • Dimensión (ga:visitorGender): Utiliza 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áginas

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

Sesión

  • Dimensión (ga:visitLength): Utiliza 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): Utiliza ga:socialInteractionNetworkActionSession en su lugar.
  • Métrica (ga:socialInteractionsPerVisit): Usa ga:socialInteractionsPerSession en su lugar.

Usuario

  • Dimensión (ga:daysSinceLastVisit): Utiliza ga:daysSinceLastSession en su lugar.
  • Dimensión (ga:visitCount): Utiliza ga:sessionCount en su lugar.
  • Dimensión (ga:visitorType): Utiliza ga:userType en su lugar.
  • Dimensión (ga:visitsToTransaction): Utiliza 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 usuarios y secuencias. Los segmentos a 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 los segmentos dinámicos, que puedes 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. Te recomendamos que migrate a la sintaxis nueva lo antes posible.

Esta versión incluye un nuevo formato de respuesta de Tabla de datos, además de la adición y baja de las dimensiones y métricas (consulta la Referencia de dimensiones y métricas para ver la lista completa de definiciones).

Salida de la tabla de datos

Para facilitar la renderización de tus datos de Google Analytics con las visualizaciones de Google Charts, la API puede mostrar de manera opcional un objeto de tabla de datos en la respuesta.

  • Se agregó un parámetro de consulta output opcional 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 Data Table en la respuesta. Este objeto se puede usar directamente con Gráficos de Google. 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:

Tiempo

  • Dimensión (ga:minute): Muestra el minuto en la hora. Los valores posibles están entre 00 y 59.
  • Dimensión: ga:nthMinute: índice para cada minuto del período especificado. El índice correspondiente al primer minuto del primer día (es decir, fecha de inicio) del período es 0, 1 para el siguiente minuto, etcétera.

Público

  • Dimensión: ga:visitorAgeBracket: rango 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 dispuestos a 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 listos para realizar una compra.

Dimensiones y métricas permitidas en los segmentos

Ahora, se pueden usar las siguientes dimensiones y métricas en segmentos:

  • Dimensión: ga:sourceMedium: valores combinados de ga:source y ga:medium.
  • Métrica: ga:localItemRevenue: Ingresos del producto en la moneda local.

Dimensiones y métricas obsoletas

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

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

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

AdSense

  • Se agregó acceso a los datos de AdSense:

    • Cumplido - ga:adsenseRevenue: Son los ingresos totales provenientes de los anuncios de AdSense.
    • Cumplido - ga:adsenseAdUnitsViewed: Muestra la cantidad de unidades de anuncios de AdSense vistas. Una unidad de anuncios es un conjunto de anuncios que se muestran como resultado de un fragmento del código del anuncio de AdSense. Detalles: https://support.google.com/adsense/answer/32715.
    • Cumplido - ga:adsenseAdsViewed: Muestra la cantidad de anuncios de AdSense vistos. Se pueden mostrar varios anuncios en una unidad de anuncios.
    • Cumplido - ga:adsenseAdsClicks: Es la cantidad de veces que se hizo clic en los anuncios de AdSense en tu sitio.
    • Cumplido - ga:adsensePageImpressions: Es la cantidad de vistas de página en las que se mostró un anuncio de AdSense. Una impresión de página puede tener varias unidades de anuncios.
    • Cumplido - ga:adsenseCTR: Es el porcentaje de impresiones de la 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áginas. Son tus ingresos de AdSense por cada 1,000 impresiones de página. (ga:adsenseRevenue/(ga:adsensePageImpressions/1000)).
    • Cumplido - ga:adsenseExits: Es la cantidad de sesiones que finalizaron debido a que un usuario hizo clic en un anuncio de AdSense.

Tiempo

  • Atenuar: ga:isoYear: Es 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 consulta 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 de la zona horaria de la vista (perfil) especificada en la consulta. Consulta la referencia de la API para obtener detalles adicionales.
Nivel de muestreo
  • Se agregó un parámetro nuevo, samplingLevel, que te permite establecer el nivel de muestreo (es decir, la cantidad de visitas que se utilizan para calcular el resultado) para una consulta de informes. Los valores permitidos son DEFAULT, FASTER y HIGHER_PRECISION.
  • Se agregaron 2 campos nuevos a la respuesta de la API: sampleSize y sampleSpace. Puedes utilizar estos valores para calcular el porcentaje de visitas que se usaron para una muestra de respuesta.
  • 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 correspondiente a la API de AdWords AccountInfo.customerId. Esta solució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 Management.
  • Los ID numéricos actuales para los segmentos personalizados dejaron de estar disponibles. Estos IDs heredados se seguirán admitiendo durante 6 meses. Recomendamos a las aplicaciones que guardan IDs de segmentos de usuarios para cambiar a los nuevos IDs alfanuméricos. Una vez que finaliza el período de baja, todas las consultas con los ID numéricos anteriores mostrarán un error.
  • Actualmente, solo se podrá consultar a través del parámetro segment en los segmentos de nivel de visita creados en la interfaz web.
  • Los segmentos predeterminados existentes con ID numéricos negativos no se verán afectados. Sin embargo, por el momento, no se admiten los nuevos segmentos predeterminados.

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

Seguimiento de apps

  • Estos datos se encuentran en los informes de perfil de la app:
    • Atenuado: ga:appId: Es el ID de la aplicación.
    • Atenuar - ga:appInstallerId: Es el 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.
    • Atenuar: ga:appName: Es el nombre de la aplicación.
    • Atenuar: ga:appVersion: Es la versión de la aplicación.
    • Atenuar - ga:exitScreenName: Es el nombre de la pantalla cuando el usuario sale de la aplicación.
    • Atenuar - ga:landingScreenName: Es el nombre de la primera pantalla vista.
    • Atenuar: ga:screenDepth: Es la cantidad de vistas de pantalla por sesión informadas como una cadena. Puede ser útil para los histogramas.
    • Atenuar (ga:screenName): Es el nombre de la pantalla.
    • Cumplido - ga:avgScreenviewDuration: Es la cantidad de tiempo promedio que los usuarios pasaron en una pantalla en segundos.
    • Cumplido - ga:timeOnScreen: Indica el tiempo que se dedica a ver la pantalla actual.
    • Cumplido: ga:screenviews: cantidad total de vistas de pantalla. Usa esto en lugar de ga:appviews.
    • Cumplido - ga:uniqueScreenviews: Indica la cantidad de ga:screenviews diferentes (únicas) en una sesión. Usa esto en lugar de ga:uniqueAppviews.
    • Cumplido: ga:screenviewsPerSession: Es la 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. Usa el nombre de la métrica nueva en su lugar.

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

Columnas o variables personalizadas

  • Acceso a dimensiones y métricas personalizadas:

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

Cambios en la documentación

Se cambió el nombre de la siguiente dimensión y métrica personalizada. Este es solo un cambio en la documentación, no requerirá que actualices tus consultas.

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

Comercio electrónico

  • Atenuado: ga:currencyCode: Es el código de la moneda local de la transacción según la norma ISO 4217.
  • Cumplido - ga:localItemRevenue: Ingresos del producto en la moneda local.
  • Cumplido - ga:localTransactionRevenue: Ingresos por transacciones en la moneda local.
  • Se cumplió el 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.
    • Atenuado: ga:exceptionDescription: Es la descripción de la excepción.
    • Cumplidas - ga:exceptionsPerScreenview: Es la cantidad de excepciones que se arrojan dividida por la cantidad de vistas de pantalla.
    • Cumplido - ga:fatalExceptionsPerScreenview: Es la cantidad de excepciones irrecuperables que se arrojan dividida por la cantidad de vistas de pantalla.

Conversiones de objetivos

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

Cambios en la documentación

Se cambió el nombre de las siguientes dimensiones y métricas de conversiones de objetivos. Este es solo un cambio en la documentación, no requerirá que actualices tus 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 produce una mejora (es decir, una transición) entre palabras clave de la Búsqueda internas en una sesión.

Seguimiento de páginas

  • 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 (los ingresos por transacciones + el valor total del objetivo) dividido por las vistas de página únicas para la página o el conjunto de páginas.

Plataforma o dispositivo

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

    • Atenuar (ga:deviceCategory): Indica el tipo de dispositivo (computadora de escritorio, tablet o dispositivo móvil).
    • Atenuar: ga:isTablet: Indica a los visitantes que usan tablets. Los valores posibles son Yes o No.
    • Atenuado - ga:mobileDeviceMarketingName: Nombre de marketing utilizado para el dispositivo móvil.

Interacciones sociales

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

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

Tiempo

  • Atenuar: ga:dateHour: valores combinados de ga:date y ga:hour.
  • Atenuado - ga:dayOfWeekName: Es el nombre del día de la semana (en inglés).
  • Atenuar: ga:isoWeek: Es el número de semana ISO, en el que 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

  • Atenuar (ga:fullReferrer): Es la URL de referencia completa, incluidos el nombre de host y la ruta.
  • Atenuar: ga:sourceMedium: Son los valores combinados de ga:source y ga:medium.
  • En esta versión, se agregan 5 métricas de velocidad del sitio nuevas:
    • 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 dimensiones y métricas nuevas a la API. Consulta la Referencia de dimensiones y métricas para conocer las definiciones.

Seguimiento de apps

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

Fuentes de tráfico

  • Atenuar: ga:socialNetwork: Es una cadena 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 del centro de datos sociales. P.ej., Google+, Blogger, Reddit, etc.
  • Atenuar: ga:hasSocialSourceReferral: Indica las visitas que llegaron al sitio desde una fuente social (p. ej., una red social como Google+, Facebook, Twitter, etcétera). Los valores posibles son Sí o No, y la primera letra se debe escribir en mayúscula.

Actividades sociales

  • Estos datos provienen de la actividad fuera del sitio importada de socios del Centro de Datos de Social.
    • Atenuar: ga:socialActivityDisplayName: En el caso de una actividad de centro de datos sociales, esta cadena representa el título de la actividad que publicó el usuario de la red social.
    • Atenuar: ga:socialActivityEndorsingUrl: Para una actividad del centro de datos sociales, esta cadena representa la URL de la actividad social (p.ej., la URL de la entrada de Google+, la URL del comentario del blog, etcétera).
    • Atenuar - ga:socialActivityPost: Para una actividad de centro de datos sociales, esta cadena representa el contenido de la actividad social que publica el usuario de la red social (p. ej., el contenido del mensaje de una publicación de Google+).
    • Atenuar: ga:socialActivityTimestamp: En el caso de una actividad del centro de datos sociales, esta cadena representa cuándo se produjo la actividad en la red social.
    • Atenuar (ga:socialActivityUserPhotoUrl): Para una actividad del centro de datos sociales, esta cadena representa la URL de la foto asociada con el perfil de la red social del usuario.
    • Atenuar: ga:socialActivityUserProfileUrl: En el caso de una actividad del centro de datos sociales, esta cadena representa la URL del perfil de la red social del usuario asociado.
    • Atenuar - ga:socialActivityContentUrl: Para una actividad del centro de datos sociales, esta cadena representa la URL que comparte el usuario de la red social asociado.
    • Atenuar - ga:socialActivityTagsSummary: Para una actividad de centro de datos sociales, se trata de un conjunto de etiquetas separadas por comas asociadas con la actividad social.
    • Atenuar: ga:socialActivityUserHandle: En el caso de una actividad de centro de datos sociales, esta cadena representa el identificador de la red social (es decir, el nombre) del usuario que inició la actividad.
    • Atenuar: ga:socialActivityAction: En el caso de una actividad de centro de datos sociales, esta cadena representa el tipo de acción social asociado con la actividad (p. ej., voto, comentario, +1, etcétera).
    • Atenuar: ga:socialActivityNetworkAction: En el caso de una actividad de centro de datos sociales, esta cadena representa el tipo de acción social y la red social en la que se originó.
    • Cumplido - ga:socialActivities: Es el recuento de actividades en las que se compartió o mencionó una URL de contenido en una red asociada del socio del centro de datos sociales.

Interacciones sociales

  • Estos datos provienen del seguimiento de las interacciones en redes sociales en el sitio.
    • Atenuar (ga:socialInteractionAction): En el caso de las interacciones en redes sociales, es una cadena que representa la acción social de la que se hace un seguimiento (p. ej., hacer +1, marcar "Me gusta" o agregar a favoritos).
    • Atenuar: ga:socialInteractionNetwork: Para interacciones en redes sociales, es una cadena que representa la red social de la que se hace un seguimiento (p. ej., Google, Facebook, Twitter, LinkedIn).
    • Atenuar: ga:socialInteractionNetworkAction: En el caso de las interacciones en redes sociales, es una cadena que representa la concatenación de ga:socialInteractionNetwork y ga:socialInteractionAction de las que se hace un seguimiento (p. ej., Google: +1, Facebook: Me gusta).
    • Atenuar: ga:socialInteractionTarget: En las interacciones en redes sociales, es una cadena que representa la URL (o el recurso) que recibe la acción de la red social.
    • Se cumplió: ga:socialInteractions: cantidad total de interacciones en redes sociales en tu sitio.
    • Se cumplió: ga:uniqueSocialInteractions: cantidad total de interacciones sociales únicas en tu sitio. Según el par de valores ga:socialInteractionNetwork y ga:socialInteractionAction
    • Cumplido: ga:socialInteractionsPerVisit, ga:socialInteractions / ga:uniqueSocialInteractions. Es la cantidad promedio de interacciones en redes sociales por visita a su sitio.

Ubicación geográfica y red

  • Atenuar: ga:metro: Es el Área de mercado designada (DMA) desde donde se originó el tráfico.

Seguimiento de páginas

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

Seguimiento de excepciones

  • Estos datos provienen de datos de seguimiento de excepciones.

    • Cumplido - ga:exceptions: indica la cantidad de excepciones que se enviaron a Google Analytics.
    • Cumplido - ga:fatalExceptions: Número de excepciones en las que isFatal se establece como verdadero.

Tiempos de usuario

  • Estos datos provienen de los datos de tiempos del usuario.

    • Atenuar: ga:userTimingCategory: Es una cadena para categorizar todas las variables de tiempo del usuario en grupos lógicos para facilitar la generación de informes.
    • Atenuar: ga:userTimingLabel: Es una cadena para indicar el nombre de la acción del recurso del que se hace un seguimiento.
    • Atenuar: ga:userTimingVariable: Es una cadena que se puede usar para agregar flexibilidad a la hora de visualizar los tiempos de los usuarios en los informes.
    • Atenuar: ga:userTimingValue Es la cantidad de milisegundos en el tiempo transcurrido que se envía a Google Analytics.
    • Cumplido - ga:userTimingSample: La cantidad de muestras que se enviaron.
    • Cumplido: ga:avgUserTimingValue: Es el valor promedio de los tiempos del usuario. ga:userTimiingValue / ga:userTimiingSample.

Dispositivo / plataforma

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

Correcciones de errores

  • Ahora, la API procesa correctamente los caracteres UTF-8 en un filtro o segmento dinámico.

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

En esta versión, se corrigen 2 errores:

Correcciones de errores

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

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

Con esta versión, se agregan 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

Consulta la Referencia de dimensiones y métricas para conocer las definiciones.

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

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

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

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

  • Todas las solicitudes para la versión 2.3 JSON o la biblioteca cliente de JavaScript de datos de Google que usa un resultado de JSON de versión 2.3 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 APIs de Google y uses una clave de API (o un token de OAuth 2.0) en cada solicitud.

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

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

Versión 3.0

  • La versión 3.0 de la API de Core Reporting es la versión principal más reciente 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 en comparación con el archivo XML anterior.
    • Nuevas bibliotecas cliente de la API de Google que admiten 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

    • Nueva URL para realizar solicitudes: https://www.googleapis.com/analytics/v3/data/ga….
    • Se requieren tokens de desarrolladores y registro.
    • Todas las solicitudes de datos de configuración se deben realizar mediante la API de Management.

Versión 2.4

  • La versión 2.4 de la API de Core Reporting es una actualización de versión secundaria que, en su mayoría, es retrocompatible con la versión 2.3 existente de la API de Data Export.

  • Actualizaciones

    • Nueva URL para realizar solicitudes: https://www.googleapis.com/analytics/v2.4/data…
    • Se requieren tokens de desarrolladores y registro.
    • Salida XML coherente con la versión 2.3, por lo que las demás 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
    • No se admiten las respuestas JSON.
    • No se admite la biblioteca cliente de JavaScript de datos de Google.
    • No hay ningún feed de cuentas. Todas las solicitudes de datos de configuración se deben realizar mediante la API de Management.

Registro

  • Todas las aplicaciones compiladas con la API de Google Analytics deben registrarse como un proyecto a través de la Consola de APIs 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 del cliente.

Política de cuotas

  • La siguiente cuota se aplica a ambas APIs de Anlaytics (API de Management y API de Data Export)

    • 50,000 solicitudes diarias por proyecto
    • 10 consultas por segundo (QPS) por dirección IP
  • La siguiente cuota se aplica a la API de Data Export

    • 10,000 solicitudes por perfil por día
    • 10 solicitudes simultáneas por perfil
  • En el caso de las aplicaciones no registradas, proporcionamos una cuota de gracia muy baja para adaptarnos a una pequeña cantidad de pruebas.

Bajas

  • En esta versión, también se anuncia la baja de la versión 2.3 y el próximo cierre del feed de cuentas en la API de Data Export. 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, todas las políticas de cuotas de la versión 2.4 se aplicarán a las solicitudes de la versión 2.3.

    • Las solicitudes al resultado de la versión 2.3 de JSON 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 cuentas en la API de Data Export mostrarán códigos de estado 404 Not Found. Todas las solicitudes de datos de configuración se deben realizar mediante la API de Management.

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

  • Los datos de AdWords se actualizan en una hora. Antes de que los datos se actualizaran diariamente.

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

Hace unas semanas, realizamos un cambio para no permitir las consultas a la API que solicitaban ga:adGroup o ga:adContent con ga:impressions, ya que esta combinación mostró 0. Con este cambio, esta combinación volvió y se corrigió para mostrar los datos correctos.

En esta versión, se corrigen 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 que realizaríamos algunos cambios próximos en la API para inhabilitar algunas consultas no válidas en el feed de datos que no muestran ningún dato. Ya hicimos esos cambios en la API y las siguientes combinaciones ya 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, el valor del intervalo de confianza de las métricas deja de estar disponible.

Baja del intervalo de confianza

  • Si aún no lo hiciste, deja de usar los valores de los intervalos de confianza para las métricas. Con esta versión, el feed de datos de la API de Data Export muestra 0.0 para todos los valores de intervalos de confianza. En un mes aproximadamente, quitaremos por completo este atributo de todos los elementos de las métricas.

    Para determinar si se realizó un muestreo de una respuesta, usa el campo containsSampledData en la respuesta.

En esta versión, se agregan 3 métricas nuevas y se actualiza el valor que se muestra de dos.

Nuevas actualizaciones de datos

  • Agregamos 3 métricas nuevas a la API sobre el rendimiento de la velocidad del sitio:
    • 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 pasó desde el código de seguimiento (p.ej., 1 unidad se especificará como 1).

  • ga:CTR ahora muestra el porcentaje real (p.ej., se muestra un valor de 2% 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 están permitidas en los segmentos avanzados. Consulta la lista actualizada para asegurarte de que tus solicitudes sean válidas.

Próximos cambios

  • Actualmente, debes 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 pasado desde el código de seguimiento (p.ej., 1 unidad se especificará como 1).

  • Actualmente, ga:CTR es percent y muestra el valor 0.02. En un futuro cercano, esto cambiará para 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 códigos de estado 401 para varios problemas de autorización. En las próximas semanas, el estado 401 se usará exclusivamente para los tokens no válidos, lo que brindará a los desarrolladores una forma de manejar los errores con 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 durante el período y ahora admite más combinaciones de dimensiones y métricas.

  • Se agregaron 10 dimensiones nuevas de AdWords: ga:adDistributionNetwork, ga:adMatchType, ga:adMatchedQuery, ga:adPlacementDomain, ga:adPlacementUrl, ga:adFormat, ga:adTargetingType, ga:adTargetingOption, ga:adDisplayUrl, 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úsquedas internas en el sitio.

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

  • Se cambiaron los grupos de dimensiones y métricas para reflejar mejor los componentes que representan.

Nuevas métricas calculadas

Las siguientes métricas calculadas provienen de cálculos que utilizan 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.

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

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

  • Basado en el comercio electrónico: ga:itemsPerPurchase, ga:margin, ga:percentNewVisits, ga:revenuePerItem, ga:revenuePerTransaction, ga:ROI, ga:RPC, ga:totalValue, ga:transactionRevenuePerVisit, ga:transactionsPerVisit.

En esta versión, se agrega una nueva función al feed de datos:

Nuevas funciones

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

En esta versión, se corrigen 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 a los que obtendría si cada filtro se aplicara de forma individual en varias búsquedas. Esto se corrigió y, si usas el operador OR, ahora se muestran valores coherentes.

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

En esta versión, se corrigen 3 errores:

Correcciones de errores

  • Se solucionó un problema de codificación en la biblioteca cliente de JavaScript. Herramienta de seguimiento de errores de Analytics

  • Ya se corrigió un error que impedía que el feed de cuentas no mostrara el nombre, la ruta del objetivo, el valor de comparación de objetivos o el tipo de comparación de objetivos que se habían establecido de forma incorrecta.

  • No es válido el operador OR una dimensión y una métrica en el parámetro del filtro de consulta del feed de datos. Por ejemplo: ga:source==google,ga:visits>5. El mensaje de error para esta consulta no válida se actualizó y ahora 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 en la nueva categoría D8. Adwords:

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

Correcciones de errores

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

En esta versión, se agregan varias funciones nuevas y se corrige un error:

Nuevas funciones

  • Se mejoró el segmento predeterminado de iPhone (gaid::-11) para generar informes sobre 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 que usa la API ahora es la misma que la de la interfaz web. De este modo, los datos de los informes muestreados se intercalan en la interfaz web y se aumenta la coherencia entre ambos.

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

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

Correcciones de errores

  • Corregimos un error sobre cómo la API informaba el valor confidenceInterval de 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 que 0.

  • Anteriormente, ga:itemQuantity y ga:uniquePurchases se intercambiaron y mostraron el valor del otro. Ahora se corrigieron para mostrar los datos correctos.

Recordatorio sobre la baja de las dimensiones y métricas

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

En esta versión, se agregan varias funciones nuevas:

Esta versión incrementa el número de la versión principal a 2.

  • Algunas funciones requieren el uso de las bibliotecas cliente más recientes. Oficialmente, admitimos Java y Javascript. Es posible que aún no se hayan actualizado las bibliotecas de terceros.

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

Compatibilidad con la segmentación avanzada

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

    • expresión ...&segment=dynamic::
    • 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 predeterminados y personalizados:

    • ...&segment=gaid::número
    • donde number es un ID que hace referencia a un segmento avanzado definido en la interfaz web de Google Analytics.
    • Puedes 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.

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

Nuevos datos de objetivos disponibles

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

  • Se agregaron 48 nuevas métricas de objetivos para los objetivos 5 y 20, y todas 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
  • GoalCompletionAll, GoalStartsAll y GoalValueAll se actualizaron para tener en cuenta los nuevos datos del objetivo.

Datos de la nueva variable personalizada

  • 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 del 1 al 5.

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

Las dimensiones y métricas dejaron de estar disponibles y se quitarán

  • Si aún no lo hiciste, deja de usar las dimensiones y métricas que dejaron de estar disponibles. Se quitarán pronto y mostrarán errores de nuestra API si se solicita.

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

Esta versión agrega funciones nuevas y algunas funciones antiguas dejarán de estar disponibles:

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

    • 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.
  • Todos los datos de seguimiento de eventos ahora se exponen como 2 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 a través de las siguientes dimensiones:

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

  • La navegación por la página de destino ahora se muestra a través de las siguientes dimensiones:

    D3. Contenido * ga:landingPagePath * ga:secondPagePath

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

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

    • ga:visitLength

En esta versión, se actualiza la API de Google Analytics Data Export de la siguiente manera:

  • Se redujeron algunas restricciones en las combinaciones de dimensiones y métricas. Ahora puedes buscar la mayor parte del contenido y las dimensiones a nivel del visitante al mismo tiempo. Por ejemplo, ga:pagePath y ga:source ahora son una combinación válida. Consulte la guía de referencia actualizada para estas combinaciones nuevas: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html

  • La cantidad total de filas que se pueden pedir en una solicitud aumentó a 10,000. La cantidad predeterminada de filas que se muestran sigue siendo 1,000, pero ahora se puede aumentar si configuras el parámetro de consulta max-results.

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

  • Ahora aplicamos que las consultas de datos deben incluir al menos una métrica válida.

  • Se aplicaron todos los cambios de baja anteriores.

En esta versión se quitan las funciones obsoletas de nuestra versión beta privada:

  • Las solicitudes de feed de la cuenta ya no admitirán 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 ya no funcionarán. 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:costPerConversion
    • 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 dejarán de funcionar. Verifica que estés usando los nombres oficiales de nuestra documentación: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    dimensiones* ga:subContinentRegion ga:subContinent*