API de vídeosGuias
Atualizar pixels
Anexe pixels de rastreamento e escolha em que momento da reprodução eles disparam.
Os pixels disparam eventos de rastreamento enquanto o vídeo é reproduzido. items é
uma coleção, então o merge funciona por item: um item com um id altera esse
pixel, um item sem ele cria um pixel novo, e um item com "_destroy": true o
exclui. Os pixels que você não mencionar ficam como estão.
Isto é um merge-patch: envie só as chaves que você quer alterar, e todo o resto mantém o valor salvo.
Dispare um pixel personalizado em 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 } }
] } }'As chaves
| Chave | Tipo | Define |
|---|---|---|
enabled | booleano | Interruptor geral de todos os pixels |
items[].id | string | Aponta para um pixel existente; omita para criar um |
items[]._destroy | booleano | true exclui o pixel para o qual o id aponta |
items[].base.name | string | Rótulo interno do pixel |
items[].base.type | string | facebook, google ou custom |
items[].tag.html | string | O trecho HTML/JS que um pixel custom injeta |
items[].dispatch.active | booleano | Liga ou desliga o disparo deste pixel |
items[].dispatch.mode | string | percent (do vídeo assistido) ou time (segundos reproduzidos) |
items[].dispatch.threshold | inteiro | A porcentagem ou o segundo em que o pixel dispara |