Servicio de selección de ubicación

Artículo
05/18/2024

El servicio de selección de ubicación le permite crear etiquetas de anuncios de ubicación, así como modificarlas y verlas. Usará ubicaciones para publicadores administrados o para compras de medios directos.

Los identificadores de ubicación y su información asociada se almacenan en el servidor con Xandr y son fáciles de modificar.
Al crear una ubicación, se especifican los tipos de creatividades que pueden servir en ella (vea supported_media_types y supported_media_subtypes a continuación).

Nota:

La segmentación de anunciantes, artículos de línea o campañas a través de este servicio invalidará cualquier destino definido por el Servicio de regla de pago.

Formato de etiqueta

Una vez que tenga el identificador de ubicación, formatee la etiqueta de selección de ubicación como se indica a continuación y la entregue al publicador que represente o con el que tenga una compra garantizada.

Nota:

"id" es el identificador de ubicación.

Sugerencia

Puede incluir marcadores de posición para pasar parámetros de cadena de consulta adicionales a nuestra plataforma durante la llamada al anuncio.

Importante

Al proporcionar las etiquetas de ubicación en el inventario seguro (SSL), debe modificar las etiquetas siguientes para usar el host: "https://secure.adnxs.com/..."

IFRAME

<!-- BEGIN IFRAME TAG < - DO NOT MODIFY -->
<IFRAME SRC="https://ib.adnxs.com/tt?id=2704"
    FRAMEBORDER="0"
    SCROLLING="no"
    MARGINHEIGHT="0"
    MARGINWIDTH="0"
    TOPMARGIN="0"
    LEFTMARGIN="0"
    ALLOWTRANSPARENCY="true"
    WIDTH="120"
    HEIGHT="600"></IFRAME>
<!-- END TAG -->

JavaScript

<!-- BEGIN JS TAG < - DO NOT MODIFY -->
<SCRIPT SRC="https://ib.adnxs.com/ttj?id=2704" TYPE="text/javascript"></SCRIPT>
<!-- END TAG -->

API de REST

Nota:

, codeplacement_code, site_codey publisher_code se pueden usar en lugar de los identificadores correspondientes en las llamadas siguientes.

Http (método)	Endpoint	Description
`POST`	`https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID` `https://api.appnexus.com/placement?site_id=SITE_ID` (JSON de selección de ubicación)	Agregue una ubicación (NETWORK).
`PUT`	`https://api.appnexus.com/placement?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID` `https://api.appnexus.com/placement?code=PLACEMENT_ID&site_id=SITE_ID` (JSON de selección de ubicación)	Modificar una ubicación existente (NETWORK).
`DELETE`	`https://api.appnexus.com/placement?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID` `https://api.appnexus.com/placement?code=PLACEMENT_CODE&publisher_code=PUBLISHER_CODE`	Elimine una ubicación existente.
`GET`	`https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID`	Vea todas las ubicaciones de uno de los publicadores.
`GET`	`https://api.appnexus.com/placement?id=PLACEMENT_ID`	Vea una ubicación específica para uno de los publicadores.
`GET`	`https://api.appnexus.com/placement?id=1,2,3`	Ver todas las ubicaciones de un sitio.

Campos JSON

