Registro de cambios de la API de Google Analytics Management

Actualizamos la API de Management de Google Analytics de forma periódica 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 APIs. Sin embargo, ocasionalmente debemos realizar cambios que requieren que los desarrolladores modifiquen sus aplicaciones existentes.

En esta página, se documentan los cambios realizados en la API de Management de Google Analytics 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 mediante los feeds que se indican en la sección Suscribirse más abajo.

Suscribirse a los registros de cambios relacionados

Todos los registros de cambios de la API de Google Analytics
–
Suscribirse rss

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

Todos los registros de cambios de la API de configuración
–
Suscribirse rss

Incluye la API de Management y la API de Provisioning.

Registro de cambios de la API de Management
–
Suscribirse rss

Configuración de la retención de datos del usuario en la API de Management

Ahora es posible establecer de manera programática la configuración de la retención de datos del usuario con los nuevos campos "dataRetentionTtl" y "dataRetentionResetOnNewActivity" agregados al recurso WebProperty.

Operaciones de escritura en la API de Management

Las operaciones de escritura en la API de Management (p.ej., crear, actualizar, borrar, aplicar parches) para los recursos de propiedad web, vista (perfil) y objetivo ya no requieren listas blancas. El límite diario predeterminado para todas las operaciones de escritura en la API de Management es de 50 escrituras por día. Consulta la página Límites y cuotas para obtener más información.

Custom Metrics

Esta es una versión con correcciones de errores. En ella, se soluciona el problema por el que la creación de una métrica personalizada de tipo TIME no se configuraba cuando no se configuraba min_value. Las solicitudes sin un min_value ahora crean una métrica personalizada con un min_value predeterminado de 0.

Monedas

Esta es una versión con correcciones de errores. En ella se soluciona un problema en el que se admitía un subconjunto de monedas en la interfaz web de Analytics, pero no en la API. Esta versión agrega compatibilidad con las siguientes monedas:

  • UAH, AED, BOB, CLP, COP, EGP, HRK, ILS, MAD, MYR, PEN, PKR, RON, RSD, SAR, SGD, VEF, LVL

Para obtener más información, consulta la siguiente página: - La referencia de Vistas (perfiles). - El artículo del Centro de ayuda Referencia de monedas

En esta versión, se agregan públicos de remarketing a la API de Management.

Público de remarketing

La API de Management te permite create, get, list, update y patch públicos de remarketing para una propiedad de Google Analytics. Para obtener más información sobre cómo funcionan los públicos de remarketing, consulta el artículo del Centro de ayuda Acerca de los públicos de remarketing en Analytics.

Informes sin muestrear

La API de informes sin muestrear ya no tiene un límite de 100 informes por día. La API usa el mismo sistema de tokens por propiedad y por día que cuando se crea un informe sin muestrear a través de la interfaz web.

Informes sin muestrear

Los informes sin muestrear a los que no pueda acceder el usuario actual ya no tendrán un vínculo de descarga dentro del mensaje de respuesta de la API de Management. Este comportamiento ahora es coherente con la funcionalidad del panel de la IU, en la que solo los propietarios de los informes pueden ver el vínculo para descargar el documento generado.

Segmentos

Esta es una versión con correcciones de errores. En esta versión, se soluciona un problema que hacía que los segmentos con valores de moneda en la definición aparecieran incorrectamente cuando se llamaba al método de lista de segmentos.

Segmentos

Esta es una versión con correcciones de errores. En esta versión, se soluciona un problema que provocaba que los usuarios con segmentos privados fijados en varias vistas (perfiles) obtuvieran una respuesta de error 500 cuando llamaban al método de lista de segmentos.

Vistas (perfiles)

Con esta actualización, la propiedad currency de vista (perfil) ahora se establecerá de forma predeterminada en USD si no se establece durante una operación de inserción. Además, las operaciones get y list mostrarán USD en las vistas (perfiles) que se crearon anteriormente sin una propiedad currency.

Filtros

Esta versión marca la eliminación final de los campos de filtro obsoletos IS_MOBILE y IS_TABLET, que deben reemplazarse por DEVICE_CATEGORY=mobile y DEVICE_CATEGORY=tablet. Las solicitudes de inserción, actualización y aplicación de parches que establecen los campos de filtro para usar IS_MOBILE y IS_TABLET mostrarán un error.

