Guía de integración

Integra tu CMS con Nodo4 Connect.

Para el equipo técnico del CMS de la red. Tu CMS necesita poder configurar una URL por pantalla, reproducir imagen o MP4 y llamar una URL al emitir. Con eso basta.

01Pedir un anuncio

Por cada pantalla y cada espacio del loop que cedas a Connect:

GET https://connect.nodo4.mx/v1/vast/{ID_CONNECT}?key={LLAVE_DE_LA_RED}

• ID Connect: el identificador de la pantalla, por ejemplo N4C-7F3K2. Lo ves en el portal.
• Llave: también se puede mandar en el encabezado Authorization: Bearer.
• Formato: la respuesta es application/xml en VAST 2.0, siempre sobre HTTPS.

02La respuesta

Con anuncio, un InLine con un solo MediaFile, a la resolución exacta de la pantalla y con la duración del spot:

<VAST version="2.0">
  <Ad id="5406b205-…">
    <InLine>
      <AdSystem version="1.0">Nodo4 Connect</AdSystem>
      <AdTitle>Verano 26</AdTitle>
      <Error>https://connect.nodo4.mx/v1/t/err/5406b205-…?code=[ERRORCODE]</Error>
      <Impression>https://connect.nodo4.mx/v1/t/imp/5406b205-…</Impression>
      <Creatives><Creative><Linear>
        <Duration>00:00:15</Duration>
        <MediaFiles>
          <MediaFile delivery="progressive" type="video/mp4" width="1920" height="1080">
            https://connect.nodo4.mx/media/creatives/…/spot.mp4
          </MediaFile>
        </MediaFiles>
      </Linear></Creative></Creatives>
    </InLine>
  </Ad>
</VAST>

Sin anuncio, la respuesta es <VAST version="2.0"/>: tu CMS sigue con su propio contenido.

03Confirmar la reproducción

Cuando reproduce el anuncio, tu CMS llama una vez la URL de Impression. Tiene 5 minutos desde la petición, salvo que tu red tenga otra ventana acordada. Una confirmación tardía se registra pero no cuenta como spot cumplido, y llamar dos veces la misma URL no duplica el conteo.

04Reportar que no se reprodujo

Si el anuncio no se pudo mostrar, tu CMS llama la URL de Error, reemplazando [ERRORCODE] por el código VAST que corresponda, por ejemplo 405 si el archivo no se pudo reproducir.

05Límites de creativo

Connect valida cada archivo al subirlo y sólo sirve el que cabe en la pantalla.

06Buenas prácticas

• Descarga el MediaFile al recibirlo y consérvalo en caché: la URL de un creativo no cambia.
• No reutilices un VAST: cada reproducción debe venir de su propia petición.
• Pide entre 5 y 30 segundos antes del espacio del loop.
• Si recibes un VAST vacío, sigue con tu contenido sin reintentar en ese mismo espacio.