Campo	Tipo	Descripción
`id`	Entero	Identificador de la ubicación. Valor predeterminado: número incrementado automáticamente (es decir, 123) Obligatorio activado: `PUT`, en la cadena de consulta
`name`	string (100)	Nombre de la ubicación. Obligatorio activado: `POST`
`code`	string (100)	Código personalizado para la ubicación. Nota: Los códigos deben ser alfanuméricos y no pueden contener espacios. También se permiten los caracteres siguientes: - period (".") - subrayado ("_") - guion ("-") - porcentaje ("%")
`code2`	string (100)	Segundo código personalizado para la selección de ubicación. Nota: Los códigos deben ser alfanuméricos y no pueden contener espacios. También se permiten los caracteres siguientes: - period (".") - subrayado ("_") - guion ("-") - porcentaje ("%")
`code3`	string (100)	Tercer código personalizado para la selección de ubicación. Nota: Los códigos deben ser alfanuméricos y no pueden contener espacios. También se permiten los caracteres siguientes: - period (".") - subrayado ("_") - guion ("-") - porcentaje ("%")
`state`	enumeración	Estado de la ubicación. Valores posibles: `"active"` o `"inactive"`. Valor predeterminado: `"active"`
`width`	Entero	Ancho de la ubicación.
`height`	Entero	Alto de la ubicación.
`is_resizable`	Booleano	Si la ubicación usa un iFrame descriptivo y desea que el tamaño de la ubicación se ajuste a creatividades más pequeñas o más grandes, establezca este campo en `true`. Valor predeterminado: `false`
`default_position`	enumeración	Posición predeterminada de la ubicación en la página. Valores posibles: - `"above"` (encima del pliegue) `"below"` (debajo del pliegue) `"unknown"` Valor predeterminado: `"unknown"`
`publisher_id`	Entero	Identificador del publicador asociado a la ubicación. Obligatorio activado: `POST`
`publisher_name`	string (100)	Nombre del publicador asociado a la ubicación.
`site_id`	Entero	Identificador del sitio primario de esta ubicación. Cada ubicación debe pertenecer a un sitio. Valor predeterminado: sitio del publicador
`site_name`	string (100)	Nombre del sitio en el que se usa la selección de ubicación.
`inventory_source_id`	Entero	En desuso.
`ad_profile_id`	Entero	Identificador del perfil de anuncio asociado a la ubicación. Nota: La manera preferida de "asignar" un perfil de anuncio a una ubicación es la siguiente: Crear una regla de calidad de anuncios con un perfil de destino (el perfil "apunta" a la ubicación). Vincula el perfil de anuncio a la regla de calidad de anuncios. Asigne la regla de calidad de anuncios al publicador. De este modo, puede disfrutar de una mayor flexibilidad mediante el perfil de destino.
`supported_media_types`	matriz de objetos	Los tipos de medios que pueden servir en la ubicación. Consulte Tipos de medios admitidos a continuación para obtener más detalles. Atención: Si no especifica o `supported_media_typessupported_media_subtypes`, el `"Banner"` tipo de medio y todos sus subtipos se permitirán de forma predeterminada.
`supported_media_subtypes`	matriz de objetos	Subtipos multimedia que pueden servir en la ubicación. Consulte Subtipos de medios admitidos a continuación para obtener más detalles.
`pop_values`	matriz	En desuso.
`default_creative_id`	Entero	En desuso. `default_creatives` Use en su lugar.
`default_creatives`	matriz	Las creatividades predeterminadas que se mostrarán en lugar de una PSA cuando no haya ningún ganador de la subasta. Para cada creatividad predeterminada, el precio de reserva se establece con el `"price"` campo de la matriz. Consulte Las creatividades predeterminadas a continuación para obtener más detalles. Nota: La colocación no aparecerá si no se cumple el precio de reserva, excepto en el caso de un prepop.
`reserve_price`	double	El precio de reserva para cada una de las creatividades predeterminadas de la ubicación se establece en la `default_creatives` matriz (consulte Las creatividades predeterminadas a continuación). Si la ubicación no tiene creatividades predeterminadas, se puede establecer un precio de reserva aquí para la colocación; sin embargo, esto no es un procedimiento recomendado, ya que el precio de reserva puede provocar la presentación de una PSA. Importante: Un perfil de administración de rendimiento reemplazará cualquier configuración de precios de reserva en el nivel de ubicación. Si usted tiene un perfil de este tipo, usted debe establecer su precio de reserva deseado a través de un piso duro.
`hide_referer`	Booleano	Si `true`es , no se notificará el referenciador.
`default_referrer_url`	string	Si se establece un perfil de visibilidad para ocultar las direcciones URL de inventario en las solicitudes de puja, puede establecer este campo para pasar una dirección URL de vanidad en su lugar. Esto resulta especialmente útil en los casos en los que los editores no quieren compartir dominios reales, pero, sin embargo, quieren que los compradores puedan identificarlos por dominio.
`visibility_profile_id`	Entero	Identificador del perfil de visibilidad asignado directamente a la ubicación. Para obtener más información sobre los perfiles de visibilidad, consulte perfil de visibilidad.
`exclusive`	Booleano	Solo lectura. Para designar si el inventario de una ubicación se va a poner a disposición para reventa, use el `rtb` campo en el `marketplace_map` objeto del sitio de la ubicación. Consulte Servicio de sitio para obtener una descripción de este campo. Todo el inventario disponible para reventa forma parte del Marketplace de RTB. Valor predeterminado: `False`
`pixel_url`	string	Llamada de piggyback a la ubicación de carga del usuario. Valor predeterminado: `null`
`pixel_type`	enumeración	Identifica el tipo de píxel. Los valores posibles son `"javascript"` o `"image"`. Valor predeterminado: `image`
`content_categories`	matriz	Lista de categorías de contenido asociadas a esta ubicación. Como máximo se pueden especificar 20 categorías para una selección de ubicación.
`filtered_advertisers`	matriz	Una lista de anunciantes a los que se les permite dirigirse a la ubicación.
`filtered_line_items`	matriz	Lista de elementos de línea que pueden tener como destino la ubicación.
`filtered_campaigns`	matriz	Una lista de campañas que pueden dirigirse a la ubicación.
`segments`	matriz	Una lista de segmentos a los que se agregarán los usuarios al ver esta ubicación.
`estimated_clear_prices`	matriz de objetos	El importe de la puja que históricamente ha ganado la mayoría (95%) de las subastas de terceros en las que participa. Consulte Precios claros estimados a continuación para obtener más detalles.
`media_subtypes`	matriz	En desuso. `supported_media_types` Use y `supported_media_subtypes` en su lugar.
`intended_audience`	enumeración	Valores solo para la auto auditación. Posibles valores: - `"general"` - `"children"` - `"young_adult"` - `"mature"`
`inventory_attributes`	matriz	Atributos confidenciales contenidos en la ubicación. Sugerencia: También `inventory_attributes` se puede aplicar en el nivel de sitio y, en este caso, también influirá en los objetos en el nivel de ubicación. Se trata de una matriz de objetos con identificadores. Consulte el Servicio de atributos de inventario para obtener una lista de identificadores.
`audited`	Booleano	Si `true`es , el propietario ha auditado automáticamente la ubicación. Valor predeterminado: `false`
`audit_level`	enumeración	Valores solo para la auto auditación. Nota: Las auto auditaciones en el nivel de sitio se pueden invalidar en el nivel de ubicación. Posibles valores: - `"site"` - Use este valor si el `audited` campo está establecido `false` en en la ubicación, pero `true` en el sitio. - `"placement"` - Use este valor si el `audited` campo está establecido `true` en en la ubicación. Valor predeterminado: `"site"`
`default_calculation_type`	enumeración	Esto determina el umbral de precio de la oferta por debajo del cual se proporcionará una creatividad predeterminada. Puede elegir si este umbral es los ingresos brutos de la red o los ingresos netos del publicador. Si no hay campañas aptas adicionales ni creatividades predeterminadas disponibles, se proporciona una PSA. Valores posibles: `"gross"` o `"net"`. Valor predeterminado: `"gross"`
`apply_floor_to_direct`	Booleano	Se ha quitado. `floor_application_target` Use en su lugar.
`demand_filter_action`	string	Indica los orígenes de demanda que se pueden incluir o excluir. Valor predeterminado: `default`
`floor_application_target`	enumeración	Tipo de pujas a las que se aplica el precio de reserva. Posibles valores: - `"external_only"` - El precio de reserva solo se aplica a las pujas externas (los miembros compradores y los miembros vendedores son diferentes). Use esta opción si prefiere proporcionar una impresión de aprendizaje administrada disponible que servir un valor predeterminado, incluso si esto significa superar el porcentaje máximo de volumen diario para learn (`max_learn_pct` campo en el servicio de publicador). - `"external_non_preferred"` - El precio de reserva se aplica a las pujas externas (el miembro comprador y el miembro vendedor son diferentes) o cuando la impresión es una impresión de aprendizaje administrada disponible que supera el porcentaje máximo de volumen diario para aprender. Use esta opción si prefiere proporcionar un valor predeterminado que proporcionar una impresión de aprendizaje administrada disponible que superaría el porcentaje máximo de volumen diario para aprender. - `"all"` - El precio de reserva se aplica a todas las ofertas excepto a las impresiones de aprendizaje administradas dentro del porcentaje máximo de volumen diario para aprender. Valor predeterminado: `"all"`
`pixel_url_secure`	string	Secure piggyback call upon user loading placement (Protección de la llamada de piggyback al colocar la carga del usuario). Valor predeterminado: `null`
`site_audit_status`	enumeración	Indica cómo el sitio ha decidido realizar auditorías creativas. Los valores posibles son `"self"` o `"unaudited"`. Valor predeterminado: `unaudited`
`toolbar`	objeto	Los vendedores deben declarar todo el inventario de la barra de herramientas y del complemento del explorador. Si un vendedor asigna el atributo de inventario "toolbar", también se deben incluir estos metadatos adicionales.
`acb_code`	string (32)	En desuso.
`tag_data`	string	En desuso.
`cost_cpm`	double	Si existe un valor, se usará como información de pago para la colocación. Esto invalidará las reglas de pago asociadas al publicador. Valor predeterminado: `null`
`is_prohibited`	Booleano	Solo lectura. Si `true`es , la ubicación se ha prohibido debido a una infracción de las directivas de contenido de Xandr. Las subastas directas y de terceros no se ejecutarán para una colocación prohibida. Valor predeterminado: `false`
`last_modified`	Timestamp	Solo lectura. Fecha y hora en que se modificó por última vez la ubicación.
`stats`	objeto	El `stats` objeto ha quedado en desuso (a partir del 17 de octubre de 2016). Use el servicio de informes para obtener información estadística en su lugar.
`content_retrieval_timeout_ms`	Entero	El tiempo de espera que esta ubicación establecerá en el contenido recuperado de las creatividades "mediadas", es decir, las creatividades cuyo `content_source` valor `"mediation"`es . Para obtener más información, consulte Creative Service. - Si se establece en `0`, el servidor de anuncios usará el valor del servicio miembro. : el valor predeterminado es `0` si no se proporciona a la API en `PUT` o `POST` llama a . - Si el servidor de anuncios lee en `0` este campo, realizará una búsqueda de miembros y usará el tiempo de espera predeterminado definido por el servicio miembro (suponiendo que también sea distinto de cero). - Al crear una ubicación, no se copiará ningún valor en este campo de la configuración predeterminada del miembro. Debe especificarlos explícitamente en las llamadas a `POST`. Para obtener más información, vea el `default_content_retrieval_timeout_ms` campo del servicio miembro. Valor predeterminado: `0`
`enable_for_mediation`	Booleano	Este será el origen de la verdad sobre si una ubicación debe aceptar contenido mediado. A menos que se establezca en `PUT` o `POST`, este campo heredará su valor predeterminado del miembro. Si el valor predeterminado se cambia en el servicio miembro, esa acción no afectará retroactivamente a las ubicaciones creadas anteriormente; seguirán estando establecidos en el valor predeterminado anterior. En otras palabras, el valor de este campo no se puede actualizar con carácter retroactivo estableciendo el valor predeterminado del miembro. Para obtener más información, vea el `default_enable_for_mediation` campo del servicio miembro. Valor predeterminado: se hereda del `default_enable_for_mediation` campo del servicio miembro.
`private_sizes`	matriz de objetos	Lista de tamaños de ubicación que se pueden permitir para servir en ofertas y paquetes. Consulte Tamaños privados a continuación para obtener más detalles.
`video`	objeto	Subtipo multimedia permitido para servir en la ubicación. Consulte Configuración de vídeo a continuación para obtener más detalles. Valor predeterminado: `null`
`ad_types`	matriz de objetos	Contiene información relacionada con los tipos de selección de ubicación, incluido el identificador del tipo de anuncio y la información sobre el representador. Para obtener más información, consulte Tipos de anuncios a continuación. Valor predeterminado: `null` Obligatorio activado: `PUT`
`use_detected_domain`	booleano	Solo lectura. Si se va a usar el dominio detectado frente al dominio notificado. El valor predeterminado es `true` para todos los clientes. Valor predeterminado: `true`
`mime_types`	matriz de cadenas	Lista de tipos MIME que se van a incluir o excluir en la ubicación. `supported_mime_types_action_include` a continuación se usa para especificar si se deben incluir o excluir esos tipos mime. Para obtener una lista de las cadenas usadas para identificar cada tipo mime, consulte Tipos mime admitidos. Valor predeterminado: `empty`
`supported_mime_types_action_include`	booleano	Si `true`es , se incluirán los tipos mime enumerados en la `mime_types` matriz. Valor predeterminado: `false`
`handles_mixed_media`	booleano	Esto indica a nuestra plataforma si el reproductor de vídeo puede admitir un archivo VAST con diferentes tipos mime. Valor predeterminado: `true`
`tinytag_renderer_asset_floor_prices`	matriz de objetos	Asocia los precios de piso a los creativos nativos que se han asignado a la colocación. Para obtener más información, vea Precios por planta de recursos de Tinytag Renderer. Obligatorio activado: `PUT`
`is_ss_native_assembly_enabled`	booleano	Cuando se habilita, aunque la solicitud original será una solicitud de banner, las solicitudes que se envían a los licitadores tendrán información nativa establecida para recibir recursos nativos de vuelta en las respuestas. La respuesta final se volverá a establecer en un tipo de anuncio de banner con un marcado de anuncios ensamblado nativo adjunto. Si `true` es así, sí.

