リリースノート

このページは、ディスプレイ＆ビデオ 360 API のリリースノートを提供するものです。

最新の API バージョン: v3

2024 年 12 月 4 日

新機能

Core と Tubi の Exchange 値のサポートを追加しました。

firstAndThirdPartyAudiences.list の最大許容ページサイズを 200 から 5000 に増やしました。firstAndThirdPartyAudiences.list リクエストの pageSize パラメータを更新して、割り当ての使用状況をさらに最適化します。

v3

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

    列挙型値
    Exchange

    EXCHANGE_CORE

    EXCHANGE_TUBI

  • 次のリストメソッドの最大ページサイズを増やしました。

    メソッド新しい最大ページサイズ
    firstAndThirdPartyAudiences.list 5000

2024 年 10 月 22 日

新機能

広告視聴単価のパフォーマンス目標のサポートを追加しました。

接続済みデバイスのターゲティングを設定および取得する機能を追加しました。

[サードパーティ ベリファイアのターゲティング] に、新しい Adloox ブランド保護設定を追加しました。

v8 構造化データ ファイルのダウンロードのサポートを追加しました。現在はクローズド ベータ版です。

v3

サポートが終了した値

SDF v5.5 のサポートを終了しました。SDF v5.5 は2024 年 10 月 3 日に廃止されます。

v3

  • 次の列挙値は非推奨になりました。

    列挙型値
    SdfVersion

    SDF_VERSION_5_5

2024 年 8 月 15 日

新機能

Netflix の Exchange タイプのサポートを追加しました。

v3

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

    列挙型値
    交換

    EXCHANGE_NETFLIX

v2

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

    列挙型値
    交換

    EXCHANGE_NETFLIX

2024 年 7 月 15 日

新機能

v3 で、広告申込情報と広告グループの構造化データ ファイルを QA 形式でダウンロードするサポートを追加しました。

v3

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

    リソースフィールド
    IdFilter

    adGroupQaIds

    lineItemQaIds

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

    列挙型値
    FileType

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

2024 年 6 月 17 日

新機能

広告主単位で割り当てられたキーワード ターゲティングの管理機能を追加しました。

広告掲載オーダー リソースに新しい optimizationObjective フィールドを追加しました。optimizationObjective は、許可リストに登録されたお客様のみご利用いただけます。

v3

v2

2024 年 5 月 30 日

新機能

構造化データファイル（SDF）バージョン 7.1 のサポートを追加しました。

v3

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

    列挙型値
    SdfVersion

    SDF_VERSION_7_1

v2

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

    列挙型値
    SdfVersion

    SDF_VERSION_7_1

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

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 を公開ベータ版から一般提供に移行しました。

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

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

YouTube とパートナーのオーバー ザ トップ広告申込情報の取得をサポートしました。この広告申込情報は、3 つの新しい LineItemType 値で識別されます。

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

v2

v1

既知の問題

このアップデートでは、v2 の次の既知の問題が修正されています。

  • v2 で列挙値を使用して割り当てられたターゲティング タイプの割り当てられたターゲティング オプションは、assignedTargetingOptionId を使用して削除または取得できませんでした。代わりに、ユーザーが列挙値を使用することが想定されていました。この更新により、割り当てられたターゲティング オプションは、assignedTargetingOptionId または AssignedTargetingOption リソースの新しい assignedTargetingOptionIdAlias フィールドで識別される列挙値を使用して削除または取得できるようになりました。
  • 広告申込情報の 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 日

コンテンツの長さ、配信タイプ、ジャンルのターゲティングの取得と設定のサポートを追加しました。

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

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_OMID で、Open 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.sites、partners.channels.sites、advertisers.negativeKeywordLists.negativeKeywords サービスに複数の変更を加えました。変更内容は次のとおりです。

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

新機能

サポートの終了

2021 年 2 月 24 日

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

新機能

2021 年 1 月 27 日

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

新機能

2020 年 12 月 4 日

地域ターゲティング オプションを検索し、複数のリソースリスト メソッドの結果を最終更新日時でフィルタする機能を追加しました。新しい LineItemWarningMessage を導入し、広告申込情報で非推奨の地域ターゲティングが使用されている場合にユーザーに通知できるようにしました。

新機能

2020 年 11 月 5 日

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

新機能

2020 年 10 月 12 日

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

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

新機能

2020 年 8 月 28 日

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

新機能

2020 年 8 月 4 日

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

新機能

2020 年 6 月 24 日

パートナー チャネルと広告主チャネルの作成メソッド、新しい FirstAndThirdPartyAudience フィールド、追加の エクスチェンジ列挙型値を追加する小規模なアップデートをリリースしました。

新機能

2020 年 6 月 2 日

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

新機能

2020 年 4 月 27 日

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

新機能

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

サービスメソッド
広告主

作成

削除

get

list

パッチ
advertisers.assets

アップロード
advertisers.campaigns

作成

削除

get

list

パッチ
advertisers.channels

get

list
advertisers.creatives

作成

削除

get

list

パッチ
advertisers.insertionOrders

作成

削除

get

list

パッチ
advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

作成

削除

get

list

パッチ
advertisers.lineItems.targetingTypes.assignedTargetingOptions

作成

削除

get

list
advertisers.locationLists

get

list
advertisers.negativeKeywordLists

get

list
combinedAudiences

get

list
customLists

get

list
firstAndThirdPartyAudiences

get

list
floodlightGroups

get

パッチ
googleAudiences

get

list
inventorySourceGroups

get

list
inventorySources

get

list
partners.channels

get

list
partners.channels

get

list

2020 年 3 月 9 日

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

既知の問題

なし。