> 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 à impact.com informações adicionais sobre os participantes do seu programa de indicação. Essas informações podem ser usadas nas [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) 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ê pode enviar são flexíveis. Por exemplo, talvez você queira incluir informações sobre:

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

Os campos personalizados podem ser enviados à impact.com ao importar um arquivo de usuários ou por UTT, API, SDK ou outro método de integração.

#### Características dos campos

Os campos personalizados enviados precisam atender a alguns requisitos de nomes e valores.

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

* Até 64 caracteres.
* São aceitos apenas caracteres alfanuméricos, hífens e sublinhados (as letras não podem ter acentos).
* Diferenciam maiúsculas de minúsculas. Por exemplo, `customFieldName` é tratado como diferente de `customfieldname`.
  {% endtab %}

{% tab title="Valores" %}

* Aceita `string`, `number`, `Boolean`, e `null types`.
* O valor do tipo string pode ter no máximo 1.024 caracteres.
* As datas devem ser formatadas como timestamp UNIX em milissegundos.
* É possível adicionar ou atualizar no máximo 100 campos por solicitação.
* Definir um campo personalizado de um usuário como `null` removerá esse campo para o usuário.
  {% endtab %}
  {% endtabs %}

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

Você pode incluir campos personalizados sempre que criar, atualizar ou inserir ou atualizar 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](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md) para ver as instruções.

Abaixo estão dois arquivos de exemplo que você pode usar como referência para a 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" %}
Os campos personalizados podem ser incluídos ao usar os recursos da impact.com [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 para dispositivos 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 diretamente no 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.
