Servicio de colocación

El servicio de selección de ubicación te permite crear etiquetas de anuncios para establecer emplazamiento, así como modificarlas y verlas. Usarás emplazamientos para editores administrados o para compras directas de medios.

  • Los ID de ubicación y su información asociada se almacenan en el lado del servidor con Xandr y son fáciles de modificar.
  • Cuando creas un emplazamiento, especificas los tipos de creatividades que pueden aparecer en él (ver supported_media_types y supported_media_subtypes abajo).

Nota:

La segmentación de anunciantes, líneas de pedido o campañas a través de este servicio anulará cualquier segmentación definida por el servicio de reglas de pago.

Formato de etiqueta

Una vez que tenga el identificador de colocación, formatee la etiqueta de selección de ubicación de la siguiente manera y entréguela al editor que representa o con el que tiene una compra garantizada.

Nota:

"id" es el id. del emplazamiento.

Sugerencia

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

Importante

Al servir las etiquetas de emplazamiento en un inventario seguro (SSL), debes modificar las siguientes etiquetas 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:

El code, placement_code, site_code, y publisher_code se puede usar en lugar de los ID correspondientes en las llamadas siguientes.

Método HTTP Endpoint Description
POST https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID

https://api.appnexus.com/placement?site_id=SITE_ID
(ubicación JSON)		 Agregar un emplazamiento (RED).
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
(ubicación JSON)		 Modificar una ubicación existente (RED).
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		 Eliminar una ubicación existente.
GET https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID Ver todos los emplazamientos de uno de sus editores.
GET https://api.appnexus.com/placement?id=PLACEMENT_ID Vea un emplazamiento específico para uno de sus editores.
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 El id. de la ubicación.

Valor predeterminado: Número incrementado automáticamente (por ejemplo, 123)
Requerido en: PUT, en la cadena de consulta
name cadena (100) El nombre del emplazamiento.

Requerido en: POST
code cadena (100) El código personalizado de la ubicación.

Nota: Los códigos deben ser alfanuméricos y no pueden contener espacios. También se permiten los siguientes caracteres:
- punto (".")
- carácter de subrayado ("_")
- guion ("-")
- porcentaje ("%")
code2 cadena (100) El 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 siguientes caracteres:
- punto (".")
- carácter de subrayado ("_")
- guion ("-")
- porcentaje ("%")
code3 cadena (100) El tercer 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 siguientes caracteres:
- punto (".")
- carácter de subrayado ("_")
- guion ("-")
- porcentaje ("%")
state enumeración El estado de la colocación. Valores posibles: "active" o "inactive".

Valor predeterminado: "active"
width Entero El ancho de la ubicación.
height Entero La altura de la colocación.
is_resizable Booleano Si la selección de ubicación usa un iFrame descriptivo y desea cambiar su tamaño para ajustarse a creatividades más pequeñas o más grandes, establezca este campo en true.

Valor predeterminado: false
default_position enumeración La posición predeterminada del emplazamiento en la página. Valores posibles: - "above" (en la parte superior de la página)
"below" (debajo del pliegue)
"unknown"

Valor predeterminado: "unknown"
publisher_id Entero El identificador del publicador asociado al emplazamiento.

Requerido en: POST
publisher_name cadena (100) El nombre del editor asociado con la ubicación.
site_id Entero Id. del sitio primario de este emplazamiento. Cada ubicación debe pertenecer a un sitio.

Predeterminado: Sitio del publicador
site_name cadena (100) Nombre del sitio en el que se usa la ubicación.
inventory_source_id Entero En desuso.
ad_profile_id Entero El identificador del perfil de anuncios asociado al emplazamiento.

Nota: La manera preferida de "asignar" un perfil de anuncio a una ubicación es la siguiente: Cree una regla de calidad de anuncios con un perfil de segmentación (el perfil "segmenta" la ubicación). Vincular el perfil de anuncio a la regla de calidad del anuncio. Asigna la regla de calidad de anuncios al editor. De este modo, podrás disfrutar de una mayor flexibilidad con el perfil de segmentación.
supported_media_types matriz de objetos Los tipos de elementos multimedia que se pueden emplear en el emplazamiento. Consulte Tipos de medios compatibles a continuación para obtener más información.

