リリースノート

このページには、Display & Video 360 API のリリースノートが掲載されています。

最新の API バージョン: v3

2024 年 4 月 23 日

新機能

新しい KPI タイプ、エクスチェンジ、アプリ プラットフォームのサポートを追加しました。

v3

  • 以下のフィールドが追加されました。

    リソースフィールド
    KPI

    kpiAlgorithmId

  • 以下の列挙値が追加されました。

    列挙型
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    交換

    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

2024 年 2 月 28 日

新機能

カスタマー マッチ オーディエンスからメンバーを明示的に削除する機能が追加されました。

新しいエクスチェンジのターゲティングがサポートされるようになりました。

v3

v2

2024 年 1 月 29 日

新機能

新しい floodlightGroups.floodlightActivities サービスを介して Floodlight アクティビティを取得する機能が追加されました。

YouTube とパートナーの広告申込情報のターゲティングに Google TV の広告枠を含めるかどうかを示す新しいフィールドを追加しました。

ディスプレイ &ビデオ 360 ユーザーの最終ログイン時間をリレーする新しいフィールドを追加しました。

v3

v2

2023 年 11 月 14 日

新機能

すべてのライブ バージョンでカスタマー マッチのオーディエンス メンバーをアップロードする際に、エンドユーザーの同意を渡す機能のサポートが追加されました。

v3

v2

2023 年 10 月 31 日

新機能

v3 を公開ベータ版から一般提供に変更しました。

v3 で AdGroupFormat 列挙値の名前を変更し、関連する形式をより正確に反映しました。

構造化データファイル v7 のサポートが追加され、v2 と v3 に SDF_VERSION_7 列挙値が追加されました。

v3

  • 次の列挙型の値が削除されました。

    列挙型
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • 以下の列挙値が追加されました。

    列挙型
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • 以下の列挙値が追加されました。

    列挙型
    SdfVersion

    SDF_VERSION_7

2023 年 10 月 2 日

新機能

以下の変更点を含む v3 の公開ベータ版をリリースしました。

移行ガイドの手順に沿って、v2 から v3 に移行してください。

v2 と v3 で、3 つの新しい LineItemType 値、1 つの新しい YoutubeAndPartnersBiddingStrategyType、1 つの新しい PartnerCostType のサポートを追加しました。

v3

v2

  • 以下の列挙値が追加されました。

    列挙型
    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

2023 年 8 月 25 日

新機能

2 つのエクスチェンジと 2 つの新しい YouTube とパートナーの入札戦略タイプのサポートを追加しました。

YouTube とパートナーの広告申込情報に、新しい effectiveContentCategory フィールドを追加しました。これにより、広告主レベルと広告申込情報レベルの両方で割り当てられた値を検討する際に、広告申込情報で使用される YoutubeAndPartnersContentCategory が表示されます。

v2

2023 年 6 月 5 日

新機能

v1 と v2 で、構造化データファイル(SDF)v6 用の新しい SdfVersion 値を追加しました。

v2

  • 以下の列挙値が追加されました。

    列挙型
    SdfVersion

    SDF_VERSION_6

v1

  • 以下の列挙値が追加されました。

    列挙型
    SdfVersion

    SDF_VERSION_6

2023 年 3 月 9 日

新機能

新しい LineItemWarningMessage 値を追加しました。これは、サポートが終了した excludeFirstPartyAudience フィールドが true に設定されている場合に、広告申込情報の warningMessages フィールドに割り当てられます。excludeFirstPartyAudience フィールドは 2023 年 3 月 25 日以降に廃止され、false に設定されます。

v2

  • 以下の列挙値が追加されました。

    列挙型
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • 以下の列挙値が追加されました。

    列挙型
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

2023 年 2 月 8 日

新機能

YouTubeAdGroup リソースと YouTubeAdGroupAd リソース、YouTube 広告グループのリソース ターゲティングを取得する機能が追加されました。また、YouTube 広告グループ単位で取得可能なターゲティング タイプを新たに追加しました。詳しくは、YouTube とパートナーのリソースの取得に関する新しいガイドページをご覧ください。

v1 と v2 で新たに 4 つのエクスチェンジのサポートを追加しました。

v2

v1

  • 以下の列挙値が追加されました。

    列挙型
    交換

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

2022 年 12 月 6 日

新機能

v2 を公開ベータ版から一般提供しました。

新しい assignedTargetingOptionIdAlias フィールドを AssignedTargetingOption リソースに追加しました。これは、ターゲティングの取得時と削除時に assignedTargetingOptionId の代わりに使用できます。このフィールドは、列挙型によって割り当てられたターゲティング タイプの割り当て済みターゲティング オプションに対してのみ設定されます。エイリアス値は、関連する列挙値の文字列です。

