> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/data-lab-custom-reports/create-custom-measures-in-data-lab.md).

# Criar métricas personalizadas no Data Lab

As métricas integradas do Data Lab atendem à maioria das necessidades de relatórios, mas às vezes você precisa de um cálculo específico para o seu programa, como uma taxa de conversão personalizada, um total ponderado ou uma proporção entre duas métricas existentes. As métricas personalizadas permitem definir sua própria fórmula usando métricas e dimensões existentes, para que o resultado apareça na visualização como qualquer métrica padrão.

{% hint style="warning" %}
**Importante:** Recomendamos *muito* que você consulte [Introdução ao Data Lab](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/data-lab-custom-reports/data-lab-introduction.md) antes de começar este artigo.
{% endhint %}

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Relatórios** → [**Data Lab**](https://app.impact.com/secure/advertiser/engage/reportBuilder.ihtml).
2. Selecione uma **visualização** para começar.
3. Na seção *Dimensões e métricas* da barra de ferramentas à direita, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Criar métrica personalizada]**.

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaJ9k8ckxQGr9Bokgj8Mb%2FUntitled%20design%20(12).png?alt=media&amp;token=68dfc0f3-adb5-4c88-8447-6ceafc61b73d" alt="" width="355"><figcaption></figcaption></figure></div>
4. No campo *Fórmula* insira o cálculo da métrica personalizada. Se precisar do resultado para um único valor de dimensão (por exemplo, um tipo de evento), você pode usar `Filter` na fórmula.

   * Consulte [Filtrar uma métrica por um valor específico](#filter-a-measure-to-a-specific-value) abaixo para obter mais informações.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Exemplo:</strong> A métrica <em>Taxa de conversão</em> usa <code>Actions / Clicks</code>. A impact.com indicará se a fórmula é válida exibindo uma mensagem de validação abaixo da caixa <em>Fórmula</em> .</p></div>
5. Dê um nome à métrica personalizada (por exemplo, *Taxa de conversão)*.
6. No ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[menu suspenso]**, selecione o **Formato**da métrica. Você pode escolher entre *Número*, *Texto*, *Porcentagem*, ou *Moeda*.
7. Selecione **Salvar** para salvar a métrica personalizada.

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FeRSxwBeihOE4jt2Um20f%2FScreenshot%202026-04-27%20at%2017.31.58.png?alt=media&amp;token=805ccf5a-b8b8-499d-86e7-efc04994dc80" alt="" width="563"><figcaption></figcaption></figure></div>

## Filtrar uma métrica por um valor específico

As medidas personalizadas normalmente calculam os resultados considerando todos os valores de uma dimensão. Às vezes, você quer o resultado de apenas um valor, como a taxa de conversão de um único tipo de evento, sem criar uma visualização separada nem depender de uma tabela dinâmica. A `Filter` função permite restringir uma medida a exatamente um valor de dimensão diretamente na fórmula.

1. Na seção Dimensões e medidas, na barra de ferramentas à direita, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Criar métrica personalizada]**.
2. Digite `Filter` no campo *Fórmula* . Enquanto você digita, o Data Lab sugere medidas, dimensões e valores. Um rótulo *Válido* ou *Inválido* aparecerá para indicar se a fórmula é válida ou não.
3. Digite um **Nome** para a medida (por exemplo, *Taxa de conversão de vendas*).
4. No ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu suspenso]**, selecione o **Formato**.
5. Selecione **Salvar**.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FAPIC59sIvphC3MM0Mmdz%2FScreenshot%202026-08-26%20at%2014.56.52.png?alt=media&amp;token=573db799-5c8e-4641-abe9-eef93c3bb01a" alt="" width="485"><figcaption></figcaption></figure></div>

### Formato da função Filter

Use a função Filter no formato *Filter(Measure, Dimension=Value).*

<table><thead><tr><th width="167.26953125">Elemento</th><th>O que inserir</th></tr></thead><tbody><tr><td>Medida</td><td>Uma medida existente, como <em>Ações.</em></td></tr><tr><td>Dimensão</td><td>A dimensão pela qual restringir, como <em>Tipo de evento</em>.</td></tr><tr><td>=</td><td>A única comparação <code>Filter</code> compatível. Não é possível usar <code>!=</code>, <code>></code>, <code>&#x3C;</code>, <code>IN</code>, <code>AND</code>, nem <code>OR</code>.</td></tr><tr><td>Valor</td><td>Um valor dessa dimensão, como o nome de um tipo de evento.</td></tr></tbody></table>

### Combinar filtros

* **Combine filtros com outras medidas:** Use `+`, `-`, `*`, `/` e parênteses. Não é possível colocar um filtro dentro de outro, como em `Filter(Filter(...))`.
* **Contar mais de um valor:** Adicione uma fórmula Filter separada para cada valor.\
  Por exemplo: `Filter(Actions, Event Type=Sale) + Filter(Actions, Event Type=Lead)`
* **Nenhuma linha correspondente:** A medida exibe **0**, ou **0%** se o formato estiver definido como *Porcentagem*.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/multi-program-reports/data-lab-custom-reports/create-custom-measures-in-data-lab.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