Atención: Si no especifica uno u otro 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 Los subtipos de medios que se pueden utilizar en la ubicación. Consulte Subtipos de medios compatibles a continuación para obtener más información.
pop_values matriz En desuso.
default_creative_id Entero En desuso. En su lugar, utilícela default_creatives .
default_creatives matriz Las creatividades predeterminadas que se mostrarán en lugar de un PSA cuando no haya un ganador de la subasta. Para cada creatividad predeterminada, el precio de reserva se establece con el "price" campo de la matriz. Consulte Recursos creativos predeterminados 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 del emplazamiento se establece en la default_creatives matriz (consulta Creatividades predeterminadas a continuación). Si la selección de ubicación no tiene creatividades predeterminadas, se puede establecer aquí un precio de reserva para la selección de ubicación; Sin embargo, esta no es la mejor práctica, ya que el precio de reserva puede provocar la visualización de un PSA.

Importante: Un perfil de gestión del rendimiento reemplazará cualquier configuración de precio de reserva a nivel de colocación. Si tiene dicho perfil, debe establecer el precio de reserva deseado a través de un piso duro.
hide_referer Booleano Si true, no se informará de la entidad de referencia.
default_referrer_url string Si se establece un perfil de visibilidad para ocultar las URL de inventario en las solicitudes de puja, puede establecer este campo para que pase una URL mnemónica en su lugar. Esto es especialmente útil en los casos en los que los editores no desean compartir dominios reales, pero quieren que los compradores puedan identificarlos por dominio.
visibility_profile_id Entero El identificador del perfil de visibilidad asignado directamente a la ubicación. Para obtener más información sobre los perfiles de visibilidad, consulte el Perfil de visibilidad.
exclusive Booleano Solo lectura.
Para indicar si el inventario de un emplazamiento va a estar disponible para su reventa, usa el rtb campo del marketplace_map objeto del sitio del emplazamiento. Consulte Servicio de sitio para obtener una descripción de este campo. Todo el inventario disponible para la reventa es parte del Marketplace RTB.

Valor predeterminado: False
pixel_url string Llamada a cuestas al usar 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 Una lista de categorías de contenido asociadas con esta ubicación. Se pueden especificar como máximo 20 categorías para una colocación.
filtered_advertisers matriz Una lista de anunciantes que pueden dirigirse a la ubicación.
filtered_line_items matriz Una lista de líneas de pedido que pueden segmentarse por emplazamiento.
filtered_campaigns matriz Una lista de campañas que pueden segmentar el emplazamiento.
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 Utilice y supported_media_subtypes en su lugar.
intended_audience enumeración Valores solo para autoauditoría. Posibles valores:
- "general"
- "children"
- "young_adult"
- "mature"
inventory_attributes matriz Los atributos confidenciales contenidos en la ubicación.

Consejo: También inventory_attributes se puede aplicar a nivel de sitio y, en este caso, también influirá en los objetos a nivel de colocación. Esta es una matriz de objetos con identificadores. Consulte el Servicio de atributos de inventario para obtener una lista de identificadores.
audited Booleano Si true, la ubicación ha sido auditada por el propietario.

Valor predeterminado: false
audit_level enumeración Valores solo para autoauditoría.

Nota: Las autoauditorías a nivel de sitio se pueden anular a 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 la ubicación.

Valor predeterminado: "site"
default_calculation_type enumeración Esto determina el umbral del precio de puja por debajo del cual se servirá un creativo predeterminado. Puedes elegir si este umbral es el ingreso bruto de la red o el ingreso neto del editor. Si no hay campañas adicionales aptas ni creatividades predeterminadas disponibles, se publica un anuncio de servicio público. Valores posibles: "gross" o "net".

Valor predeterminado: "gross"
apply_floor_to_direct Booleano Eliminado. En su lugar, utilícela floor_application_target .
demand_filter_action string Indica fuentes de demanda que se pueden incluir o excluir.