新しい billingConfig フィールドを Advertiser リソースに追加しました。

3 つの新しい LineItemType 値で識別される YouTube とパートナーのオーバー ザ トップ広告申込情報を取得できるようになりました。

v1 と v2 の多数の list メソッドの最大ページサイズを 200 に増やしました。デフォルトのページサイズは変更されません。

v2

v1

既知の問題

このアップデートにより、v2 の以下の既知の問題が修正されます。

  • v2 の列挙値を使用して割り当てられたターゲティング タイプに割り当てられたターゲティング オプションは、assignedTargetingOptionId を使用して削除または取得することができず、代わりにユーザーが列挙値を使用することが想定されていました。この更新により、AssignedTargetingOption リソースの新しい assignedTargetingOptionIdAlias フィールドによって識別される assignedTargetingOptionId または列挙値を使用して、割り当てられたターゲティング オプションを削除または取得できます。
  • 広告申込情報の bulkUpdate リクエストで advertisersId リクエスト パラメータが正しく使用されておらず、エラーが返されました。このアップデートにより、メソッドが修正され、リクエスト パラメータの名前が advertisersId から advertiserId に変更されました。

2022 年 10 月 27 日

InsertionOrder 内で既存の広告申込情報を複製する機能が追加されました。

advertisers.insertionOrders.targetingTypes.assignedTargetingOptions サービスに create メソッドと delete メソッドが追加され、ターゲティング タイプのサブセットに対する広告掲載オーダー ターゲティングの書き込みサポートが導入されました。

新機能

v2

v1

v1 に追加された新機能はありません。

2022 年 9 月 20 日

以下の変更点を含む v2 の公開ベータ版をリリースしました。

移行ガイドの手順に沿って、v1 から v2 に移行します。

v1 で 3 つの新しいエクスチェンジのサポートを追加しました。

新機能

v2

v1 と v2 の変更点は次のとおりです。

v1

  • 以下の列挙型値が v1 に追加されました。

    列挙型
    交換

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

2022 年 5 月 26 日

新しい inventorySources サービス書き込みメソッドと新しい guaranteedOrders サービスを使用して、InventorySource リソースを作成し、GuaranteedOrder リソースを管理する機能が追加されました。

CustomBiddingAlgorithm リソースに modelReadiness フィールドが導入されました。このフィールドには、アルゴリズムのモデルにアクセス可能な各広告主について、アルゴリズムのモデルの準備状況が示されます。

advertisers.creatives.list メソッドで新しい filter クエリ パラメータ機能を有効にしました。これにより、ユーザーは指定されたタイムスタンプの前または後に updateTime を持つクリエイティブのみを取得できます。

SdfVersion 列挙値の追加により、最新の SDF バージョン v5.5 のサポートを追加しました。

新機能

2022 年 3 月 31 日

コンテンツの長さストリーム タイプジャンルの取得と設定のサポートを追加しました。

InsertionOrder オブジェクトに billableOutcome フィールドを追加しました。

MaximizeSpendBidStrategy オブジェクトに raiseBidForDeals フィールドが導入され、ターゲットとする取引に入札戦略で広告主の最小価格を適用するかどうかをユーザーが設定できるようになりました。

新機能

2022 年 2 月 2 日

特定のカスタマー マッチ FirstAndThirdPartyAudience リソースのメンバーの作成更新編集のサポートを追加しました。これらの新機能の使用方法については、新しいオーディエンスを使用するガイドのカスタマー マッチ オーディエンスをアップロードするページをご覧ください。

InsertionOrder リソースと LineItem リソースに新しい reservationType フィールドが導入されました。これにより、リソースがタグ保証型か、プログラマティック保証型か、非保証型かを識別できます。

新しい excludeNewExchanges フィールドを使用して、広告申込情報で新しいエクスチェンジを自動的にターゲットに設定するかどうかを取得して設定する機能が追加されました。

新機能に加え、デフォルトの割り当て上限が 2 倍になりました。

新機能

2021 年 12 月 8 日

ターゲティング タイプ TARGETING_TYPE_AUDIO_CONTENT_TYPE で、オーディオ コンテンツ タイプのターゲティングのサポートを追加しました。

新機能

2021 年 11 月 8 日

カスタム入札アルゴリズムとそのスクリプトの管理が完全にサポートされるようになりました。 該当するものは次のとおりです。

