モバイル デバイス タグを Android タグと iOS タグに分けるか、 ifa
と ifa_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_type が mobile_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)、 ppid 、 tifa (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 |
プレイヤーの幅 (ピクセル単位)。 必須ではありませんが、ビデオ入札者が入札リクエストの幅と高さの両方を確実に受け取るために、このパラメーターをお勧めします。 |