次の方法で共有


Android および iOS インベントリに必要なタグ パラメーター

モバイル デバイス タグを Android タグと iOS タグに分けるか、 ifaifa_type パラメーター、 aaid、または idfa を使用して、デバイス識別子とデバイスの種類をクエリ文字列に動的に渡すことができます。 在庫を収益化するには、配置でこれらの値が設定されていない限り、幅や高さなどの追加のパラメーターが必要であることに注意してください。

次の例では、サンプル サーバー側タグにデバイスの種類と識別子を実装する方法を示します。

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>&idfa=<INSERT_MACRO>

Android タグと iOS タグには、次のパラメーターが必要です。

パラメーター 必須 互換性のあるハンドラー 説明
appid (モバイル) string はい ptv, ssptv, vmap, ssvmap この文字列は、Android または iOS デバイスで実行されているモバイル アプリを識別するために使用されます。
- Android では、これはアプリのパッケージ名です。 次のように書式設定されます: com.example.helloworld
- iOS では、これはアプリの数値 iOS ストア ID で、App Storeによって自動生成されます。 次のように書式設定されます: 123456789
多くの購入者は、appid に基づいてキャンペーンのターゲット設定とレポートを設定します。 正しい appid を提供しなかった場合、これらの購入者は在庫を魅力的にできなくなります。 そのため、 supply_typemobile_app に設定されている場合は、このフィールドを渡すことを強くお勧めします。 これは、モバイル SDK が広告を要求するときに行うことです。 SDK が appidに渡される方法を理解するには、例を参照してください。
特定の 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
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)、 ppidtifa (Tizen (Samsung))、 vida (Vizio)、 lgudid (LG) です。
: デバイスまたはプラットフォーム ID を動的に渡すことができない場合は、次を使用する必要があります。
- ifa_type=openudid 認証データがあり、永続的な ID を渡すことができる場合は、CTV 広告要求の場合
- 永続的な ID を持つ認証データがない場合は、&ifa_type=sessionid
referrer string デスクトップおよびモバイル Web にのみ必要 ptv, ssptv, vmap, ssvmap 広告が表示される URL
vcontext int インベントリを収益化するために必要 ptv, ssptv ビデオの配置の位置。 使用可能な値:
- 1 - リニアプリロール
- 2 - リニアミッドロール
- 3 - リニアポストロール
- 4 - アウトストリーム
- 5 - バナーストリーム
- 6 - In-Feed
- 7 - スポット
- 8 - 関連するコンテンツの事前ロール
- 9 - 関連コンテンツミッドロール
- 10 - 関連コンテンツポストロール

: 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 プレイヤーの高さ (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。
vmaxduration int いいえ ptv, ssptv, vmap, ssvmap 1 回の要求の場合、これはビデオの最大配置時間 (秒単位) です。 この値より長い期間のクリエイティブは、オークションから除外されます。 ポッド化されたインベントリの場合、これは完全なポッドの長さです。
vwidth int インベントリを収益化するために必要 ptv, ssptv, vmap, ssvmap プレイヤーの幅 (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。