Tipos de medios admitidos

Las creatividades se clasifican por tipo de medio y subtipo multimedia. El tipo de medio define el estilo de presentación general de la creatividad, por ejemplo, "Banner"y el subtipo multimedia define el estilo de presentación específico de las creatividades, por ejemplo, "Standard Banner" o "In-Banner Video". Puede usar esta matriz para limitar el tipo de medio, el estilo de visualización general de las creatividades, que puede servir en una ubicación. Para limitar el subtipo multimedia, el estilo de visualización específico de las creatividades, use la supported_media_subtypes matriz (consulte Subtipos multimedia admitidos a continuación).

Campo	Tipo	Descripción
`id`	Entero	Identificador del tipo de medio permitido. Puede usar el servicio de tipos de medios para ver todos los tipos de medios. Valor predeterminado: `1`
`name`	string	Nombre del tipo de medio permitido. Valor predeterminado: `"Banner"`
`media_type_group_id`	Entero	Identificador de grupo para el tipo de medio.
`uses_sizes`	enumeración	Si el tipo de medio tiene especificaciones de tamaño. Posibles valores: - `"always"` - `"sometimes"` - `"never"`
`last_modified`	date	La última vez que se actualizó el `allowed_media_type` objeto.

Subtipos multimedia admitidos

Las creatividades se clasifican por tipo de medio y subtipo multimedia. El tipo de medio define el estilo de presentación general de la creatividad, por ejemplo, "Banner"y el subtipo multimedia define el estilo de presentación específico de las creatividades, por ejemplo, "Standard Banner" o "In-Banner Video". Puede usar esta matriz para limitar el subtipo multimedia, el estilo de visualización específico de las creatividades, que puede servir en una ubicación. Para limitar el tipo de medio, el estilo de visualización general de las creatividades, use la supported_media_types matriz (consulte Tipos de medios admitidos anteriormente).

