Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La plateforme Xandr catégorise les créations par format, type de média et sous-type de média. Le format définit le type de ressource des créations (flash, image, etc.) ; le type de média définit le style d’affichage général des éléments créatifs (bannière, extensible, vidéo, etc.) ; et le sous-type multimédia définit le style d’affichage spécifique des créatifs (bannière standard, mediamind extensible, STANDARD VAST, etc.).
Ce service en lecture seule vous permet d’afficher tous les sous-types de médias pris en charge et les types de médias auxquels ils appartiennent.
Conseil
Pour afficher tous les formats et types de médias pris en charge, vous pouvez utiliser creative format service et media type service.
API REST
| HTTP, méthode | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/media-subtype | Afficher tous les sous-types de média. |
GET |
https://api.appnexus.com/media-subtype?id=MEDIA_SUBTYPE_ID | Afficher un sous-type de média spécifique. |
GET |
https://api.appnexus.com/media-subtype?media_type.id=MEDIA_TYPE_ID | Afficher les sous-types de média qui appartiennent à un type de média spécifique. |
Champs JSON
| Champ | Type (longueur) | Description |
|---|---|---|
id |
int | ID du sous-type de média. |
last_modified |
Timestamp | Date et heure de la dernière modification du sous-type de média par Xandr. |
media_type |
objet | Type de média auquel appartient le sous-type. Pour plus d’informations, consultez Type de média ci-dessous. |
name |
string | Nom du sous-type de média. Par exemple, "Standard Banner", "In-Banner Video" ou "15-Second VAST". |
native_assets |
tableau d’objets | Tableau décrivant les contraintes sur les éléments d’annonces natives pour ce sous-type multimédia. Les éléments d’une publicité native peuvent inclure le titre, le contenu du corps, etc. Les contraintes du format peuvent être si le contenu du corps est requis ou recommandé, ou la durée du texte. Pour plus d’informations, consultez Ressources natives ci-dessous. |
permitted_sizes |
tableau d’objets | Tailles autorisées pour les créatifs du sous-type multimédia. Pour plus d’informations, consultez Tailles autorisées ci-dessous. Note: Les sous-types de média n’ont pas tous des exigences de taille autorisées. |
Type de média
L’objet media_type contient les champs suivants.
| Champ | Type | Description |
|---|---|---|
id |
int | ID du type de média. |
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 |
chaîne | Nom du type de média. Par exemple : "Banner" 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). |
Tailles autorisées
Chaque objet du permitted_sizes tableau contient les champs suivants.
| Champ | Type | Description |
|---|---|---|
aspect_ratio_tolerance |
double | Si validate_image_size et scaling_permitted sont à la fois true, l’image peut s’écarter des proportions de platform_width et platform_height de cette quantité. Par exemple, les proportions d’un platform_width et platform_height de 254 x 133 sont de 1,19 :1. Si est aspect_ratio_tolerance 0,03, un rapport d’aspect compris entre 1,16 :1 et 1,22 :1 serait acceptable. |
max_image_height |
int | Si validate_image_size est true, la hauteur d’image maximale acceptable, en pixels, pour les créatifs de ce sous-type multimédia. |
min_image_height |
int | Si validate_image_size est true, la hauteur d’image minimale acceptable, en pixels, pour les créatifs de ce sous-type multimédia. |
max_image_width |
int | Si validate_image_size est true, la largeur d’image maximale acceptable, en pixels, pour les créatifs de ce sous-type multimédia. |
min_image_width |
int | Si validate_image_size est true, la largeur d’image minimale acceptable, en pixels, pour les créatifs de ce sous-type multimédia. |
platform_height |
int | Hauteur de rendu réelle, en pixels, pour les créatifs de ce sous-type multimédia. Il s’agit également de la hauteur qui apparaît dans les rapports. |
platform_width |
int | Largeur de rendu réelle, en pixels, pour les créatifs de ce sous-type multimédia. Il s’agit également de la largeur qui apparaît dans les rapports. |
scaling_permitted |
valeur booléenne | Si la valeur est true, l’image pour les créatifs de ce sous-type multimédia doit avoir les mêmes proportions que/platform_widthplatform_height .Si la valeur est false, l’image pour les créatifs de ce sous-type multimédia doit avoir une largeur et une hauteur correspondant exactement à platform_width et platform_height. |
validate_image_size |
valeur booléenne | Si la valeur est true, l’image des créatifs de ce sous-type multimédia est validée par rapport aux exigences définies par les champs suivants dans cet objet :- scaling_permitted- aspect_ratio_tolerance- min_image_width- max_image_width- min_image_height- max_image_height |
Ressources natives
| Champ | Type | Description |
|---|---|---|
max_text_length |
int | Longueur maximale autorisée du texte de la ressource native pour ce sous-type multimédia, en caractères. |
min_text_length |
int | Longueur minimale autorisée du texte de la ressource native pour ce sous-type multimédia, en caractères. |
native_asset_name |
enum | Nom de la ressource native. Il peut s’agir de l’un des éléments suivants : - "title"- "content"- "description"- "full_text"- "context"- "icon_img_url"- "main_media"- "cta"- "rating"- "click_fallback_url" |
requirement |
enum | Indique si cette ressource est requise par ce sous-type de média particulier. Ce champ peut contenir plusieurs niveaux de "requiredness":- "required"- "recommended"- "optional" |
Exemples
Afficher tous les sous-types de média
$ curl -b cookies -c cookies 'https://api.appnexus.com/media-subtype'
{
"response": {
"status": "OK",
"count": 26,
"start_element": null,
"num_elements": null,
"media-subtypes": [
{
"id": 1,
"name": "Standard Banner",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 1,
"name": "Banner",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 2,
"name": "Popup",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 2,
"name": "Pop",
"media_type_group_id": 2,
"uses_sizes": "sometimes"
}
},
{
"id": 3,
"name": "In-Banner Video",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 1,
"name": "Banner",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 4,
"name": "Popunder",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 2,
"name": "Pop",
"media_type_group_id": 2,
"uses_sizes": "sometimes"
}
},
{
"id": 5,
"name": "Standard Interstitial",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 3,
"name": "Interstitial",
"media_type_group_id": 1,
"uses_sizes": "never"
}
},
{
"id": 7,
"name": "15-second VAST",
"last_modified": "2012-02-17 22:58:10",
"media_type": {
"id": 4,
"name": "Video",
"media_type_group_id": 4,
"uses_sizes": "never"
}
},
{
"id": 8,
"name": "30-second VAST",
"last_modified": "2012-02-17 22:58:10",
"media_type": {
"id": 4,
"name": "Video",
"media_type_group_id": 4,
"uses_sizes": "never"
}
},
{
"id": 9,
"name": "Text",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 5,
"name": "Text",
"media_type_group_id": 1,
"uses_sizes": "sometimes"
}
},
{
"id": 10,
"name": "Other Expandable",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 11,
"name": "MediaMind",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 12,
"name": "Pointroll",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 13,
"name": "EyeWonder",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 14,
"name": "EyeReturn",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 15,
"name": "Pictela",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 16,
"name": "Flashtalking",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 17,
"name": "Doubleclick",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 18,
"name": "Unicast",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 19,
"name": "Spongecell",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 20,
"name": "Adrime",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 21,
"name": "Layer",
"last_modified": "2012-02-01 18:49:36",
"media_type": {
"id": 3,
"name": "Interstitial",
"media_type_group_id": 1,
"uses_sizes": "never"
}
},
{
"id": 22,
"name": "Slide-in",
"last_modified": "2012-02-01 18:49:37",
"media_type": {
"id": 3,
"name": "Interstitial",
"media_type_group_id": 1,
"uses_sizes": "never"
}
},
{
"id": 23,
"name": "Other VAST",
"last_modified": "2012-02-17 22:58:11",
"media_type": {
"id": 4,
"name": "Video",
"media_type_group_id": 4,
"uses_sizes": "never"
}
},
{
"id": 24,
"name": "Oggifinogi",
"last_modified": "2012-02-20 19:07:46",
"media_type": {
"id": 6,
"name": "Expandable",
"media_type_group_id": 1,
"uses_sizes": "always"
}
},
{
"id": 48,
"name": "IAB",
"last_modified": "2012-04-30 16:39:35",
"media_type": {
"id": 8,
"name": "Skin",
"media_type_group_id": 1,
"uses_sizes": "never"
}
},
{
"id": 49,
"name": "Custom",
"last_modified": "2012-04-30 16:39:35",
"media_type": {
"id": 8,
"name": "Skin",
"media_type_group_id": 1,
"uses_sizes": "never"
}
}
}
]
}
}
Afficher le "Standard VAST" sous-type de média (ID 64)
$ curl -b cookies -c cookies 'https://api.appnexus.com/media-subtype?id=64'
{
"response": {
"status": "OK",
"count": 1,
"start_element": 0,
"num_elements": 100,
"media-subtype": {
"id": 64,
"name": "Standard VAST",
"last_modified": "2014-09-04 13:06:04",
"media_type": {
"id": 4,
"name": "Video",
"media_type_group_id": 4,
"uses_sizes": "never"
},
"permitted_sizes": null,
"native_assets": null
}
}
}
Afficher les sous-types de média qui appartiennent au type de "Banner" média
$ curl -b cookies -c cookies 'https://api.appnexus.com/media-subtype?media_type.id=1'
{
"response": {
"status": "OK",
"count": 2,
"start_element": 0,
"num_elements": 100,
"media-subtypes": [
{
"id": 1,
"name": "Standard Banner",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 1,
"name": "Banner",
"media_type_group_id": 1,
"uses_sizes": "always"
},
"permitted_sizes": null
},
{
"id": 3,
"name": "In-Banner Video",
"last_modified": "2012-01-27 16:14:43",
"media_type": {
"id": 1,
"name": "Banner",
"media_type_group_id": 1,
"uses_sizes": "always"
},
"permitted_sizes": null
}
]
}
}