En esta sección se describen los parámetros que mejoran la monetización o son exigidos por diversas autoridades y órganos de gobierno. Estos parámetros deben enviarse además de los parámetros necesarios para cada servicio y se describen en otra parte de este documento (es decir, estos parámetros no sustituyen a los parámetros propios del servicio).
Token de socio
Vea también: Token de acceso.
Para evitar la reutilización no deseada de los parámetros por parte de terceros no autorizados, Triton Digital recomienda encapsular todos los parámetros en un "token de socio" (partnertok o X-Partner-Token). La ofuscación de los datos también agrega una capa de privacidad adicional para los usuarios finales.
El formato del token de socio está documentado en la especificación de token seguro de Triton Digital. Necesitará una clave privada para firmar el token; Se asigna una clave única a cada editor o socio. Comuníquese con el Servicio al Cliente de Triton Digital para obtener su clave privada.
Existen dos formas de proporcionar un token de socio:
En la cadena de consulta HTTP: use el parámetro partnertok .
En el encabezado HTTP: use el encabezado X-Partner-Token .
Si se usa el ejemplo de la especificación de token seguro, el parámetro resultante en una cadena de consulta sería:
partnertok=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6ImExYjJjM2Q0ZTUifQ.eyJpc3MiOiJwZHZ5Iiwic3ViIjoiZm9vQGJhci5jb20iLCJpYXQiOjE0Mjk4MDI3MTYsInRkLXJlZyI6dHJ1ZX0.YeNcfr7Rcpv4P8Tu6Y2bRuGqYUGQM0lHjyK_nD8SWKA
Es preferible utilizar un encabezado HTTP/HTTPS para evitar el almacenamiento en caché y posibles problemas de truncamiento si la URL resultante es demasiado larga.
Una vez que se genera un token de socio, es válido durante 24 horas. Este valor se eligió para evitar generar el token con demasiada frecuencia, lo que retrasaría el acceso al contenido, deteriorando así la experiencia del usuario.
Alternativamente, los parámetros se pueden proporcionar en texto limpio directamente en la cadena de consulta HTTP como parámetros independientes.
Identificación del oyente
Tenga en cuenta que se necesita una gestión de ID de oyentes correctamente implementada para dirigir correctamente las impresiones "direccionables" (inteligentes) en Yield-Op.
Consulte también: Administración de ID de oyentes.
Triton Digital es compatible con los siguientes tipos específicos de ID de oyentes:
Parámetro | Descripción | Valor |
|---|---|---|
lsid | Identificador de usuario principal de Triton Digital para usar como base para mediciones y limitación de frecuencia. Se recomienda este parámetro. Consulte Administración de ID de oyentes. para obtener detalles de uso. | Secuencia Caracteres alfanuméricos, incluida la siguiente lista de caracteres especiales:
|
PPID | El publisher proporcionó la ID del oyente. Secuencia codificada mediante URL. | Como arriba. |
idfa | Identificador de Apple para anunciantes. (utilizar solo si el usuario no ha habilitado la función "Limitar seguimiento de anuncios"). | Como arriba. |
gaid | ID de publicidad de Android. (Úselo solo si el usuario no ha habilitado "Excluirse de la publicidad basada en intereses"). | Como arriba. |
Rida | ID de Roku. | Como arriba. |
AIFA | ID de publicidad de Amazon. | Como arriba. |
MSAI | ID de Microsoft. | Como arriba. |
app | ID generada por la aplicación. | Como arriba. |
cookie | ID basada en cookies (generada por el servidor). Esto utiliza una cookie HTTP y no requiere compatibilidad específica del reproductor. | Como arriba. |
<proveedor>-UID | Identificador extendido de la empresa especificado en <proveedor>. | Como arriba. |
Información del oyente
Se puede proporcionar información adicional al oyente a través de los siguientes parámetros:
Parámetro | Descripción | Valor |
|---|---|---|
lat | Latitud de la ubicación actual del oyente. Consulte la Nota 1, a continuación. | Valor de punto flotante: de -90.0 a 90.0 |
long | Longitud de la ubicación actual del oyente. Consulte la Nota 1, a continuación. | Valor de punto flotante: de -180.0 a 180.0 |
edad | Edad del oyente, con base en la información obtenida a través del registro de oyentes. | Valor entero: de 1 a 125 |
género | Género del oyente, con base en la información obtenida a través del registro de oyentes. | “m" o "f" u "o" para masculino, femenino u otro (distingue entre mayúsculas y minúsculas) |
postalcode | Código postal de la ubicación residencial del oyente, con base en la información obtenida a través del registro de oyentes. Consulte la Nota 2, a continuación. | Código postal válido. Por ejemplo, 91403 o H3G 1R8 |
country | Código de país de la ubicación residencial del oyente, con base en la información obtenida a través del registro de oyentes. Consulte la Nota 2, a continuación. | Código de país de dos letras alfa-2 según la norma ISO 3166-1 (p. ej., US) |
Nota 1
Tanto lat como long deben proporcionarse juntos (si especifica uno, debe especificar ambos). Al especificar latitud/longitud, los clientes/reproductores deben usar la mayor precisión que sea razonable, dependiendo del dispositivo, la plataforma y las consideraciones de uso de la batería. (Sugerimos una precisión de 100 metros).
Nota 2
Tanto el código postal como el país deben proporcionarse juntos.
Regulador
Con el fin de que la comunicación y la transparencia estén en línea con las prácticas de la industria con respecto al consentimiento de sus usuarios finales y las bases legales para procesar la información personal, todos los publishers implementarán, en la medida que resulte aplicable en cada jurisdicción pertinente en cuanto a las operaciones, los siguientes parámetros para aprobar instrucciones que codifiquen dicho consentimiento:
Parámetro | Encabezado HTTP | Descripción | Valor |
|---|---|---|---|
Gpp* | X-gpp | Cadena GPP que permite la transmisión de señales de privacidad, consentimiento y elección del consumidor. La cadena debe cumplir con la especificación de la plataforma de privacidad global de IAB Tech Lab. | Cadena GPP codificada en base64 segura para URL. |
gpp_sid * | X-gpp-sid | La sección ID para indica qué legislación (es decir, la sección de la cadena GPP) se considera "en vigor". | Entero |
GDPR * | Aviso que indica si rigen las normas de la Regulación General de Protección de Datos (GDPR). La GDPR fue promulgada por el Parlamento Europeo y el Consejo de la Unión Europea. | 0 = GDPR no se aplica 1 = Se aplica el RGPD | |
gdpr_consent * | X-gdpr-consent | Secuencia de consentimiento y transparencia de conformidad con la GDPR que encapsula los detalles relevantes sobre cómo se establcen la transparencia y el consentimiento. La secuencia debe seguir las especifficaciones del Marco de Transparencia y Consentimiento de IAB. | Secuencia de consentimiento GDPR con codificación base64 y URL seguro. |
us_privacy | Secuencia de Privacidad de los Estados Unidos que indica si las Regulaciones de Privacidad de los EE. UU. son aplicables al consumidor, si aparece un aviso legal con un "aviso explícito" con un consumidore y si el consumidor optó por excluirse de la venta de sus datos personales. La versión 1 solo admite señales relacionadas con la Ley de Privacidad del Consumidor de California (CCPA). La secuencia debe cumplir con el formato de U.S. Privacy String (Secuencia de Privacidad en los EE. UU.) | Secuencia | |
coppa | Aviso que indica si rigen las normas de la Ley de Protección de la Privacidad de los Niños En Línea (COPPA). COPPA fue promulgada por la Comisión Federal de Comercio de los EE. UU. | 0 = No se aplican las restricciones de COPPA 1 = Se aplican restricciones de COPPA |
* En relación con GDPR, Triton Digital es un proveedor registrado y aprobado según la Lista de proveedores globales (GVL) TCF v2.0. que lleva el Interactive Advertising Bureau Europe (IAB Europa). El ID de proveedor de Triton Digital en la GVL es 239.
Información del dispositivo/reproductor
Parámetro | Descripción | Valor |
|---|---|---|
dist | Este parámetro se usa para identificar el canal de distribución. (Es decir, propiedad digital donde el oyente accede al contenido de audio). | Cadena. Es posible ingresar cualquier cadena. El límite de caracteres es 50. |
banners | Marcadores de capacidades de banner. Este artículo actualmente se usa para el análisis estadístico por parte de Triton Digital, pero se espera que asuma un rol más directo en el futuro. | Secuencia: lista separada por comas de tamaños de banner compatibles. Por ejemplo: banners=728x90,300x250 |
omid | Indicador que muestra si el reproductor admite la API de definición de interfaz de medición abierta (generalmente a través de OMSDK) y qué versión. Este parámetro solo se puede proporcionar a través del token de socio. | 0 = No admite OMID 1 = Admite OMID 1.0 |
store-id | Solo para el inventario de aplicaciones móviles. Identificador de la tienda de aplicaciones donde se obtuvo una aplicación instalada. Se usa para ubicar la aplicación dentro de la tienda correspondiente. Ejemplo para iTunes: store-id=726533955 Ejemplo para Google Play: store-id=com.tritondigital.tritonradio Los compradores programáticos requieren este parámetro para verificar que Triton Digital tiene permiso para vender su inventario utilizando el marco de app-ads.txt . | Secuencia |
bundle-id | Solo se usa para el inventario de aplicaciones móviles, donde se requiera. Identificados de la aplicación creado para ser exclusivo de la aplicación e independiente de la tienda de aplicaciones que la distribuye. En Android e iOS, debería ser el nombre de un paquete (por ejemplo, com.tritondigital.tritonradio). | Secuencia |
store-url | Solo para el inventario de aplicaciones móviles. URL de la tienda de aplicaciones donde se obtuvo la aplicación para solicitar el anuncio/conectarse al stream. La cadena debe estar codificada mediante URL. Ejemplo:
Los compradores programáticos requieren este parámetro para verificar que Triton Digital tiene permiso para vender su inventario utilizando el marco de app-ads.txt . | URL encoded string of a URL. |
agent | El agente/reproductor (software) específico que se utiliza para reproducir el archivo/stream de audio. | Secuencia. Si desea obtener los valores válidos para su agente/reproductor, contáctese con el administrador de su cuenta de Triton Digital. |
agent-family | El tipo/familia que mejor describe un agente/reproductor específico. | Secuencia. Los valores válidos son: browser |
agent-device | El dispositivo específico (hardware) que se utiliza para reproducir el archivo/stream de audio. Aunque esto es opcional, Triton Digital recomienda usarlo, ya que el dispositivo no siempre puede derivarse correctamente del encabezado predeterminado del "agente de usuario". | Secuencia.
|
agent-device-family | El tipo/familia que mejor describe un dispositivo específico. | Secuencia.
|
agent-os | El sistema operativo que se utiliza para reproducir el archivo/stream de audio. Aunque esto es opcional, Triton Digital recomienda usarlo, ya que el sistema operativo no siempre puede derivarse correctamente del encabezado predeterminado del "agente de usuario". | Secuencia.
|
Los parámetros del dispositivo/reproductor basados en el agente se pueden verificar mediante los validadores enumerados en las Reglas de direccionamiento de formato en el documento API de reserva y disponibilidad de Triton Digital, en Direccionamiento de oyentes - Reproductor/dispositivo.
Direccionamiento personalizado
Los publishers que deseen diferenciar su inventario en segmentos personalizados pueden usar los siguientes parámetros.
Parámetro | Encabezado HTTP | Descripción | Valor |
|---|---|---|---|
csegid | ID de segmento personalizado Antes de implementar esto, comuníquese con la Asistencia Técnica de Triton Digital para habilitar el direccionamiento de ID de segmento personalizado en su cuenta. En este momento, el direccionamiento de ID de segmento personalizado solo funciona con la publicidad Tap (no es compatible con Yield-Op). | Valor entero: de 1 a 1000000 | |
ttag | X-ttag | Etiquetas de direccionamiento personalizadas que puede hacer coincidir independientemente en TAP o Yield-Op. Una práctica recomendada es enviar una lista de etiquetas separadas por coma, usando un formato como por ejemplo Ejemplo: Tenga en cuenta que el uso de una lista de etiquetas separadas por comas y Consulte Ejemplo de uso de TTags. | Caracteres alfanuméricos más símbolos UTF-8. Tenga en cuenta que "&" y "=" no son caracteres válidos. |
dmp-segments | X-dmp-segments | Identificadores de los segmentos de las DMP externas a los que pertenecen los oyentes. | Lista CSV de las ID de segmento. Por ejemplo: |
N/A. | X-DMP-Segment-IDs | Identificadores de los segmentos de las DMP externas a los que pertenecen los oyentes. Esta versión del parámetro segments solo se usa para integraciones DMP específicas que aprovechan el reproductor y/o SDK. Para saber en detalle cuándo y cómo usar esta función, consulte su administrador de Éxito del Cliente de Triton Digital. Este parámetro no se admite en el token de socio ni en la cadena de consulta HTTP. | Nombre de la DMP (p. ej., "dmp_1_name") e ID de segmento separados por comas (p. ej., 123,234,345). Ejemplo para DMP Blork Audience con ID de segmento 1234 y 5678: y DMP ACME Segmenter con ID de segmento 4321 y 8765: {"blork_audience":[1234,5678], "acme_segmenter":[4321,8765]} |
Ejemplo de uso de TTags
Tiene un reproductor personalizado en el tablero para vehículos motorizados. Usted define el tipo de vehículo en el reproductor con TTags personalizadas de modo que las campañas de anuncios en Tap pueden dirigirse a ese vehículo. Si, por ejemplo, su reproductor se encuentra en un SUV Ford con tracción en las cuatro ruedas, puede crear las siguientes TTags personalizadas:
ttag=vehicle:ford
ttag=vehicle:4wd
ttag=vehicle:SUV
Parámetro para el ejemplo anterior:
ttag=vehicle:ford,vehicle:4wd,vehicle:SUV
Como resultado, el reproductor aceptará los anuncios de las campañas de Tap dirigidas a:
Todos los vehículos Ford.
Todos los vehículos con tracción en las cuatro ruedas.
Todos los SUV.
Específicamente los vehículos Ford con tracción en las cuatro ruedas.
Específicamente los SUV de Ford.
Específicamente los SUV Ford con tracción en las cuatro ruedas.
No aceptará el direccionamiento específico de otras marcas de vehículos, ni el direccionamiento específico de vehículos Ford con tracción en dos ruedas, etc.
Consejo (transmisión de radio)
Si tiene acceso al sistema automatizado de radio de su estación, puede usar activadores/puntos de referencia de los metadatos cart de direccionamiento de contenido para dirigir sus vuelos de Tap a un contenido de streaming en vivo específico. Para obtener más información, consulte el artículo de la base de conocimiento de Triton Digital Using Content Targeting Cue Points to Target a Livestream Show.