> 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/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md).

# Campos personalizados para o Advocate explicados

Você pode usar *campos personalizados* para enviar ao impact.com dados adicionais sobre os participantes do seu programa de indicação. Essas informações podem ser usadas nas suas [regras do programa](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/advocate-program-rules-explained.md) para determinar quando metas e ações são acionadas. Você também pode segmentar os participantes com base nos valores dos campos personalizados.

Os tipos de campos personalizados que você envia são flexíveis. Por exemplo, talvez você queira incluir informações sobre um participante:

* Data de nascimento
* Idioma
* Localização
* Tipo de assinatura
* Status de associação

Os campos personalizados podem ser enviados ao impact.com quando você fizer upload de um arquivo de importação de usuários ou via UTT, API, SDK ou outro método de integração.

#### Características do campo

Quaisquer campos personalizados que você enviar precisam atender a alguns requisitos para nomes e valores de campo.

{% tabs %}
{% tab title="Nomes" %}

* Até 64 caracteres.
* Somente caracteres alfanuméricos, hífens e sublinhados são aceitos (as letras devem ser sem acento).
* Diferencia maiúsculas de minúsculas, por exemplo, `customFieldName` é tratado como diferente de `customfieldname`.
  {% endtab %}

{% tab title="Valores" %}

* Suporta `string`, `número`, `Booleano`, e `tipos nulos`.
* Valor máximo de string de 1024 caracteres.
* As datas devem ser formatadas como um timestamp UNIX em milissegundos.
* No máximo 100 campos podem ser adicionados/atualizados por solicitação.
* Definir um campo personalizado de um usuário como `nulo` removerá o campo desse usuário.
  {% endtab %}
  {% endtabs %}

#### Enviar informações de campos personalizados ao impact.com

Você pode incluir campos personalizados sempre que criar, atualizar ou fazer upsert de usuários, independentemente do método pelo qual você envia os dados.

{% tabs %}
{% tab title="Importações de arquivo" %}
Você pode incluir campos personalizados ao importar novos usuários ou atualizar usuários existentes em massa. Consulte [Importar participantes do Advocate em massa](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md) para obter instruções.

Abaixo estão dois arquivos de exemplo que você pode usar como guia para a sua importação.

* Importações de dados de usuário: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d)
* Importações de dados de eventos: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](/files/3f7a9cf38d390db6b46efbce3f9155a3a45a815d)
  {% endtab %}

{% tab title="APIs e SDKs" %}
Campos personalizados podem ser incluídos ao usar os [métodos GraphQL](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/graphql-api) ou [endpoints da API REST](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/advocate-rest-api) que criam, atualizam ou fazem upsert de usuários. Eles também podem ser incluídos ao usar [UTT](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/advocate-installation-scripts) ou nossas [opções móveis](https://integrations.impact.com/integration-guides/for-brands/advocate/mobile-options-for-advocate/mobile-options-for-advocate-programs) para criar, atualizar ou fazer upsert de usuários dentro da sua aplicação.
{% endtab %}
{% endtabs %}


---

# 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/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.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.