Notas de la versión

En esta página, se incluyen notas de la versión de Display & API de Video 360.

Versión más reciente de la API: v3

15 de agosto de 2024

Nuevas funciones

Se agregó compatibilidad con el tipo Exchange de Netflix.

v3

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    Intercambio

    EXCHANGE_NETFLIX

v2

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    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:

    RecursoCampos
    IdFilter

    adGroupQaIds

    lineItemQaIds

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    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 pedido de inserción recurso. optimizationObjective solo está disponible para los clientes incluidos en la lista de entidades permitidas.

v3

v2

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 enumeración:

    EnumValores
    SdfVersion

    SDF_VERSION_7_1

v2

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    SdfVersion

    SDF_VERSION_7_1

23 de abril de 2024

Nuevas funciones

Se agregó compatibilidad con nuevos tipos de KPI, intercambios y plataformas de apps.

v3

  • Se agregaron los siguientes campos:

    RecursoCampos
    KPI

    kpiAlgorithmId

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    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

28 de febrero de 2024

Nuevas funciones

Se agregó la capacidad de quitar explícitamente miembros de los públicos de Segmentación por clientes.

Se agregó compatibilidad para orientar a intercambios nuevos.

v3

v2

29 de enero de 2024

Nuevas funciones

Se agregó la capacidad de recuperar actividades de Floodlight a través de una nueva Servicio floodlightGroups.floodlightActivities.

Se agregó un nuevo campo que comunica si un canal de YouTube y Línea de pedido de Partners incluye el inventario de Google TV en su segmentación.

Se agregó un nuevo campo para retransmitir la última hora de acceso de una Pantalla y Video 360 usuario.

v3

v2

14 de noviembre de 2023

Nuevas funciones

Se agregó compatibilidad para pasar el consentimiento del usuario final al subir la Segmentación por clientes. miembros del público en todas las versiones publicadas.

v3

v2

31 de octubre de 2023

Nuevas funciones

Se movió v3 de la versión beta pública a la disponibilidad general.

Se cambió el nombre de un valor enum AdGroupFormat en la versión 3 para que sea más preciso. reflejan el formato relevante.

Se agregó compatibilidad con archivos de datos estructurados v7 con la incorporación de la Valor de enumeración SDF_VERSION_7 en las versiones 2 y 3.

v3

  • Se quitaron los siguientes valores de enumeración:

    EnumValores
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    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:

Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 2 a la versión 3.

Se agregó compatibilidad con 3 valores LineItemType nuevos, uno nuevo YoutubeAndPartnersBiddingStrategyType y un elemento nuevo PartnerCostType en las versiones 2 y 3.

v3

v2

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    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 intercambios y dos nuevos YouTube & Socios tipos de estrategias de ofertas.

Se agregó un nuevo campo effectiveContentCategory a YouTube y de Google Partners para mostrar La línea de pedido usa YoutubeAndPartnersContentCategory cuando consideran los valores asignados tanto a nivel del anunciante como de la línea de pedido.

v2

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 enumeración:

    EnumValores
    SdfVersion

    SDF_VERSION_6

v1

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    SdfVersion

    SDF_VERSION_6

9 de marzo de 2023

Nuevas funciones

Se agregó un nuevo valor LineItemWarningMessage que se al campo warningMessages de una línea de pedido si el campo obsoleto excludeFirstPartyAudience se estableció en true Se desactivará el campo excludeFirstPartyAudience y se establecerá en false después del 25 de marzo de 2023.

v2

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 de febrero de 2023

Nuevas funciones

Se agregó la capacidad de recuperar YouTubeAdGroup y YouTubeAdGroupAd y también un grupo de anuncios de YouTube la segmentación de recursos. Además, agregamos nuevas funciones tipos de segmentación recuperables que se usan en los grupos de anuncios de YouTube o a nivel de organización. Lee nuestra nueva página de guía sobre cómo recuperar YouTube y Socios para obtener más información.

Se agregó compatibilidad con cuatro intercambios adicionales en las versiones 1 y 2.