Filtros

En esta versión, se agregó compatibilidad para usar una dimensión personalizada en un campo de filtro. Para ello, se agregó una propiedad fieldIndex a todas las secciones de detalles del filtro. Por ejemplo, ahora es posible configurar la expresión de filtro con "field": "CUSTOM_DIMENSION" y "fieldIndex": "1" para que el filtro funcione en la primera dimensión personalizada.

Objetivos

En esta versión, también se soluciona un problema que se producía al crear un objetivo con "comparisonValue": "0".

En esta versión, se marcarán la baja y la eliminación definitiva del recurso dailyUpload. El recurso dailyUpload dejó de estar disponible oficialmente el 20 de junio de 2014. Todas las importaciones de datos de costos deberían realizarse mediante el recurso de cargas.

En esta versión, se agregan dos colecciones nuevas a la API de Management: Custom Dimensions y Custom Metrics.

Dimensiones y métricas personalizadas

Ahora es posible crear, enumerar, obtener, aplicar parches y actualizar dimensiones y métricas personalizadas con la API de Management.

La respuesta del método list para todas las colecciones ahora incluye una lista vacía para la propiedad items cuando la colección no contiene recursos. Anteriormente, la propiedad items se omitía de la respuesta. Consulta la referencia de la API para obtener detalles completos sobre consultas y respuestas para los datos de configuración de Google Analytics.

En esta versión, se presenta un nuevo alcance para la API de Google Analytics Management. - analytics.manage.users.readonly - Consulta los permisos del usuario de Google Analytics.

Se agregó un nuevo campo de filtros de DEVICE_CATEGORY, y IS_MOBILE y IS_TABLET dejaron de estar disponibles. Usa DEVICE_CATEGORY=mobile y DEVICE_CATEGORY=tablet.

El recurso Vista (perfil) ahora incluye una propiedad enhancedECommerceTracking que indica si el Comercio electrónico mejorado está habilitado (true) o inhabilitado (false).

Esta versión incluye nuevos tipos de importación de datos y el recurso dailyUpload dejó de estar disponible.

Importación de datos

Consulta la Guía para desarrolladores de Importación de datos para obtener información detallada sobre cómo usar la API de Management para importar datos a tu cuenta de Google Analytics.

Videos subidos

  • El recurso upload ahora admite los siguientes tipos de carga:
    • Datos de la campaña
    • Datos del contenido
    • Datos de costos
    • Datos del producto
    • Datos de reembolso
    • Datos del usuario
  • El recurso upload tiene un nuevo método migrateDataImport para migrar los datos de costos existentes customDataSources.

Baja de las cargas diarias

  • El recurso dailyUpload ahora está obsoleto. Consulta la Guía de migración para obtener detalles sobre cómo migrar para usar la función de Importación de datos.
  • El recurso dailyUpload seguirá funcionando durante seis meses más. A partir de ese momento, cualquier customDataSources restante con la propiedad uploadType establecida en analytics#dailyUploads se migrará automáticamente y solo funcionará con el recurso upload.
  • Los usuarios actuales del recurso dailyUpload deben actualizar su código y migrar para usar el recurso Carga lo antes posible.

En esta versión, se agregan dos APIs de configuración nuevas.

Filtros

Informes sin muestrear: API de Management

Se agregará un nuevo recurso a la API de Management llamado Informes sin muestrear. Los informes sin muestrear son informes de Google Analytics (GA) que se generaron con datos sin muestrear.Actualmente, los informes sin muestreo están disponibles solo para los usuarios de GA Premium. 

Segmentos: API de Management v2.4 y v3.0

Se realizaron los siguientes cambios en la Colección de segmentos:

  • Los segmentos de usuario y secuencia ahora son compatibles con la API.
  • La colección de segmentos ahora muestra todos los segmentos integrados y personalizados a nivel de sesión y nivel de usuario.
  • La propiedad definition para los segmentos ahora usará la sintaxis nueva de segmentos. Esto incluye las definiciones de los segmentos existentes a nivel de la sesión, que cambiarán de definition: "" a definition: "sessions::condition::".
  • Se agregó una nueva propiedad type al recurso Segment para indicar si un segmento es CUSTOM (es decir, creado por un usuario en la interfaz web) o BUILT_IN (es decir, proporcionado por Google Analytics).

