Servicio TinyTag

El servicio TinyTag le permite crear ID de TinyTag, así como modificarlos y verlos.

Los identificadores están asociados a información sobre el espacio de anuncios, como el tamaño, el precio de reserva y qué marcas o creatividades pueden ejecutarse en ese espacio. Esta información se almacena en el lado del servidor con Xandr y es fácil de modificar.

Los ID de TinyTag se pueden usar en TinyTags, que se colocan directamente en las páginas del editor y toman la forma https://ib.``adnxs``.com/tt?id=1básica . Se puede pasar más información en un TinyTag utilizando los parámetros dinámicos de TinyTag.

Tenga en cuenta que el miembro asociado con la ID de TinyTag tiene derechos de preferencia sobre el inventario y recibe crédito (o efectivo) si otro miembro lo compra.

API de REST

Método HTTP Endpoint Description
DELETE https://api.adnxs.com/tt/MEMBER_ID/TAG_ID Eliminar un TinyTag existente.
GET https://api.adnxs.com/tt/MEMBER_ID Ver todos los TinyTags de un miembro.
GET https://api.adnxs.com/tt/MEMBER_ID/TAG_ID Ver un TinyTag en particular.
POST https://api.adnxs.com/tt/MEMBER_ID
(etiqueta JSON)
Crea un nuevo TinyTag.
PUT https://api.adnxs.com/tt/MEMBER_ID/TAG_ID
(etiqueta JSON)
Modificar un TinyTag existente.

Campos JSON

