# Promociones

Las promociones son banners y vídeos colocados en lugares estratégicos para atraer la atención y promocionar un producto, servicio o mensaje.

En Tradly, una promoción puede dirigir a un anuncio, una cuenta, un enlace externo o un mensaje estático.

Para obtener más información, consulta la documentación de [promociones](https://tradly.app/docs/promotion).

**Objeto**

```
{
    "id": 12,
    "reference": "campaign - fresh produce",
    "image_path": "https://storage.googleapis.com/tradlyapp/images/19542/c2d24f03-eef2-436b-a625-c91f734f4bc0.jpg",
    "medium": "app",
    "type": "general",
    "placement": "home_top_banner",
    "value": "listing id 1",
    "active": true,
    "start_at": "2021-01-01",
    "end_at": "2021-02-01"
}
```

| **nombre** | **tipo** | **descripción** |
| --- | --- | --- |
| `id` | `integer` | Identificador único del banner promocional |
| `reference` | `string` | Nombre de referencia |
| `image_path` | `string` | URL de imagen; no debe estar vacía |
| `medium` | `string` | Plataforma o canal de destino; por ejemplo, puedes crear un banner para Android y otro para la aplicación web |
| `type` | `string` | Tipo del objeto que se devuelve |
| `placement` | `string` | Ubicación opcional, como la parte superior o lateral de una página |
| `value` | `string` | Valor opcional, como un ID de anuncio o un enlace profundo para redirigir al usuario |
| `start_at` | `date` | Fecha de inicio del banner en formato `YYYY-MM-DD` |
| `end_at` | `date` | Fecha de finalización en formato `YYYY-MM-DD` |
| `active` | `boolean` | Indica si el banner promocional está activo |