Experimentos

Las siguientes métricas de AdSense ahora se pueden usar como objetivos de optimización:

  • ga:adsenseAdsClicks: Es la cantidad de veces que se hizo clic en los anuncios de AdSense en tu sitio.
  • ga:adsenseAdsViewed: Es la cantidad de anuncios de AdSense vistos. Se pueden mostrar varios anuncios en una unidad de anuncios.
  • ga:adsenseRevenue: Son los ingresos totales provenientes de los anuncios de AdSense.

Nueva colección de resúmenes de cuentas

Se realizaron los siguientes cambios en los segmentos predeterminados debido a que las dimensiones ga:isMobile y ga:isTablet dejaron de estar disponibles:

  • El nombre del segmento gaid::-11 cambió de Tráfico en dispositivos móviles a Tráfico en dispositivos móviles y tablets. La definición de este segmento se cambió de ga:isMobile==Yes a ga:deviceCategory==mobile,ga:deviceCategory==tablet. Ten en cuenta que ga:isMobile incluía tráfico de tablets, lo que se refleja en la nueva definición. Si solo desea obtener tráfico de dispositivos móviles, sin incluir las tablets, cambie al nuevo segmento Tráfico en dispositivos móviles (gaid::-14).
  • La definición del segmento gaid::-13 cambió de ga:isTablet==Yes a ga:deviceCategory==tablet. Esto sigue representando el tráfico de tablets.
  • Se agregó el segmento gaid::-14. El nombre del segmento es Tráfico en dispositivos móviles y la definición es ga:deviceCategory==mobile.

Correcciones de errores:

  • Se corrigió la información de zona horaria de las vistas (perfiles). Detalles: Antes de esta corrección, en algunos casos, cuando se enumeraban las vistas (perfiles) en la API de Management, se mostraba información incorrecta de la zona horaria de una vista (perfil). Ahora la información de la zona horaria de las vistas (perfiles) es coherente con la configuración de la interfaz de administrador de Google Analytics.

En esta versión, se presentan las operaciones de escritura para los recursos de propiedad web, vista (perfil) y objetivos, así como un conjunto de 3 recursos nuevos que permiten la administración de permisos del usuario.

API de configuración de cuentas

  • Ahora es posible crear, actualizar, aplicar parches y borrar vistas (perfiles). Consulta la referencia de Vista (perfiles) para obtener detalles sobre los métodos nuevos.
  • Ahora es posible crear y actualizar las propiedades web y los objetivos, así como aplicarles parches. Para obtener detalles sobre los métodos nuevos, consulta la referencia de propiedades web y la referencia de objetivos.
  • Ahora se puede solicitar una sola propiedad web, una vista (perfil) o un objetivo con el método get.
  • Actualmente, estas funciones están disponibles como vista previa para desarrolladores en versión beta limitada. Si te interesa registrarte, solicita acceso a la versión beta.

Permisos del usuario en la API de Management

  • El nuevo recurso accountUserLinks permite administrar los permisos de las cuentas de los usuarios.
  • El nuevo recurso webpropertyUserLinks permite administrar los permisos de propiedad de los usuarios.
  • El nuevo recurso profileUserLinks habilita la administración de los permisos de vista (perfil) para los usuarios.
  • Los permisos para un usuario autorizado ahora están disponibles como parte de los recursos Cuenta, Propiedad web y Vista (perfil).
  • Se introdujo un nuevo alcance, que es necesario para administrar los permisos del usuario. https://www.googleapis.com/auth/analytics.manage.users.
  • Para obtener más información, consulta la Guía para desarrolladores de Permisos del usuario.

Como parte del lanzamiento de nuevos segmentos, lanzaremos los siguientes cambios en la colección de segmentos:

  • Todos los IDs de segmento se cambiarán de números enteros positivos a cadenas alfanuméricas. Si guardaste los IDs de segmento de usuarios, te recomendamos que los actualices para usar los IDs nuevos.
  • La colección de segmentos solo mostrará los segmentos existentes a nivel de la visita. Actualmente, la API no admite los segmentos nuevos de visitante, cohorte y secuencia.
  • La colección de segmentos seguirá mostrando los segmentos predeterminados existentes con los mismos ID numéricos negativos; sin embargo, actualmente no se admiten los segmentos predeterminados nuevos.

