Servicio de subtipo multimedia
La plataforma Xandr clasifica las creatividades por formato, tipo de medio y subtipo multimedia. El formato define el tipo de recurso de las creatividades (flash, imagen, etc.); el tipo de medio define el estilo de visualización general de los creativos (banner, ampliable, vídeo, etc.); y el subtipo multimedia define el estilo de visualización específico de las creatividades (banner estándar, MediaMind ampliable, VAST estándar, etc.).
Este servicio de solo lectura permite ver todos los subtipos multimedia admitidos y los tipos de medios a los que pertenecen.
Sugerencia
Para ver todos los formatos y tipos de medios admitidos, puede usar el servicio de formato creativo y el servicio de tipo multimedia.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/media-subtype | Ver todos los subtipos multimedia. |
GET |
https://api.appnexus.com/media-subtype?id=MEDIA_SUBTYPE_ID | Ver un subtipo de medios específico. |
GET |
https://api.appnexus.com/media-subtype?media_type.id=MEDIA_TYPE_ID | Ver subtipos multimedia que pertenecen a un tipo de medio específico. |
Campos JSON
| Campo | Tipo (longitud) | Description |
|---|---|---|
id |
Entero | Identificador del subtipo multimedia. |
last_modified |
Timestamp | Fecha y hora en que Xandr modificó por última vez el subtipo multimedia. |
media_type |
object | Tipo de medio al que pertenece el subtipo. Para obtener más información, vea Tipo de medio a continuación. |
name |
string | Nombre del subtipo multimedia. Por ejemplo, "Standard Banner", "In-Banner Video" o "15-Second VAST". |
native_assets |
matriz de objetos | Matriz que describe restricciones en los elementos de anuncios nativos para este subtipo multimedia. Los elementos de un anuncio nativo pueden incluir el título, el contenido del cuerpo y mucho más. Las restricciones del formato pueden ser si el contenido del cuerpo es necesario o recomendado, o cuánto tiempo puede ser el texto. Para obtener más información, consulte Recursos nativos a continuación. |
permitted_sizes |
matriz de objetos | Tamaños permitidos para las creatividades del subtipo multimedia. Para obtener más información, consulte Tamaños permitidos a continuación. Nota: No todos los subtipos multimedia tienen requisitos de tamaño permitidos. |
Tipo de medio
El media_type objeto contiene los campos siguientes.
| Campo | Tipo | Description |
|---|---|---|
id |
Entero | Identificador del tipo de medio. |
media_type_group_id |
Entero | Grupo al que pertenece un tipo de medio. Esta información es relevante para establecer los tipos de medios permitidos en las ubicaciones (consulte Servicio de selección de ubicación). Solo se pueden permitir los tipos de medios que pertenecen al mismo grupo en una sola ubicación. |
name |
string | Nombre del tipo de medio. Por ejemplo, "Banner" o "Video". |
uses_sizes |
enumeración | Requisito de tamaño para las creatividades que pertenecen al tipo de medio. Posibles valores: - "always": el ancho y el alto son necesarios al agregar creatividades (Banner y Expandable).- "sometimes": el ancho y el alto a veces son necesarios al agregar creatividades (pop y texto).- "never": el ancho y el alto no son necesarios al agregar creatividades (intersticiales, de vídeo y de piel). |
Tamaños permitidos
Cada objeto de la permitted_sizes matriz contiene los campos siguientes.
| Campo | Tipo | Description |
|---|---|---|
aspect_ratio_tolerance |
double | Si validate_image_size y scaling_permitted son , truela imagen puede desviarse de la relación de aspecto de platform_width y platform_height por esta cantidad. Por ejemplo, la relación de aspecto para un platform_width y platform_height de 254x133 es 1,19:1. Si es aspect_ratio_tolerance 0,03, sería aceptable una relación de aspecto entre 1,16:1 y 1,22:1. |
max_image_height |
Entero | Si validate_image_size es true, el alto máximo aceptable de la imagen, en píxeles, para las creatividades de este subtipo multimedia. |
min_image_height |
Entero | Si validate_image_size es true, el alto mínimo aceptable de la imagen, en píxeles, para las creatividades de este subtipo multimedia. |
max_image_width |
Entero | Si validate_image_size es true, el ancho de imagen máximo aceptable, en píxeles, para las creatividades de este subtipo multimedia. |
min_image_width |
Entero | Si validate_image_size es true, el ancho de imagen mínimo aceptable, en píxeles, para las creatividades de este subtipo multimedia. |
platform_height |
Entero | Alto de representación real, en píxeles, para las creatividades de este subtipo multimedia. Este también es el alto que aparece en los informes. |
platform_width |
Entero | Ancho de representación real, en píxeles, para las creatividades de este subtipo multimedia. Este también es el ancho que aparece en los informes. |
scaling_permitted |
booleano | Si truees , la imagen de las creatividades de este subtipo multimedia debe tener la misma relación de aspecto que/platform_widthplatform_height .Si falsees , la imagen de las creatividades de este subtipo multimedia debe tener un ancho y un alto que coincidan exactamente con platform_width y platform_height. |
validate_image_size |
booleano | Si truees , la imagen de las creatividades de este subtipo multimedia se validará según los requisitos definidos por los siguientes campos de este objeto:- scaling_permitted- aspect_ratio_tolerance- min_image_width- max_image_width- min_image_height- max_image_height |
Recursos nativos
| Campo | Tipo | Description |
|---|---|---|
max_text_length |
Entero | Longitud máxima permitida del texto del recurso nativo para este subtipo multimedia, en caracteres. |
min_text_length |
Entero | Longitud mínima permitida del texto del recurso nativo para este subtipo multimedia, en caracteres. |
native_asset_name |
enumeración | Nombre del recurso nativo. Puede ser una de las siguientes: - "title"- "content"- "description"- "full_text"- "context"- "icon_img_url"- "main_media"- "cta"- "rating"- "click_fallback_url" |
requirement |
enumeración | Si este recurso es necesario para este subtipo multimedia determinado. Este campo puede contener varios niveles de "requiredness":- "required"- "recommended"- "optional" |
Ejemplos
Ver todos los subtipos multimedia
$ 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"
}
}
}
]
}
}
Ver el "Standard VAST" subtipo multimedia (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
}
}
}
Visualización de los subtipos multimedia que pertenecen al tipo de "Banner" medio
$ 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
}
]
}
}