Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 |
sí | 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 |
sí | 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"
}
}