Campo	Tipo	Descripción
`id`	Entero	Identificador del subtipo de medios permitido. Puede usar el servicio de subtipos multimedia para ver todos los subtipos multimedia. Valor predeterminado: `null`
`name`	string	Nombre del subtipo de medios permitido.
`is_private`	booleano	Si el subtipo multimedia está establecido en private. Si `true` es así, sí.
`media_type_group_id`	Entero	Identificador de grupo para el tipo de medio.

Nota:

Tipos de medios y subtipos de medios admitidos

Si no especifica los tipos de medios admitidos o los subtipos de medios admitidos, el "Banner" tipo de medio y todos sus subtipos se permitirán de forma predeterminada.
Puede combinar los "Banner" tipos de medios y "Text" , y cualquier combinación de sus subtipos multimedia, en una sola ubicación, pero no puede combinar ninguno de los otros tipos de medios y subtipos multimedia. Esta limitación garantiza que solo se proporcionen las creatividades adecuadas en una ubicación. Por ejemplo, una ubicación que permite que las creatividades del tipo "Video" de medio se alimenten a un reproductor de vídeo; no tendría sentido permitir que creativos de cualquier otro tipo de medio, como "Interstitial", sirvieran en la ubicación.
Puede establecer una ubicación para permitir el "Expandable" tipo de medio o cualquiera de sus subtipos para el inventario directo. Si desea admitir creatividades ampliables para las ubicaciones que están disponibles para revender a otros miembros de la plataforma, proporcione el identificador de ubicación para admitir la verificación.

Tipos mime admitidos

La mime_types matriz de objetos admite los tipos mime que se muestran en la tabla siguiente. Si no se especifica ningún tipo mime, se aceptarán todos los tipos MIME. La API de selección de ubicación usa la cadena de la columna Nombre . Si necesita pasar esta información en una etiqueta, use el identificador.

Nombre	Id
`application/x-shockwave-flash`	1
`video/x-flv`	2
`video/mp4`	3
`video/webm`	4
`application/javascript`	5
`application/octet-stream`	6
`image/jpeg`	7
`image/gif`	8
`image/png`	9
`application/zip`	10
`application/vnd.ms-asf`	11
`video/x-ms-wmv`	12
`video/ogg`	13
`video/x-msvideo`	14
`video/mpeg`	15
`video/quicktime`	16
`video/3gpp`	17
`video/3gpp2`	18
`video/x-m4v`	19
`audio/ogg`	20
`audio/x-pn-realaudio`	21
`audio/mpeg`	22
`text/css`	23
`text/html`	24
`text/plain`	25
`audio/mp4`	26

Configuración de vídeo

Si es supported_media_type"video" o supported_media_subtypes es "Standard VAST", estos campos deben incluirse en el video objeto . Consulte ejemplos a continuación.

Nota:

La siguiente configuración afecta a los resultados de la subasta: para la configuración del reproductor outstream, que determina el comportamiento final del reproductor de vídeo Outstream, consulte "Configuración del reproductor de vídeo de salida" en nuestra documentación de la interfaz de usuario.

