En esta página, se proporcionan notas de la versión de la API de Display & Video 360.
Versión más reciente de la API: v3
22 de octubre de 2024
Nuevas funciones
Se agregó compatibilidad con el objetivo de rendimiento de costo por vista.
Se agregó la capacidad de establecer y recuperar la segmentación de dispositivos conectados.
Se agregó una nueva configuración de seguridad de la marca de Adloox en la segmentación de verificadores externos.
Se agregó compatibilidad para descargar archivos de datos estructurados v8, que actualmente se encuentra en versión beta cerrada.
v3
Se agregaron los siguientes campos:
Objeto Campos AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentSe agregaron los siguientes valores de enum:
Enum Valores DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
Valores obsoletos
Se quitó la compatibilidad con SDF v5.5 debido a que dejará de estar disponible el 3 de octubre de 2024.
v3
Los siguientes valores de enum dejaron de estar disponibles:
Enum Valores SdfVersionSDF_VERSION_5_5
15 de agosto de 2024
Nuevas funciones
Se agregó compatibilidad con el tipo Exchange de Netflix.
v3
Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_NETFLIX
v2
Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_NETFLIX
15 de julio de 2024
Nuevas funciones
Se agregó compatibilidad para descargar archivos de datos estructurados de líneas de pedido y grupos de anuncios en formato de QA en la versión 3.
v3
Se agregaron los siguientes campos:
Recurso Campos IdFilter Se agregaron los siguientes valores de enum:
Enum Valores FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 de junio de 2024
Nuevas funciones
Se agregó compatibilidad para administrar la segmentación por palabras clave asignada a nivel del anunciante.
Se agregó un nuevo campo optimizationObjective al recurso de pedido de inserción. optimizationObjective solo está disponible para los clientes incluidos en la lista de entidades permitidas.
v3
Se agregaron los siguientes campos:
Recurso Campos InsertionOrder Los siguientes métodos ahora admiten los siguientes tipos de segmentación:
Tipo de orientación Métodos TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Los siguientes métodos ahora admiten los siguientes tipos de segmentación:
Tipo de orientación Métodos TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 de mayo de 2024
Nuevas funciones
Se agregó compatibilidad con la versión 7.1 de los archivos de datos estructurados (SDF).
v3
Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion SDF_VERSION_7_1
v2
Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion SDF_VERSION_7_1
23 de abril de 2024
Nuevas funciones
Se agregó compatibilidad con nuevos tipos de KPI, intercambios y plataformas de aplicaciones.
v3
Se agregaron los siguientes campos:
Recurso Campos KPI Se agregaron los siguientes valores de enum:
Enum Valores AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Intercambio EXCHANGE_DRAX
KpiType KPI_TYPE_CPCL
KPI_TYPE_CPCV
KPI_TYPE_CPV
KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST
KPI_TYPE_MAXIMIZE_PACING
KPI_TYPE_TOS10
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
v2
Se agregaron los siguientes valores de enum:
Enum Valores AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Intercambio EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 de febrero de 2024
Nuevas funciones
Se agregó la capacidad de quitar miembros de forma explícita de los públicos de Segmentación por clientes.
Se agregó compatibilidad para segmentar anuncios para nuevos mercados.
v3
Se agregaron los siguientes campos:
Recurso Campos firstAndThirdPartyAudiences.editCustomerMatchMembers Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Se agregaron los siguientes campos:
Recurso Campos firstAndThirdPartyAudiences.editCustomerMatchMembers Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 de enero de 2024
Nuevas funciones
Se agregó la capacidad de recuperar actividades de Floodlight a través de un nuevo servicio floodlightGroups.floodlightActivities.
Se agregó un nuevo campo que indica si una línea de pedido de YouTube y socios incluye el inventario de Google TV en su segmentación.
Se agregó un campo nuevo para transmitir la última hora de acceso de un usuario de Display & Video 360.
v3
Se agregaron los siguientes métodos:
Servicio Métodos floodlightGroups.floodlightActivities Se agregaron los siguientes campos:
Recurso Campos Usuario YoutubeAndPartnersInventorySourceConfig
v2
Se agregaron los siguientes métodos:
Servicio Métodos floodlightGroups.floodlightActivities Se agregaron los siguientes campos:
Recurso Campos Usuario YoutubeAndPartnersInventorySourceConfig
14 de noviembre de 2023
Nuevas funciones
Se agregó compatibilidad para pasar el consentimiento del usuario final cuando se suben miembros del público de la Segmentación por clientes en todas las versiones publicadas.
v3
Se agregaron los siguientes campos:
Recurso Campos ContactInfoList MobileDeviceIdList
v2
Se agregaron los siguientes campos:
Recurso Campos ContactInfoList MobileDeviceIdList
31 de octubre de 2023
Nuevas funciones
Se quitó la versión 3 de la fase beta pública y se pasó a la disponibilidad general.
Se cambió el nombre de un valor de enum AdGroupFormat en la versión 3 para reflejar con mayor precisión el formato relevante.
Se agregó compatibilidad con los archivos de datos estructurados v7 con la incorporación del valor de enumeración SDF_VERSION_7 en las versiones 2 y 3.
v3
Se quitaron los siguientes valores de enum:
Enum Valores AdGroupFormat AD_GROUP_FORMAT_ACTION
Se agregaron los siguientes valores de enum:
Enum Valores AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion SDF_VERSION_7
2 de octubre de 2023
Nuevas funciones
Se lanzó la versión 3 en versión beta pública, que incluye los siguientes cambios:
- La capacidad de administrar por completo las listas de ubicaciones de proximidad, lo que permite usar el servicio
advertisers.locationLists.assignedLocationspara crear y borrar ubicaciones asignadas a recursosTARGETING_LOCATION_TYPE_PROXIMITYLocationList - Un nuevo campo booleano
enableOptimizedTargeting, que reemplaza el campotargetingExpansionLevelen el objetoTargetingExpansionConfig - El requisito del campo
billingConfigen el recursoAdvertiser, que se debe incluir cuando se realizan solicitudesadvertisers.create, y un nuevo campobillingConfigen el recursoPartner - Nuevos recursos
AdGroupyAdGroupAdque reemplazan los recursosYoutubeAdGroupyYoutubeAdGroupAden la versión 2.
Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 2 a la 3.
Se agregó compatibilidad con 3 valores nuevos de LineItemType, un YoutubeAndPartnersBiddingStrategyType nuevo y un PartnerCostType nuevo en las versiones 2 y 3.
v3
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Se quitaron los siguientes métodos:
Servicio Métodos advertisers.manualTriggers activar
create
desactivar
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Cambió el comportamiento del siguiente método:
Método Cambios advertisers.locationLists.create Ahora admite la creación de recursos LocationListTARGETING_LOCATION_TYPE_PROXIMITY.advertisers.locationLists.patch Ahora admite la actualización de recursos LocationListdeTARGETING_LOCATION_TYPE_PROXIMITY.advertisers.locationLists.assignedLocations.bulkEdit Ahora se admite la edición masiva de los recursos AssignedLocationen los recursosLocationListdeTARGETING_LOCATION_TYPE_PROXIMITY.advertisers.locationLists.assignedLocations.create Ahora admite la creación de recursos AssignedLocationen recursosLocationListTARGETING_LOCATION_TYPE_PROXIMITY.Se agregaron los siguientes parámetros de consulta:
Método Parámetros inventorySources.get Se volvieron obligatorios los siguientes campos:
Recurso Campos Anunciante Se agregaron los siguientes campos:
Recurso Campos BiddingStrategy InsertionOrder Socio TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Se quitaron los siguientes campos:
Recurso Campos InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Se agregaron los siguientes valores de enum:
Enum Valores CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Se quitaron los siguientes valores de enum:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Se agregaron los siguientes valores de enum:
Enum Valores LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
25 de agosto de 2023
Nuevas funciones
Se agregó compatibilidad con dos mercados y dos nuevos tipos de estrategias de ofertas de YouTube y socios.
Se agregó un nuevo campo effectiveContentCategory a las líneas de pedido de YouTube y socios para mostrar el YoutubeAndPartnersContentCategory que usa la línea de pedido cuando se consideran los valores asignados a nivel del anunciante y de la línea de pedido.
v2
Se agregaron los siguientes campos:
Recurso Campos YoutubeAndPartnersSettings Se quitaron los siguientes campos:
Recurso Campos InventorySource subSitePropertyId
Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
5 de junio de 2023
Nuevas funciones
Se agregó un nuevo valor SdfVersion para los archivos de datos estructurados (SDF) v6 en las versiones 1 y 2.
v2
Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion SDF_VERSION_6
v1
Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion SDF_VERSION_6
9 de marzo de 2023
Nuevas funciones
Se agregó un nuevo valor LineItemWarningMessage que se asignará al campo warningMessages de un elemento de una sola línea si tiene el campo excludeFirstPartyAudience obsoleto establecido en true. El campo excludeFirstPartyAudience dejará de estar disponible y se establecerá en false después del 25 de marzo de 2023.
v2
Se agregaron los siguientes valores de enum:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Se agregaron los siguientes valores de enum:
Enum Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 de febrero de 2023
Nuevas funciones
Se agregó la capacidad de recuperar recursos YouTubeAdGroup y YouTubeAdGroupAd, así como la segmentación de recursos de grupos de anuncios de YouTube. Además, agregamos nuevos tipos de segmentación recuperables que se usan a nivel de los grupos de anuncios de YouTube. Para obtener más información, consulta nuestra nueva página de guía sobre cómo recuperar recursos de YouTube y socios.
Se agregó compatibilidad con cuatro mercados adicionales en las versiones 1 y 2.
v2
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Se agregaron los siguientes campos:
Servicio Métodos AssignedTargetingOption YoutubeAndPartnersSettings Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Se agregaron los siguientes valores de enum:
Enum Valores Intercambio EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 de diciembre de 2022
Nuevas funciones
Se quitó la versión 2 de la fase beta pública y se pasó a la disponibilidad general.
Se agregó un nuevo campo assignedTargetingOptionIdAlias al recurso AssignedTargetingOption, que se puede usar en lugar de assignedTargetingOptionId cuando se recupera y borra la segmentación.
Este campo solo se establece para las opciones de segmentación asignadas de los tipos de segmentación que se asignan a través de enum. El valor del alias es el valor de enumeración relevante como una cadena.
Se agregó un nuevo campo billingConfig al recurso Advertiser.
Se agregó compatibilidad para recuperar las líneas de pedido de YouTube y socios de transmisión continua, que se identifican con tres valores nuevos de LineItemType.
Se aumentó el tamaño máximo de la página a 200 para varios métodos list en las versiones 1 y 2. El tamaño de página predeterminado no se modifica.
v2
Se agregaron los siguientes campos:
Recurso Campos Anunciante AssignedTargetingOption Se agregaron los siguientes valores de enum:
Enum Valores LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
v1
Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
Problemas conocidos
Esta actualización corrige los siguientes problemas conocidos de la versión 2:
- No se pudieron quitar ni recuperar las opciones de segmentación asignadas de los tipos de segmentación que se asignaban con valores de enum en la versión 2 con su
assignedTargetingOptionId, sino que se esperaba que los usuarios usaran el valor de enum. Con esta actualización, estas opciones de segmentación asignadas se pueden quitar o recuperar conassignedTargetingOptionIdo el valor de enumeración, identificado por el nuevo campoassignedTargetingOptionIdAliasen el recursoAssignedTargetingOption. - La solicitud de línea de pedido
bulkUpdateno usaba correctamente el parámetro de solicitudadvertisersId, por lo que se mostraba un error. Con esta actualización, se corrigió el método y se cambió el nombre del parámetro de solicitud deadvertisersIdaadvertiserId.
27 de octubre de 2022
Se agregó la capacidad de duplicar una línea de pedido existente dentro del elemento superior InsertionOrder.
Se introdujo la compatibilidad con la escritura de segmentación de orden de inserción parcial para un subconjunto de tipos de segmentación con la adición de los métodos create y delete al servicio advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.
Nuevas funciones
v2
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
No se agregaron funciones nuevas a la versión 1.
20 de Septiembre de 2022
Se lanzó la versión 2 en versión beta pública, que incluye los siguientes cambios:
- La capacidad de recuperar las líneas de pedido de YouTube & Partners y su configuración de segmentación con los métodos
getylisten los serviciosadvertisers.lineItemsyadvertisers.lineItems.targetingTypes.assignedTargetingOptions - Dos nuevos métodos de segmentación masiva en el servicio
advertisers.lineItemsque permiten editar y recuperar la segmentación asignada en varias líneas de pedido con una sola solicitud. - Un nuevo método
bulkUpdateque permite a los usuarios actualizar elentityStatusde varias líneas de pedido en una sola solicitud. - Nueva lógica de segmentación que requiere que los recursos
AssignedTargetingOptionde un subconjunto de tipos de segmentación se asignen y recuperen con valores de enum en lugar de los IDs de opción de segmentación que se recuperan con el serviciotargetingTypes.targetingOptions.
Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 1 a la 2.
Se agregó compatibilidad con tres mercados nuevos en la versión 1.
Nuevas funciones
v2
La siguiente es una lista de los cambios entre la versión 1 y la 2:
Se agregaron los siguientes métodos en la versión 2:
Servicio Métodos advertisers.lineItems bulkEditAssignedTargetingOptions
Se quitaron los siguientes métodos en la versión 2:
Servicio Métodos advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Se cambió el nombre de los siguientes métodos en la versión 2:
Servicio Nombre del método anterior Nombre del método nuevo advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions socios bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Los recursos
AssignedTargetingOptionde los siguientes tipos de segmentación usan enums para la asignación de segmentación en la versión 2. El campoassignedTargetingOptionIdpara los recursosAssignedTargetingOptionde estos tipos de segmentación también se actualizó en la versión 2 para usar versiones de cadena de los valores de enum:Tipo de orientación Tipo de enumeración TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Entorno TARGETING_TYPE_EXCHANGE Intercambio TARGETING_TYPE_GENDER Género TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Visibilidad Se agregaron los siguientes campos en la versión 2:
Se quitaron los siguientes campos en la versión 2:
Los siguientes campos se volvieron obligatorios en la versión 2:
Se agregaron los siguientes valores de enum en la versión 2:
Enum Valores AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Intercambio EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Se quitaron los siguientes valores de enum en la versión 2:
Enum Valores LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Se agregaron los siguientes valores de enum en la v1:
Enum Valores Intercambio EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 de mayo de 2022
Se agregó la capacidad de crear recursos InventorySource y administrar recursos GuaranteedOrder a través de nuevos métodos de escritura de servicios inventorySources y un nuevo servicio guaranteedOrders.
Se introdujo el campo modelReadiness en el recurso CustomBiddingAlgorithm. En este campo, se indica el nivel de preparación del modelo del algoritmo para cada anunciante que puede acceder a él.
Se habilitó la nueva funcionalidad del parámetro de consulta filter para el método advertisers.creatives.list, que permite al usuario recuperar solo las creatividades con un updateTime antes o después de una marca de tiempo determinada.
Se agregó compatibilidad con la versión más reciente del SDF, v5.5, a través de la adición de un valor de enumeración SdfVersion.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos guaranteedOrders inventorySources Se agregaron los siguientes campos:
Recurso Campos CustomBiddingAlgorithm InventorySource Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion Los siguientes métodos de lista ahora se pueden filtrar por las siguientes propiedades:
Método Campos advertisers.creatives.list
31 de marzo de 2022
Se agregó compatibilidad para recuperar y configurar la segmentación en duración del contenido, tipo de transmisión y género.
Se agregó el campo billableOutcome al objeto InsertionOrder.
Se agregó el campo raiseBidForDeals al objeto MaximizeSpendBidStrategy, lo que permite a los usuarios establecer si la estrategia de ofertas aplica precios mínimos del anunciante para las ofertas segmentadas.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Se agregaron los siguientes valores de enum:
Enum Valores TargetingType
2 de febrero de 2022
Se agregó compatibilidad para crear, actualizar y editar miembros de ciertos recursos de Segmentación por clientes FirstAndThirdPartyAudience. En la página Sube públicos de Segmentación por clientes de nuestra nueva guía Cómo utilizar públicos, se detalla cómo usar estas nuevas funciones.
Se agregó un nuevo campo reservationType en los recursos InsertionOrder y LineItem que identifica si un recurso tiene garantía de etiquetas, garantía programática o no tiene garantía.
Se agregó la capacidad de recuperar y establecer si una línea de pedido segmenta automáticamente
excambios nuevos a través de un nuevo campo excludeNewExchanges.
Además de las funciones nuevas, se duplicaron los límites de cuota predeterminados.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos firstAndThirdPartyAudiences Se agregaron los siguientes campos:
Recurso Campos FirstAndThirdPartyAudience InsertionOrder LineItem
8 de diciembre de 2021
Se agregó compatibilidad con la segmentación por tipo de contenido de audio en el tipo de segmentación TARGETING_TYPE_AUDIO_CONTENT_TYPE.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption TargetingOption Se agregaron los siguientes valores de enum:
Enum Valores TargetingType
8 de noviembre de 2021
Se agregó compatibilidad total para administrar algoritmos de ofertas personalizadas y sus secuencias de comandos. Esto incluye lo siguiente:
- Funciones para create
customBiddingAlgorithmsnuevos y actualizar los existentes. - La capacidad de subir secuencias de comandos a través del proceso de recuperación de una ubicación de recursos disponible y, luego, subir el archivo a esa ubicación.
- Un nuevo servicio
customBiddingAlgorithms.scriptspara recuperar y createcustomBiddingScripts.
Se agregó una nueva página Implementa ofertas personalizadas a nuestra guía Cómo administrar líneas de pedido, en la que se describe el proceso para crear un algoritmo de ofertas personalizadas, subir una secuencia de comandos y asignarlo como la estrategia de ofertas de una línea de pedido.
Se agregó compatibilidad con la versión más reciente de SDF, v5.4, a través de la adición de un valor de enumeración SdfVersion.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos customBiddingAlgorithms customBiddingAlgorithms.scripts media Se agregaron los siguientes valores de enum:
Enum Valores SdfVersion
14 de septiembre de 2021
Se agregó compatibilidad con la segmentación por proximidad en los tipos de segmentación TARGETING_TYPE_BUSINESS_CHAIN y TARGETING_TYPE_POI.
Se agregó la capacidad de buscar opciones de segmentación disponibles para TARGETING_TYPE_BUSINESS_CHAIN y TARGETING_TYPE_POI con targetingTypes.targetingOptions.search, ya que no se pueden recuperar a través de los métodos targetingTypes.targetingOptions.get o targetingTypes.targetingOptions.list.
Se agregaron los nuevos campos sharedAdvertiserIds y customBiddingAlgorithmState al recurso de algoritmo de ofertas personalizadas y se agregó compatibilidad con el tipo de algoritmo de ofertas personalizadas GOAL_BUILDER_BASED.
Se agregaron dos valores nuevos a la enumeración Exchange.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Cuerpo de la solicitud de TargetingOptions.search Se agregaron los siguientes valores de enum:
Enum Valores CustomBiddingAlgorithmType Intercambio TargetingType Los siguientes métodos de lista ahora se pueden filtrar según las siguientes propiedades:
Método Campos customBiddingAlgorithms.list
4 de agosto de 2021
Se agregó compatibilidad con la segmentación del inventario habilitada para Open Measurement en el tipo de segmentación TARGETING_TYPE_OMID.
Se aumentó la cantidad máxima de opciones de segmentación asignadas que se pueden mostrar en una sola página de varios métodos de lista de opciones de segmentación asignados de anunciante, campaña, pedido de inserción y línea de pedido con el parámetro de método pageSize.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption TargetingOption Se agregaron los siguientes valores de enum:
Enum Valores TargetingType Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
26 de mayo de 2021
Se lanzó el servicio advertisers.invoices, que permite a los usuarios hacer lo siguiente:
- recuperar las facturas emitidas a un anunciante durante un mes determinado.
- Buscar el código de moneda que utiliza un anunciante durante un mes determinado
Se agregó el campo campaignBudgets al recurso de la campaña. Los segmentos de presupuesto del pedido de inserción se pueden vincular a un presupuesto de campaña, lo que restringe la suma del presupuesto de los segmentos asociados al importe total del presupuesto de la campaña.
Se agregó compatibilidad con la segmentación por posición de contenido nativo en el nuevo tipo de segmentación TARGETING_TYPE_NATIVE_CONTENT_POSITION.
Se agregó un nuevo campo prismaEnabled al recurso del anunciante, lo que permite a los usuarios habilitar la integración con la herramienta Prisma de Mediaocean.
Se habilitó la compatibilidad con el valor de enumeración ENTITY_STATUS_PAUSED en el campo entityStatus del anunciante.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.invoices Se agregaron los siguientes campos:
Recurso Campos Anunciante AssignedTargetingOption TargetingOption Se agregaron los siguientes valores de enum:
Enum Valores AssignedTargetingOption.Recency Intercambio TargetingType Los siguientes valores de enumeración ahora son válidos para los siguientes campos:
Recurso Campo Valores Anunciante entityStatus ENTITY_STATUS_PAUSED
29 de abril de 2021
Se agregaron campos nuevos a los recursos de Canal y Lista de palabras clave negativas que muestran el recuento de elementos de línea que usan el recurso para la segmentación. Se habilitaron nuevas propiedades filter para el método de lista de líneas de pedido que permiten al usuario recuperar solo las líneas de pedido que usan canales específicos o listas de palabras clave negativas en su segmentación.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Canal Los siguientes métodos de lista ahora se pueden filtrar según las siguientes propiedades:
Método Campos advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 de marzo de 2021
Se agregó un método nuevo al servicio de línea de pedido que genera una línea de pedido con configuraciones predeterminadas. Estos valores predeterminados se basan en el tipo de línea de pedido determinado, así como en la configuración y la segmentación asignada del pedido de inserción superior.
Se habilitó la recuperación de la segmentación de la campaña a través de un nuevo servicio de segmentación de campañas y un método de lista masiva adicional.
Se expandió la segmentación por aplicación para permitir la segmentación de aplicaciones en más plataformas.
Se realizaron varios cambios en los servicios advertisers.channels.sites, partners.channels.sites y advertisers.negativeKeywordLists.negativeKeywords para permitir una administración más sencilla del contenido de los canales y las listas de palabras clave negativas. Entre estos cambios, se incluyen los siguientes:
- La adición de métodos
replace, que permite a un usuario reemplazar por completo el contenido existente de un canal o una lista de palabras clave negativas. - Se quitó el requisito de que no se incluyan elementos existentes en los campos
createdSitesocreatedNegativeKeywordsde las solicitudes de edición masiva. - El aumento de la cantidad máxima de elementos que se pueden mostrar en una sola página de una respuesta de lista de sitios o lista de palabras clave negativas.
Nuevas funciones
Se agregaron los siguientes métodos:
Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption.AppAssignedTargetingOptionDetails Se aumentó el tamaño máximo de página para los siguientes métodos de lista:
Método Tamaño máximo de página anterior Nuevo tamaño máximo de página advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Bajas
Ya no se pueden asignar los siguientes valores de enumeración a recursos nuevos o existentes:
Enum Valores PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 de febrero de 2021
Se introdujo un nuevo servicio de segmentación de pedidos de inserción y un método de lista masiva adicional que permite recuperar la segmentación asignada a los pedidos de inserción. Se expandió el recurso de creatividad y se agregaron campos de creatividad de solo resultados para que los usen las creatividades de audio de terceros. Se agregaron nuevos tipos de objetivos de rendimiento para que los usen los recursos de orden de inserción y campaña.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Se agregaron los siguientes campos:
Recurso Campos Creatividad Se agregaron los siguientes valores de enum:
Enum Valores ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 de enero de 2021
Se habilitó la recuperación y administración de pedidos de inserción de TV y líneas de pedido de transmisión por Internet mediante la introducción de un nuevo campo InsertionOrderType y un nuevo valor de enumeración LineItemType. Se agregó compatibilidad con las líneas de pedido de aplicaciones para dispositivos móviles a través de un campo de línea de pedido mobileApp.
Se expandió la compatibilidad con exchange, google audience y SDF a través de valores de enumeración adicionales. Se introdujo la
posibilidad de filtrar y ordenar los valores de advertisers.list
según la hora de la última actualización.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos InsertionOrder LineItem Se agregaron los siguientes valores de enum:
Enum Valores Intercambio GoogleAudienceType LineItemType SdfVersion Los siguientes métodos de lista ahora se pueden ordenar y filtrar por los siguientes campos:
Método Campos anunciantes
4 de diciembre de 2020 .
Se agregó la capacidad de buscar opciones de segmentación de región geográfica y filtrar los resultados de varios métodos de lista de recursos por la hora de la última actualización. Se introdujo un nuevo LineItemWarningMessage para informar a los usuarios cuándo una línea de pedido usa la segmentación geográfica obsoleta.
Nuevas funciones
Se agregaron los siguientes métodos:
Servicio Métodos targetingTypes.targetingOptions Se agregaron los siguientes valores de enum:
Enum Valores Intercambio LineItemWarningMessage Los siguientes métodos de lista ahora se pueden ordenar y filtrar por los siguientes campos:
Método Campos advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 de noviembre de 2020
Se agregó la capacidad de crear, asignar y activar activadores manuales que inician la inversión de las líneas de pedido asociadas. Se introdujeron las opciones de expansión de la segmentación que, cuando se configuran, pueden expandir la segmentación de una línea de pedido para incluir a usuarios similares a los de los públicos segmentados. Se agregaron campos de ID de segmento personalizados a los objetos de DoubleVerify y Integral Ad Science que se usan en la segmentación de verificación de terceros.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos advertisers.manualTriggers Se agregaron los siguientes campos:
Recurso Campos AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Se agregaron los siguientes valores de enum:
Enum Valores LineItemFlightDateType Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.lineItems.list
12 de octubre de 2020
Se agregaron mensajes de advertencia recuperables al recurso de línea de pedido y un tipo de objetivo de rendimiento de tasa de clics (CTR). Se agregó warningMessages como campo filtrable cuando se muestran las líneas de pedido.
Además de las nuevas funciones, ahora están vigentes nuevos límites de cuota y hay disponible nueva documentación sobre el uso de solicitudes por lotes.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos LineItem Se agregaron los siguientes valores de enum:
Enum Valores PerformanceGoalType Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.lineItems.list
28 de agosto de 2020
Se agregaron campos nuevos a la respuesta del método de auditoría del anunciante y nuevos campos filtrables a varios métodos de lista.
Nuevas funciones
Se agregaron los siguientes campos:
Recurso Campos Cuerpo de la respuesta de Advertisers.Audit Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 de agosto de 2020
Se lanzaron nuevos servicios de administración de usuarios, socios y segmentación de socios. Se introdujeron herramientas para ayudar a los usuarios a evitar de forma proactiva alcanzar los límites de entidades de la cuenta. Se agregó compatibilidad con las líneas de pedido de audio y el uso de algoritmos de ofertas personalizados en las estrategias de ofertas de líneas de pedido y pedidos de inserción.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos customBiddingAlgorithms socios partners.targetingTypes.assignedTargetingOptions users Se agregaron los siguientes métodos:
Servicio Métodos anunciantes Se agregaron los siguientes campos:
Recurso Campos MaximizeSpendBidStrategy PerformanceGoalBidStrategy Se agregaron los siguientes valores de enum:
Enum Valores BiddingStrategyPerformanceGoalType LineItemType Los siguientes métodos de lista ahora se pueden ordenar y filtrar por los siguientes campos:
Método Campos advertisers.lineItems.list Se agregaron los siguientes permisos para usar en los siguientes servicios:
Alcance Servicios https://www.googleapis.com/auth/display-video-user-management
24 de junio de 2020
Se lanzó una pequeña actualización que agrega un método de creación para los canales de socios y anunciantes, nuevos campos FirstAndThirdPartyAudience y valores adicionales de enumeración exchange.
Nuevas funciones
Se agregaron los siguientes servicios:
Servicio Métodos advertisers.channels partners.channels Se agregaron los siguientes campos:
Recurso Campos FirstAndThirdPartyAudience Se agregaron los siguientes valores de enum:
Enum Valores Intercambio Los siguientes métodos de lista ahora se pueden filtrar por los siguientes campos:
Método Campos advertisers.creatives.list
2 de junio de 2020
Se introdujo la capacidad de crear, parchear y propagar un subconjunto de entidades segmentables, y se agregó la capacidad de modificar la segmentación a nivel del anunciante para tres tipos de segmentación: canal, exclusión de etiquetas de contenido digital y exclusión de categorías sensibles.
Nuevas funciones
Se agregaron los siguientes servicios:
Se agregaron los siguientes métodos:
Servicio Métodos anunciantes advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Se agregaron los siguientes campos:
Recurso Campos anunciante creatividad insertionOrder.insertionOrderBudgetSegment
27 de abril de 2020
Se lanzó un gran conjunto de funciones, lo que expandió el alcance de la API más allá de SDF. Se agregó la administración de recursos principales, que te permite crear, recuperar, actualizar y borrar entidades, como anunciantes, campañas, pedidos de inserción, líneas de pedido y creatividades. Las nuevas funciones también permiten editar la segmentación a nivel de la línea de pedido.
Nuevas funciones
Se agregaron los siguientes servicios:
9 de marzo de 2020
Se lanzó la versión 1 de la API de Display & Video 360. Esta es la versión inicial de la API.
Problemas conocidos
Ninguno