v2

v1

  • Se agregaron los siguientes valores de enumeración:

    EnumValores
    Intercambio

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 de diciembre de 2022

Nuevas funciones

Se movió v2 de la versión beta pública a la disponibilidad general.

Se agregó un nuevo campo assignedTargetingOptionIdAlias al archivo recurso AssignedTargetingOption, que se puede usar en lugar del assignedTargetingOptionId cuando se recupere y borre 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 enumeración. El valor del alias es el valor de enumeración relevante como una cadena.

Se agregó un nuevo campo billingConfig al archivo Advertiser recurso.

Se agregó compatibilidad para recuperar contenido de YouTube y Las líneas de pedido de transmisión libre de socios Se identifica con tres valores LineItemType nuevos.

Se aumentó el tamaño máximo de la página a 200 para varios métodos list en la versión 1 y la 2. El el tamaño de página predeterminado no cambia.

v2

v1

Problemas conocidos

Esta actualización corrige los siguientes problemas conocidos de la versión 2:

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 pedido de inserción parcial para un subconjunto de tipos de segmentación con la adición de create y delete a la advertisers.insertionOrders.targetingTypes.assignedTargetingOptions servicio.

Nuevas funciones

v2

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:

Sigue los pasos que se indican en nuestra guía de migración para migrar de la versión 1 a la versión 2.

Se agregó compatibilidad con tres intercambios nuevos en la versión 1.

Nuevas funciones

v2

A continuación, se incluye una lista de los cambios entre la v1 y la v2:

v1

  • Se agregaron los siguientes valores de enumeración a la versión 1:

    EnumValores
    Intercambio

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 de mayo de 2022

Se agregó la capacidad de crear recursos de InventorySource y administrar GuaranteedOrder recursos a través de nuevas con los métodos de escritura del servicio inventorySources y una nueva servicio de guaranteedOrders.

Se introdujo el campo modelReadiness en el CustomBiddingAlgorithm recurso. Este campo enumera la preparación de la modelo de 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 para recuperar solo las creatividades con un updateTime antes o después de una marca de tiempo determinada.

Se agregó compatibilidad con la versión de SDF más reciente, v5.5, mediante la versión se agrega un valor enum SdfVersion.

Nuevas funciones

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 a InsertionOrder .

Se introdujo el campo raiseBidForDeals en el MaximizeSpendBidStrategy, lo que permite a los usuarios establecer si la oferta en el que se aplican los precios mínimos de los anunciantes para los acuerdos segmentados.

Nuevas funciones

2 de febrero de 2022

Se agregó compatibilidad para crear, actualizar y editar los miembros de ciertas Segmentación por clientes FirstAndThirdPartyAudience. El Sube los públicos de Segmentación por clientes en nuestra nueva plataforma. En la guía Uso de públicos, se detalla cómo utilizar estas nuevas funciones.

Se agregó un nuevo campo reservationType en InsertionOrder y LineItem Recursos que identifican si un recurso es de Etiquetas garantizadas, Programática Garantizadas o no garantizadas.

Se agregó la capacidad de recuperar y establecer si una línea de pedido se segmenta automáticamente. intercambios nuevos mediante un nuevo excludeNewExchanges .

Además de las funciones nuevas, se duplicaron los límites de cuota predeterminados.

Nuevas funciones

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

8 de noviembre de 2021

Se agregó compatibilidad total para administrar algoritmos de ofertas personalizadas y sus secuencias de comandos. Esto incluye lo siguiente:

Se agregó una nueva página para implementar ofertas personalizadas al nuestra guía Cómo administrar líneas de pedido, en la que se describe crear un algoritmo de ofertas personalizadas, subir una secuencia de comandos asignar el algoritmo de ofertas personalizadas como la estrategia de ofertas de una línea de pedido.

Se agregó compatibilidad con la versión de SDF más reciente, v5.4, mediante la se agrega un valor enum SdfVersion.

Nuevas funciones

14 de septiembre de 2021

