Release Notes

This page provides release notes for the Display & Video 360 API.

Latest API version: v3

August 15, 2024

New Features

Added support for Netflix Exchange type.

v3

  • The following enum values have been added:

    EnumValue(s)
    Exchange

    EXCHANGE_NETFLIX

v2

  • The following enum values have been added:

    EnumValue(s)
    Exchange

    EXCHANGE_NETFLIX

July 15, 2024

New Features

Added support for downloading Line Item and Ad Group Structured Data Files in QA format in v3.

v3

June 17, 2024

New Features

Added support for managing keyword targeting assigned at the advertiser level.

Added new optimizationObjective field to the insertion order resource. optimizationObjective is only available to allowlisted customers.

v3

v2

May 30, 2024

New Features

Added support for Structured Data Files (SDF) version 7.1.

v3

  • The following enum values have been added:

    EnumValue(s)
    SdfVersion

    SDF_VERSION_7_1

v2

  • The following enum values have been added:

    EnumValue(s)
    SdfVersion

    SDF_VERSION_7_1

April 23, 2024

New Features

Added support for new KPI types, exchanges, and app platforms.

v3

  • The following fields have been added:

    ResourceField(s)
    Kpi

    kpiAlgorithmId

  • The following enum values have been added:

    EnumValue(s)
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Exchange

    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

February 28, 2024

New Features

Added the ability to explicitly remove members from customer match audiences.

Added support for targeting new exchanges.

v3

v2

January 29, 2024

New Features

Added the ability to retrieve Floodlight activities through a new floodlightGroups.floodlightActivities service.

Added a new field communicating whether a YouTube & Partners line item includes Google TV inventory in its targeting.

Added a new field to relay the last login time for a Display & Video 360 user.

v3

v2

November 14, 2023

New Features

Added support for passing end-user consent when uploading Customer Match audience members in all live versions.

v3

v2

October 31, 2023

New Features

Moved v3 out of public beta and into general availability.

Renamed an AdGroupFormat enum value in v3 to more accurately reflect the relevant format.

Added support for Structured Data Files v7 with the addition of the SDF_VERSION_7 enum value in v2 and v3.

v3

  • The following enum values have been removed:

    EnumValue(s)
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • The following enum values have been added:

    EnumValue(s)
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • The following enum values have been added:

    EnumValue(s)
    SdfVersion

    SDF_VERSION_7

October 2, 2023

New Features

Released v3 in public beta, which includes the following changes:

Follow the steps in our migration guide to migrate from v2 to v3.

Added support for 3 new LineItemType values, one new YoutubeAndPartnersBiddingStrategyType, and one new PartnerCostType in v2 and v3.

v3

v2

August 25, 2023

New Features

Added support for two exchanges and two new YouTube & Partners bidding strategy types.

Added a new effectiveContentCategory field to YouTube & Partners line items to surface the YoutubeAndPartnersContentCategory used by the line item when considering values assigned at both the advertiser and line item level.

v2

June 5, 2023

New Features

Added a new SdfVersion value for Structured Data Files (SDF) v6 in v1 and v2.

v2

  • The following enum values have been added:

    EnumValue(s)
    SdfVersion

    SDF_VERSION_6

v1

  • The following enum values have been added:

    EnumValue(s)
    SdfVersion

    SDF_VERSION_6

March 9, 2023

New Features

Added a new LineItemWarningMessage value that will be assigned to a line item's warningMessages field if it has the deprecated excludeFirstPartyAudience field set to true. The excludeFirstPartyAudience field will be sunset and set to false after March 25, 2023.

