次の方法で共有

クエリ文字列パラメーターを使用してビデオ属性をターゲットする

  • [アーティクル]

インストリーム ビデオにタグ ソリューションを使用する場合、効果的に需要をターゲット化するには、可能なタグ パラメーターの範囲に関する知識と慎重な実装が必要です。

Microsoft Advertising では、クライアントまたはサーバー環境からビデオ需要をソースするための使い方が簡単なタグがクライアントに提供されます。 要求は業界標準の VAST XML を介して満たされます。VAST には VAST (メディア ファイルのみ)、VPAID1 (Flash) または VPAID2 (Flash または JavaScript) を含めることができます。 ptvタグとvmapタグはクライアント側で使用でき、ssptvタグとssvmapタグはサーバー側で使用できます。 これらのタグは複数のユース ケースで使用され、デスクトップ Web、モバイル Web、モバイル アプリ (iOS と Android)、OTT、IPTV、ゲーム コンソールなど、さまざまなデバイス コンテキストへの需要をソーシングします。

デスクトップ Web ビデオに使用する場合は、Cookie を使用できます。モバイル アプリの場合は、IDFA や AAID などのデバイス識別子を使用できます。 OTT または IPTV IP の場合は、他の識別子をユーザーとデバイスの識別に使用できます。 ptv および ssptv タグは、OpenRTB プロトコル (2.2 以降) で使用できます。

このページでは、使用可能なクエリ文字列パラメーターとその対象について説明します。 各属性は、クエリ文字列パラメーターを使用して、a/ptv または/ssptv タグに追加できます。 これらの属性は、クリエイティブ属性とは異なります。 クエリ文字列パラメーターの例を次に示します。

https://ib.adnxs.com/ptv?id=5523324&vmaxduration=30&vskippable=0&vplaybackmethod=5&vwidth=480&vcontext=1&vframeworks=1,2&schain=<blahblah>

ビデオ配置とプレーヤーの次のターゲット属性は、OpenRTB 2.2 および OpenRTB 2.3 仕様に準拠しています。 (詳細については、「SP からの受信入札要求」を参照してください)広告呼び出しでは、次に示すクエリ文字列パラメーターを受け入れます。 Compatible Handlers 列には、各パラメーターで動作するタグの種類が示されています。

成功するには、次のパラメーターが特に重要です。

  • Web およびモバイル Web インベントリの場合は、ビデオ要求に常に referrer パラメーターを含めます。 たとえば、abcd.comがインベントリの適切な URL である"referrer=abcd.com&"を含めます。
  • モバイル アプリと CTV インベントリには、referrerではなく appid パラメーターが必要です。 たとえば、com.xandrがインベントリのアプリ ID である"appid=com.xandr"を含めます。
  • 交換需要を受け取るために、ビデオ インベントリのすべての広告リクエストに対して referrer または appid パラメーターを渡す必要があります。 そうしないと、在庫の需要が大幅に制限され、効果的に収益化できなくなります。

注:

デバイス ID フィールドは大文字と表示されます。

基本的なターゲット属性

パラメーター 型 必須 互換性のあるハンドラー 説明
gdpr ブール値 はい。EU のすべての GET 呼び出しで ptv, ssptv, vmap, ssvmap 呼び出しの GDPR 状態を示すブール値。
- 0 = no = GDPR が適用されない
- 1 = はい = GDPR が適用されます
gdpr_consent string はい。EU のすべての GET 呼び出しで ptv, ssptv, vmap, ssvmap GDPR 同意データを含む文字列。 このフィールドは、IAB ヨーロッパの同意文字列とベンダーリスト形式: 透明性 & 同意フレームワークと advertisingconsent.eu で説明されているgetConsentDataに相当します。
vmax_slot_duration int ポッドに複数のスロットがある要求で CTV インベントリを収益化するために必要です。 ptv, ssptv, vmap, ssvmap 広告ポッドのスロットあたりの最大動画再生時間 (秒単位)。 この値より長い期間のクリエイティブはポッドから除外されます。

