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

# fact_ad_sessions

> Conversas iniciadas a partir de um anúncio Click-to-WhatsApp, com os detalhes do criativo do anúncio.

# fact\_ad\_sessions

Cada linha é uma conversa iniciada quando um usuário clicou em um anúncio **Click-to-WhatsApp** (Facebook/Instagram), junto com o criativo que o trouxe: título, texto, mídia e o id de origem do anúncio. Faça join com `fact_treble_sessions` através de `session_id` para análise de resultados. Este dataset não estava disponível no warehouse anterior.

## Que perguntas ela responde?

* Quais anúncios geram mais conversas de WhatsApp?
* Quais criativos (título/texto/mídia) convertem melhor depois que a conversa começa?
* Qual é o funil do clique no anúncio até o objetivo (join com `fact_target_events`)?

## Colunas

| Coluna          | Tipo       | Descrição                                                                      |
| --------------- | ---------- | ------------------------------------------------------------------------------ |
| `session_id`    | Int64      | A conversa que o anúncio iniciou (join com `fact_treble_sessions`)             |
| `company_id`    | Int32      | Sua empresa (filtrada automaticamente)                                         |
| `created_at`    | DateTime64 | Quando a conversa começou                                                      |
| `headline`      | String     | Título do anúncio                                                              |
| `body`          | String     | Texto do corpo do anúncio                                                      |
| `source_type`   | String     | `ad` ou `post`; ocasionalmente vazio quando a Meta não envia o campo           |
| `source_id`     | String     | ID do anúncio/post na Meta — chave para o join com seus relatórios do Meta Ads |
| `source_url`    | String     | URL do anúncio/post                                                            |
| `media_type`    | String     | `image` ou `video`; ocasionalmente vazio                                       |
| `image_url`     | String     | URL da imagem do criativo, quando a mídia é uma imagem                         |
| `video_url`     | String     | URL do vídeo do criativo, quando a mídia é um vídeo                            |
| `thumbnail_url` | String     | URL da miniatura do vídeo                                                      |
| `treble_image`  | String     | Cópia do criativo armazenada pela Treble                                       |
| `synced_at`     | DateTime64 | Quando esta linha foi gravada/corrigida pela última vez                        |

## Exemplos de consultas

### Conversas por anúncio, últimos 30 dias

```sql theme={null}
SELECT source_id, any(headline) AS headline, count() AS conversations
FROM fact_ad_sessions
WHERE created_at >= today() - 30
GROUP BY source_id
ORDER BY conversations DESC
```

### Do anúncio à conversão

```sql theme={null}
SELECT
    a.source_id,
    any(a.headline)                 AS headline,
    uniqExact(a.session_id)         AS conversations,
    uniqExact(t.session_id)         AS converted
FROM fact_ad_sessions AS a
LEFT JOIN fact_target_events AS t
    ON t.company_id = a.company_id AND t.session_id = a.session_id
WHERE a.created_at >= today() - 30
GROUP BY a.source_id
ORDER BY conversations DESC
```