Valor predeterminado: default
floor_application_target enumeración El tipo de ofertas a las que se aplica el precio de reserva. Posibles valores:
- "external_only" - El precio de reserva se aplica solo a las ofertas externas (el miembro comprador y el miembro vendedor son diferentes). Utilice esta opción si prefiere servir una impresión de Learn administrado disponible que servir un valor predeterminado, incluso si esto significa superar el % máximo del volumen diario para Learn (max_learn_pct campo en Publisher Service).
- "external_non_preferred" - El precio de reserva se aplica a ofertas externas (el miembro comprador y el miembro vendedor son diferentes) o cuando la impresión es una impresión de aprendizaje administrada disponible que excede el % máximo del volumen diario para aprender. Use esta opción si prefiere servir un valor predeterminado que servir una impresión de aprendizaje administrado disponible que superaría el % máximo del volumen diario de aprendizaje.
- "all" - El precio de reserva se aplica a todas las pujas excepto las impresiones de aprendizaje administrado dentro del % máximo del volumen diario de aprendizaje.

Valor predeterminado: "all"
pixel_url_secure string Llamada segura al cargar la ubicación 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 barras de herramientas y complementos del navegador. Si un vendedor asigna el atributo de inventario "barra de herramientas", estos metadatos adicionales también deben incluirse.
acb_code cadena (32) En desuso.
tag_data string En desuso.
cost_cpm double Si existe un valor, se usará como información de pago para el emplazamiento. Esto invalidará cualquier regla de pago asociada con el editor.

Valor predeterminado: null
is_prohibited Booleano Solo lectura. Si true, la ubicación se ha prohibido debido a una infracción de las directivas de contenido de Xandr. No se llevarán a cabo subastas directas ni de terceros para una ubicación prohibida.

Valor predeterminado: false
last_modified marca de tiempo Solo lectura. La 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). En su lugar, utilice el servicio de informes para obtener información estadística.
content_retrieval_timeout_ms Entero El tiempo de espera de esta selección de ubicación se establecerá en el contenido recuperado de creatividades "mediadas", es decir, las creatividades cuyo content_source estado establecido en "mediation". Para obtener más información, consulte el Servicio Creativo.
- Si se establece en 0, el servidor de anuncios utilizará el valor del Servicio para miembros
- Valor predeterminado si 0 no se proporciona a la API en PUT o POST llamadas.
- Si el servidor de anuncios lee un 0 en este campo, realizará una búsqueda de miembros y utilizará el tiempo de espera predeterminado definido por el Servicio para miembros (suponiendo que también sea distinto de cero).
- Al crear una ubicación, no se copiarán valores 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, consulte el default_content_retrieval_timeout_ms campo de Servicio para miembros.

Valor predeterminado: 0
enable_for_mediation Booleano Esta será la fuente de la verdad para saber 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 se cambia el valor predeterminado en el Servicio al Miembro, esa acción no afectará retroactivamente las ubicaciones creadas anteriormente; Se seguirán estableciendo en el valor predeterminado anterior. En otras palabras, el valor de este campo no se puede actualizar retroactivamente estableciendo el valor predeterminado del miembro. Para obtener más información, consulte el default_enable_for_mediation campo de Servicio para miembros.

Predeterminado: Heredado del default_enable_for_mediation campo del Servicio al Miembro.
private_sizes matriz de objetos La lista de tamaños de emplazamientos que se pueden permitir en ofertas y paquetes. Consulte Tamaños privados a continuación para obtener más información.
video objeto El subtipo de medio permitido sirve 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 relativa a los tipos de ubicación, incluido el identificador de tipo de anuncio e información sobre el representador. Para obtener más información, consulta Tipos de anuncios a continuación.

Valor predeterminado: null
Requerido en: PUT
use_detected_domain booleano Solo lectura. Si se debe usar el dominio detectado frente al dominio reportado. 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 selección de ubicación. supported_mime_types_action_include a continuación se usa para especificar si se incluirán o excluirán esos tipos MIME. Para obtener una lista de las cadenas utilizadas para identificar cada tipo MIME, consulte Tipos MIME compatibles.

