> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myunite.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pré-teste digital

> Crie um pré-teste de anúncio para Meta ou TikTok.

Use `channel: "digital"` para anúncios em Meta e TikTok. Os campos específicos ficam em `digital`.

## Campos

| Campo | Obrigatório | Descrição |
| - | - | - |
| `uploadId` | Sim | Imagem, ou vídeo de até 30 s. |
| `channel` | Sim | `digital`. |
| `digital.platform` | Sim | `meta` ou `tiktok`. |
| `digital.placement` | Sim | Posição do anúncio. Veja a tabela abaixo. |
| `digital.objective` | Não | `awareness`, `traffic`, `sales` ou `leads`. |
| `title`, `brandId`, `locale`, `metadata` | Não | Iguais ao [pré-teste OOH](https://docs.myunite.ai/pretests/ooh.md). |

## Posições por plataforma

| Plataforma | Posições (`placement`) |
| - | - |
| `meta` | `feed`, `stories`, `reels`, `in_stream` |
| `tiktok` | `feed` |

Uma posição que a plataforma não oferece responde [`invalid_placement`](https://docs.myunite.ai/errors#invalid_placement). A lista sempre atual está em `GET /catalog`, em `digital.platforms`.

## Exemplo

```bash curl theme={null}
curl -X POST https://myunite.ai/api/v1/pretests \
  -H "Authorization: Bearer $UNITE_API_KEY" \
  -H "Idempotency-Key: verao-relogio-urbano-meta-001" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadId": "upl_0123456789abcdef0123456789abcdef.mp4",
    "title": "Verão · relógio urbano",
    "channel": "digital",
    "digital": { "platform": "meta", "placement": "reels", "objective": "awareness" }
  }'
```

```javascript JavaScript theme={null}
const res = await fetch("https://myunite.ai/api/v1/pretests", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UNITE_API_KEY}`,
    "Idempotency-Key": "verao-relogio-urbano-meta-001",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    uploadId: "upl_0123456789abcdef0123456789abcdef.mp4",
    title: "Verão · relógio urbano",
    channel: "digital",
    digital: { platform: "meta", placement: "reels", objective: "awareness" },
  }),
});
console.log(res.status, await res.json()); // 202
```

```python Python theme={null}
import os
import requests

res = requests.post(
    "https://myunite.ai/api/v1/pretests",
    headers={
        "Authorization": f"Bearer {os.environ['UNITE_API_KEY']}",
        "Idempotency-Key": "verao-relogio-urbano-meta-001",
    },
    json={
        "uploadId": "upl_0123456789abcdef0123456789abcdef.mp4",
        "title": "Verão · relógio urbano",
        "channel": "digital",
        "digital": {"platform": "meta", "placement": "reels", "objective": "awareness"},
    },
)
print(res.status_code, res.json())  # 202
```

Vídeos acima de 30 segundos respondem [`video_too_long`](https://docs.myunite.ai/errors#video_too_long) e não consomem a cota.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.