> 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-rewards/referral-promo-codes-for-participants.md).

# Códigos promocionais de indicação para participantes

{% hint style="danger" %}
**Importante**: Depois que o recurso for ativado para o seu programa, ele não poderá ser desativado.
{% endhint %}

Os códigos promocionais de indicação são uma ótima maneira de condensar a atribuição e a recompensa em 1 etapa no **início** do processo de indicação. Os vouchers são apresentados pelos defensores do cliente aos amigos indicados e oferecem um desconto. Assim que o amigo indicado usa o código promocional no checkout, o código é atribuído ao defensor do cliente, que por sua vez recebe uma recompensa.

Você pode criar códigos promocionais de indicação para seus defensores fazendo upload de códigos promocionais nas regras do seu programa. Depois de ter o seu [regras do programa](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md) configurado, navegue até a *Códigos Promocionais* seção para fazer upload de um lote de códigos promocionais de indicação.

{% hint style="success" %}
**Observação**: Este recurso é separado de [recompensas de combustível](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/fuel-tank-rewards-explained.md). As recompensas de combustível também usam códigos, mas esses códigos são usados apenas para recompensar o participante — não para criar uma atribuição entre o defensor e o amigo indicado.
{% endhint %}

#### Configurar códigos promocionais de indicação

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage] → Regras do Programa**.
2. Role até a *Códigos Promocionais* seção e, em seguida, selecione **Configurar códigos promocionais**. Para códigos promocionais de indicação, isso pode ser definido como **Uso múltiplo** ou **Uso único**.
   * É recomendável usar códigos de uso único em vez de códigos de uso múltiplo, pois isso pode ajudar a minimizar fraudes.

     <div data-with-frame="true"><figure><img src="/files/4dda00f17bb6667e5b990358a97acf3cfb89d5bf" alt="" width="563"><figcaption></figcaption></figure></div>
3. Selecione o número de códigos que você gostaria de disponibilizar por defensor. Esta opção só está disponível se você tiver selecionado criar **Uso único** códigos promocionais.
   * Um defensor pode ter um número de códigos atribuídos a ele. O defensor recebe automaticamente outro código promocional quando um que ele tinha é usado.

     <div data-with-frame="true"><figure><img src="/files/8de628ceeb4a3070489d238d8554d8cd195b22b6" alt="" width="375"><figcaption></figcaption></figure></div>
4. Você pode definir quando gostaria de ser notificado sobre a baixa quantidade de códigos promocionais.
   * Quando o número de códigos atingir a quantidade definida na seção de notificações, um e-mail será enviado para você como lembrete de que seus códigos estão acabando. É muito importante garantir que seu programa não chegue a zero, então certifique-se de criar mais códigos assim que estiver com poucos para manter o programa funcionando sem problemas.
5. Selecione **Fazer upload de códigos** para fazer upload de um lote de códigos promocionais de indicação.
   * Você será redirecionado para uma página onde poderá fazer upload do seu lote de códigos em qualquer um dos formatos de arquivo aceitos.

     <div data-with-frame="true"><figure><img src="/files/81baf4397957bb61f800cedf45984cce9445b6bf" alt="" width="375"><figcaption></figcaption></figure></div>
6. Selecione **Salvar** assim que você tiver configurado seus códigos promocionais. Um pop-up aparecerá perguntando se você tem certeza de que gostaria de salvar. Depois que você ativar os códigos de uso único, a ação não poderá ser desfeita.

   <div data-with-frame="true"><figure><img src="/files/697e2a87ce1db21574de3491afe70f2d071bd3f6" alt="" width="344"><figcaption></figcaption></figure></div>
7. Selecione ![](/files/66c8e080626634530c2872aaf75277e9fd02cc33) **\[caixa de seleção]** para aplicar automaticamente um novo modelo de código promocional ao seu widget.
   * Como alternativa, se você tiver um widget ou microsite existente, pode adicionar manualmente o componente de código promocional de indicação. Você pode fazer isso navegando até **Conteúdo** na barra de navegação à esquerda e, em seguida, escolhendo editar seu widget ou microsite. Selecione **Adicionar** à direita para adicionar um componente ao seu widget ou microsite existente. Saiba mais sobre [componentes de widget e microsite](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-components-explained.md).

Depois de fazer upload dos seus códigos promocionais de indicação, os códigos serão gerados automaticamente e disponibilizados por meio dos [widgets](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/introduction-to-participant-experiences.md#widgets-0-0) ou microsites que você configurou.

Na imagem abaixo, o defensor recebe 5 códigos diferentes entre os quais ele pode alternar e copiar para compartilhar com os indicados. Se um código já tiver sido copiado antes, você será notificado abaixo do campo do código. Isso ajuda a evitar situações em que você possa enviar o mesmo código para várias pessoas.

<div data-with-frame="true"><figure><img src="/files/0cb3e6d37c5a4b43b7ed28b71ab11e3001c8981b" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**Observação**: Caso o seu defensor fique sem códigos e entre em contato com você pedindo mais, você pode criar manualmente um para ele se quiser fornecer códigos em circunstâncias especiais. Para fazer isso, navegue até **Participantes**. Selecione o participante para o qual você gostaria de gerar um novo código e, em seguida, selecione a guia **Códigos e Links** e selecione **Adicionar código de indicação** para gerar um novo código para ele. O código será adicionado ao lote existente dele no widget.
{% endhint %}

#### Atribuição por horário do evento

As indicações são atribuídas por meio de upserts de usuários, e isso acontece por chamadas de API, importações de usuários ou até mesmo carregamentos de widgets. Os códigos promocionais de indicação também podem ser enviados de volta com eventos de compra. Você pode nos passar o evento em `OrderPromoCode` da API de conversões. Saiba mais sobre como criar um [evento de conversão](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions).

#### Veja seus códigos promocionais

Há vários detalhes que você pode ver na *tela Ver códigos* . Você pode diferenciar entre códigos de uso único e de uso múltiplo verificando o tipo de código. Você também poderá ver quais códigos já foram usados e poderá ver quais defensores foram atribuídos a quais indicações.

{% hint style="success" %}
**Observação**: Os códigos de uso único são uma ótima maneira de minimizar as chances de uso fraudulento dos seus códigos promocionais. Enquanto códigos de uso múltiplo costumam ser compartilhados em sites de terceiros, códigos de uso único só podem ser usados uma vez e reduzem a probabilidade de serem espalhados por fontes não confiáveis.
{% endhint %}

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engajar] →** **Recompensas → Gerenciador de Códigos**.
2. Selecione o participante para o qual você gostaria de ver os códigos.
3. No *tela Ver códigos* na tela, você encontrará todas as informações relevantes sobre que tipo de códigos foram emitidos, o que foi usado e muito mais.

   <div data-with-frame="true"><figure><img src="/files/a5810ed2ded2813185e1b44d7bed73ec81adc9c0" alt=""><figcaption></figcaption></figure></div>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/referral-promo-codes-for-participants.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
