Digital Platform API - デバイス モデル サービス

  • [アーティクル]

モバイル デバイスは make とモデルによって分類されます。make は一般にデバイスの製造元 (Apple など) であり、モデルは一般に特定の製品 (iPhone など) です。 読み取り専用デバイス モデル サービスを使用すると、Xandr システムに登録されているモバイル デバイスのモデルと、メイク、デバイスの種類 (電話、タブレット、またはその他のデバイス)、デバイスの画面サイズ、サポートされている機能 (JavaScript クリエイティブ、Flash クリエイティブ、Cookie など) をモデルごとに確認できます。 このサービスを使用して、モバイル キャンペーンのターゲット設定のためにこのデータを取得できます。

注:

携帯電話会社に基づいてモバイル キャンペーンをターゲットにすることもできます。 詳細については、 運送業者サービスに関するページを参照してください。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/device-model すべてのデバイス モデルを表示する
GET https://api.appnexus.com/device-model?device_type=DEVICE_TYPE 特定の種類 (、、pcphoneまたはtablet) のすべてのデバイス モデルを表示する
GET https://api.appnexus.com/device-model?id=DEVICE_MODEL_ID 特定のデバイス モデルを表示する
GET https://api.appnexus.com/device-model/meta フィルター処理および並べ替え可能なフィールドを確認する

JSON フィールド

フィールド 種類 説明
codes オブジェクトの配列 デバイス モデルのサード パーティの表現。 詳細については、以下の コード を参照してください。
device_make_id int モデルが属するデバイスの ID。 たとえば、 iPhone デバイス モデルはデバイス make に Apple 属します。
device_make_name string モデルが属するデバイスの名前。
device_type 列挙 デバイスの種類。 使用可能な値:
- pc
- phone
- tablet
- tv
- gameconsole
- stb
- mediaplayer
id int デバイス モデルの ID。
name string デバイス モデルの名前 (など iPhone)。
screen_height int デバイス上の画面の高さ。
screen_width int デバイス上の画面の幅。
supports_cookies ブール型 まだ利用できません。 の場合 true、デバイスは Cookie をサポートします。 の場合 null、Xandr は、デバイスが Cookie をサポートしているかどうかを認識しません。
supports_flash ブール型 まだサポートされていません。 の場合 true、デバイスは Flash クリエイティブをサポートします。 の場合 null、Xandr はデバイスが Flash をサポートしているかどうかを認識しません。
supports_geo ブール型 まだ利用できません。 の場合 true、GPS データが使用可能な場合、デバイスはユーザーの緯度と経度を渡すことができます。
supports_html_audio ブール型 まだ利用できません。 の場合 true、デバイスは HTML オーディオ クリエイティブをサポートします。 の場合 null、Xandr はデバイスが HTML オーディオをサポートしているかどうかを認識しません。
supports_html_video ブール型 まだ利用できません。 の場合 true、デバイスは HTML ビデオ クリエイティブをサポートします。 の場合 null、Xandr はデバイスが HTML ビデオをサポートしているかどうかを認識しません。
supports_js ブール型 まだ利用できません。 の場合 true、デバイスは JavaScript クリエイティブをサポートします。 の場合 null、Xandr は、デバイスが JavaScript をサポートしているかどうかを認識しません。

Codes

配列内の codes 各オブジェクトには、次のフィールドが含まれています。

フィールド 種類 説明
id int デバイス モデルの ID。
code string デバイス モデルのサード パーティの表現。
notes string サード パーティに関する識別情報。
device_model_id int デバイス モデルの ID。

例

モバイル デバイスのすべてのモデルを表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/device-model'
{
    "response": {
        "status": "OK",
        "count": 9033,
        "start_element": null,
        "num_elements": null,
        "device-models": [
            {
                "id": 1,
                "name": "Onetab XST2",
                "device_make_id": 1,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "4G Systems",
                "codes": [
                    {
                        "id": 1,
                        "code": "da-3499464",
                        "notes": "4G Systems:Onetab XST2",
                        "device_model_id": 1
                    }
                ]
            },
            {
                "id": 2,
                "name": "PAD7",
                "device_make_id": 2,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "A-Link",
                "codes": [
                    {
                        "id": 2,
                        "code": "da-3924965",
                        "notes": "A-Link:PAD7",
                        "device_model_id": 2
                    }
                ]
            },
            {
                "id": 3,
                "name": "A101",
                "device_make_id": 3,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "Acer",
                "codes": [
                    {
                        "id": 3,
                        "code": "da-3318996",
                        "notes": "Acer:A101",
                        "device_model_id": 3
                    }
                ]
            },
            {
                "id": 4,
                "name": "A200",
                "device_make_id": 3,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "Acer",
                "codes": [
                    {
                        "id": 4,
                        "code": "da-3334186",
                        "notes": "Acer:A200",
                        "device_model_id": 4
                    }
                ]
            },
            ...
        ]
    }
}

モバイル デバイスの特定のモデルを表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/device-model?id=2'
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": null,
        "num_elements": null,
        "device-model": {
            "id": 2,
            "name": "PAD7",
            "device_make_id": 2,
            "device_type": "tablet",
            "screen_width": null,
            "screen_height": null,
            "is_aggregated": false,
            "supports_js": null,
            "supports_cookies": null,
            "supports_flash": null,
            "supports_geo": null,
            "supports_html_video": null,
            "supports_html_audio": null,
            "device_make_name": "A-Link",
            "codes": [
                {
                    "id": 2,
                    "code": "da-3924965",
                    "notes": "A-Link:PAD7",
                    "device_model_id": 2
                }
            ]
        }
    }
}

デバイスのすべてのモデルを "tablet" 表示する

$ curl -b cookies -c cookies 'https://api.appnexus.com/device-model?device_type=tablet'
{
    "response": {
        "status": "OK",
        "count": 547,
        "start_element": null,
        "num_elements": null,
        "device-models": [
            {
                "id": 1,
                "name": "Onetab XST2",
                "device_make_id": 1,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "4G Systems",
                "codes": [
                    {
                        "id": 1,
                        "code": "da-3499464",
                        "notes": "4G Systems:Onetab XST2",
                        "device_model_id": 1
                    }
                ]
            },
            {
                "id": 2,
                "name": "PAD7",
                "device_make_id": 2,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "A-Link",
                "codes": [
                    {
                        "id": 2,
                        "code": "da-3924965",
                        "notes": "A-Link:PAD7",
                        "device_model_id": 2
                    }
                ]
            },
            {
                "id": 3,
                "name": "A101",
                "device_make_id": 3,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "Acer",
                "codes": [
                    {
                        "id": 3,
                        "code": "da-3318996",
                        "notes": "Acer:A101",
                        "device_model_id": 3
                    }
                ]
            },
            {
                "id": 4,
                "name": "A200",
                "device_make_id": 3,
                "device_type": "tablet",
                "screen_width": null,
                "screen_height": null,
                "is_aggregated": false,
                "supports_js": null,
                "supports_cookies": null,
                "supports_flash": null,
                "supports_geo": null,
                "supports_html_video": null,
                "supports_html_audio": null,
                "device_make_name": "Acer",
                "codes": [
                    {
                        "id": 4,
                        "code": "da-3334186",
                        "notes": "Acer:A200",
                        "device_model_id": 4
                    }
                ]
            },
            ...
        ]
    }
}