> 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 cobrem a maioria das necessidades de relatórios, mas às vezes você precisa de um cálculo específico do seu programa, como uma taxa de conversão personalizada, um total ponderado ou uma razão entre duas métricas existentes. As métricas personalizadas permitem definir sua própria fórmula usando métricas e dimensões existentes, de modo que o resultado apareça na sua visualização como qualquer métrica padrão.

{% hint style="warning" %}
**Importante:** Nós *altamente* recomendamos que consulte [Introdução ao Data Lab](/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] → Reports** → [**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* 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]**.

   <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 você precisar do resultado apenas para um único valor de dimensão (por exemplo, um Event Type), você pode usar `Filtro` na sua fórmula.&#x20;

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

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Exemplo:</strong> A <em>Taxa de conversão</em> métrica usa <code>Ações / Cliques</code>. A impact.com indicará se a fórmula é válida ou não exibindo uma mensagem de validação abaixo da <em>campo Fórmula</em> caixa.</p></div>
5. Dê um nome à sua métrica personalizada (por exemplo, *Taxa de conversão)*.
6. Na ![](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 seu **Formato**. Você pode escolher entre *Número*, *Texto*, *Porcentagem*, ou *Moeda*.
7. Selecione **Salvar** para salvar sua 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 para um valor específico

As métricas personalizadas normalmente calculam em todos os valores de uma dimensão. Às vezes, você quer apenas o resultado para um valor, como a taxa de conversão de um único Event Type, sem criar uma visualização separada ou depender de uma tabela dinâmica. A `Filtro` função permite restringir uma métrica a exatamente um valor de dimensão diretamente na fórmula.

1. Na seção Dimensões e Métricas 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. Insira `Filtro` no *campo Fórmula* campo. À medida que você digita, o Data Lab sugere métricas, dimensões e valores. Um *Válido* ou *Inválido* aparecerá para indicar se a fórmula é válida ou não.
3. Insira um **Nome** para a métrica (por exemplo, *Taxa de conversão de vendas*).
4. &#x20;Na ![](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 seu **Formato**.&#x20;
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(Métrica, Dimensão=Valor).*&#x20;

<table><thead><tr><th width="167.26953125">Elemento</th><th>O que inserir</th></tr></thead><tbody><tr><td>Métrica</td><td>Uma métrica existente, como <em>Ações.</em></td></tr><tr><td>Dimensão</td><td>A dimensão pela qual limitar, como <em>Tipo de evento</em>.</td></tr><tr><td>=</td><td>A única comparação <code>Filtro</code> suportada. Você não pode usar <code>!=</code>, <code>></code>, <code>&#x3C;</code>, <code>IN</code>, <code>AND</code>, ou <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>

### Combinando filtros

* **Combine filtros com outras métricas:** Use `+`, `-`, `*`, `/` e parênteses. Você não pode colocar um filtro dentro de outro, como `Filter(Filter(...))`.
* **Conte mais de um valor:** Adicione uma fórmula Filter separada para cada valor.\
  Por exemplo: `Filter(Ações, Tipo de evento=Venda) + Filter(Ações, Tipo de evento=Lead)`
* **Nenhuma linha correspondente:** A métrica mostra **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.