Campo Obligatorio Tipo Descripción
acb_code no cadena(32) No se usa habitualmente.
active No, el valor predeterminado está activo Entero El valor booleano determina si se puede usar el segmento
ad_profile_id no Entero Es el identificador del perfil de aprobación de anuncios que se usa para los estándares de calidad de los creativos.
audit_level no enumeración Valores solo para autoauditoría.
Nota: Las auditorías automáticas a nivel de sitio se pueden anular en el nivel de colocación (tinytag).
Posibles valores:
- "tinytag": use este valor si el campo auditado se establece en verdadero en la ubicación.
- "site": use este valor si el campo auditado se establece como falso en la ubicación pero verdadero en el sitio.
audited no booleano Si es verdadero, el propietario ha autoauditado la ubicación.
code no cadena(100) Campo definido por el usuario para la etiqueta de llamada mediante códigos. Se puede encontrar más información en la página de Tinytag.
code2 no cadena(100) Segundo código, si lo desea.
content_retrieval_timeout_ms no Entero
- Si 0, el servidor de anuncios utiliza 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, realiza una búsqueda de miembros y utiliza el tiempo de espera predeterminado definido por el Servicio para miembros (suponiendo que también sea distinto de cero).
- Al crear un TinyTag, ninguno de los valores se copia en este campo desde 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.
default_calculation_type no enumeración Esto determina el umbral del precio de puja por debajo del cual se sirve una creatividad predeterminada. 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: "bruto" o "neto".
default_creative_id no Entero El recurso creativo predeterminado que se ejecutará si ninguna puja alcanza el precio de reserva.
default_creatives no matriz Las creatividades predeterminadas que se muestran en lugar de un PSA cuando no hay un ganador de la subasta. Para cada creatividad predeterminada, el precio de reserva se establece con el campo "price" en la matriz. Consulte Recursos creativos predeterminados a continuación para obtener más detalles.
Nota: Para las ubicaciones de pops: la ubicación no aparece si no se cumple el precio de reserva, excepto en el caso de un prepop.
default_referrer_url no 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. Sin embargo, ten en cuenta que las campañas de Xandr no pueden dirigir directamente al dominio de vanidad, aunque sí puede ser atacado por postores externos.
enable_for_mediation no booleano - Esta es la fuente de la verdad sobre si un TinyTag debe aceptar contenido mediado
- A menos que se establezca en PUT o POST, este campo hereda su valor predeterminado del miembro. Si se cambia el valor predeterminado en el Servicio al Miembro, esa acción no afecta retroactivamente a los TinyTags creados anteriormente; Se siguen 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.
estimated_clear_prices no El importe de la puja que históricamente ha ganado la mayoría (95 %) de las subastas de terceros en las que participa. Consulte el precio claro estimado a continuación para obtener más detalles.
exclusive No, el valor predeterminado es False booleano Solo lectura. Este campo ha quedado en desuso. Anteriormente, este campo servía como valor predeterminado para el comportamiento exclusivo de un TinyTag. Esta configuración se controla ahora mediante el rtb campo dentro del marketplace_map objeto del site servicio.
floor_application_target no 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). Use 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 de learn.
- "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.
- "Todos": 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.
height no Entero La altura de la etiqueta en píxeles.
hide_referer booleano No mostrar la página de referencia.
id No, solo en Modificar Entero Id. de Xandr asignado por la API para hacer referencia a esta etiqueta.
intended_audiences no enumeración Valores solo para autoauditoría. Valores posibles: "general", "niños", "young_adult" o "maduro".
inventory_attributes no matriz Valores solo para autoauditoría. Esta es una matriz de objetos con identificadores. Consulte el Servicio de atributos de inventario para obtener una lista de identificadores.
is_resizable no booleano Si la ubicación utiliza 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.
last_activity no marca de tiempo La marca de tiempo de la última modificación de esta pequeña etiqueta.
media_subtypes no enumeración En desuso. En su lugar, use supported_media_types y supported_media_subtypes.
member_id int El id. de miembro propietario de esta etiqueta. Requerido para la llamada, pero no JSON.
name no string Nombre asociado con el TinyTag
pixel_type no enumeración Identifica el tipo de píxel. Los valores posibles son "script" o "imagen".
pixel_url no string La ubicación que el píxel notifica cuando un usuario hace clic en esa ubicación.
pixel_url_secure no booleano Indica si la dirección URL del píxel apunta a una página web encriptada.
pop_values no matriz Si el supported_media_type es "Pop" o el supported_media_subtypes es "Popup" o "Popunder", esta matriz define el comportamiento del pop. Consulte Valores pop a continuación para obtener más detalles.
position no enumeración "arriba", "abajo" o "desconocido": la posición del TinyTag con respecto al pliegue de la página
publisher_id no Entero El Id. del editor asociado al sitio en el que se encuentra la etiqueta.
reserve_price No, el valor predeterminado es 0 USD double El precio de reserva del anuncio en $CPM: es el precio más bajo al que el propietario del inventario está dispuesto a vender; de lo contrario, se sirve el creativo predeterminado.
Nota : este campo aparece como "precio" en el listado /meta.
segments no Matriz de objetos Un usuario que ve este TinyTag se coloca en todos los segmentos especificados Ejemplo: "segments": [ {"segment_id":1} ]
site_id int El Id. del sitio al que está asociada la etiqueta. La jerarquía es Etiquetas de sitios>. Para obtener más información sobre el Servicio de sitio, realice una GET llamada a https://api.adnxs.com/site/meta.
supported_media_subtypes no matriz 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.
supported_media_types no matriz 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.
tag_data no string Otra información, a menudo datos demográficos o descriptivos. Enviado solo al postor del propietario. Consulte también qs_data en TinyTags.
Nota: este campo aparece como "other_data" en el listado /meta.
use_detected_domain No, el valor predeterminado es True. booleano Solo lectura. Si se debe usar el dominio detectado frente al dominio reportado. El valor predeterminado es true para todos los clientes.
visibility_profile_id no Entero El identificador del perfil de visibilidad asignado directamente a la ubicación.
width no Entero El ancho de la etiqueta en píxeles.

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 y el estilo de visualización específico de las creatividades, utilice la matriz de supported_media_subtypes (consulte Subtipos de medios compatibles a continuación).

Campo Tipo Descripción
id Entero El identificador del subtipo de medio permitido.
name string Solo lectura. Nombre del subtipo de medio permitido.

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 matriz de supported_media_types (consulte Subtipos de medios compatibles más arriba).

Campo Tipo Descripción
id Entero El identificador del subtipo de medio permitido.
name string Solo lectura. Nombre del subtipo de medio permitido.

