¿Qué es el objeto schain (SupplyChain)?

Es un objeto del IAB Tech Lab que se lleva en OpenRTB en source.ext.schain y que lista, en orden, cada sistema de publicidad que tocó el bid request entre el publisher y el exchange, para que los compradores puedan verificar la ruta de suministro.

¿Qué significan asi, sid y hp en cada nodo?

asi es el dominio canónico del sistema de publicidad, sid es el id de cuenta de vendedor o revendedor dentro de ese sistema (que coincide con su sellers.json), y hp es 1 cuando ese nodo participa en el flujo de pago. Los tres son requeridos por nodo.

¿Cuál es la diferencia entre el objeto JSON y la cadena serializada?

El objeto JSON es la estructura completa source.ext.schain usada en el cuerpo de un bid request. La cadena serializada es una forma compacta codificada en URL —ver,complete!node!node— donde cada nodo es asi,sid,hp,rid,name,domain, usada cuando se necesita una cabecera o un parámetro de consulta.

¿Cuándo debe ser complete 0 frente a 1?

Establece complete=1 solo cuando cada intermediario desde el publisher en adelante esté declarado en el array de nodos. Si algún salto upstream es desconocido u omitido, establece complete=0 para que los bidders sepan que la cadena está incompleta.

¿Esta herramienta descarga mi etiqueta de anuncio o bid request de un servidor?

No. Tú pegas o construyes el schain y todo —serialización, análisis y validación— ocurre localmente en tu navegador. Los ids de vendedor, dominios y datos de nodo que introduces nunca se envían a ArrayKit.

¿Puede validar un schain que copié de un bid request en vivo?

Sí. Pégalo en el modo Validate como el objeto JSON (incluido un envoltorio source.ext.schain) o la cadena serializada, y la herramienta comprueba los campos requeridos de los nodos, el flag complete, el ver, y dibuja la cadena de saltos.

Constructor y validador de schain

Construye y valida el objeto IAB SupplyChain (schain) para OpenRTB, y exporta tanto el JSON source.ext.schain como la cadena serializada, todo en tu navegador.

El Constructor y validador de schain funciona por completo en tu navegador. Los ids de vendedor, los dominios y los nodos de la cadena de suministro que construyes o pegas permanecen en tu dispositivo y nunca se suben a ArrayKit.

Abre la Referencia de enums de OpenRTB

Acerca de Constructor de schain

El Constructor y validador de schain ensambla el objeto SupplyChain del IAB Tech Lab que viaja en los bid requests de OpenRTB en source.ext.schain. Añade cada intermediario como un nodo ordenado con su asi, sid y flag hp (pago), establece los valores complete y ver, y luego copia tanto el objeto JSON como la cadena serializada codificada en URL que esperan los exchanges. Cambia al modo Validate para pegar un schain existente —como JSON o como cadena serializada— y ver al instante los campos requeridos que faltan, un flag complete incorrecto o una versión inesperada, con la cadena de saltos dibujada nodo a nodo. Los ingenieros de ad-ops, SSP y de header bidding pueden auditar y reparar rutas de suministro aquí mismo; los nodos y los ids de vendedor que pegas se analizan en tu dispositivo y nunca se suben.

Características

Añade, reordena y elimina nodos ordenados de la cadena de suministro (asi, sid, hp, rid, name, domain)
Alterna el flag complete y fija ver a la especificación actual 1.0
Exporta el objeto JSON source.ext.schain de OpenRTB listo para soltar en un bid request
Genera la cadena serializada codificada en URL que aceptan los exchanges (ver,complete!node!node)
El modo Validate acepta un schain JSON o una cadena serializada
Señala un asi, sid o hp ausente, un flag complete no válido y un ver inesperado
Visualiza la cadena de saltos para que confirmes el orden de los nodos de un vistazo
Funciona por completo en tu navegador: los ids de vendedor y los dominios permanecen en tu dispositivo

Cómo usar Constructor de schain