広告申込情報の管理ガイドに、カスタム入札の実装ページを新たに追加しました。このページでは、カスタム入札アルゴリズムの作成、スクリプトのアップロード、広告申込情報の入札戦略としてのカスタム入札アルゴリズムの割り当ての手順について説明しています。

SdfVersion 列挙値の追加により、最新の SDF バージョン v5.4 のサポートを追加しました。

新機能

2021 年 9 月 14 日

ターゲティング タイプ TARGETING_TYPE_BUSINESS_CHAIN および TARGETING_TYPE_POI で近隣地域ターゲティングのサポートを追加しました。

targetingTypes.targetingOptions.get メソッドや targetingTypes.targetingOptions.list メソッドでは取得できないため、targetingTypes.targetingOptions.search を使用して利用可能な TARGETING_TYPE_BUSINESS_CHAIN および TARGETING_TYPE_POI ターゲティング オプションを検索する機能を追加しました。

カスタム入札アルゴリズムのリソースに新しい sharedAdvertiserIds フィールドと customBiddingAlgorithmState フィールドを導入し、GOAL_BUILDER_BASED カスタム入札アルゴリズム タイプのサポートを追加しました。

Exchange 列挙型に 2 つの新しい値を追加しました。

新機能

2021 年 8 月 4 日

ターゲティング タイプ TARGETING_TYPE_OMIDOpen Measurement が有効な広告枠ターゲティングのサポートを追加しました。

pageSize メソッド パラメータを使用して、ターゲティング オプションのリスト メソッドが割り当てられているさまざまな広告主キャンペーン広告掲載オーダー広告申込情報の 1 ページで返される、割り当てられたターゲティング オプションの最大数を増やしました。

新機能

2021 年 5 月 26 日

advertisers.invoices サービスをリリースしました。これにより、ユーザーは次のことができます。

  • 特定の月に広告主に発行された請求書を取得する。
  • 特定の月に広告主が使用した通貨コードを調べる。

キャンペーン リソースに campaignBudgets フィールドを追加しました。広告掲載オーダーの予算セグメントキャンペーンの予算にリンクして、関連付けられたセグメントの合計予算をキャンペーンの合計予算額に制限できます。

新しいターゲティング タイプ TARGETING_TYPE_NATIVE_CONTENT_POSITIONネイティブ コンテンツの位置ターゲティングのサポートを追加しました。

広告主リソースに新しい prismaEnabled フィールドを導入し、ユーザーが Mediaocean の Prisma ツールとの統合を有効にできるようにしました。

広告主の entityStatus フィールドに対する ENTITY_STATUS_PAUSED 列挙値のサポートを有効にしました。

新機能

2021 年 4 月 29 日

チャネル リソースと除外キーワード リストリソースに、ターゲティングにリソースを使用して広告申込情報の数を返す新しいフィールドが追加されました。広告申込情報リストメソッドで新しい filter プロパティが有効になり、ターゲティングで特定のチャネルまたは除外キーワード リストを使用している広告申込情報のみを取得できるようになりました。

新機能

2021 年 3 月 30 日

デフォルト設定で広告申込情報を生成する広告申込情報サービスに新しいメソッドを追加しました。これらのデフォルト値は、指定された広告申込情報タイプのほか、親広告掲載オーダーの設定と割り当てられているターゲティングに基づきます。

新しいキャンペーン ターゲティング サービス追加の一括リスト方式を使用して、キャンペーンのターゲット設定を取得できるようになりました。

アプリ ターゲティングが拡張され、より多くのプラットフォームでアプリをターゲットに設定できるようになりました。

チャネルと除外キーワード リストの内容を簡単に管理できるように、advertisers.channels.sitespartners.channels.sitesadvertisers.negativeKeywordLists.negativeKeywords サービスに複数の変更を加えました。変更内容は次のとおりです。

  • replace メソッドの追加。これにより、ユーザーはチャネル リストまたは除外キーワード リストの既存のコンテンツを完全に上書きできます。
  • 一括編集リクエストの createdSites フィールドまたは createdNegativeKeywords フィールドに既存のアイテムが含まれないという要件がなくなりました。
  • サイトの一覧表示または除外キーワードの一覧表示のレスポンスで 1 ページで返すことができる最大アイテム数の引き上げ。

新機能

サポートの終了

2021 年 2 月 24 日

新しい広告掲載オーダー ターゲティング サービス一括リスト メソッドを導入し、広告掲載オーダーに割り当てられたターゲティングを取得できるようにしました。クリエイティブ リソースを拡張し、第三者のオーディオ クリエイティブで使用できるように出力専用のクリエイティブ フィールドを追加しました。広告掲載オーダーキャンペーンのリソースで使用する新しいパフォーマンス目標タイプを追加しました。

