> For the complete documentation index, see [llms.txt](https://ereemby.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ereemby.gitbook.io/docs/sistema-de-temas/funcoes/events.md).

# Events

Use a função `erbyEvent` para enviar eventos de comportamento do comprador (carrinho, lista de desejos etc.). Cada evento recebe um `event_type` e a lista de `products` envolvidos.

### addToCart

Dispare quando o cliente adiciona um produto ao carrinho.

```js
erbyEvent({
    event_type: 'addToCart',
    products: [{
        id: string,
        name: string,
        price: number,
        quantity: number
    }]
})
```

#### Exemplo pré-preenchido

```js
erbyEvent({
    event_type: 'addToCart',
    products: [{
        id: '17811305744281024988111941416',
        name: 'Mockup Premium',
        price: 49.90,
        quantity: 1
    }]
})
```

### addToWishlist

Dispare quando o cliente adiciona um item à lista de desejos.

```js
erbyEvent({
    event_type: 'addToWishlist',
    products: [{
        id: string,
        name: string,
        price: number,
        quantity: number
    }]
})
```

#### Exemplo pré-preenchido

```js
erbyEvent({
    event_type: 'addToWishlist',
    products: [{
        id: '17811305744281024988111941416',
        name: 'Mockup Premium',
        price: 129.90,
        quantity: 1
    }]
})
```

### Campos

| Campo                 | Tipo                 | Descrição                                                                                                          |
| --------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `event_type`          | `string`             | O tipo do evento. Ex.: `addToCart`, `addToWishlist`.                                                               |
| `products`            | `array`              | Lista de produtos do evento. Normalmente um item, mas aceita vários.                                               |
| `products[].id`       | `string` ou `number` | ID do produto, ou da variante quando houver. É o valor usado para casar com o catálogo nas plataformas de anúncio. |
| `products[].name`     | `string`             | Nome do produto.                                                                                                   |
| `products[].price`    | `number`             | Preço unitário como número cru. Ex.: `29.9`. Nunca use `"R$ 29,90"`.                                               |
| `products[].quantity` | `number`             | Quantidade. Use valor inteiro.                                                                                     |