Valor predeterminado: empty
supported_mime_types_action_include booleano Si true, se incluirán los tipos MIME enumerados en la mime_types matriz.

Valor predeterminado: false
handles_mixed_media booleano Esto le dice a nuestra plataforma si el reproductor de vídeo puede admitir un archivo VAST con diferentes tipos de mime.

Valor predeterminado: true
tinytag_renderer_asset_floor_prices matriz de objetos Asocia los precios mínimos a los creativos nativos que se han asignado a la ubicación. Para obtener información adicional, consulte Precios mínimos de activos de Tinytag Renderer.

Requerido en: PUT
is_ss_native_assembly_enabled booleano Cuando está habilitada, 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 activos nativos en las respuestas. La respuesta final se establecerá de nuevo en un tipo de anuncio de banner con un marcado de anuncio ensamblado nativo adjunto. Si true entonces sí.
GPID cadena (255) Id. de ubicación global (GPID). Identificador de nivel de ubicación global proporcionado por el editor para indicar una ubicación de anuncio específica en la página.

Tipos de medios admitidos

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

Campo Tipo Descripción
id Entero El identificador del tipo de medio permitido. Puede usar el servicio de tipo 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 El 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 Cuándo se actualizó por última vez el allowed_media_type objeto.

Subtipos de medios admitidos

Las creatividades se clasifican por tipo de medio y subtipo de medio. El tipo de medio define el estilo de visualización general de la creatividad, por ejemplo, "Banner"y el subtipo de medios define el estilo de visualización específico de las creatividades, por ejemplo, "Standard Banner" o "In-Banner Video". Puede usar esta matriz para limitar el subtipo de medio, el estilo de visualización específico de los creativos, que se pueden publicar en una ubicación. Para limitar el tipo de medio y el estilo de visualización general de las creatividades, utilice la supported_media_types matriz (consulte Tipos de medios compatibles más arriba).

Campo Tipo Descripción
id Entero El identificador del subtipo de medio permitido. Puede utilizar el servicio de subtipos de medios para ver todos los subtipos de medios.

Valor predeterminado: null
name string Nombre del subtipo de medio permitido.
is_private booleano Si el subtipo de elemento multimedia se establece en privado. Si true entonces sí.
media_type_group_id Entero El identificador de grupo para el tipo de medio.

Nota:

Tipos y subtipos de medios admitidos

  • Si no especifica los tipos de medios o subtipos de medios compatibles, el "Banner" tipo de medios y todos sus subtipos se permitirán de forma predeterminada.
  • Puede combinar los "Banner" tipos de medios y "Text" cualquier combinación de sus subtipos de medios en una sola ubicación, pero no puede combinar ninguno de los otros tipos y subtipos de medios. Esta limitación garantiza que solo se sirvan creativos apropiados en un emplazamiento. Por ejemplo, un emplazamiento que permite a creativos del tipo "Video" multimedia está destinado a ser alimentado a un reproductor de vídeo; no tendría sentido permitir que creativos de cualquier otro tipo de medio, como "Interstitial", sirvan en el emplazamiento.
  • Puede establecer una ubicación para permitir el tipo de medio o cualquiera de sus subtipos para el "Expandable" inventario directo. Si quieres admitir creatividades expandibles para emplazamientos que están disponibles para revender a otros miembros de la plataforma, proporciona el identificador del emplazamiento al Portal de soporte al cliente para su verificación.

Tipos MIME admitidos

La mime_types matriz de objetos admite los tipos MIME mostrados en la tabla siguiente. Si no se especifican tipos MIME, se aceptarán todos los tipos MIME. La API de selección de ubicación usa la cadena de la columna Name . Si necesita pasar esta información en una etiqueta, use el ID.

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 es supported_media_subtypes"Standard VAST", estos campos deben incluirse en el video objeto. Consulte los ejemplos a continuación.

Nota:

La siguiente configuración afecta a los resultados de la subasta: para la configuración del reproductor de salida, que determina el comportamiento final del reproductor de vídeo de salida, 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 Un identificador único para el objeto de configuración de vídeo.
width Entero La anchura 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 el emplazamiento.
- Si maximum_number_ads es >1, la duración máxima se aplica a toda la longitud de un pod de anuncios (una agrupación lineal de más de un anuncio diseñado para rellenar un emplazamiento único).

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 que se pueda reproducir en el emplazamiento. 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 el emplazamiento. Si maximum_number_ads es >1así, la ubicación puede ser un pod de anuncios (una agrupación lineal de más de un anuncio diseñada para llenar una sola ubicación).
start_delay_secs Entero El retraso de inicio en segundos para la colocación. Si el valor del retraso de inicio es >0, entonces 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 que no nullsea , el supports_skippable campo debe establecerse en true. (Ver más abajo).
supports_skippable booleano El espacio publicitario se puede omitir.
Posibles valores: "true" o "false"
context string Posición de desplazamiento 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 diferentes 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 El marco de la colocació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 botones superiores que se pueden asociar al pod de anuncios. La duración del efecto bumper no se incluye en la duración total del ad pod. Ver vídeo bumpers object.
player_vast_version string Este campo especifica la versión VAST más alta que admite la selección de ubicación y debe establecerse en el valor más alto que admita el reproductor. Las creatividades que requieran una versión vast superior a la versión de jugador no podrán participar en la ubicación.
Posibles valores:
- 2.0
- 3.0
- 4.0

PRECAUCIÓN: Si especificas un valor superior al que admite el reproductor, se producirán errores cuando se procesen creatividades no admitidas.
vmin_ad_duration Entero La duración mínima de la creatividad permitida, en segundos.
minbitrate Entero La velocidad de bits mínima en kbps.
mf_min_width Entero La anchura mínima de la creatividad de vídeo.
mf_min_height Entero La altura mínima de la creatividad de vídeo.
aspect_ratios matriz de objetos La relación de aspecto creativa que puede servir para la colocación de un vídeo. La matriz contiene ratio_width y ratio_height.

Efectos superiores de vídeo

Esta matriz de objetos contiene información relacionada con los botones superiores de un pod de anuncios.

Campo Tipo Descripción
video_bumper_type string El tipo de parachoques. Entre las opciones se incluyen:
- intro
- outro
Valor predeterminado: null
max_duration_secs Entero La duración máxima del botón superior.

Valor predeterminado: null

Relaciones de aspecto

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

Campo Tipo Descripción
ratio_width Entero La anchura de la relación de aspecto
ratio_height Entero La altura de la relación de aspecto

Tipos de anuncio

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

Campo Tipo Descripción
id Entero El id. del ad_type.
Posibles valores:
1 = Banner
2 = Vídeo
3 = Nativo

Valor predeterminado: null
Requerido en: POST/PUT
renderer_id Entero Id. del representador.
Posibles valores:
1 = banner de outstream
2 = vídeo outstream

Valor predeterminado: null
Requerido en: POST/PUT
name string El nombre del ad_type en todas las letras minúsculas, por ejemplo video , o banner.
display_name string El nombre para mostrar del , mostrado como el tipo de ad_typeanuncio con mayúsculas iniciales, por ejemplo Video o Banner.
renderer varios objetos Un objeto que consta de y iddisplay_name del representador.

Valor predeterminado: null
Requerido en: POST/PUT

Precios mínimos de los activos del renderizador Tinytag

Esta matriz de objetos se usa para asociar precios mínimos a las creatividades nativas que se han asignado al emplazamiento.

Campo Tipo (longitud) Descripción
renderer_id Entero Id. del representador.

Requerido en: POST/PUT
ad_type_id Entero El id. del ad_type. Este siempre será 3 ya que solo puedes asociar precios mínimos con creativos nativos.

Valor predeterminado: 3
Requerido en: POST/PUT
asset_type string El tipo de activo.
Los valores posibles son:
- main_image
- video
Requerido en: POST/PUT
floor_price double El importe de la puja preferido a cambio de las impresiones del activo nativo.