新機能

2021 年 1 月 27 日

新しい InsertionOrderType フィールド新しい PlacementType 列挙値が導入され、テレビ広告掲載オーダーとオーバー ザ トップ広告申込情報を取得、管理できるようになりました。mobileApp 広告申込情報フィールドでモバイルアプリ広告申込情報を使用できるようになりました。列挙値を追加することで、エクスチェンジGoogle オーディエンスSDF のサポートを拡張しました。最終更新日時advertisers.list 値をフィルタリングして並べ替える機能が導入されました。

新機能

2020 年 12 月 4 日

地域ターゲティング オプションを検索し、複数のリソースリスト メソッドの結果を最終更新時刻でフィルタリングする機能が追加されました。サポートが終了した地域ターゲティングが広告申込情報で使用されていることをユーザーに知らせる新しい PlacementWarningMessage が導入されました。

新機能

2020 年 11 月 5 日

関連付けられた広告申込情報の支出を開始する手動トリガーを作成、割り当て、有効にする機能が追加されました。ターゲットの拡張オプションを導入しました。このオプションを設定すると、ターゲット オーディエンスに類似するユーザーを広告申込情報のターゲティングに拡張できます。第三者ベリフィケーション ターゲティングで使用される DoubleVerify オブジェクトと Integral Ad Science オブジェクトにカスタム セグメント ID フィールドを追加しました。

新機能

2020 年 10 月 12 日

広告申込情報リソースとクリック率(CTR)のパフォーマンス目標タイプに、取得可能な警告メッセージが導入されました。広告申込情報を一覧表示する際のフィルタ可能なフィールドとして warningMessages を追加しました。

新機能に加えて、新しい割り当て上限が有効になり、バッチ リクエストの利用に関する新しいドキュメントが利用可能になりました。

新機能

2020 年 8 月 28 日

広告主の監査メソッドのレスポンスに新しいフィールドを追加し、さまざまなリストメソッドに新しいフィルタ可能なフィールドを追加しました。

新機能

2020 年 8 月 4 日

新しいユーザー管理パートナーパートナー ターゲティング サービスをリリースしました。アカウント エンティティの上限への到達を事前に回避できるツールを導入しました。オーディオ広告申込情報がサポートされるようになりました。また、広告申込情報および広告掲載オーダーの入札戦略でカスタム入札アルゴリズムを使用できるようになりました。

新機能

2020 年 6 月 24 日

パートナー チャネルと広告主チャネル用の create メソッド、新しい FirstAndThirdPartyAudience フィールド、追加の exchange 列挙値に関する小規模な更新をリリースしました。

新機能

2020 年 6 月 2 日

ターゲット設定可能なエンティティのサブセットを作成、パッチ、入力できる機能が導入され、チャネルデジタル コンテンツ ラベルの除外デリケートなカテゴリの除外の 3 つのターゲティング タイプについて広告主レベルのターゲティングを変更できるようになりました。

新機能

2020 年 4 月 27 日

大規模な機能セットをリリースし、API の範囲を SDF 以外にも拡大。広告主、キャンペーン、広告掲載オーダー、広告申込情報、クリエイティブなどのエンティティを作成、取得、更新、削除できるコアリソース管理が追加されました。また、広告申込情報レベルでターゲティングを編集できる新機能もあります。

新機能

次のサービスが追加されました。

サービスメソッド
広告主

作成

削除

get

リスト

パッチ

advertisers.assets

アップロード

advertisers.campaigns

作成

削除

get

リスト

パッチ

advertisers.channels

get

リスト

advertisers.creatives

作成

削除

get

リスト

パッチ

advertisers.insertionOrders

作成

削除

get

リスト

パッチ

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

作成

削除

get

リスト

パッチ

advertisers.lineItems.targetingTypes.assignedTargetingOptions

作成

削除

get

リスト

advertisers.locationLists

get

リスト

advertisers.negativeKeywordLists

get

リスト

combinedAudiences

get

リスト

customLists

get

リスト

firstAndThirdPartyAudiences

get

リスト

floodlightGroups

get

パッチ

googleAudiences

get

リスト

inventorySourceGroups

get

リスト

inventorySources

get

リスト

partners.channels

get

リスト

partners.channels

get

リスト

2020 年 3 月 9 日

Display & Video 360 API v1 をリリースしました。これは API の初期バージョンです。

既知の問題

なし。