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"
            }
        ]
    }
    }