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 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 Management que podrían afectar a 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

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

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

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

Incluye la API de Management y la API de aprovisionamiento.

Registro de cambios de la API de Management
–
Suscribirse rss

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

Ahora es posible configurar de manera programática la configuración de retención de datos del usuario mediante los nuevos campos “dataRetainTtl” 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 o aplicar parches) para los recursos de propiedad web, vista (perfil) y objetivos ya no requieren una inclusión en la lista blanca. 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 corrección de errores que soluciona el problema por el que la creación de una métrica personalizada del tipo TIME fallaba cuando no se configuraba min_value. Las solicitudes sin 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 por 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 referencia de vistas (perfiles). - El artículo del Centro de ayuda Referencia de monedas

Esta versión agrega públicos de remarketing a la API de Management.

Públicos de remarketing

La API de Management te permite segmentar los públicos de remarketing create, get, list, update y patch para una propiedad de Google Analytics. Si deseas 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 utiliza el mismo sistema de tokens por propiedad y por día que cuando 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 informes pueden ver el vínculo de descarga del 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 causaba 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 versión, la propiedad currency de View (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 antes 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 se deben reemplazar 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 cuando se creaba un objetivo con "comparisonValue": "0".

Esta versión marca la baja y la eliminación finales del recurso dailyUpload. El recurso dailyUpload dejó de estar disponible oficialmente el 20 de junio de 2014. Ahora, toda la importación de datos de costos se debe realizar con el recurso de cargas.

En esta versión, se agregan dos colecciones nuevas a la API de Management: Dimensiones personalizadas y Métricas personalizadas.

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. Revisa la referencia de la API para obtener detalles completos sobre las consultas y respuestas de 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 de usuario de Google Analytics.

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

El recurso View (Profile) 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 sobre la Importación de datos para obtener detalles sobre cómo usar la API de Management para importar datos a tu cuenta de Google Analytics.

Cargas

  • 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 método migrateDataImport nuevo para migrar los datos de costos existentes customDataSources.

Baja de las cargas diarias

  • El recurso dailyUpload dejó de estar disponible. 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 muestrear solo están disponibles 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:

  • Ahora la API admite segmentos de usuarios y secuencias.
  • La colección 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 nueva sintaxis de segmentos. Esto incluye las definiciones de los segmentos existentes a nivel de 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 (proporcionado por Google Analytics).

Experiments

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

  • ga:adsenseAdsClicks: Indica la cantidad de veces que se hizo clic en los anuncios de AdSense en tu sitio.
  • ga:adsenseAdsViewed: Indica 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 la baja de las dimensiones ga:isMobile y ga:isTablet:

  • El nombre del segmento gaid::-11 cambió de Tráfico de dispositivos móviles a Tráfico de 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 definición nueva. Si solo desea obtener tráfico en 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 las zonas horarias de las vistas (perfiles) es coherente con la que se configura en la interfaz de administrador de Google Analytics.

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

API de configuración y configuración de cuentas

  • Ahora es posible crear, actualizar, aplicar parches y borrar vistas (perfiles). Revisa la referencia de Vistas (perfiles) para obtener detalles sobre los métodos nuevos.
  • Ahora es posible crear y actualizar las propiedades y los objetivos web, así como aplicar parches. Revisa la referencia de propiedades web y la referencia de objetivos para obtener detalles sobre los nuevos métodos.
  • Ahora se puede solicitar una sola propiedad web, vista (perfil) o 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

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

  • Todos los IDs de segmento cambiarán de números enteros positivos a cadenas alfanuméricas. Si guardaste los IDs de segmento de los 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 de visitante, cohorte y secuencia nuevos.
  • La colección Segmentos seguirá mostrando los segmentos predeterminados existentes con los mismos ID numéricos negativos. Sin embargo, por el momento, 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 la 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 de 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.

Esta versión agrega 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 de los experimentos del Optimizador de sitios web de Google ya no se incluyen en sus colecciones correspondientes.

En esta versión, se agregan dos versiones nuevas de la API con muchas funciones nuevas y se da de baja la versión anterior. 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 compatible con versiones anteriores. Todo el desarrollo futuro de la API se realizará en esta versión.

  • Datos nuevos

    • Representación completa de los objetivos del 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
    • Parámetros de 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 una 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 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 es compatible con la biblioteca cliente de JavaScript de datos de Google
    • 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.

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 Google Analytics Data Export. Se actualizaron las bibliotecas de Google Data Java y JavaScript. Se puede acceder a cada feed especificando el URI del feed correspondiente en el método getManagementFeed() de las bibliotecas.

Nueva documentación

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