Se agregó compatibilidad con la orientación por proximidad en los tipos de orientación. TARGETING_TYPE_BUSINESS_CHAIN y TARGETING_TYPE_POI

Se agregó la capacidad de buscar TARGETING_TYPE_BUSINESS_CHAIN y TARGETING_TYPE_POI opciones de segmentación con targetingTypes.targetingOptions.search, ya que no pueden recuperados a través de targetingTypes.targetingOptions.get targetingTypes.targetingOptions.list métodos.

Se agregaron nuevas sharedAdvertiserIds y customBiddingAlgorithmState para las ofertas personalizadas recurso del algoritmo y más compatibilidad con el GOAL_BUILDER_BASED es el tipo de algoritmo de las ofertas personalizadas.

Se agregaron dos valores nuevos a la enum Exchange.

Nuevas funciones

4 de agosto de 2021

Se agregó compatibilidad con Open Measurement habilitado. segmentación por inventario en el tipo de segmentación. TARGETING_TYPE_OMID

Aumento de la cantidad máxima de opciones de segmentación asignadas que se pueden devolver en una sola página de varios anunciantes, campañas, Segmentación asignada por pedido de inserción y línea de pedido de la lista de opciones con el parámetro del método pageSize.

Nuevas funciones

26 de mayo de 2021

Lanzaste el servicio advertisers.invoices, que permite usuarios:

  • 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 a la campaña recurso. Los segmentos de presupuesto de pedido de inserción pueden vincularse Un presupuesto de la campaña, lo que restringe el presupuesto total del segmentos asociados al importe total del presupuesto de la campaña.

Se agregó compatibilidad con segmentación de posición de contenido nativo en la nueva el tipo de segmentación TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Se introdujo un nuevo campo prismaEnabled para el anunciante lo que permite a los usuarios habilitar la integración con la herramienta Prisma de Mediaocean.

Se habilitó la compatibilidad con el valor enum ENTITY_STATUS_PAUSED para Campo entityStatus del anunciante.

Nuevas funciones

29 de abril de 2021

Se agregaron campos nuevos al Canal y Recursos de la lista de palabras clave negativas que devuelven el recuento de líneas usando el recurso para la segmentación. Se habilitó el nuevo filter propiedades del método de lista de líneas de pedido que permiten al usuario Solo recuperar líneas de pedido que usan canales específicos o palabras clave negativas listas en su segmentación.

Nuevas funciones

30 de marzo de 2021

Se agregó un nuevo método al servicio de la línea de pedido que genera un con configuraciones predeterminadas. Estos valores predeterminados se basan en el un tipo de línea de pedido determinado, así como la configuración y la segmentación del pedido de inserción superior.

Se habilitó la recuperación de la segmentación de campaña mediante una un nuevo servicio de segmentación de campañas método de lista masiva adicional.

Se amplió la segmentación de aplicaciones para permitir la segmentación de aplicaciones. en más plataformas.

Se realizaron varios cambios en advertisers.channels.sites, partners.channels.sites y Servicios de advertisers.negativeKeywordLists.negativeKeywords a permiten una administración más sencilla del contenido del canal y de la lista de palabras clave negativas. Estos Entre los cambios, se incluyen los siguientes:

  • La adición de métodos replace, que permite al usuario reemplazar por completo el el contenido existente de un canal o una lista de palabras clave negativas.
  • La eliminación del requisito de que ninguna parte elementos incluidos en la createdSites o createdNegativeKeywords campos de edición masiva solicitudes.
  • El aumento de la cantidad máxima de elementos que se pueden devolver en un solo de una lista de sitios o enumera palabras clave negativas.

Nuevas funciones

Bajas

24 de febrero de 2021

Incorporamos un nuevo servicio de segmentación para pedidos de inserción y método de lista masiva adicional que permite recuperar la segmentación asignada a los pedidos de inserción. Se expandió el recurso creativo, agregando campos de creatividades de solo salida para que los use creatividades de audio de terceros. Se agregaron nuevos tipos de objetivos de rendimiento. para que se use en pedido de inserción y campaña de Google Cloud.

