# Explicación de los campos personalizados para Advocate

Puedes usar *campos personalizados* para enviar a impact.com piezas adicionales de datos sobre los participantes en tu programa de referidos. Esta información puede usarse en tus [reglas del programa](https://help.impact.com/brand/es/que-te-gustaria-aprender/advocate-program/getting-started-with-advocate/advocate-program-rules-explained) para determinar cuándo se activan objetivos y acciones. También puedes segmentar a tus participantes según los valores de los campos personalizados.

Los tipos de campos personalizados que envíes son flexibles. Por ejemplo, es posible que quieras incluir información sobre el/la participante:

* Cumpleaños
* Idioma
* Ubicación
* Tipo de suscripción
* Estado de membresía

Los campos personalizados pueden enviarse a impact.com cuando cargas un archivo de importación de usuarios o mediante UTT, API, SDK u otro método de integración.

#### Características del campo

Cualquier campo personalizado que envíes debe cumplir algunos requisitos para los nombres y valores de los campos.

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

* Hasta 64 caracteres.
* Solo se aceptan caracteres alfanuméricos, guiones y guiones bajos (las letras deben estar sin acentos).
* Distingue entre mayúsculas y minúsculas, por ejemplo, `customFieldName` se trata como distinto de `customfieldname`.
  {% endtab %}

{% tab title="Valores" %}

* Admite `cadena`, `número`, `Booleano`, y `valores nulos`.
* Valor máximo de cadena de 1024 caracteres.
* Las fechas deben formatearse como una marca de tiempo UNIX en milisegundos.
* Se pueden agregar/actualizar un máximo de 100 campos por solicitud.
* Establecer un campo personalizado para un usuario en `null` eliminará el campo para ese usuario.
  {% endtab %}
  {% endtabs %}

#### Enviar información de campos personalizados a impact.com

Puedes incluir campos personalizados siempre que crees, actualices o hagas upsert de usuarios, independientemente del método mediante el cual envíes los datos.

{% tabs %}
{% tab title="Importaciones de archivos" %}
Puedes incluir campos personalizados al importar nuevos usuarios o al actualizar usuarios existentes en masa. Consulta [Importar participantes defensores en masa](https://help.impact.com/brand/es/que-te-gustaria-aprender/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk) para obtener instrucciones.

A continuación hay dos archivos de muestra que puedes usar como guía para tu importación.

* Importaciones de datos de usuarios: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) o [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media)
* Importaciones de datos de eventos: [CSV](https://assets.ctfassets.net/s68ib1kj8k5n/20lD8Gua3EtW8qIahBvciz/152fd3cfaa3f0ee4076a6729bc8d4164/userEventSample.csv) ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) o [JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/2IPDDkVhCgDBPyQrRANfb9/d38643fba660ca1412b7d85f1b7c0f41/userEventSample.jsonl) ![](https://3147719151-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 y SDKs" %}
Los campos personalizados pueden incluirse al usar los [métodos GraphQL](https://integrations.impact.com/impact-brand/docs/graphql-reference) o [endpoints de la API Rest](https://integrations.impact.com/impact-brand/docs/saasquatch-rest-api-1) que crean, actualizan o hacen upsert de usuarios. También pueden incluirse al usar [UTT](https://integrations.impact.com/impact-brand/docs/install-the-utt) o nuestras [opciones móviles](https://integrations.impact.com/impact-brand/docs/saasquatch-mobile-overview-1) para crear, actualizar o hacer upsert de usuarios desde dentro de tu aplicación.
{% endtab %}
{% endtabs %}