注: この値は、配置と要求 (vmaxduration) にポッドの最大継続時間の値が指定されていない場合にのみ、配置ビデオ設定で定義されているスロットの最大期間をオーバーライドします。
vmax_num_ads int いいえ ptv, ssptv, vmap, ssvmap 広告ポッドあたりの広告の最大数。 これは、特定のポッドに対して送信される要求の数です。
vmaxduration int CTV インベントリを収益化するために必要です。 ptv, ssptv, vmap, ssvmap 1 回の要求の場合、これはビデオの最大配置時間 (秒単位) です。 この値より長い期間のクリエイティブは、オークションから除外されます。 ポッド化されたインベントリの場合、これは完全なポッドの長さです。
vskippable int いいえ ptv, ssptv 配置がスキップ可能かどうかを示します。 使用可能な値:
- 1 - 広告スロットはスキップ可能
- 0 - 広告スロットはスキップできません
vplaybackmethod int いいえ ptv, ssptv 配置の再生方法を指定します。
- 1 - 自動再生、サウンドオン
- 2 - 自動再生、サウンドオフ
- 3 - クリックして再生する
- 4 - マウス オーバー
- 5 - 自動再生、不明なサウンド
vwidth int インベントリを収益化するために必要 ptv, ssptv, vmap, ssvmap プレイヤーの幅 (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。
vheight int インベントリを収益化するために必要 ptv, ssptv, vmap, ssvmap プレイヤーの高さ (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。
vcontext int インベントリを収益化するために必要 ptv, ssptv ビデオの配置の位置。 使用可能な値:
- 1 - リニアプリロール
- 2 - リニアミッドロール
- 3 - 線形ポストロール
- 4 - Outstream
vframeworks int インベントリを収益化するために必要 ptv, ssptv, vmap, ssvmap プレイヤーがサポートするフレームワーク。 使用可能な値:
- 1 - VPAID 1.0
- 2 - VPAID 2.0
- 3 - MRAID-1
- 4 - MRAID-2
- 5 - ORMMA
- 6 - OMID-1

注: vframeworks では、コンマ区切り整数値のリストだけでなく、単一の整数値もサポートされます。 例えば、
vframeworks=1,2,3
または
vframeworks=1.
referrer string はい(Web トラフィックの場合) ptv, ssptv, vmap, ssvmap 広告がレンダリングされる URL。
appid int はい(モバイル アプリ/CTV トラフィックの場合) ptv, ssptv, vmap, ssvmap モバイル/CTV アプリケーションのバンドル ID。 プラットフォーム固有のアプリケーション識別子は、アプリに固有であり、交換とは無関係です。 この文字列は、Android または Apple iOS モバイル デバイスだけでなく、Android TV、Apple TV、Roku などの接続済みテレビ デバイスで実行されているアプリを識別するために使用されます。詳細/例については、「 IAB Tech Lab OTT/CTV ストア割り当て済みアプリ識別ガイドライン」を参照してください。

- Android (モバイル & CTV) では、これは Google Play ストアの開発者によって定義されたアプリの英数字パッケージ名です。 このバンドル ID は、アプリ ストアの詳細ページの URL の末尾に表示される com.example.helloworld。
- iOS (モバイル) と tvOS (CTV) では、これはアプリの数値 iOS ストア ID で、Apple App Storeによって自動生成されます。 このバンドル ID は、アプリ ストアの詳細ページの URL の末尾に表示される 123456789です。
- Roku (CTV) では、これは Roku によって自動生成された数値 ID です。 このバンドル ID は、IABTL app-ads.txt ガイドラインに従って、Roku Channel Store ページ ソースの HTML メタタグで使用できる 123456です。

多くの購入者は、appid に基づいてキャンペーンのターゲット設定とレポートを設定します。 適切な appid を指定しなかった場合、これらの購入者はインベントリを魅力的にできなくなります。 そのため、supply_typeが mobile_app に設定されている場合は、このフィールドを渡すことを強くお勧めします。 これは、モバイル SDK が広告を要求するときに行うことです。 特定のアプリのアプリ ID を見つけるには、Web 検索を使用して見つけることができるアプリの詳細ページを調べます。 たとえば、"Tubi" アプリの詳細ページを次に示します (上記の説明に従って appid バンドルを使用できます)。

- Google Play (Android): https://play.google.com/store/apps/details?id=com.tubitv
- Apple (iOS/tvOS): https://apps.apple.com/us/app/tubi-watch-movies-tv-shows/id886445756
- Roku: https://channelstore.roku.com/details/7c34d32446def64db7eb2cc359749fe5/tubi-free-movies-and-tv
vv int CTV インベントリを収益化するために必要です。 ptv, ssptv, vmap, ssvmap プレーヤーでサポートされている VAST バージョン:
- 2 - VAST 2.0
- 3 - VAST 3.0
- 4 - VAST 4.0
- 5 - VAST 4.1
- 6 - VAST 4.2。
schain string 再売り在庫の要求に必要 ptv, ssptv 広告システムでは、文字列シリアル化 SupplyChain を受け入れるために、広告タグまたは VAST URL のパラメーターをサポートする必要があります。 このパラメーターは schainすることをお勧めします。 schain文字列パラメーターとそれに対応する JSON オブジェクトの詳細については、OpenRTB 以外の要求の SupplyChain に関するページを参照してください。

1.0,1!exchange1.com,1234,1,bid-request-1,publisher,publisher.com!exchange2.com,abcd,1,bid-request2,intermediary,intermediary.com
eids 文字列 いいえ ptv, ssptv, vmap, ssvmap オークションが開始されると、パブリッシャーによって拡張 ID (eid) が渡されます。 各 eid には 3 つのコンマ区切りフィールドがあり、ソースと ID は必須フィールドです。
- source: ID の配信元を表す ID ソリューション ソース。 たとえば、発行元が提供する ID ソリューションの liveramp.com またはカスタム文字列を指定できます。
- id: ID ソリューションによって提供されるユーザー ID。
- rti_partner: サード パーティ ID ソリューション名。
次の例では、2 つの拡張 ID とそれぞれのフィールドを示します。 複数の ID を渡すには、eid をパイプ文字で区切ります。
    - 拡張 ID1: source=adserver.org,id=987654,rti_partner=TDID
    - 拡張 ID2: source=criteo.com,id=1234567,rti_partner=(none)

2 つの拡張 ID は、次のようにエンドポイントに渡されます。

...&eids=adserver.org,987654,TDID|criteo.com,1234567&...
intro_bumper_min_duration int いいえ ptv, ssptv, vmap, ssvmap Intro bumpersを許可する予定の場合の最小広告期間 (秒単位)。
intro_bumper_min_durationは、intro bumper スロットのvmin_ad_durationをオーバーライドします。 intro_bumper_min_durationとオーバーライドvmin_ad_durationが渡された場合、intro_bumper_min_durationはintro bumperにのみ適用され、vmin_ad_durationはポッドの残りの部分に適用されます。
注: intro minが要求で渡された場合、配置がintro bumpersに対して有効になっていない場合でも、広告リクエストでintro bumpersがアクティブになります。 「 In-Stream ビデオの配置を構成する」の「手順 14c」を参照してください。
intro_bumper_max_duration int いいえ ptv, ssptv, vmap, ssvmap Intro bumpersを許可する場合の最大広告時間 (秒単位)。
注: intro maxが要求で渡された場合、配置がintro bumpersに対して有効になっていない場合でも、広告リクエストでintro bumpersがアクティブになります。 「 In-Stream ビデオの配置を構成する」の「手順 14c」を参照してください。
outro_bumper_min_duration int いいえ ptv, ssptv, vmap, ssvmap Outro bumpersを許可する予定の場合の最小広告期間 (秒単位)。 outro_bumper_min_durationは、outro bumper スロットのvmin_ad_durationをオーバーライドします。 outro_bumper_min_durationとオーバーライドvmin_ad_durationが渡された場合、outro_bumper_min_durationはoutro bumperにのみ適用され、vmin_ad_durationはポッドの残りの部分に適用されます。
注: outro minが要求で渡された場合、配置がoutro bumpersに対して有効になっていない場合でも、広告リクエストでoutro bumpersがアクティブになります。 「 In-Stream ビデオの配置を構成する」の「手順 14c」を参照してください。
outro_bumper_max_duration int いいえ ptv, ssptv, vmap, ssvmap outro bumpersを許可する場合の最大広告時間 (秒単位)。
注: outro maxが要求で渡された場合、配置がoutro bumpersに対して有効になっていない場合でも、広告リクエストでoutro bumpersがアクティブになります。「In-Stream ビデオの配置を構成する」の「手順 14c」を参照してください。

その他の設定

パラメーター 型 必須 互換性のあるハンドラー 説明
id int はい ptv, ssptv, vmap, ssvmap 広告が配信される配置の一意の ID。 生の配置 ID を渡さない場合は、 member パラメーターと inv_code パラメーターの組み合わせを渡すことができます。 詳細については、これらのパラメーターのドキュメントを参照してください。
member int いいえ ptv, ssptv, vmap, ssvmap (省略可能)広告が配信される配置のメンバーのメンバー ID。 配置 ID を渡す代わりに、このフィールドと inv_code の組み合わせを渡して、特定の配置を一意に識別できます。
carrier 文字列 いいえ ptv, ssptv, vmap, ssvmap 携帯電話会社の名前。 通常、システムはデバイスの IP アドレスから通信事業者を推測できるため、これは省略可能です。 例: AT&T - US。 このフィールドで使用できる値の詳細については、「 Carrier Service」を参照してください。
connection_type 文字列 いいえ ptv, ssptv, vmap, ssvmap デバイスで使用されるネットワークの種類。 使用できる値は、"wifi" または "wan" です。
content_len int CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツの期間 (秒単位)。
content_livestream int CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツがライブまたはビデオ オンデマンド (VOD) のいずれであるか。 0: VOD、1: Live。
content_genre string CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツを最もよく表すジャンル。
content_program_type 文字列 いいえ ptv, ssptv, vmap, ssvmap プログラムの種類 (映画、イベント、エピソードなど)。
content_contentrating string CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツレーティング (例: PG-13)。
content_album 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツが属するアルバム。通常はオーディオ用です。
content_artist 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツでクレジットされたアーティスト。
content_cat 文字列配列 CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツ プロデューサーを記述する IAB コンテンツ カテゴリの配列。 リスト 5.1 を参照してください。
content_context int CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツの種類 (ゲーム、ビデオ、テキストなど)。
content_data_id 文字列 いいえ ptv, ssptv, vmap, ssvmap データ プロバイダーの Exchange 固有 ID。
content_data_name 文字列 いいえ ptv, ssptv, vmap, ssvmap データ プロバイダーの Exchange 固有の名前。
content_data_segment object 配列 いいえ ptv, ssptv, vmap, ssvmap 実際のデータ値を含む Segment オブジェクトの配列。
content_embeddable int いいえ ptv, ssptv, vmap, ssvmap コンテンツが埋め込み可能かどうかを示すインジケーター (例: 埋め込み可能なビデオ プレーヤー)、0 = いいえ、1 = はい。
content_episode int CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap エピソード番号。
content_isrc 文字列 いいえ ptv, ssptv, vmap, ssvmap ISO-3901に準拠した国際標準記録コード。
content_keywords 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツを記述するキーワードのコンマ区切りリスト。
content_prodq int CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap 生産品質。
content_producer_id 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツ プロデューサーまたは発信者 ID。 コンテンツが配信され、埋め込みタグを使用してサイトに投稿される場合に便利です。
content_producer_cat 文字列配列 いいえ ptv, ssptv, vmap, ssvmap コンテンツ プロデューサーを記述する IAB コンテンツ カテゴリの配列。 リスト 5.1 を参照してください。
content_producer_name 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツ プロデューサーまたは発信者名 (例: "Warner Bros")。
content_producer_domain 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツ プロデューサーの最上位ドメイン (例: "producer.com")。
content_qagmediarating int いいえ ptv, ssptv, vmap, ssvmap IQG ガイドラインごとのメディアレーティング。 リスト 5.19 を参照してください。
content_season 文字列 CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツ シーズン (例: "シーズン 3")。
content_series string CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツ シリーズ。 ビデオの例: "The Office" (テレビ)、"Star Wars" (映画)、または "Arby 'N' The Chief" (Web 用)。 ビデオ以外の例: "Ecocentric" (タイム マガジン ブログ)。
content_sourcerelationship int いいえ ptv, ssptv, vmap, ssvmap 0 = 間接、1 = 直接。
content_title 文字列 CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap コンテンツ タイトル。 ビデオの例: "検索委員会" (テレビ)、"新しい希望" (映画)、または "Endgame" (Web 用に作成)。 ビデオ以外の例: "なぜ南極氷河がこんなに早く溶けているのか" (タイム誌の記事)。
content_url 文字列 いいえ ptv, ssptv, vmap, ssvmap 購入側のコンテキスト化またはレビュー用のコンテンツの URL。
content_userrating 文字列 いいえ ptv, ssptv, vmap, ssvmap コンテンツのユーザー評価 (例: 星の数、いいねなど)。
content_network 文字列 CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap 最上位の親企業、または関連する場合は、複数のテレビのようなチャネル、d2c コンテンツ ブランド、またはコンテンツが表示されているデジタル プロパティを所有するサブブランド。
content_language 文字列 いいえ ptv, ssptv, vmap, ssvmap ビデオ コンテンツの言語。 2 文字の ISO-639-1-alpha-2 コードを使用して言語を指定します。
channel_name 文字列 CTV インベントリを収益化することをお勧めします。 ptv, ssptv コンテンツがオンになっているチャネルの名前。
airtime 文字列 いいえ ptv, ssptv 元の放送時間。 これは、時間シフトされたコンテンツにのみ適用されます。
content_id 文字列 いいえ ptv, ssptv, vmap, ssvmap 一意の英数字コンテンツ識別子。
devmake 文字列 いいえ ptv, ssptv, vmap, ssvmap 広告を要求するデバイスの製造元。 通常、この値は UA 文字列パラメーター (サーバー側実装の場合) から解析されるか、要求ヘッダー (クライアント側統合の場合) に自動的に含まれます。 それ以外の場合は、このパラメーターを使用して、クエリ文字列内の情報を直接渡すことができます。 例: da-4G Systems。 このフィールドで使用できる値の詳細については、 Device Make Service の名前の値を参照し、 "da-"でプレフィックスを付けます。
devtype 文字列 いいえ ptv, ssptv, vmap, ssvmap 広告を要求するデバイスの種類。 通常、この値は UA 文字列パラメーター (サーバー側実装の場合) から解析されるか、要求ヘッダー (クライアント側統合の場合) に自動的に含まれます。 それ以外の場合は、このパラメーターを使用して、クエリ文字列内の情報を直接渡すことができます。 使用できる値は、 da-Tablet、 da-Mobile Phone、 da-Game Console、 da-TV、 da-Set Top Box、 da-Media Playerです。 このフィールドの値がターゲット/レポートにマップされる方法の詳細については、「 Profile Service」の「デバイスの種類のターゲット」セクションを参照してください。
devmodel 文字列 いいえ ptv, ssptv, vmap, ssvmap 広告を要求するデバイスの特定の名前または番号。 通常、この値は UA 文字列パラメーター (サーバー側実装の場合) から解析されるか、要求ヘッダー (クライアント側の統合の場合) に自動的に含まれます。 それ以外の場合は、このパラメーターを使用して、クエリ文字列内の情報を直接渡すことができます。 例: da-3499464。 このフィールドに使用できる値の詳細については、Device Model Service のプレフィックス“da-”付いたコード値に関するページを参照してください。
dnt ブール値 いいえ ptv, ssptv, vmap, ssvmap このフィールドは非推奨であり、今後削除される可能性があります。 代わりに LimitAdTrackingEnabled フラグを使用します。
true場合、ユーザーはシステム レベルの優先順位を設定して、動作的にターゲットを絞った広告を受信しないように設定します。 許可される値: true、 false、 1、または 0。
devtime int いいえ ptv, ssptv, vmap, ssvmap デバイス上の時刻 (エポック以降の秒単位)、または UNIX 時刻。
devtz 文字列 いいえ ptv, ssptv, vmap, ssvmap デバイスのタイムゾーン。
external_uid 文字列 いいえ ptv, ssptv, vmap, ssvmap このユーザーの外部ユーザー ID に対応する文字列。
ifa string インベントリを収益化するために必要 ptv, ssptv, vmap, ssvmap UUID 標準を使用した一意のデバイス識別子 (8-4-4-4-12)
ifa_type string インベントリを収益化するために必要 ptv, ssptv, vmap, ssvmap 使用できる値は、 aaid (Android)、 idfa (AppleTV)、 afai (Amazon Fire)、msai (Microsoft)、 rida (Roku)、 ppid、 tifa (Tizen (Samsung))、 vida (Vizio)、 lgudid (LG) です。

注: デバイスまたはプラットフォーム ID を動的に渡すことができない場合は、次を使用する必要があります。
- ifa_type=openudid 認証データがあり、永続的な ID を渡すことができる場合は、CTV 広告要求の場合
- &ifa_type=sessionid 永続的な ID を持つ認証データがない場合
LimitAdTrackingEnabled ブール値 いいえ ptv, ssptv, vmap, ssvmap true場合、ユーザーはシステム レベルの優先順位を設定して、動作的にターゲットを絞った広告を受信しないように設定します。 許可される値: true、 false、 1、または 0。
iOS のシステム レベルの広告設定の詳細については、「 iAd からの興味に基づく広告のオプトアウト」を参照してください。
Android でのシステム レベルの広告設定の詳細については、「 広告 ID」を参照してください。
md5udid 文字列 いいえ ptv, ssptv, vmap, ssvmap ANDROID_IDの MD5 ハッシュ。 これは Android デバイスに対してのみ送信する必要があります。 これは URL でエンコードする必要があります。
sha1udid 文字列 いいえ ptv, ssptv, vmap, ssvmap ANDROID_IDの SHA1 ハッシュ。 これは Android デバイスに対してのみ送信する必要があります。 これは URL エンコードされている必要があります。.
rida 文字列 いいえ ptv, ssptv, vmap, ssvmap Roku デバイスのデバイス ID。

注: このパラメーターは、 ifa と ifa_type が渡される場合は必要ありません。
idfa 文字列 いいえ ptv, ssptv, vmap, ssvmap iOS 6 以降を実行している iOS デバイスの Apple アドバタイズ識別子。

注: このパラメーターは、 ifa と ifa_type が渡される場合は必要ありません。
aaid 文字列 いいえ ptv, ssptv, vmap, ssvmap Google Play サービスから取得した Android デバイスの Google 広告識別子。
adid 文字列 いいえ ptv, ssptv, vmap, ssvmap Windows デバイスの Windows アドバタイズ識別子。
注: このパラメーターは、 ifa と ifa_type が渡される場合は必要ありません。
ip 文字列 CTV インベントリを収益化するために必要です。 ptv, ssptv, vmap, ssvmap 広告要求を行うデバイスの IP アドレス (例: 207.237.150.246)。
- /ptv呼び出しと/ssptv呼び出しにipが指定されていない場合、システムは geo 検出に "X-Forwarded-For" HTTP ヘッダーを介して渡された IP を使用します。
language 文字列 いいえ ptv, ssptv, vmap, ssvmap ISO 言語コードで指定されたデバイスの言語。
loc 文字列 いいえ ptv, ssptv, vmap, ssvmap 緯度と経度で表されるユーザーの場所 ( snnn.ddddddddddddd、snnn.ddddddddddddd) の形式。 小数点以下 13 桁までの有効桁数を使用できます。
loc_age int いいえ ptv, ssptv, vmap, ssvmap 位置データの経過時間 (ミリ秒単位)。
loc_prec int いいえ ptv, ssptv, vmap, ssvmap 位置データの精度 (メートル単位)。
mcc int いいえ ptv, ssptv, vmap, ssvmap ITU によって指定されたモバイル国コード。
mnc int いいえ ptv, ssptv, vmap, ssvmap ITU によって指定されたモバイル ネットワーク コード。
openudid 文字列 いいえ ptv, ssptv, vmap, ssvmap デバイスの OpenUDID 。 これは、iOS バージョン 5 以降でのみ送信する必要があります。
orientation 文字列 いいえ ptv, ssptv, vmap, ssvmap 広告リクエスト中のデバイス画面の向き。 使用できる値は、 "v" または "h"です。
os 文字列 いいえ ptv, ssptv, vmap, ssvmap オペレーティング システムと、広告を要求するデバイスのバージョン番号。 通常、この値は UA 文字列パラメーター (サーバー側実装の場合) から解析されるか、要求ヘッダー (クライアント側統合の場合) に自動的に含まれます。 それ以外の場合は、このパラメーターを使用して、クエリ文字列内の情報を直接渡すことができます。 例: iPhone - iOS (other versions)。 このフィールドで使用できる値の詳細については、「 オペレーティング システム サービス」を参照してください。
pcode 文字列 いいえ ptv, ssptv, vmap, ssvmap 広告を要求するユーザーの郵便番号。 指定しない場合、郵便番号は IP アドレスから決定されます。
redirenc 文字列 いいえ ptv, ssptv, vmap, ssvmap 配信する有効なクリエイティブがない場合に使用するリダイレクト URL。 URL はエンコードする必要があります。
reserve int いいえ ptv, ssptv, vmap, ssvmap この在庫の予約価格。これは、クリエイティブを配置するために配置が受け入れる最小正味額です。 このパラメーターは、事前設定された価格をオーバーライドし、Yield Management が使用されていない場合、または予約価格が YM フロアよりも値が大きい場合は、フロア ルールのオーバーライド設定がオンになっている場合に、ハード フロア (および関連するソフト フロア) を設定します。
sha1mac 文字列 いいえ ptv, ssptv, vmap, ssvmap ODIN の SHA1 ハッシュ。 これは、iOS バージョン 5 以降でのみ送信する必要があります。 URL エンコードする必要があります。
st 文字列 いいえ ptv, ssptv, vmap, ssvmap 広告が表示される環境を示す在庫の供給の種類。 使用できる値: "mobile_app"、 "mobile_web"、または "web"。 既定値は "mobile_app" です。
size 文字列 いいえ ptv, ssptv, vmap, ssvmap 非推奨。 代わりに、 vwidth と vheight を使用します。 要求されたバナー サイズ ( "320x50"、スポット広告の画面サイズなど)。
tmpl_id int いいえ ptv, ssptv, vmap, ssvmap 供給テンプレート識別子。
traffic_source_code 文字列 いいえ ptv, ssptv, vmap, ssvmap トラフィック ソース コードを使用すると、特定のインプレッションのサードパーティのトラフィック ソースをチェックできます。 トラフィック ソース コードが Microsoft Advertising に事前登録されていて、 trafficSourceCode プロパティを使用してクエリ文字列を介して渡される場合は、インプレッションに対して発生したサード パーティのトラフィックのソースを知ることができます。
この traffic_source_code は Standard フィード に含まれており、発行元のキーと値の情報をフィードに渡すために使用できます。
ua 文字列 CTV インベントリを収益化するために必要です。 ptv, ssptv, vmap, ssvmap 広告を要求するデバイスに関連付けられているユーザー エージェント文字列。 指定した場合、HTTP ヘッダー経由で送信される標準ユーザー エージェントではなく、この値が使用されます。 URL エンコードする必要があります。 ユーザー エージェントは、デバイスのオペレーティング システムやデバイスの製造元やモデルなどの情報と、アプリケーションに関する情報、およびユーザーに代わって動作するソフトウェア ベンダーを識別します。 多くのバイヤーは、これらのパラメータに基づいて対象ユーザーをターゲットとし、それらを含まないと需要が制限されます。
us_privacy 文字列 いいえ ptv, ssptv IAB Tech Labの米国プライバシー文字列は、米国のプライバシー規制の下で消費者のプライバシーと選択に関するシグナルを伝えます。 サービス ポリシーの一部
詳細については、「サービス ポリシーの一部」を参照してください。
placement_set 文字列 いいえ vmap, ssvmap タグに関連付ける配置セット。 詳細については、「 配置セット サービス」を参照してください。
vmin_ad_duration* int CTV インベントリを収益化するために必要です。 ptv, ssptv, vmap, ssvmap 広告の最小再生時間 (秒単位)。
mimes* string CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap ビデオ MIME は、ID のコンマ区切りのリストとして表され、受け入れられます。 ID は、 Placement Service のドキュメント の 「サポートされている Mime の種類」にあります。
minbitrate* int CTV インベントリを収益化することをお勧めします。 ptv, ssptv, vmap, ssvmap 許容される最小ビットレート。
mf_min_height* int いいえ ptv, ssptv, vmap, ssvmap メディア ファイルの最小高さ (ピクセル単位)
mf_min_width* int いいえ ptv, ssptv, vmap, ssvmap メディア ファイルの最小幅 (ピクセル単位)
mf_aspect_ratio* int いいえ ptv, ssptv, vmap, ssvmap メディア ファイルの縦横比
an_user_id int いいえ ssptv Microsoft Advertising ユーザー ID
gpp 文字列 はい。該当する米国の状態のすべての GET 呼び出しで ptv, ssptv, vmap, ssvmap 実際の IAB GPP 同意文字列を示します。 これは、個人データを処理することが許可されているベンダーと、その条件を意味します。 このフィールドは、IAB Tech Lab の グローバル プライバシー プラットフォーム (GPP) の一部として説明されています。
gpp_sid 文字列配列 はい。該当する米国の状態のすべての GET 呼び出しで ptv, ssptv, vmap, ssvmap GPP のどのセクションが呼び出しに適用するかを示すブール値。
ext_inv_code レポートで使用できるクエリ文字列に渡される定義済みの値。 この値は、ログに記録される前にシステムに入力する必要があります。 詳細については、「外部インベントリ コード サービス」を参照してください。 例: ext_inv_code=10039