# Campos Personalizados para 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/sobre-o-que-voce-gostaria-de-aprender/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 em valores de campos personalizados.

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

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

Campos personalizados podem ser enviados ao impact.com quando você faz o 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 campos.

{% 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 de forma distinta de `customfieldname`.
  {% endtab %}

{% tab title="Valores" %}

* Suporta `string`, `quantidade`, `Booleano`, e `tipos null`.
* Valor máximo de string de 1024 caracteres.
* Datas devem ser formatadas como um timestamp UNIX em milissegundos.
* É possível adicionar/atualizar no máximo 100 campos por solicitação.
* Definir um campo personalizado para um usuário como `null` removerá o campo desse usuário.
  {% endtab %}
  {% endtabs %}

#### Enviar 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 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/sobre-o-que-voce-gostaria-de-aprender/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 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/impact-brand/docs/graphql-reference) ou [endpoints da API Rest](https://integrations.impact.com/impact-brand/docs/saasquatch-rest-api-1) do 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/impact-brand/docs/install-the-utt) ou nossas [opções mobile](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) para criar, atualizar ou fazer upsert de usuários dentro do seu aplicativo.
{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.