v2

  • The following enum values have been added:

    EnumValue(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • The following enum values have been added:

    EnumValue(s)
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

February 8, 2023

New Features

Added the ability to retrieve YouTubeAdGroup and YouTubeAdGroupAd resources, as well as YouTube Ad Group resource targeting. In addition, we've also added new retrievable targeting types used on the YouTube Ad Groups level. Read our new guide page on retrieving YouTube & Partners resources for more information.

Added support for four additional exchanges in v1 and v2.

v2

v1

  • The following enum values have been added:

    EnumValue(s)
    Exchange

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

December 6, 2022

New Features

Moved v2 out of public beta and into general availability.

Added a new assignedTargetingOptionIdAlias field to the AssignedTargetingOption resource, which can be used in place of the assignedTargetingOptionId when retrieving and deleting targeting. This field is only set for assigned targeting options of targeting types that are assigned via enum. The alias value is the relevant enum value as a string.

Added a new billingConfig field to the Advertiser resource.

Added support for retrieving YouTube & Partners over-the-top line items, identified by three new LineItemType values.

Increased the max page size to 200 for numerous list methods in v1 and v2. The default page size is unchanged.

v2

v1

Known issues

This update fixes the following known issues in v2:

October 27, 2022

Added the ability to duplicate an existing line item within the parent InsertionOrder.

Introduced partial insertion order targeting write support for a subset of targeting types with the addition of create and delete methods to the advertisers.insertionOrders.targetingTypes.assignedTargetingOptions service.

New Features

v2

v1

No new features have been added to v1.

September 20, 2022

Released v2 in public beta, which includes the following changes:

Follow the steps in our migration guide to migrate from v1 to v2.

Added support for three new exchanges in v1.

New Features

v2

The following is a list of changes between v1 and v2:

v1

  • The following enum values have been added in v1:

    EnumValue(s)
    Exchange

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

May 26, 2022

Added the ability to create InventorySource resources and manage GuaranteedOrder resources through new inventorySources service write methods and a new guaranteedOrders service.

Introduced the modelReadiness field in the CustomBiddingAlgorithm resource. This field lists the readiness of the algorithm's model for each advertiser that can access it.

Enabled new filter query parameter functionality for the advertisers.creatives.list method that allows the user to only retrieve creatives with an updateTime before or after a given timestamp.

Added support for the newest SDF version, v5.5, through the addition of an SdfVersion enum value.

New Features

March 31, 2022

Added support for retrieving and setting targeting on content duration, stream type, and genre.

Added the billableOutcome field to the InsertionOrder object.

Introduced the raiseBidForDeals field to the MaximizeSpendBidStrategy object, letting users set whether the bidding strategy applies advertiser floor prices for targeted deals.

New Features

February 2, 2022

Added support for creating, updating, and editing members of certain Customer Match FirstAndThirdPartyAudience resources. The Upload Customer Match Audiences page in our new Use Audiences guide details how to use these new features.

Introduced a new reservationType field in InsertionOrder and LineItem resources that identifies whether a resource is Tag Guaranteed, Programmatic Guaranteed, or not guaranteed.

Added the ability to retrieve and set whether a line item automatically targets new exchanges through a new excludeNewExchanges field.

In addition to new features, default quota limits have been doubled.

New Features

December 8, 2021

Added support for audio content type targeting under the targeting type TARGETING_TYPE_AUDIO_CONTENT_TYPE.

New Features

November 8, 2021

Added full support for managing custom bidding algorithms and their scripts. This includes:

A new Implement Custom Bidding page has been added to our Managing Line Items guide that describes the process of creating a custom bidding algorithm, uploading a script, and assigning the custom bidding algorithm to be as a line item's bidding strategy.

Added support for the newest SDF version, v5.4, through the addition of an SdfVersion enum value.

New Features

September 14, 2021

Added support for proximity targeting under targeting types TARGETING_TYPE_BUSINESS_CHAIN and TARGETING_TYPE_POI.

Added the ability to search for available TARGETING_TYPE_BUSINESS_CHAIN and TARGETING_TYPE_POI targeting options using targetingTypes.targetingOptions.search, as they cannot be retrieved via targetingTypes.targetingOptions.get or targetingTypes.targetingOptions.list methods.

Introduced new sharedAdvertiserIds and customBiddingAlgorithmState fields to the Custom Bidding Algorithm resource and added support for the GOAL_BUILDER_BASED custom bidding algorithm type.

Added a two new values to the Exchange enum.

New Features

August 4, 2021

Added support for Open Measurement enabled inventory targeting under the targeting type TARGETING_TYPE_OMID.

Increased the maximum number of assigned targeting options that can be returned in a single page of various advertiser, campaign, insertion order, and line item assigned targeting option list methods using the pageSize method parameter.

New Features

May 26, 2021

Launched the advertisers.invoices service, which lets users:

  • retrieve invoices issued to an advertiser during a given month.
  • lookup the currency code used by an advertiser during a given month.

Added the campaignBudgets field to the campaign resource. Insertion order budget segments can be linked to a campaign budget, restricting the sum budget of the associated segments to the total campaign budget amount.

Added support for native content position targeting under the new targeting type TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Introduced a new prismaEnabled field to the advertiser resource, letting users enable integration with Mediaocean's Prisma tool.

Enabled support for the ENTITY_STATUS_PAUSED enum value to the Advertiser's entityStatus field.

New Features

April 29, 2021

Added new fields to Channel and Negative Keyword List resources that return the count of line items using the resource for targeting. Enabled new filter properties for the line item list method that allow the user to only retrieve line items that are using specific channels or negative keyword lists in their targeting.

New Features

March 30, 2021

Added a new method to the line item service that generates a line item with default configurations. These default values are based on the given line item type, as well as the settings and assigned targeting of the parent insertion order.

Enabled the retrieval of campaign targeting through a new campaign targeting service and additional bulk list method.

Expanded app targeting to allow the targeting of apps on more platforms.

Made multiple changes to advertisers.channels.sites, partners.channels.sites and advertisers.negativeKeywordLists.negativeKeywords services to allow for easier management of channel and negative keyword list content. These changes include:

  • The addition of replace methods, which enables a user to fully overwrite the existing contents of a channel or negative keyword list.
  • The removal of the requirement that no existing items be included in the createdSites or createdNegativeKeywords fields of bulk edit requests.
  • The increase of the maximum number of items that can be returned on a single page of a list sites or list negative keywords response.

New Features

Deprecations

February 24, 2021

Introduced a new insertion order targeting service and additional bulk list method enabling the retrieval of targeting assigned to insertion orders. Expanded the creative resource, adding output-only creative fields for use by third-party audio creatives. Added new performance goal types for use by insertion order and campaign resources.

New Features

January 27, 2021

Enabled retrieval and management of TV insertion orders and over-the-top line items through the introduction of a new InsertionOrderType field and a new LineItemType enum value. Added support for mobile app line items through a mobileApp line item field. Expanded exchange, google audience, and SDF support through additional enum values. Introduced the capability to filter and order advertisers.list values by the last updated time.

New Features

December 4, 2020

Added the capability to search for Geo Region targeting options and filter multiple resource list method results by their last updated time. Introduced a new LineItemWarningMessage to inform users of when a line item is using deprecated geographic targeting.

New Features

November 5, 2020

Added the capability to create, assign and activate manual triggers that initiate associated line items' spending. Introduced targeting expansion options that, when set, can expand the targeting of a line item to include users similar to those in targeted audiences. Appended custom segment ID fields to DoubleVerify and Integral Ad Science objects used in third-party verification targeting.

New Features

October 12, 2020

Introduced retrievable warning messages to the line item resource and a click-through rate (CTR) performance goal type. Added warningMessages as a filterable field when listing line items.

In addition to new features, new quota limits are now in effect and new documentation on utilizing batch requests is available.

New Features

August 28, 2020

Added new fields to the response of the advertiser audit method and new filterable fields to various list methods.

New Features

August 4, 2020

Launched new user management, partner, and partner targeting services. Introduced tools to help users proactively avoid reaching account entity limits. Added support for audio line items and the use of custom bidding algorithms in line items and insertion order bid strategies.

New Features

June 24, 2020

Launched a small update adding a create method for partner and advertiser channels, new FirstAndThirdPartyAudience fields, and additional exchange enum values.

New Features

June 02, 2020

Introduced the ability to create, patch, and populate a subset of targetable entities and added the ability to modify advertiser-level targeting for three targeting types: channel, digital content label exclusion, and sensitive category exclusion.

New Features

April 27, 2020

Launched a large feature set, expanding the scope of the API beyond SDF. Added core resource management that allows you to create, retrieve, update, and delete entities such as advertisers, campaigns, insertion orders, line items and creatives. New capabilities also allow the editing of targeting at the line item level.

New Features

The following services have been added:

ServiceMethod(s)
advertisers

create

delete

get

list

patch

advertisers.assets

upload

advertisers.campaigns

create

delete

get

list

patch

advertisers.channels

get

list

advertisers.creatives

create

delete

get

list

patch

advertisers.insertionOrders

create

delete

get

list

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

create

delete

get

list

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

create

delete

get

list

advertisers.locationLists

get

list

advertisers.negativeKeywordLists

get

list

combinedAudiences

get

list

customLists

get

list

firstAndThirdPartyAudiences

get

list

floodlightGroups

get

patch

googleAudiences

get

list

inventorySourceGroups

get

list

inventorySources

get

list

partners.channels

get

list

partners.channels

get

list

March 09, 2020

Launched Display & Video 360 API v1. This is the initial version of the API.

Known issues

None.