Nuevas funciones

27 de enero de 2021

Se habilitó la recuperación y administración de pedidos de inserción de TV y transmisión libre elementos mediante la introducción de una nuevo campo InsertOrderType y un nuevo valor enum LineItemType. Se agregó compatibilidad con apps para dispositivos móviles a través de un campo de línea de pedido mobileApp. Intercambio, público de Google y Compatibilidad con SDF a través de valores de enumeración adicionales Se introdujo el capacidad para filtrar y ordenar advertisers.list valores según la hora de la actualización más reciente.

Nuevas funciones

4 de diciembre de 2020 .

Se agregó la función para buscar Opciones de segmentación por región geográfica y filtrar varios recursos mostrar los resultados del método según la hora de la última actualización Se introdujo un elemento new LineItemWarningMessage para informar a los usuarios cuándo se produce un la línea de pedido usa la segmentación geográfica que dejó de estar disponible.

Nuevas funciones

5 de noviembre de 2020

Se agregó la capacidad de crear, asignar y activar. activadores manuales que inician líneas de pedido asociadas de gastos operativos. Se introdujeron opciones de expansión de la segmentación que, cuando se establece, puede expandir la segmentación de una línea de pedido para incluir usuarios similares los de los públicos objetivo. Anexó campos de ID de segmentos personalizados a Integral Ad Science y DoubleVerify objetos utilizados en segmentación por verificación de terceros.

Nuevas funciones

12 de octubre de 2020

Se agregaron mensajes de advertencia recuperables en la línea de pedido y un tipo de objetivo de rendimiento de tasa de clics (CTR). Agregado warningMessages como campo filtrable cuando se muestran líneas de pedido

Además de las nuevas funciones, se implementaron nuevos límites de cuota y hay disponible documentación nueva sobre cómo utilizar las solicitudes por lotes.

Nuevas funciones

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

4 de agosto de 2020

Lanzamos nuevos servicios de administración de usuarios, socios y orientación para socios. Se agregaron herramientas para ayudar a los usuarios a evitar de manera proactiva alcanzar los límites de entidades de la cuenta. Se agregó compatibilidad para líneas de pedido de audio y el uso de algoritmos de ofertas personalizadas en las estrategias de ofertas de líneas de pedido y orden de inserción.

Nuevas funciones

24 de junio de 2020

Se lanzó una pequeña actualización en la que se agregó un método de creación para los canales de socio y anunciante, nuevos campos FirstAndThirdPartyAudience y valores de enumeración exchange adicionales.

Nuevas funciones

2 de junio de 2020

Se introdujo la capacidad de crear, aplicar parches y propagar un subconjunto de entidades a las que se puede orientar, 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

27 de abril de 2020

Se lanzó un gran conjunto de funciones, lo que amplió el alcance de la API más allá de SDF. Agregado que 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:

ServicioMétodos
anunciantes

crear

borrar

obtener

lista

parche

advertisers.assets

carga

advertisers.campaigns

crear

borrar

obtener

lista

parche

advertisers.channels

obtener

lista

advertisers.creatives

crear

borrar

obtener

lista

parche

advertisers.insertionOrders

crear

borrar

obtener

lista

parche

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

crear

borrar

obtener

lista

parche

advertisers.lineItems.targetingTypes.assignedTargetingOptions

crear

borrar

obtener

lista

advertisers.locationLists

obtener

lista

advertisers.negativeKeywordLists

obtener

lista

combinedAudiences

obtener

lista

customLists

obtener

lista

firstAndThirdPartyAudiences

obtener

lista

floodlightGroups

obtener

parche

googleAudiences

obtener

lista

inventorySourceGroups

obtener

lista

inventorySources

obtener

lista

partners.channels

obtener

lista

partners.channels

obtener

lista

9 de marzo de 2020

Lanzamiento de campañas de Display & Versión 1 de la API de Video 360. Esta es la versión inicial de la API.

Problemas conocidos

Ninguno