API de vídeosGuías
Actualizar píxeles
Agrega píxeles de seguimiento y elige en qué momento de la reproducción se disparan.
Los píxeles disparan eventos de seguimiento mientras el vídeo se reproduce. items
es una colección, así que la combinación funciona por elemento: un elemento con
un id modifica ese píxel, un elemento sin él crea un píxel nuevo, y un
elemento con "_destroy": true lo elimina. Los píxeles que no mencionas se quedan
como están.
Esto es un merge-patch: envía solo las claves que quieres cambiar y todo lo demás conserva su valor guardado.
Dispara un píxel personalizado al 50%
curl -X PATCH https://api.vturb.com/v1/videos/{id} \
-H "Authorization: Bearer vt_..." \
-H "Content-Type: application/json" \
-d '{ "pixels": { "enabled": true, "items": [
{ "base": { "name": "Half-view", "type": "custom" },
"tag": { "html": "<script>track()</script>" },
"dispatch": { "active": true, "mode": "percent", "threshold": 50 } }
] } }'Las claves
| Clave | Tipo | Define |
|---|---|---|
enabled | booleano | Interruptor general de todos los píxeles |
items[].id | string | Apunta a un píxel existente; omítelo para crear uno |
items[]._destroy | booleano | true elimina el píxel al que apunta el id |
items[].base.name | string | Etiqueta interna del píxel |
items[].base.type | string | facebook, google o custom |
items[].tag.html | string | El fragmento HTML/JS que inyecta un píxel custom |
items[].dispatch.active | booleano | Activa o desactiva el disparo de este píxel |
items[].dispatch.mode | string | percent (del vídeo visto) o time (segundos reproducidos) |
items[].dispatch.threshold | entero | El porcentaje o segundo en el que se dispara el píxel |