Notas sobre los tipos y subtipos de medios admitidos

  • Si no especifica los tipos de medios compatibles o los subtipos de medios compatibles, el tipo de medios "Banner" se permite de forma predeterminada.

  • Puede combinar los tipos de medios "Banner" y "Texto", y 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, una ubicación que permite creatividades del tipo multimedia "Video" está destinada a ser alimentada a un reproductor de video; no tendría sentido permitir que creativos de ningún otro tipo de medios, como "Interstitial", sirvieran en la ubicación.

  • Puede establecer una ubicación para permitir el tipo de medio "Expandible" o cualquiera de sus subtipos para el inventario directo. Si quieres admitir creatividades expandibles para ubicaciones que están disponibles para revender a otros miembros de la plataforma, proporciona la dirección URL para admitir la verificación.

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 campo is_expired 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 el supported_media_subtypes del emplazamiento. Por ejemplo, si la selección de ubicación permite creatividades del tipo de medio "Banner", no podrá asociar creatividades predeterminadas que utilicen una plantilla creativa para el tipo de media "Intersticial". Consulte el campo de plantilla en el Servicio creativo para obtener más información.
  • Si la ubicación tiene un tamaño (los campos "ancho" y "alto" están definidos para la ubicación), esta matriz debe contener solo una creatividad con las dimensiones coincidentes.
Campo Tipo Descripción
height Entero El alto del recurso creativo predeterminado.
id Entero El id. de la creatividad predeterminada.
name string Solo lectura. El nombre del recurso creativo predeterminado.
price double El precio de reserva del recurso creativo predeterminado. Una oferta ganadora debe estar por encima de este precio.
width Entero El ancho del creativo predeterminado.

Valores pop

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

Campo Tipo Descripción Predeterminado
pop_freq_duration Entero Consulta pop_freq_times. Sin límite de frecuencia
pop_freq_times Entero El número de veces que se puede mostrar la etiqueta a un usuario único en pop_frequency_duration segundos. No surte ningún efecto cuando pop_is_prepop se establece en true. Sin límite de frecuencia
pop_is_prepop booleano Si es verdadera, la etiqueta es una etiqueta prepop y sirve en una ventana que la página del editor ya ha mostrado. false
pop_max_height Entero La altura máxima de la creatividad. Si se especifica pop_max_height, cualquier creatividad que muestre la etiqueta debe tener una altura igual o menor que pop_max_height Sin altura máxima
pop_max_width Entero Si se especifica pop_max_width, cualquier creatividad que muestre la etiqueta debe tener un ancho igual o menor que pop_max_width Sin ancho máximo

Precios claros estimados

Campo Tipo Descripción
average_price double Este es el promedio de todas las ofertas presentadas para esta ubicació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.
height Entero Al exportar etiquetas de emplazamiento sin tamaño que se van a servir, se determina la altura del emplazamiento.
Comprobado booleano Indica si se comprueban los precios creados.
width Entero Al exportar etiquetas de emplazamiento sin tamaño que se van a servir, se determina la anchura del emplazamiento.

Ejemplo

Paso 1. Creación de un archivo con formato JSON con los parámetros pertinentes

$ cat tag
 {
     
"tinytag": 
{
         
"width": "728",
         
"height": "90",
         
"reserve_price": "5.00",
         
"default_creative_id": 212,
         
"active": true,
         
"tag_data": "male/22",
         
"ad_profile_id": 234
     }
 }

Paso 2. Agregue el archivo TinyTag a la caché de Imp Bus usando su ID de miembro

$ curl -b cookies -c cookies -X POST --data-binary @tag https://api.adnxs.com/tt/1/
{
    "response": {
        "status": "OK",
        "id": "1234"
    }
}

Paso 3. Ver la etiqueta que has creado con el id. de etiqueta 1234

$ curl -b cookies -c cookies https://api.adnxs.com/tt/1/1234


$ curl -b cookies -c cookies [adnxs.com/tt/1/1234](https://api.adnxs.com/tt/1/1234)

{
    "response": {
        "tinytag": {
            "id": 1234,
            "width": "728",
            "height": "90",
            "member_id": 1,
            "reserve_price": 5.00,
            "default_creative_id": 212,
            "tag_data": "male\/22",
            "active": true,
            "ad_profile_id": 234
        },
        "status": "OK"
    }
}