> 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 à impact.com informações 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 seus participantes com base nos valores dos campos personalizados.

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

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

Campos personalizados podem ser enviados à impact.com quando você carrega um arquivo de importação de usuários ou via UTT, API, SDK ou outro método de integração.

#### Características dos campos

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

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

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

{% tab title="Valores" %}

* Aceita `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 `null` removerá o campo desse usuário.
  {% endtab %}
  {% endtabs %}

#### Envie informações de campos personalizados para a impact.com

Você pode incluir campos personalizados sempre que criar, atualizar ou fazer upsert de usuários, independentemente do método usado para enviar 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 instruções.

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

* Importações de dados de usuários: [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 [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) da impact.com 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 do seu aplicativo.
{% 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.