En esta versión, se agregan 2 propiedades nuevas al recurso de propiedad web:

  • profileCount: Muestra el recuento de perfiles de una propiedad. Esto te permite filtrar propiedades que no tienen ningún perfil (es decir, profileCount = 0).
  • industryVertical: Muestra la vertical o categoría de la industria seleccionada para una propiedad.

Correcciones de errores:

  • La propiedad eCommerceTracking del recurso de perfil ahora es coherente con la configuración de comercio electrónico de la sección Administrador de la interfaz web. Muestra true cuando el seguimiento de comercio electrónico está habilitado y false si no lo está.
  • El recurso Webproperty ahora incluye una propiedad level para indicar si la propiedad web es PREMIUM o STANDARD.
  • Se agregó un extremo nuevo a la API de Management v3 para acceder a los recursos de Experimentos y modificarlos.
  • El recurso de perfil ahora incluye una propiedad type para identificar si un perfil está configurado para un sitio web o una app. Los dos valores posibles son WEB o APP.

En esta versión, se agregan respuestas de error útiles a la API de Management.

  • Se agregaron nuevos códigos de error, motivos y descripciones al cuerpo de las respuestas de error de la API. Se documentaron todos los códigos para las versiones 2.4 y 3.0 de la API de Management.

Esta versión agrega datos, cambia las funciones existentes y corrige un error.

Datos nuevos

  • La colección de segmentos avanzados ahora contiene un campo segmentId que se puede usar en el parámetro segmento de la API de Data Export.

Cambios

  • Se cambió el tipo de datos de max-results a integer.

  • El valor máximo predeterminado y máximo de max-results se cambió a 1,000.

Correcciones de errores

  • Las cuentas, las propiedades web y los perfiles para los experimentos del Optimizador de sitios web de Google ya no se incluyen en sus colecciones correspondientes.

En esta actualización, se agregan dos versiones nuevas de la API con muchas funciones nuevas, y la versión anterior queda obsoleta. Los cambios afectan la forma en que solicitas y manejas los datos de la API.

Versión 3.0

  • Esta es la versión principal más reciente de nuestra API y no es retrocompatible. Todo el desarrollo futuro de la API se realizará en esta versión.

  • Datos nuevos

    • Representación completa de los objetivos de evento
    • Un ID de propiedad web interno que se puede utilizar para establecer un vínculo directo a la interfaz de usuario de Google Analytics
    • Configuración del perfil para los parámetros predeterminados de búsqueda de páginas y sitios

  • Cambios

Versión 2.4

  • Esta es una actualización de versión secundaria que, en su mayoría, es retrocompatible con la versión 2.3 existente.

  • Cambios

    • Una política de cuotas nueva
    • Integración en la Consola de APIs de Google para administrar el acceso a las APIs y solicitar más cuota
    • Compatibilidad continua con los mecanismos de autorización existentes y OAuth 2.0
    • Nueva URL para realizar solicitudes: https://www.googleapis.com/analytics/v2.4/management/…
    • Respuestas solo en XML
    • No se admite la biblioteca cliente de Google Data JavaScript
    • Salida de XML coherente con la versión 2.3, por lo que las otras bibliotecas cliente de datos de Google existentes seguirán funcionando.

Baja

  • Anunciamos que la versión heredada 2.3 de la API de Management dejará de estar disponible. Continuará funcionando durante dos meses; después de ese plazo, todas las solicitudes v2.3 mostrarán una respuesta v2.4.

Esta es la versión beta de la API de Google Analytics Management.

Feeds nuevos

Bibliotecas cliente actualizadas

  • La API de Management se lanzará en la misma biblioteca que la API de Data Export de Google Analytics. Se actualizaron las bibliotecas de Java y JavaScript de Google. Para acceder a cada feed, especifica el URI del feed apropiado en el método getManagementFeed() de las bibliotecas.

Nueva documentación

  • Se creó una nueva sección de los documentos para desarrolladores de Google Analytics que describe cómo funciona la nueva API de Management.