En esta página, se proporcionan notas de la versión de la API de Google Bid Manager.
Versión más reciente de la API: v2
20 de noviembre de 2024
Nuevas funciones
Se inicia FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. Esto permite la inclusión de datos de confianza más bajos para las métricas con los siguientes prefijos:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
Cuando se usa este filtro, se debe incluir una de las métricas relevantes.
En el lanzamiento, las búsquedas que no incluyan este filtro tendrán el comportamiento predeterminado anterior de solo incluir datos de alta confianza. A partir del 4 de febrero de 2025, las consultas que no incluyan este filtro incluirán, de forma predeterminada, datos con menor confianza.
v2
Se agregaron los siguientes filtros:
Tipo de filtro Valores disponibles FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: Incluye datos con menor confianza. (Predeterminada después del 4 de febrero de 2025)1: Solo incluye datos de alta confianza. (Opción predeterminada antes del 4 de febrero de 2025)
1 de octubre de 2024
Nuevas funciones
Ninguno
Problemas conocidos
v2
Desactivación de la dimensión de informes de modelado de inventario anónimo (AIM)
La dimensión FILTER_ANONYMOUS_INVENTORY_MODELING es puesta del sol.
La creación o ejecución de recursos Query con valores de desactivación en params.groupBy muestra un error 400.
Las métricas de DST/ROC (costos operativos regulatorios) y costo total de medios dejaron de ser compatibles con los informes de YOUTUBE.
Ya no se pueden usar los siguientes valores de métricas en los informes YOUTUBE:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
Si creas o ejecutas recursos Query con un params.type de YOUTUBE y un valor de métrica relevante en params.metrics, se muestra un error 400.
1 de mayo de 2024
Nuevas funciones
Ninguno
Problemas conocidos
v2
Desactivación de los informes de atribución de rutas y de rutas completas
Los informes de Ruta completa y Ruta de atribución dejarán de estar disponibles. Recuperar o crear estos tipos de recursos Query y Report genera un error.
Los siguientes valores de ReportType son de puesta del sol:
FULL_PATHPATH_ATTRIBUTION
El campo pathQueryOptions del objeto Options también es de puesta de sol.
28 de febrero de 2024
Nuevas funciones
Ninguno
Problemas conocidos
v2
Desactivación de los valores de las métricas de conversiones en dispositivos múltiples
Las métricas de conversiones en dispositivos múltiples dejarán de estar disponibles. Se incluyen los siguientes valores de métricas de la API de Bid Manager:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 de julio de 2022
Nuevas funciones
Se lanzó la versión 2 de la API de Bid Manager.
Se realizaron cambios estructurales en la API, incluida la actualización del extremo del servicio y el cambio de nombre de los servicios y métodos.
Se actualizaron significativamente los recursos de Query y Report quitando campos innecesarios, reorganizando los existentes y cambiando sus tipos. Esto incluye cambiar los tipos de campo para usar objetos nombrados en lugar de una definición general de "objeto anidado".
Se requiere ejecutar consultas ad hoc con el método queries.run en lugar de que se ejecuten automáticamente después de la creación.
Se reemplazó el parámetro de consulta queries.run asynchronous por synchronous.
Se simplificó la recuperación de informes mediante los siguientes cambios:
- La adición de un método
queries.reports.get - La adición de un parámetro de consulta
orderByaqueries.reports.list - La actualización del cuerpo de la respuesta
queries.runde un objeto vacío a una instancia del recursoReportgenerado
Se actualizaron los mensajes de error que devuelve la API para que sean más específicos y proporcionen soluciones más prescriptivas.
Sigue las instrucciones que se presentan en la Guía de migración a la versión 2 para migrar de la versión 1.1 a la 2.
v2
Se cambió el extremo del servicio:
Extremo de servicio v1 Extremo de servicio v2 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comSe cambió el nombre de los servicios de la siguiente manera:
Servicio v1 Servicio de v2 Búsquedas consultas Informes queries.reports Se cambió el nombre de los métodos de la siguiente manera:
Se agregaron los siguientes métodos:
Servicio Métodos queries.reports get Los siguientes métodos tienen un cuerpo de respuesta nuevo:
Método Nuevo objeto de cuerpo de respuesta queries.run Informe Se quitaron los siguientes campos:
Recurso Campos Cuerpo de la respuesta de queries.listkind
Cuerpo de la respuesta de queries.reports.listkind
Consulta kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
El tipo de objeto de los siguientes campos cambió a lo siguiente:
Recurso Campos Tipo de objeto Consulta Informe RunQueryRequest Se agregaron los siguientes parámetros de consulta de métodos:
Método Parámetros de consulta queries.list orderBy queries.reports.list orderBy queries.run síncrono Se quitaron los siguientes parámetros de consulta de métodos:
Método Parámetros de consulta queries.create asíncrono queries.run asíncrono Se agregaron los siguientes valores de filtro:
Valor del filtro FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Se quitaron los siguientes valores de filtro:
Valor del filtro FILTER_TRUEVIEW_IAR_REGION Se agregaron los siguientes valores de métricas:
Valor de la métrica METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
Problemas conocidos
Ninguno
Versiones anteriores
Para obtener información sobre las versiones anteriores de la API de Bid Manager para las versiones que dejarán de estar disponibles, consulta nuestras notas de la versión archivadas.