Mantén seleccionada la pestaña Build y rellena asi, sid y el flag hp de cada nodo
Añade más nodos y usa las flechas para ponerlos en orden de publisher a exchange
Establece el flag complete (1 cuando toda la ruta está declarada) y copia el JSON o la cadena serializada
Cambia a Validate y pega un schain existente para comprobar los campos requeridos y el orden de los nodos

Ejemplo

Entrada

asi: exchange1.com
sid: 1234
hp: 1
complete: 1

Salida

1.0,1!exchange1.com,1234,1

Un nodo se serializa como ver,complete!asi,sid,hp; el JSON va en source.ext.schain.

Errores comunes y solución de problemas

Validate reporta que a un nodo le falta asi, sid o hp. — Cada nodo necesita los tres campos requeridos: asi es el dominio canónico del sistema de publicidad, sid es el id de vendedor/revendedor de ese sistema, y hp debe ser 0 o 1.
El exchange rechaza la cadena serializada. — Los campos deben ir codificados en URL y ordenados asi,sid,hp,rid,name,domain, con comas entre campos y ! entre nodos; el segmento de cabecera es ver,complete.
complete está en 1 pero dejaste fuera un revendedor upstream. — complete=1 afirma que cada intermediario está declarado. Si algún salto es desconocido, establece complete=0 para que los bidders posteriores sepan que la ruta es parcial.
sid no coincide con el id de vendedor en sellers.json. — El sid de cada nodo debe ser igual al seller_id que el sistema correspondiente publica en su sellers.json, o los compradores tratarán la ruta como no verificada.

Preguntas frecuentes

¿Qué es el objeto schain (SupplyChain)?: Es un objeto del IAB Tech Lab que se lleva en OpenRTB en source.ext.schain y que lista, en orden, cada sistema de publicidad que tocó el bid request entre el publisher y el exchange, para que los compradores puedan verificar la ruta de suministro.
¿Qué significan asi, sid y hp en cada nodo?: asi es el dominio canónico del sistema de publicidad, sid es el id de cuenta de vendedor o revendedor dentro de ese sistema (que coincide con su sellers.json), y hp es 1 cuando ese nodo participa en el flujo de pago. Los tres son requeridos por nodo.
¿Cuál es la diferencia entre el objeto JSON y la cadena serializada?: El objeto JSON es la estructura completa source.ext.schain usada en el cuerpo de un bid request. La cadena serializada es una forma compacta codificada en URL —ver,complete!node!node— donde cada nodo es asi,sid,hp,rid,name,domain, usada cuando se necesita una cabecera o un parámetro de consulta.
¿Cuándo debe ser complete 0 frente a 1?: Establece complete=1 solo cuando cada intermediario desde el publisher en adelante esté declarado en el array de nodos. Si algún salto upstream es desconocido u omitido, establece complete=0 para que los bidders sepan que la cadena está incompleta.
¿Esta herramienta descarga mi etiqueta de anuncio o bid request de un servidor?: No. Tú pegas o construyes el schain y todo —serialización, análisis y validación— ocurre localmente en tu navegador. Los ids de vendedor, dominios y datos de nodo que introduces nunca se envían a ArrayKit.
¿Puede validar un schain que copié de un bid request en vivo?: Sí. Pégalo en el modo Validate como el objeto JSON (incluido un envoltorio source.ext.schain) o la cadena serializada, y la herramienta comprueba los campos requeridos de los nodos, el flag complete, el ver, y dibuja la cadena de saltos.

Herramientas relacionadas

Validador de sellers.json — Valida sellers.json contra la especificación del IAB Tech Lab.
Validador de ads.txt — Valida archivos ads.txt y app-ads.txt línea por línea.
Generador de bid request OpenRTB — Construye bid requests OpenRTB 2.5 y 2.6 desde un formulario.
Referencia de enums OpenRTB — Consulta cada lista enumerada de OpenRTB 2.x con su significado.
Generador de ad units de Prebid — Construye una configuración de ad unit de Prebid.js y su snippet pbjs.
Decodificador de consentimiento TCF — Decodifica cadenas IAB TCF v2.2 y ve los propósitos y vendors.