Campo	Tipo	Descripción
`id`	Entero	Identificador único para el objeto de configuración de vídeo.
`width`	Entero	Ancho de la creatividad de vídeo.
`max_duration_secs`	Entero	La duración máxima de un anuncio de vídeo que se permite reproducir en la ubicación. - Si `maximum_number_ads` es >`1`, la duración máxima se aplica a toda la longitud de un pod de anuncio (una agrupación lineal de más de un anuncio diseñado para rellenar una sola ubicación). Nota: Este campo debe establecerse para habilitar los pods de anuncios.
`maximum_ad_duration_secs`	Entero	La duración máxima del anuncio de vídeo en segundos de cualquier anuncio único que se pueda reproducir en la ubicación. Esto solo se aplica a los pods de anuncios.
`maximum_number_ads`	Entero	El número máximo de anuncios que se pueden reproducir en la ubicación. Si `maximum_number_ads` es >`1`, la ubicación puede ser un pod de anuncio (una agrupación lineal de más de un anuncio diseñado para rellenar una sola ubicación).
`start_delay_secs`	Entero	Retraso de inicio en segundos para la colocación. Si el valor de retraso de inicio es >`0`, la posición de la ubicación es `"mid-roll"`. Nota: Este campo debe establecerse si el contexto es `"mid-roll"`.
`skipoffset_seconds`	Entero	El número de segundos que se permiten para que se reproduzca el vídeo, antes de que se pueda omitir. El valor predeterminado es `null`. PRECAUCIÓN: Si establece este valor en cualquier cosa excepto `null`, el `supports_skippable` campo debe establecerse en `true`. (Vea a continuación).
`supports_skippable`	booleano	La ranura del anuncio se puede omitir. Valores posibles: `"true"` o `"false"`
`context`	string	Posición de lanzamiento de la creatividad de vídeo. Valores posibles: `"pre-roll"`, `"mid-roll"`, `"post-roll"`. Importante: Este campo debe establecerse para habilitar los pods de anuncios.
`layback_method`	string	Los distintos métodos de reproducción son: - `Auto-play, sound-on` - `Auto-play, sound-off` - `Click-to-play` - `Mouse-over` - `Auto-play, sound unknown` Posibles valores: - `"auto_play_sound_on"` - `"auto_play_sound_off"` - `"click_to_play"` - `"mouse_over"` - `"auto_play_sound_unknown"` - `null`
`frameworks`	matriz de cadenas	Marco de la ubicación. Entre las opciones se incluyen: - `VPAID 1.0` - `VPAID 2.0` - `MRAID-1` - `ORMMA` - `MRAID-2` Posibles valores: - `"vpaid_1_0"` - `"vpaid_2_0"` - `"mraid_1"` - `"ormma"` - `"mraid_2"`
`video_bumpers`	matriz de objetos	Los parachoques que se pueden asociar al pod de anuncios. La duración del parachoques no se incluye en la duración general del pod del anuncio. Vea el objeto de parachoques de vídeo .
`player_vast_version`	string	Este campo especifica la versión más grande que admite la selección de ubicación y debe establecerse en el valor más alto que admite el jugador. Las creatividades que requieran una versión vasta superior a la de su reproductor no serán aptas para servir en su ubicación. Posibles valores: - `2.0` - `3.0` - `4.0` PRECAUCIÓN: Especificar un valor mayor que el que admite el reproductor puede producir errores cuando se representan creatividades no admitidas.
`vmin_ad_duration`	Entero	Duración mínima de la creatividad permitida, en segundos.
`minbitrate`	Entero	Velocidad de bits mínima en kbps.
`mf_min_width`	Entero	Ancho mínimo de la creatividad de vídeo.
`mf_min_height`	Entero	Altura mínima de la creatividad de vídeo.
`aspect_ratios`	matriz de objetos	Relación de aspecto creativo que puede servir para una colocación de vídeo. La matriz contiene `ratio_width` y `ratio_height`.

Parachoques de vídeo

Esta matriz de objetos contiene información relacionada con los parachoques de un pod de anuncio.

Campo	Tipo	Descripción
`video_bumper_type`	string	Tipo de parachoques. Entre las opciones se incluyen: - `intro` - `outro` Valor predeterminado: `null`
`max_duration_secs`	Entero	Duración máxima del parachoques. Valor predeterminado: `null`

Relaciones de aspecto

Esta matriz de objetos contiene información sobre la relación de aspecto creativo que puede servir para una ubicación de vídeo.

Campo	Tipo	Descripción
`ratio_width`	Entero	Ancho de la relación de aspecto
`ratio_height`	Entero	Alto de la relación de aspecto

Tipos de anuncios

Esta matriz de objetos contiene información relacionada con los tipos de selección de ubicación, incluido el identificador del tipo de anuncio y la información sobre el representador.

Campo	Tipo	Descripción
`id`	Entero	Identificador de .`ad_type` Posibles valores: `1` = Banner `2` = Vídeo `3` = Nativo Valor predeterminado: `null` Obligatorio activado: `POST`/`PUT`
`renderer_id`	Entero	Identificador del representador. Posibles valores: `1` = banner outstream `2` = vídeo de secuencia de salida Valor predeterminado: `null` Obligatorio activado: `POST`/`PUT`
`name`	string	Nombre de en `ad_type` todas las letras minúsculas, por ejemplo `video` , o `banner`.
`display_name`	string	Nombre para mostrar de `ad_type`, que se muestra como el tipo de anuncio con límites iniciales, por ejemplo `Video` , o `Banner`.
`renderer`	multiobjeto	Objeto que consta de y `iddisplay_name` del representador. Valor predeterminado: `null` Obligatorio activado: `POST`/`PUT`

Precios de la planta de activos del representador Tinytag

Esta matriz de objetos se usa para asociar los precios inferiores a los creativos nativos que se han asignado a la ubicación.

Campo	Tipo (longitud)	Descripción
`renderer_id`	Entero	Identificador del representador. Obligatorio activado: `POST`/`PUT`
`ad_type_id`	Entero	Identificador de .`ad_type` Esto siempre será 3, ya que solo puede asociar precios de piso con creativos nativos. Valor predeterminado: `3` Obligatorio activado: `POST`/`PUT`
`asset_type`	string	Tipo de recurso. Los valores posibles son: - `main_image` - `video` Obligatorio activado: `POST`/`PUT`
`floor_price`	double	Importe de la oferta preferida a cambio de las impresiones del recurso nativo. Obligatorio activado: `POST`/`PUT`

Creatividades predeterminadas

Esta matriz se usa para asignar creatividades predeterminadas a la ubicación. Tenga en cuenta los siguientes requisitos:

Una creatividad predeterminada no debe expirar. Para obtener más información, consulte el is_expired campo en Creative Service .
Una creatividad predeterminada debe asignarse a una plantilla de creatividad que coincida con y supported_media_typessupported_media_subtypes de la ubicación. Por ejemplo, si la ubicación permite creatividades del "Banner" tipo de medio, no podrá asociar las creatividades predeterminadas que usan una plantilla creativa para el "Interstitial" tipo de medio. Para obtener más información, consulte el template campo en Creative Service .
Si el tamaño de la ubicación es (los "width" campos y "height" se definen para la ubicación), esta matriz debe contener solo una creatividad con las dimensiones coincidentes.

Campo	Tipo	Descripción
`id`	Entero	Identificador de la creatividad predeterminada.
`width`	Entero	Ancho de la creatividad predeterminada.
`height`	Entero	Alto de la creatividad predeterminada.
`price`	double	Precio de reserva para la creatividad predeterminada. Una oferta ganadora debe estar por encima de este precio.
`name`	string	Solo lectura. Nombre de la creatividad predeterminada.

Valores emergentes

Si es supported_media_type"Pop", o es "Popup"supported_media_subtypes o "Popunder", estos campos deben incluirse en la pop_values matriz. Consulte a continuación para obtener un ejemplo.

