Partager via

Service de type de média

La plateforme Xandr catégorise les créatifs par format, type de média et sous-type de média :

  • Le format définit le type de ressource du créatif (flash, image, etc.)
  • Le type de média définit le style d’affichage général du créatif (bannière, extensible, vidéo, etc.)
  • Le sous-type media définit le style d’affichage spécifique du créatif (bannière standard, mediamind extensible, STANDARD VAST, etc.)

Ce service en lecture seule vous permet d’afficher tous les types de médias pris en charge.

Conseil

Pour afficher tous les formats et sous-types multimédias pris en charge, vous pouvez utiliser creative format service et media subtype service.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/media-type Afficher tous les types de médias.
GET https://api.appnexus.com/media-type?id=MEDIA_TYPE_ID Afficher un type de média spécifique.

Champs JSON

Champ Type Description
code string Version conviviale du nom du type de média. Par exemple, "Image and Text" devient "image_and_text".
id int ID du type de média.
last_modified Timestamp Date et heure de la dernière modification du type de média par Xandr.
media_type_group_id int Groupe auquel appartient un type de média. Ces informations sont pertinentes pour définir les types de médias autorisés sur les placements (consultez Service de placement). Seuls les types de médias qui appartiennent au même groupe peuvent être autorisés sur un seul emplacement.
name string Nom du type de média. Par exemple, "Banner", "Interstitial" ou "Video".
uses_sizes enum La taille requise pour les éléments créatifs appartenant au type de média.
Valeurs possibles :
- "always": La largeur et la hauteur sont requises lors de l’ajout de créations (bannière et extensible).
- "sometimes": La largeur et la hauteur sont parfois requises lors de l’ajout de créations (pop et texte).
- "never": La largeur et la hauteur ne sont pas requises lors de l’ajout de créations (Interstitial, Video et Skin).

Exemples

Afficher tous les types de médias

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

Afficher le type de "Video" média (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"
        }
    }
}

Afficher les types de médias qui nécessitent toujours que les créatifs aient une largeur et une hauteur

$ 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"
            }
        ]
    }
    }
  • Last updated on