> 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/advocate-program/advocate-program-settings/test-your-advocate-program.md).

# Teste seu programa Advocate

Você pode testar seu programa Advocate simulando as [regras do programa](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) com dados de exemplo para confirmar se uma regra se comporta como esperado antes de usá-la em produção.

{% hint style="success" %}
**Observação:** Você precisa configurar pelo menos 1 regra do programa para testá-lo.
{% endhint %}

{% stepper %}
{% step %}

## Acesse Testar meu programa

1. No menu de navegação à esquerda, selecione ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** <i class="fa-arrow-right">:arrow-right:</i> **Regras do programa** <i class="fa-arrow-right">:arrow-right:</i> **Testar meu programa**.
   1. Selecione **Próximo** para avançar entre as etapas.
      {% endstep %}

{% step %}

## Confirme o programa e a versão

2. O programa é preenchido previamente com base no contexto atual. Altere-o somente se precisar testar outro programa.
3. No *menu suspenso* ![](https://4048883401-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 se deseja simular a versão **Rascunho** ou **Ativa** .
   1. Saiba mais sobre o que significa ter uma versão de rascunho e uma versão ativa do seu programa Advocate.
      {% endstep %}

{% step %}

## Escolha o evento e preencha os dados de entrada

4. Selecione o evento que deseja simular e insira as informações conforme elas ocorreriam no seu programa:
   * **Início da indicação**
   * **O amigo faz uma compra**
   * **O amigo reembolsa uma compra**
   * **O amigo realiza uma ação**

<details>

<summary>Referência dos campos</summary>

| Campo                                 | O que faz                                              | Disponível para                                                       |
| ------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------- |
| **Evento de compra**                  | O evento de compra rastreado a ser simulado.           | Amigo faz uma compra, Amigo reembolsa uma compra                      |
| **Data da compra**                    | A data da compra simulada.                             | Amigo faz uma compra, Amigo reembolsa uma compra                      |
| **Tipo de evento**                    | O evento rastreado a ser simulado.                     | O amigo realiza uma ação                                              |
| **Data do evento**                    | A data em que o evento ocorreu.                        | O amigo realiza uma ação                                              |
| **Moeda**                             | A moeda do valor da compra simulada.                   | Amigo faz uma compra, Amigo realiza uma ação                          |
| **Valor da compra**                   | O valor da compra simulada.                            | Amigo faz uma compra (obrigatório), Amigo realiza uma ação (opcional) |
| **Indicação iniciada em**             | A data em que a indicação começou.                     | Todos os eventos                                                      |
| **Indicação convertida**              | Especifique se e quando a indicação já foi convertida. | Todos os eventos, exceto Início da indicação                          |
| **Segmentos de advocates** (opcional) | Limite o teste a um segmento específico de Advogados.  | Todos os eventos                                                      |
| **Segmentos de Amigos** (opcional)    | Limite o teste a um segmento específico de Amigos.     | Todos os eventos                                                      |

</details>
{% endstep %}

{% step %}

## Executar o teste

5. Selecionar **Executar teste**. Suas regras são avaliadas com base no programa e na versão selecionados, além das informações fornecidas.
   {% endstep %}

{% step %}

## Leia o resultado da prévia

6. Confira o painel *Prévia* :
   1. Um resumo das regras acionadas, o período se houver ações baseadas em datas e uma linha marcada para cada ação resultante. Confirme se o resultado corresponde ao esperado.
      {% endstep %}
      {% endstepper %}

## Casos de teste

Estes casos de teste usam regras de exemplo que você pode configurar para confirmar se o programa funciona como deseja antes de publicá-lo. Cada cenário abaixo detalha uma situação específica. Adapte os detalhes, como o acionador, os valores e os segmentos, para corresponder à configuração do seu programa.

<details>

<summary>Lógica básica de acionamento</summary>

**Objetivo:**

* Confirmar que uma regra básica acionada por compra corresponde ao evento e retorna o resultado esperado.
* Confirmar que não há um comportamento de fallback incorreto.

**Configuração da regra:**

* Acionador: o Amigo faz uma compra.
* Ação: recompensa e e-mail para o Advogado, com uma recompensa em dinheiro para o Advogado.
* Não é necessária nenhuma ação padrão.

**Dados de entrada do teste:**

* Evento: o Amigo faz uma compra.
* Evento de compra, data da compra, valor da compra e moeda correspondentes à sua regra.
* Indicação iniciada na mesma data.
* Deixe os segmentos em aberto.

**Resultado esperado:**

* A regra corresponde ao evento, e a prévia mostra exatamente qual regra foi correspondida.
* A linha da recompensa do Advogado mostra o valor configurado para a recompensa.
* A linha do e-mail para o Advogado é exibida.
* Nenhuma outra ação de fallback incorreta é exibida.

</details>

<details>

<summary>Correspondência com período vs. fallback</summary>

**Objetivo:**

* Confirmar que uma data dentro de um período baseado em tempo aplica a ação correspondente.
* Confirmar que uma data fora do período usa a ação padrão como fallback.

**Configuração da regra:**

* Acionador: o Amigo faz uma compra.
* Uma ação baseada em tempo, limitada a um período e baseada na data de início da indicação.
* Uma ação padrão para datas fora desse período.

**Execução A (dentro do período):**

* Defina a data de início da indicação dentro do período.

**Resultado esperado A:**

* A prévia mostra exatamente qual regra baseada em tempo foi correspondida.
* A recompensa e o e-mail correspondentes são aplicados.

**Execução B (fora do período):**

* Defina a data de início da indicação fora do período.

**Resultado esperado B:**

* A ação baseada em tempo não corresponde.
* A recompensa e o e-mail padrão são aplicados.

</details>

<details>

<summary>Seleção de recompensa por nível</summary>

**Objetivo:**

* Confirmar que o nível de recompensa correto é selecionado com base no valor da compra.

**Configuração da regra:**

* Acionador: o Amigo faz uma compra.
* Ação: Recompensa escalonada e e-mail para o defensor.
* Pelo menos três faixas de recompensa, definidas por intervalos de valor de compra (por exemplo, uma faixa baixa, uma média e uma alta).

**Dados de entrada do teste:**

* Execute uma vez para cada faixa.
* Insira um valor de compra que esteja dentro do intervalo de cada faixa.
* Mantenha todas as outras entradas iguais em todas as execuções.

**Resultado esperado:**

* Cada execução mostra a recompensa configurada para a faixa em que o valor se enquadra, e não a recompensa de outra faixa.

</details>

<details>

<summary>Elegibilidade condicionada a segmento</summary>

**Objetivo:**

* Confirme que uma condição de segmento controla se a regra se aplica.

**Configuração da regra:**

* Acionador: o Amigo faz uma compra.
* Uma condição que exige que o defensor esteja em um segmento específico.
* De preferência, uma ação padrão para todos os demais.

**Execução A (correspondência):**

* Defina o segmento do defensor como o segmento elegível.

**Resultado esperado A:**

* A ação elegível é aplicada.
* A ação padrão não é executada.

**Execução B (sem correspondência):**

* Defina o segmento do defensor como um segmento não elegível.

**Resultado esperado B:**

* A ação padrão é aplicada, se estiver configurada.
* Caso contrário, nenhuma ação qualificável é executada.

</details>

<details>

<summary>Cálculo de comissão</summary>

**Objetivo:**

* Confirme que uma recompensa de comissão é calculada com base no valor da compra e exibida na moeda correta.

**Configuração da regra:**

* Acionador: o Amigo faz uma compra.
* Ação: Recompensa e e-mail para o defensor.
* Uma recompensa baseada em comissão — uma porcentagem do valor da compra — na moeda da transação.

**Execuções A e B:**

* Dois valores de compra diferentes, na mesma moeda.

**Resultados esperados de A e B:**

* Cada uma mostra a taxa de comissão aplicada corretamente ao respectivo valor.

**Execução C (se o seu programa aceitar várias moedas):**

* O mesmo valor da execução A, mas em outra moeda.

**Resultado esperado de C:**

* A comissão é calculada corretamente e exibida na nova moeda.
* Isso permite avaliar o tratamento de moedas separadamente do cálculo do valor.

</details>

<details>

<summary>Sem correspondência e sem ação padrão configurada</summary>

**Objetivo:**

* Confirme que a prévia indica claramente que nenhuma ação será executada quando nada corresponder e não houver uma alternativa.

**Configuração da regra:**

* Uma ação baseada em horário sem uma ação padrão configurada.

**Dados de entrada do teste:**

* Defina a data de início da indicação fora do período de tempo.

**Resultado esperado:**

* Nenhuma correspondência com o período de tempo.
* Nenhuma ação padrão alternativa disponível.
* A prévia indica claramente que nenhuma ação qualificável será executada.

</details>

<details>

<summary>Sem correspondência porque uma condição da regra não foi atendida</summary>

**Objetivo:**

* Confirme que a prévia indica que nenhuma ação será executada quando as próprias condições da regra não forem atendidas — não apenas quando o período de tempo não corresponder.

**Configuração da regra:**

* Uma regra com duas condições no evento acionador: um evento de compra específico e um valor mínimo de compra.

**Dados de entrada do teste:**

* Insira um evento de compra que não corresponda, um valor abaixo do mínimo ou ambos.

**Resultado esperado:**

* Nenhuma condição da regra é atendida.
* A prévia indica claramente que nada acontecerá.

</details>


---

# 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/advocate-program/advocate-program-settings/test-your-advocate-program.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.