Campo	Tipo	Descripción
`pop_freq_times`	Entero	Número de veces que la etiqueta se puede extraer a un identificador de usuario único en `pop_frequency_duration` segundos. No tiene ningún efecto cuando `pop_is_prepop` se establece en `true`. Valor predeterminado: `No frequency cap`
`pop_freq_duration`	Entero	Consulte `pop_freq_times`. Valor predeterminado: `No frequency cap`
`pop_is_prepop`	Booleano	Si `true`es , la etiqueta es una etiqueta de rellenado previo y servirá en una ventana que la página del publicador ya ha aparecido. Valor predeterminado: `false`
`pop_max_width`	Entero	Si `pop_max_width` se especifica, cualquier creatividad mostrada por la etiqueta debe tener un ancho igual o menor que `pop_max_width` Valor predeterminado: `no max width`.
`pop_max_height`	Entero	Alto máximo de la creatividad. Si `pop_max_height` se especifica, cualquier creatividad mostrada por la etiqueta debe tener un alto igual o menor que `pop_max_height`. Valor predeterminado: `no max height`

Precios claros estimados

Campo	Tipo	Descripción
`clear_price`	Entero	El importe de la puja que históricamente ha ganado la mayoría (95%) de las subastas de terceros en las que participa para esta colocación.
`average_price`	double	Este es el promedio de todas las ofertas enviadas para esta colocación.
`width`	Entero	Al exportar etiquetas de ubicación sin tamaño que se van a servir, esto determina el ancho de la ubicación.
`height`	Entero	Al exportar etiquetas de ubicación sin tamaño que se van a servir, esto determina el alto de la ubicación.
`verified`	Booleano	Indica si se ha comprobado la creatividad.
`geo_country`	string	El código de país de la ubicación geográfica asociada a la impresión.

Tamaños privados

Esta matriz determina los tamaños de ubicación específicos que pueden servir para una oferta personalizada o en un paquete. En override_size_preference deal service o package service debe establecerse append en para que estos tamaños privados sirvan junto con los tamaños de ubicación estándar.

Campo	Tipo	Descripción
`width`	Entero	Ancho de la ubicación.
`height`	Entero	Alto de la ubicación.

Estadísticas

El stats objeto ha quedado en desuso (a partir del 17 de octubre de 2016). Use el servicio de informes para obtener información estadística en su lugar.

De acuerdo con la directiva de plataforma, los vendedores deben identificar todo el inventario de complementos de barra de herramientas o explorador y separarlo de otro inventario en sus propias ubicaciones. Para identificar el inventario de la barra de herramientas, los vendedores deben:

Establezca el objeto inventory_attribute de forma adecuada.
Envíe la información necesaria en la matriz de la barra de herramientas, que se describe aquí:

Parámetro	Tipo	Descripción
`name`	string	Nombre comercial común de la barra de herramientas.
`company`	string	El desarrollador de la barra de herramientas. Identifique la entidad empresarial legal, no un nombre comercial.
`tos_url`	string	Un vínculo a una página web donde nuestros auditores pueden encontrar términos de servicio completos.
`install_url`	string	Un vínculo a una página web donde nuestros auditores pueden instalar la barra de herramientas.

Ejemplos

Visualización de todas las ubicaciones de uno de los publicadores

$ curl -b cookies -c cookies 'https://api.appnexus.com/placement?publisher_id=88888'

{
    "response": {
        "status": "OK",
        "count": 4,
        "start_element": 0,
        "num_elements": 100,
        "placements": [
            {
                "id": 594595,
                "name": "Test Placement 1",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": 300,
                "height": 250,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": "",
                "pixel_type": "image",
                "last_modified": "2011-10-24 19:45:31",
                "media_subtypes": [
                    "banner"
                ],
                "intended_audience": "general",
                "audited": true,
                "audit_level": "placement",
                "default_calculation_type": "gross",
                "publisher_name": "National Public Radio",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "include",
                "is_resizable": true,
                "pixel_url_secure": "",
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": [
                    {
                        "id": 2,
                        "name": "Political opinion"
                    },
                    {
                        "id": 16,
                        "name": "Blogs"
                    }
                ],
                "supported_media_types": [
                    {
                        "name": "Banner",
                        "id": 1
                    }
                ],
                "supported_media_subtypes": null,
                "content_categories": [
                    {
                        "id": 7,
                        "name": "Arts & Entertainment",
                        "is_system": true
                    },
                    {
                        "id": 17,
                        "name": "News",
                        "is_system": true
                    },
                    {
                        "id": 25,
                        "name": "Society",
                        "is_system": true
                    },
                    {
                        "id": 11445,
                        "name": "Books & Literature",
                        "is_system": true
                    }
                ],
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": [
                    {
                        "id": 35081,
                        "name": "Test Advertiser 1"
                    }
                ],
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            },
            {
                "id": 605055,
                "name": "Test Placement 2",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": null,
                "height": null,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": null,
                "pixel_type": "image",
                "last_modified": "2012-03-08 00:49:50",
                "media_subtypes": null,
                "intended_audience": null,
                "audited": false,
                "audit_level": "site",
                "default_calculation_type": "gross",
                "publisher_name": "Test Publisher 1",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "default",
                "is_resizable": false,
                "pixel_url_secure": null,
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": null,
                "supported_media_types": [
                    {
                        "id": 1,
                        "name": "Banner"
                    },
                    {
                        "id": 5,
                        "name": "Text"
                    }
                ],
                "supported_media_subtypes": null,
                "content_categories": null,
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": null,
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            },
            {
                "id": 605056,
                "name": "Test Placement 3",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": null,
                "height": null,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": null,
                "pixel_type": "image",
                "last_modified": "2012-03-08 00:54:37",
                "media_subtypes": null,
                "intended_audience": null,
                "audited": false,
                "audit_level": "site",
                "default_calculation_type": "gross",
                "publisher_name": "Test Publisher 1",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "default",
                "is_resizable": false,
                "pixel_url_secure": null,
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": null,
                "supported_media_types": null,
                "supported_media_subtypes": [
                    {
                        "id": 3,
                        "name": "In-Banner Video",
                        "media_type": {
                            "id": 1
                        }
                    }
                ],
                "content_categories": null,
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": null,
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            },
            {
                "id": 605057,
                "name": "Test Placement 4",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": 1,
                "height": 1,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": null,
                "pixel_type": "image",
                "last_modified": "2012-03-08 01:07:47",
                "media_subtypes": null,
                "intended_audience": null,
                "audited": false,
                "audit_level": "site",
                "default_calculation_type": "gross",
                "publisher_name": "Test Publisher 1",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "default",
                "is_resizable": false,
                "pixel_url_secure": null,
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": null,
                "supported_media_types": [
                    {
                        "id": 3,
                        "name": "Interstitial"
                    }
                ],
                "supported_media_subtypes": null,
                "content_categories": null,
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": null,
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            }
        ]
    }
}

