Partager via


API de plateforme numérique - Service de modèle d’appareil

Les appareils mobiles sont classés par marque et modèle, où la marque est généralement le fabricant de l’appareil (par exemple, Apple) et le modèle est généralement le produit spécifique (comme l’iPhone). Le service de modèle d’appareil en lecture seule vous permet de voir quels modèles d’appareils mobiles sont inscrits dans le système Xandr, ainsi que la marque, le type d’appareil (téléphone, tablette ou autre appareil), la taille de l’écran de l’appareil et les fonctionnalités prises en charge (telles que les créations JavaScript, les créations Flash, les cookies) pour chaque modèle. Vous pouvez utiliser ce service pour récupérer ces données à des fins de ciblage dans des campagnes mobiles.

Remarque

Vous pouvez également cibler des campagnes mobiles basées sur l’opérateur mobile. Pour plus d’informations, consultez service d’opérateur.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/device-model Afficher tous les modèles d’appareil
GET https://api.appnexus.com/device-model?device_type=DEVICE_TYPE Afficher tous les modèles d’appareil d’un type spécifique (par exemple, pc, phoneou tablet)
GET https://api.appnexus.com/device-model?id=DEVICE_MODEL_ID Afficher un modèle d’appareil spécifique
GET https://api.appnexus.com/device-model/meta Découvrez les champs que vous pouvez filtrer et trier par

Champs JSON

Champ Type Description
codes tableau d’objets Représentations tierces pour le modèle d’appareil. Pour plus d’informations, consultez Codes ci-dessous.
device_make_id int ID de la fabrique d’appareil à laquelle appartient le modèle. Par exemple, le modèle d’appareil iPhone appartient à la fabrique de l’appareil Apple .
device_make_name string Nom de la fabrique d’appareil à laquelle appartient le modèle.
device_type enum Type d’appareil. Valeurs possibles :
- pc
- phone
- tablet
- tv
- gameconsole
- stb
- mediaplayer
id int ID du modèle d’appareil.
name string Nom du modèle d’appareil (par exemple iPhone, ).
screen_height int Hauteur de l’écran sur l’appareil.
screen_width int Largeur de l’écran sur l’appareil.
supports_cookies Valeur booléenne Pas encore disponible. Si la valeur est true, l’appareil prend en charge les cookies. Si nullla valeur est , Xandr ne sait pas si l’appareil prend en charge les cookies.
supports_flash Valeur booléenne Pas encore pris en charge. Si la valeur est true, l’appareil prend en charge les créations Flash. Si nullla valeur est , Xandr ne sait pas si l’appareil prend ou non en charge Flash.
supports_geo Valeur booléenne Pas encore disponible. Si truela valeur est , l’appareil peut transmettre la latitude et la longitude des utilisateurs lorsque les données GPS sont disponibles.
supports_html_audio Valeur booléenne Pas encore disponible. Si la valeur est true, l’appareil prend en charge les créations audio HTML. Si nullla valeur est , Xandr ne sait pas si l’appareil prend en charge l’audio HTML.
supports_html_video Valeur booléenne Pas encore disponible. Si la valeur est true, l’appareil prend en charge les créations vidéo HTML. Si nullla valeur est , Xandr ne sait pas si l’appareil prend en charge la vidéo HTML.
supports_js Valeur booléenne Pas encore disponible. Si la valeur est true, l’appareil prend en charge les éléments créatifs JavaScript. Si la valeur est null, Xandr ne sait pas si l’appareil prend ou non en charge JavaScript.

Codes

Chaque objet du codes tableau contient les champs suivants.

Champ Type Description
id int ID du modèle d’appareil.
code chaîne Représentation tierce pour le modèle d’appareil.
notes string Informations d’identification sur le tiers.
device_model_id int ID du modèle d’appareil.

Exemples

Afficher tous les modèles d’appareils mobiles

$ 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
                    }
                ]
            },
            ...
        ]
    }
}

Afficher un modèle spécifique d’appareil mobile

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

Afficher tous les modèles d’appareils "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
                    }
                ]
            },
            ...
        ]
    }
}