> 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).

# Explicação sobre campos personalizados para o Advocate

Você pode usar *campos personalizados* para enviar ao impact.com dados extras sobre os participantes do seu programa de indicação. Essas informações podem ser usadas em 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:

* Aniversário
* Idioma
* Localização
* Tipo de assinatura
* Status de associação

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 ex., `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 para um usuário como `nulo` removerá o campo desse usuário.
  {% endtab %}
  {% endtabs %}

#### Envie informações de campos personalizados para o 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 arquivos" %}
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 para orientar sua importação.

* Importações de dados de usuários: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
* Importações de dados de eventos: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) ou [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
  {% 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 nossos [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 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/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.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.