Visualización de una ubicación específica

$ curl -b cookies -c cookies 'https://api.appnexus.com/placement?id=605057'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605057,
            "name": "Test Placement 4",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": 1,
            "height": 1,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 01:07:47",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "Test Publisher 1",
            "site_name": "[Test Publisher 1] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": null,
            "inventory_attributes": null,
            "supported_media_types": [
                {
                    "id": 3,
                    "name": "Interstitial"
                }
            ],
            "supported_media_subtypes": null,
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Adición de una ubicación que solo permite creativos con el tipo de `"Interstitial"` medio

$ cat placement

{
    "placement": {
        "name": "Placement for Interstitials",
        "publisher_id": 88888,
        "supported_media_types": [
            {
                "id": 3
            }
        ],
        "video": 10,
        "supports_skippable": true,
        "player_vast_version" "3.0"
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 605058,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605058,
            "name": "Placement for Interstitials",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": 1,
            "height": 1,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 01:41:52",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "Test Publisher 1",
            "site_name": "[Test Publisher 1] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": null,
            "inventory_attributes": null,
            "supported_media_types": [
                {
                    "id": 3,
                    "name": "Interstitial"
                }
            ],
            "supported_media_subtypes": null,
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Adición de una ubicación que solo permite creativos con el `"In-Banner Video"` subtipo multimedia

$ cat placement

{
    "placement": {
        "name": "Placement for In-Banner Video",
        "publisher_id": 88888,
        "supported_media_subtypes": [
            {
                "id": 3
            }
        ],
        "video": 10,
        "supports_skippable": true,
        "player_vast_version" "3.0"
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 605059,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605059,
            "name": "Placement for In-Banner Video",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": null,
            "height": null,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 01:46:43",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "Test Publisher 1",
            "site_name": "[Test Publisher 1] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": null,
            "inventory_attributes": null,
            "supported_media_types": null,
            "supported_media_subtypes": [
                {
                    "id": 3,
                    "name": "In-Banner Video",
                    "media_type": {
                        "id": 1
                    }
                }
            ],
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Adición de una ubicación que solo permite creativos con el `"Popup"` subtipo multimedia

$ cat placement

{
    "placement": {
        "name": "Placement for Popups",
        "publisher_id": 88888,
        "supported_media_subtypes": [
            {
                "id": 2
            }
        ],
        "pop_values":{
            "pop_is_prepop":false,
            "pop_freq_times":4,
            "pop_freq_duration":1440,
            "pop_max_width":500,
            "pop_max_height":100
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=88888'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 605076,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605076,
            "name": "Placement for Popups",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": null,
            "height": null,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 15:56:05",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "National Public Radio",
            "site_name": "[National Public Radio] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": {
                "pop_freq_times": 4,
                "pop_freq_duration": 1440,
                "pop_is_prepop": false,
                "pop_max_width": 500,
                "pop_max_height": 100
            },
            "inventory_attributes": null,
            "supported_media_types": null,
            "supported_media_subtypes": [
                {
                    "id": 2,
                    "name": "Popup",
                    "media_type": {
                        "id": 2
                    }
                }
            ],
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Adición de una ubicación que solo permite creativos con el `"Video Standard VAST"` subtipo multimedia

$ cat placement
{
    "placement": {
        "name": "Placement for Standard VAST Video",
        "publisher_id": 585173,
        "supported_media_subtypes": [
            {
                "id": 64
            }
        ],
        "video": {
        "id": 5,
        "width": 750,
        "max_duration_secs": 30,
        "supports_skippable": true,
        "player_vast_version": "3.0",
        "context": "pre-roll",
        "playback_method": null,
        "frameworks": [
          "vpaid_1_0",
          "vpaid_2_0",
          "mraid_1",
          "ormma",
          "mraid_2"
          ]
      }
    }
}
 
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=585173'
 
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 5078562,
    "start_element": 0,
    "num_elements": 100,
    "placement": {
      "id": 5078562,
      "name": "Placement for Standard VAST Video",
      "code": null,
      "code2": null,
      "code3": null,
      "state": "active",
      "cost_cpm": null,
      "publisher_id": 585173,
      "content_retrieval_timeout_ms": 0,
      "enable_for_mediation": true,
      "is_prohibited": false,
      "site_id": 1275896,
      "default_referrer_url": null,
      "reserve_price": null,
      "width": 1,
      "height": 1,
      "default_position": "unknown",
      "default_creative_id": null,
      "ad_profile_id": null,
      "acb_code": null,
      "tag_data": null,
      "hide_referer": false,
      "inventory_source_id": null,
      "pixel_url": null,
      "pixel_type": "image",
      "last_modified": "2015-07-07 20:44:42",
      "media_subtypes": null,
      "intended_audience": null,
      "audited": false,
      "audit_level": "site",
      "default_calculation_type": "gross",
      "publisher_name": "National Public Radio",
      "site_name": "[National Public Radio] - ROS",
      "site_audit_status": "unaudited",
      "member_id": 958,
      "demand_filter_action": "default",
      "visibility_profile_id": null,
      "is_resizable": false,
      "pixel_url_secure": null,
      "floor_application_target": "all",
      "client_js_tracking_pct": 0,
      "use_detected_domain": true,
      "pop_values": null,
      "toolbar": null,
      "inventory_attributes": null,
      "supported_media_types": null,
      "supported_media_subtypes": [
        {
          "id": 64,
          "name": "Standard VAST",
          "media_type": {
            "id": 4
          }
        }
      ],
      "content_categories": null,
      "segments": null,
      "estimated_clear_prices": [
        {
          "clear_price": 1,
          "average_price": 0.5,
          "width": 0,
          "height": 0,
          "verified": true
        }
      ],
      "filtered_advertisers": null,
      "filtered_line_items": null,
      "filtered_campaigns": null,
      "default_creatives": null,
      "private_sizes": null,
      "video": {
        "id": 9,
        "width": 750,
        "max_duration_secs": 30,
        "supports_skippable": true,
        "context": "pre-roll",
        "playback_method": null,
        "frameworks": [
          "vpaid_1_0",
          "vpaid_2_0",
          "mraid_1",
          "ormma",
          "mraid_2"
        ]
      }
    }
  }
}

Adición de una ubicación de pod de anuncio que permite un parachoques de introducción

$ cat placement
{
    "placement": {
        "video": {
            "supports_skippable": false,
            "player_vast_version": "3.0",
            "playback_method": null,
            "max_duration_sec": 200,
            "maximum_number_ads": 20,
            "context": "mid-roll",
            "start_delay_secs": 30,
            "frameworks": [
                "vpaid_2_0"
            ],
            "video_bumpers": [
                {
                    "video_bumper_type": "outro",
                    "max_duration_secs": 30
                }
            ]
        }
    }
}
 
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=626425'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "11323022",
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 11323022,
            "name": "Ad Pod Placement",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 626425,
            "content_retrieval_timeout_ms": 0,
            "enable_for_mediation": true,
            "is_prohibited": false,
            "site_id": 1433875,
            "default_referrer_url": null,
            "reserve_price": null,
            "width": 1,
            "height": 1,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "exclusive": false,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2017-05-23 15:27:18",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "New_Publisher",
            "site_name": "[New_Publisher] - ROS",
            "site_audit_status": "unaudited",
            "member_id": 958,
            "demand_filter_action": "default",
            "visibility_profile_id": null,
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "client_js_tracking_pct": 0,
            "use_detected_domain": true,
            "auction_timeout_ms": null,
            "pop_values": null,
            "toolbar": null,
            "inventory_attributes": null,
            "supported_media_types": null,
            "supported_media_subtypes": [
                {
                    "id": 64,
                    "is_private": false,
                    "name": "Standard VAST",
                    "media_type": {
                        "id": 4
                    }
                }
            ],
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true,
                    "geo_country": ""
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null,
            "private_sizes": null,
            "video": {
                "id": 282568,
                "width": null,
                "max_duration_secs": null,
                "supports_skippable": false,
                "context": "mid-roll",
                "playback_method": null,
                "maximum_number_ads": 20,
                "maximum_ad_duration_secs": null,
                "start_delay_secs": 30,
                "frameworks": [
                    "vpaid_2_0"
                ],
                "video_bumpers": [
                    {
                        "video_bumper_type": "outro",
                        "max_duration_secs": 30
                    }
                ]
            },
            "ad_types": null
        }
    }
}

Adición de una ubicación con la característica skipoffset habilitada

{
        "placement": {
            "id": 11633087,
            ...
            "video": {
                "id": 336328,
                "width": null,
                "max_duration_secs": 60,
                "supports_skippable": true,
                "player_vast_version": "3.0",
                "context": "pre-roll",
                "playback_method": null,
                "maximum_number_ads": 3,
                "maximum_ad_duration_secs": null,
                "start_delay_secs": null,
                "use_server_side_trackers": false,
                "frameworks": null,
                "video_bumpers": [
                    {
                        "video_bumper_type": "outro",
                        "max_duration_secs": 15
                    }
                ],
                "skipoffset_seconds": 10
            }
        }
}

Compartir a través de

Servicio de selección de ubicación

Formato de etiqueta

IFRAME

JavaScript

API de REST

Campos JSON

Tipos de medios admitidos

Subtipos multimedia admitidos

Tipos mime admitidos

Configuración de vídeo

Parachoques de vídeo

Relaciones de aspecto

Tipos de anuncios

Precios de la planta de activos del representador Tinytag

Creatividades predeterminadas

Valores emergentes

Precios claros estimados

Tamaños privados

Estadísticas

Ejemplos

Visualización de todas las ubicaciones de uno de los publicadores

Visualización de una ubicación específica

Adición de una ubicación que solo permite creativos con el tipo de `"Interstitial"` medio

Adición de una ubicación que solo permite creativos con el `"In-Banner Video"` subtipo multimedia

Adición de una ubicación que solo permite creativos con el `"Video Standard VAST"` subtipo multimedia

Adición de una ubicación de pod de anuncio que permite un parachoques de introducción

Adición de una ubicación con la característica skipoffset habilitada

Recursos adicionales

Compartir a través de

Servicio de selección de ubicación

Formato de etiqueta

IFRAME

JavaScript

API de REST

Campos JSON

Tipos de medios admitidos

Subtipos multimedia admitidos

Tipos mime admitidos

Configuración de vídeo

Parachoques de vídeo

Relaciones de aspecto

Tipos de anuncios

Precios de la planta de activos del representador Tinytag

Creatividades predeterminadas

Valores emergentes

Precios claros estimados

Tamaños privados

Estadísticas

Barra de herramientas & declaración de complemento del explorador

Ejemplos

Visualización de todas las ubicaciones de uno de los publicadores

Visualización de una ubicación específica

Adición de una ubicación que solo permite creativos con el tipo de "Interstitial" medio

Adición de una ubicación que solo permite creativos con el "In-Banner Video" subtipo multimedia

Adición de una ubicación que solo permite creativos con el "Popup" subtipo multimedia

Adición de una ubicación que solo permite creativos con el "Video Standard VAST" subtipo multimedia

Adición de una ubicación de pod de anuncio que permite un parachoques de introducción

Adición de una ubicación con la característica skipoffset habilitada

Recursos adicionales

Adición de una ubicación que solo permite creativos con el tipo de `"Interstitial"` medio

Adición de una ubicación que solo permite creativos con el `"In-Banner Video"` subtipo multimedia

Adición de una ubicación que solo permite creativos con el `"Popup"` subtipo multimedia

Adición de una ubicación que solo permite creativos con el `"Video Standard VAST"` subtipo multimedia