Requerido en: POST/PUT

Recursos creativos predeterminados

Utilice esta matriz para asignar creatividades predeterminadas a la ubicación. Ten en cuenta los siguientes requisitos:

  • Una creatividad predeterminada no debe estar caducada. Consulte el is_expired campo en el Servicio creativo para obtener más información.

  • Se debe asignar un recurso creativo predeterminado a una plantilla de creatividad que coincida con el supported_media_types y supported_media_subtypes de la ubicación. Por ejemplo, si la selección de ubicación permite creatividades "Banner" del tipo de medios, no podrá asociar creatividades predeterminadas que utilicen una plantilla de creatividad para el tipo de "Interstitial" medios. Consulte el template campo en el Servicio creativo para obtener más información.

  • Si la ubicación tiene un tamaño (los "width" campos y "height" están definidos para la ubicación), esta matriz debe contener solo una creatividad con las dimensiones coincidentes.

Campo Tipo Descripción
id Entero El id. de la creatividad predeterminada.
width Entero El ancho del creativo predeterminado.
height Entero El alto del recurso creativo predeterminado.
price double El precio de reserva del recurso creativo predeterminado. Una oferta ganadora debe estar por encima de este precio.
name string Solo lectura. El nombre del recurso creativo predeterminado.

Valores pop

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

Campo Tipo Descripción
pop_freq_times Entero El número de veces que la etiqueta se puede mostrar en 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, la etiqueta es una etiqueta prepop y se mostrará en una ventana que ya ha aparecido en la página del editor.

Valor predeterminado: false
pop_max_width Entero Si pop_max_width se especifica, cualquier creatividad que muestre la etiqueta debe tener un ancho igual o menor que pop_max_width

Valor predeterminado: no max width.
pop_max_height Entero La altura máxima de la creatividad. Si pop_max_height se especifica, cualquier creatividad que muestre la etiqueta debe tener una altura 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 ubicación.
average_price double Este es el promedio de todas las ofertas presentadas para esta ubicación.
width Entero Al exportar etiquetas de emplazamiento sin tamaño que se van a servir, se determina la anchura del emplazamiento.
height Entero Al exportar etiquetas de emplazamiento sin tamaño que se van a servir, se determina la altura del emplazamiento.
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 un trato personalizado o en un paquete. El override_size_preference servicio de ofertas o el servicio de paquetes debe establecerse append para que estos tamaños privados sirvan junto con los tamaños de ubicación estándar.

Campo Tipo Descripción
width Entero El ancho de la ubicación.
height Entero La altura de la colocación.

Estadísticas

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

Declaración de complemento del explorador & la barra de herramientas

De acuerdo con la política de la plataforma, los vendedores deben identificar todo el inventario de complementos de barra de herramientas / navegador y separarlo de otro inventario en sus propias ubicaciones. Para identificar el inventario de la barra de herramientas, los vendedores deben:

  • Establezca la inventory_attribute configuración apropiada.
  • Envíe la información necesaria en la matriz de barras de herramientas, que se describe aquí:
Parámetro Tipo Descripción
name string El nombre comercial común de la barra de herramientas.
company string El desarrollador de la barra de herramientas. Identifique la entidad comercial legal, no un nombre comercial.
tos_url string Un enlace a una página web donde nuestros auditores pueden encontrar términos de servicio completos.
install_url string Vínculo a una página web donde nuestros auditores pueden instalar la barra de herramientas.

Ejemplos

Ver todos los emplazamientos de uno de tus editores

$ 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 un emplazamiento específico

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

Agregar una ubicación que permita solo creatividades con el tipo de "Interstitial" medios

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

Agregar una ubicación que permita solo 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
        }
    }
}

Agregar una ubicación que permita solo 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
        }
    }
}

Agregar una ubicación que permita solo 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"
        ]
      }
    }
  }
}

Agregar una ubicación en el pod de anuncios que permite un efecto cortinoso 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
        }
    }
}

Agregar 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
            }
        }
}
  • Last updated on