Esta sección describe los parámetros de cadena de consulta que se usan para habilitar la publicidad on demand en los servicios de Triton Digital. Estos parámetros deben enviarse además de los parámetros descritos en Parámetros, en la Especificación técnica de publicidad.
El ID de colocación (stid) es el método preferido para indicar para qué colocación se está realizando la solicitud de anuncio on demand. Triton Digital también admite métodos alternativos, como el nombre de la estación o una ID externa. Para obtener más información, consulte Póngase en contacto con el servicio de asistencia técnica.
Envíe un parámetro únicamente si desea pasar específicamente un valor para ese parámetro. Si no desea pasar un valor, no debe enviar el parámetro.
Los parámetros se pueden proporcionar en la cadena de consulta del URI del extremo o, cuando se indique, como un campo de encabezado HTTP. Cuando se reciben ambos, la cadena de consulta se evalúa primero y el encabezado HTTP se evalúa en segundo lugar, en el orden que se presenta en esta página.
Los parámetros de cadena de consulta que admiten una lista se pueden establecer como separados por comas sin procesar o como codificados por URL.
Cadena de consulta | Encabezado HTTP | Descripción | Formato |
|---|---|---|---|
stid | ID de la colocación (históricamente conocida como la "ID de estación"). Obligatorio. Para obtener alternativas, consulte Nota STID. | Entero | |
tipo | Posición del anuncio. Obligatorio. | Secuencia. Valores válidos:
| |
maxAds | Cuando el valor del parámetro es mayor que 1, el ad server on demand devuelve un pod de anuncios que contiene varios anuncios hasta el valor del parámetro, y se utiliza el atributo sequence en la respuesta. Este parámetro es opcional, el valor predeterminado es 1. Cuando el ad server solo tiene un elemento ad para devolver, no se utiliza un pod de ad y el atributo sequence no se utiliza en la respuesta. Consulte también Notas de uso de pods de anuncios y Notas de uso de posicionamiento de pausas. | Entero. Valores válidos: 1 a 10. | |
ip | X-Device-IP | Dirección IP del reproductor o dispositivo del oyente. Necesario para integraciones de servidor a servidor. | Para IPv4: formato decimal con puntos. Ejemplo: Para IPv6: caracteres hexadecimales separados por dos puntos. Ejemplo: |
ua | X-Device-User-Agent | Encabezado HTTP User-Agent del reproductor/dispositivo del oyente. Necesario para integraciones de servidor a servidor. | Codificado mediante URL si se envía como cadena de consulta. |
cabecera | X-Device-Referer | Encabezado HTTP de referente del reproductor/dispositivo del oyente (URL de la página en la que está integrado el reproductor). Recomendado para reproductores basados en navegador en integraciones de servidor a servidor. Nota: el uso de una "r" en esta ortografía de X-Device-Referer es correcto. | Codificado mediante URL si se envía como cadena de consulta. |
idioma-dispositivo | X-Device-Accept-Language o | Cabecera HTTP del reproductor/dispositivo del oyente. Indica para qué idiomas está configurado el cliente y la variante local preferida. Admitimos ambos: cadena de consulta o encabezado HTTP. Recomendado para integraciones de servidor a servidor. | Secuencia. Código de dos letras que corresponde a los códigos de idioma ISO-639-1 . |
dispositivo-so | Sistema operativo del dispositivo. | Secuencia. Ejemplo: iOS | |
dispositivo-osv | Versión del sistema operativo del dispositivo | Secuencia. Ejemplo: 3.1.2. | |
mindur | Duración mínima en segundos permitida para el anuncio solicitado. Si usa este parámetro, invalida TAP duración de medios programáticos establecida en Calidad de anuncio progresivo. Para obtener información sobre cómo funciona este parámetro con maxAds y pods de anuncios, consulte Notas de uso de pods de anuncios. | Entero. | |
maxdur | Duración máxima en segundos permitida para el anuncio solicitado. Si usa este parámetro, invalida TAP duración de medios programáticos establecida en Calidad de anuncio progresivo. Para obtener información sobre cómo funciona este parámetro con maxAds y pods de anuncios, consulte Notas de uso de pods de anuncios | Entero. | |
iab-categories-to-exclude | Lista de categorías de anuncios no permitidas para el anuncio solicitado. Las categorías se definen en la especificación DAAST de IAB y se enumeran con los códigos en OpenRTB. Para excluir el nivel 2 de una categoría, cada categoría de nivel 2 debe excluirse individualmente. Excluir una categoría de nivel 1 no bloquea las categorías de nivel 2 que la componen. Por ejemplo, excluir solo IAB1 no bloquea IAB1-1 a IAB1-7. Aunque la especificación DAAST está obsoleta, sus categorías de anuncios todavía se usan regularmente. Triton se actualizará a la taxonomía de productos publicitarios de IAB una vez que haya alcanzado un nivel aceptable de uso. | Secuencia. Lista de códigos separados por comas. | |
feed-type | Requerido para el caso de uso específico en el que el inventario se ofrece a publicidad programática y los anuncios solicitados a través de on demand se unen a un podcast. También se puede utilizar para la transmisión en vivo. Consulte también método de entrega. | Secuencia. Valores válidos:
| |
parámetro de consulta content-language | El idioma del contenido donde se reproducirán los anuncios. Esto se puede usar en el direccionamiento de campañas o para definir una regla específica en el intercambio de anuncios. | Secuencia. Código de dos letras que corresponde a los códigos de idioma ISO 639-1. | |
iab-v2-cat | Categoría del contenido según lo definido por la taxonomía de contenido V2 de IAB Tech Lab (archivo XLXS). La primera categoría de la lista se considera la categoría principal. Este parámetro se recomienda para contenido de audio personalizado, como servicios de música, donde el género es dinámico y se basa en la elección del oyente. Consulte IAB notas de uso de categorías. | Lista separada por comas de valores enteros, cada uno dentro del rango de 1-698. (Consulte IAB Notas de uso de categorías a continuación). | |
site-url | URL el sitio web donde se oirá el anuncio. Los compradores programáticos lo utilizan para identificar el inventario en el que hacen ofertas. También se utiliza para verificar si Triton Digital puede vender su inventario utilizando el marco ads.txt. Si no se envía, Triton Digital usará el valor configurado para esta colocación. Para obtener más información, consulte Vendedores digitales autorizados (ads.txt). | URL codificada cadena de una URL, que debe incluir el protocolo, http o https). Ejemplo:
| |
delivery-method | La forma en la que se enviará el contenido de audio al oyente. Este parámetro es obligatorio si se descarga el contenido en el que aparecerá el anuncio y se ofrece inventario de anuncios a compradores programáticos. | Secuencia. Valores válidos:
Consulte Notas sobre el método de entrega. | |
break-id | ID de interrupción | Identificador único universal (UUID) que se utiliza para identificar las pausas publicitarias on demand para la separación de la industria. Debe ser único para cada oyente. Para obtener más información, consulte Separación por industria. | Secuencia |
break-context | Break-Context | Cadena codificada devuelta por Triton Digital en respuesta a una break-id; la cadena break context debe ser devuelta a Triton Digital con la siguiente solicitud de anuncio. Para obtener más información, consulte Separación por industria. | Secuencia |
break-position | Ubique break position de los anuncios solicitados de manera tal que coincidan con el direccionamiento de contenido correspondiente. En el caso de varios anuncios entregados, solo se espera que un anuncio ( ya sea el primero o el último) coincida con ese direccionamiento. El parámetro es opcional. Para obtener más información, consulte Notas de uso de Break Positioning a continuación. | Secuencia. Valores válidos:
| |
número de ruptura | El número de pausa en el episodio del podcast. | Entero. | |
series-title | Título de la serie para contenido de podcast. | Secuencia. | |
episode-season | Número de temporada para el contenido del podcast. | Secuencia. | |
episode-number | Número de episodio para contenido de podcast. | Secuencia. | |
episode-title | Título del episodio para contenido de podcast. | Secuencia. | |
episode-url | URL de origen del episodio para el contenido del podcast. | Codificado mediante URL si se envía como cadena de consulta. | |
duración del episodio | Duración del episodio. | Entero. | |
Guid | ID de episodio | Secuencia. En formato UUID estándar. |
Notas sobre el método de entrega
A continuación se muestran las definiciones de los valores del método de entrega .
Streaming: para un flujo interminable de contenido, como radio en vivo. La sesión del usuario finaliza solo cuando el dispositivo cierra la conexión. El contenido se recupera a medida que se consume. Esto también se aplica a los servicios de música bajo demanda. No se aplica a las actuaciones "en vivo" bajo demanda porque constantemente se agrega contenido nuevo a la lista de reproducción a medida que se consume el contenido actual.
Descargar: para contenido individual pregrabado o finito, como un podcast. La sesión del usuario finaliza una vez que se descarga el contenido o antes si el usuario se desconecta a mitad de camino. Por lo general, la recuperación y el consumo de contenido son independientes; un ejemplo es el caso de un oyente que descarga un podcast y lo escucha más tarde, incluso quizá cuando el dispositivo está fuera de línea. Por lo tanto, las impresiones se activan por la descarga, no por el consumo.
progresivo: Para el mismo tipo de contenido pregrabado o finito que la descarga, pero el contenido se recupera a medida que se consume. Esto debe ser aplicado por el reproductor en el dispositivo del usuario. Es una implementación de cliente, por lo que las implementaciones del lado del servidor que aceleran la velocidad de descarga no califican una sesión como descarga progresiva.
Notas de uso de pods de anuncios
Un pod de anuncios es un grupo de múltiples anuncios contenidos en una sola respuesta. Se proporcionan múltiples elementos <Ad> con atributos <secuencia> . El resultado es una solicitud VAST con múltiples anuncios ordenados con números de secuencia. Los anuncios se seleccionan en función de su prioridad/peso.
Un pod de anuncios puede contener varios anuncios de fuentes directas pero solo un anuncio programático. Tenga en cuenta que si usa mindur o maxdur junto con un valor maxAds mayor que "1", las duraciones mínimas y máximas especificadas se aplican a cada anuncio en el pod de anuncios, no a la duración total del pod de anuncios. Cuando una solicitud incluye un parámetro break-id y un parámetro maxAds , el contexto de pausa que se devuelve contiene todas las categorías IAB e ID de anunciante contenidos en el pod del anuncio.
Hay lógica de limitación incrustada en un pod de anuncios; Un pod de anuncios no contendrá dos o más anuncios del mismo vuelo de TAP, ni dos o más anuncios con la misma categoría IAB. Tenga en cuenta que puede aplicar la separación de industrias dentro de los pods de anuncios.
IAB Notas de uso de categorías
Todos los siguientes parámetros deben incluirse en la solicitud de anuncio para poder usar IAB v2 y, por lo tanto, causar una impresión IAB v2 para el podcast:
guidbreak-numberbreak-idipua
Si alguno de los parámetros anteriores no está incluido, se utiliza IAB v1.
IAB se aceptan valores superiores a 698, pero se ignorarán. En su lugar, use el parámetro de idioma de contenido dedicado. Por ejemplo, si Triton recibe iab-v2-cat=1068 (1068 = inglés), esto no establecerá el idioma del contenido en inglés.
A diferencia del contenido de transmisión donde el género del programa es estático, la categoría de contenido (iab-v2-cat) de los servicios de música personalizados es dinámica y depende de la selección del oyente. Para aprovechar las campañas publicitarias dirigidas a los oyentes por preferencia de contenido, use el parámetro iab-v2-cat en sus solicitudes de anuncios. Configure el reproductor para que utilice el valor iab-v2-cat que más se acerque a la selección de categoría de contenido actual del oyente. Esto alerta a las campañas dirigidas de mayor valor sobre el inventario direccionable disponible.
Notas de uso de Break Positioning
El uso de break-position está estrechamente relacionado con el targeting position-in-break. Si usted no usa este tipo de direccionamiento, simplemente ignore este parámetro.
Al pasar un ID de pausa y un contexto de pausa, el ad server determina automáticamente la primera posición . Si no usa break-context, debe usar break-position=first para que el primer vuelo entregado apunte a la primera posición, si es posible.
El ad server no puede determinar la última posición del corte. Incluso cuando use break-context, debe usar break-position=last para indicar que esta será la última solicitud de anuncio relacionada con esa pausa en particular, de modo que el último vuelo entregado apunte a la última posición, si es posible.
Incluso si maxAds está por encima de 1, solo un anuncio devuelto direccionará la primera o la última posición. Además, la cantidad de anuncios devueltos debe coincidir con la cantidad de anuncios solicitados antes de que el último se pueda considerar en la última posición. Si el ad server devuelve menos anuncios de los solicitados, ninguno de ellos apuntará a la última posición. Por ejemplo: si maxAds es 3 y solo se completa la primera posición, no se entregará el anuncio "last in break".