Media Type サービス
Xandr プラットフォームは、形式、メディアの種類、およびメディア サブタイプによってクリエイティブを分類します。
- 形式は、クリエイティブのリソースの種類 (フラッシュ、画像など) を定義します。
- メディアの種類は、クリエイティブの一般的な表示スタイル (バナー、展開可能、ビデオなど) を定義します。
- メディア サブタイプは、クリエイティブの特定の表示スタイル (標準バナー、MediaMind expandable、Standard VAST など) を定義します。
この読み取り専用サービスを使用すると、サポートされているすべてのメディアの種類を表示できます。
ヒント
サポートされているすべての形式とメディア サブタイプを表示するには、 Creative Format Service と Media サブタイプ サービスを使用できます。
REST API
| HTTP メソッド | エンドポイント | 説明 |
|---|---|---|
GET |
https://api.appnexus.com/media-type | すべてのメディアの種類を表示します。 |
GET |
https://api.appnexus.com/media-type?id=MEDIA_TYPE_ID | 特定のメディアの種類を表示します。 |
JSON フィールド
| フィールド | 種類 | 説明 |
|---|---|---|
code |
string | メディアの種類の名前のコードフレンドリ バージョン。 たとえば、"Image and Text" は "image_and_text" になります。 |
id |
int | メディアの種類の ID。 |
last_modified |
timestamp | Xandr がメディアの種類を最後に変更した日時。 |
media_type_group_id |
int | メディアの種類が属するグループ。 この情報は、プレースメントで許可されるメディア タイプを設定する場合に関連します ( 「プレースメント サービス」を参照してください)。 1 つの配置で許可できるのは、同じグループに属するメディアタイプのみです。 |
name |
string | メディアの種類の名前。 ("Banner"、"Interstitial"、または "Video" など)。 |
uses_sizes |
列挙 | メディアの種類に属するクリエイティブのサイズ要件。 使用可能な値: - "always": クリエイティブを追加する場合は幅と高さが必要です (バナーと展開可能)。- "sometimes": クリエイティブ (ポップとテキスト) を追加するときに、幅と高さが必要になる場合があります。- "never": クリエイティブ (スポット、ビデオ、スキン) を追加する場合、幅と高さは必要ありません。 |
例
すべてのメディアの種類を表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/media-type'
{
"response": {
"status": "OK",
"count": 8,
"start_element": null,
"num_elements": null,
"media-types": [
{
"id": 1,
"name": "Banner",
"media_type_group_id": 1,
"uses_sizes": "always",
"last_modified": "2012-03-16 21:36:10"
},
{
"id": 2,
"name": "Pop",
"media_type_group_id": 2,
"uses_sizes": "sometimes",
"last_modified": "2012-03-16 21:36:10"
},
{
"id": 3,
"name": "Interstitial",
"media_type_group_id": 1,
"uses_sizes": "never",
"last_modified": "2012-06-26 17:18:54"
},
{
"id": 4,
"name": "Video",
"media_type_group_id": 4,
"uses_sizes": "never",
"last_modified": "2012-03-16 21:36:10"
},
{
"id": 5,
"name": "Text",
"media_type_group_id": 1,
"uses_sizes": "sometimes",
"last_modified": "2012-03-16 21:36:10"
},
{
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always",
"last_modified": "2012-03-16 21:36:11"
},
{
"id": 8,
"name": "Skin",
"media_type_group_id": 1,
"uses_sizes": "never",
"last_modified": "2012-06-26 17:18:54"
},
{
"id": 9,
"name": "Facebook",
"media_type_group_id": 6,
"uses_sizes": "always",
"last_modified": "2012-06-27 18:53:17"
}
]
}
}
メディアの種類を表示する "Video" (ID 4)
$ curl -b cookies -c cookies 'https://api.appnexus.com/media-type?id=4'
{
"response": {
"status": "OK",
"count": 1,
"start_element": null,
"num_elements": null,
"media-type": {
"id": 4,
"name": "Video",
"media_type_group_id": 4,
"uses_sizes": "never",
"last_modified": "2012-03-16 21:36:10"
}
}
}
クリエイティブの幅と高さを常に必要とするメディアの種類を表示する
$ curl -b cookies -c cookies 'https://api.appnexus.com/media-type?uses_sizes=always'
{
"response": {
"status": "OK",
"count": 4,
"start_element": 0,
"num_elements": 100,
"media-types": [
{
"id": 1,
"name": "Banner",
"media_type_group_id": 1,
"uses_sizes": "always",
"last_modified": "2012-03-16 21:36:10",
"code": "banner"
},
{
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always",
"last_modified": "2012-03-16 21:36:11",
"code": "expandable"
},
{
"id": 9,
"name": "Facebook",
"media_type_group_id": 6,
"uses_sizes": "always",
"last_modified": "2012-06-27 18:53:17",
"code": "facebook"
},
{
"id": 10,
"name": "Image and Text",
"media_type_group_id": 1,
"uses_sizes": "always",
"last_modified": "2013-10-31 20:31:59",
"code": "image_and_text"
}
]
}
}