CTV には 1 つの組み合わせタグを使用することも、デバイスの種類ごとに個別のタグを作成することもできます。 デバイスを識別するときは、 ifa と ifa_type を使用することをお勧めします。これらのパラメーターを使用できない場合は、 openudidを使用できます。
注:
在庫を収益化するには、配置でこれらの値が設定されていない限り、幅や高さなどの追加のパラメーターが必要です。
次の例では、 ifa/ifa_type または を使用してサーバー側タグを実装する方法を示します。 ifa と ifa_type を使用できない場合は、 openudid。
https://secure.adnxs.com/ssptv?id=<PLACEMENT_ID>&appid=<INSERT_MACRO>&ifa=<INSERT_MACRO>&ifa_type=<INSERT_MACRO>
https://secure.adnxs.com/ssptv?id=<PLACEMENT_ID>&appid=<INSERT_MACRO>&openudid=<INSERT_MACRO>
| パラメーター | 型 | 必須 | 互換性のあるハンドラー | 説明 |
|---|---|---|---|---|
appid (CTV) |
string | はい |
ptv, ssptv, vmap, ssvmap |
この文字列は、Apple TV、Fire TV、Android TV、Roku などの ConnectedTV デバイスで実行されているアプリを識別するために使用されます。 - Android では、これはアプリのパッケージ名です。 次のように書式設定されます: com.example.helloworld。- iOS では、これはアプリの数値 iOS ストア ID で、App Storeによって自動生成されます。 次のように書式設定されます: 123456789。 多くの購入者は、 appidに基づいてキャンペーンのターゲット設定とレポートを設定します。 正しい appid を提供しなかった場合、これらの購入者は在庫を魅力的にできなくなります。 そのため、 supply_type が mobile_app に設定されている場合は、このフィールドを渡すことを強くお勧めします。特定の Android または IOS アプリのアプリ ID を見つけるには、Web 検索を使用して見つけることができるアプリの詳細ページを見つけます。 アプリ ストアの詳細ページの URL には、アプリの ID が表示されます。 たとえば、"Fussball" アプリの詳細ページを次に示します。 - Google Play: https://play.google.com/store/apps/details?id=de.telekom.FUSSBALL.DE- iTunes: https://itunes.apple.com/de/app/fussball.de/id422052549 |
channel_name |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv |
コンテンツがオンになっているチャネルの名前。 |
content_cat |
文字列配列 | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツ プロデューサーを記述する IAB コンテンツ カテゴリの配列。 リスト 5.1 を参照してください。 |
content_context |
int | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツの種類 (ゲーム、ビデオ、テキストなど)。 |
content_contentrating |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツレーティング (例: PG-13)。 |
content_episode |
int | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
エピソード番号。 |
content_genre |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツを最もよく表すジャンル。 |
content_len |
int | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツの期間 (秒単位)。 |
content_livestream |
int | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツがライブまたはビデオ オンデマンド (VOD) のいずれであるか。 0: VOD、1: Live。 |
content_network |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
最上位の親企業、または関連する場合は、複数のテレビのようなチャネル、d2c コンテンツ ブランド、またはコンテンツが表示されているデジタル プロパティを所有するサブブランド。 |
content_prodq |
int | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
生産品質。 |
content_season |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツ シーズン (例: "シーズン 3")。 このフィールドは、CTV (Connected TV) インベントリを収益化するために重要です。 |
content_series |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツ シリーズ。 ビデオの例: "The Office" (テレビ)、"Star Wars" (映画)、または "Arby 'N' The Chief" (Web 用)。 ビデオ以外の例: "Ecocentric" (タイム マガジン ブログ)。 |
content_title |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
コンテンツ タイトル。 ビデオの例: "検索委員会" (テレビ)、"新しい希望" (映画)、または "Endgame" (Web 用に作成)。 ビデオ以外の例: "なぜ南極氷河がこんなに早く溶けているのか" (タイム誌の記事)。 |
id |
string | はい |
ptv, ssptv, vmap, ssvmap |
広告が配信される配置の一意の ID。 生の配置 ID を渡さない場合は、 member パラメーターと inv_code パラメーターの組み合わせを渡すことができます。 詳細については、「クエリ パラメーターを使用したターゲット ビデオ属性」を参照してください。 |
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 を持つ認証データがない場合 |
ip |
string | インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
広告要求を行うデバイスの IP アドレス (例: 207.237.150.246)。- /ptv呼び出しと/ssptv呼び出しにipが指定されていない場合、システムは geo 検出に "X-Forwarded-For" HTTP ヘッダーを介して渡された IP を使用します。 |
mimes* |
string | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
ビデオ MIME は、ID のコンマ区切りのリストとして表され、受け入れられます。 ID は、 Placement Service のドキュメント の 「サポートされている Mime の種類」にあります。 |
minbitrate* |
int | インベントリを収益化することをお勧めします。 |
ptv, ssptv, vmap, ssvmap |
許容される最小ビットレート。 |
ua |
string | インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
広告を要求するデバイスに関連付けられているユーザー エージェント文字列。 指定した場合、HTTP ヘッダー経由で送信される標準ユーザー エージェントではなく、この値が使用されます。 URL エンコードする必要があります。 ユーザー エージェントは、デバイスのオペレーティング システムやデバイスの製造元やモデルなどの情報と、アプリケーションに関する情報、およびユーザーに代わって動作するソフトウェア ベンダーを識別します。 多くのバイヤーは、これらのパラメータに基づいて対象ユーザーをターゲットとし、それらを含まないと需要が制限されます。 |
vcontext |
int | インベントリを収益化するために必要です。 |
ptv, ssptv |
ビデオの配置の位置。 使用可能な値: - 1 - リニアプリロール - 2 - リニアミッドロール - 3 - リニアポストロール 注: vcontext値にマップされた対応する OpenRTB 2.6 フィールド (video.plcmt) については、OpenRTB 2.6 のドキュメントを参照してください。 |
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. |
vheight |
int | インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
プレイヤーの高さ (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。 |
vmax_slot_duration |
int | ポッドに複数のスロットがある要求で CTV インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
広告ポッドのスロットあたりの最大動画再生時間 (秒単位)。 この値より長い期間のクリエイティブはポッドから除外されます。 注: この値は、配置と要求 (vmaxduration) にポッドの最大継続時間の値が指定されていない場合にのみ、配置ビデオ設定で定義されているスロットの最大期間をオーバーライドします。 |
vmaxduration |
int | インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
1 回の要求の場合、これはビデオの最大配置時間 (秒単位) です。 この値より長い期間のクリエイティブは、オークションから除外されます。 ポッド化されたインベントリの場合、これは完全なポッドの長さです。 |
vmin_ad_duration* |
int | インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
広告の最小再生時間 (秒単位)。 |
vv |
int | インベントリを収益化するために必要です。 |
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。 |
vwidth |
int | インベントリを収益化するために必要です。 |
ptv, ssptv, vmap, ssvmap |
プレイヤーの幅 (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。 |