# Importar participantes de Advocate en masa

Advocate acepta importaciones enviadas en `.csv` o `.jsonl` formatos de archivo. Consulte nuestro [archivo CSV de importación de muestra](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) y [archivo JSONL de importación de muestra](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) para ver la estructura de archivo requerida para su importación.

{% hint style="info" %}
**Nota:** Recomendamos que cada importación no exceda los 500.000 registros.
{% endhint %}

#### Importar participantes en masa

1. En el menú de navegación izquierdo, seleccione ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Participants**.
2. Seleccione **Importar usuarios**.
3. Bajo *Tipo de importación*, seleccione **Usuarios**.
4. Agregue su archivo de importación seleccionando **Seleccionar archivo**.
5. **\[Opcional]** Para agregar o eliminar a los participantes importados de un segmento de usuario específico, seleccione el segmento en la lista desplegable.

{% hint style="info" %}
**Nota:** Esta selección se aplica a *todos* los participantes incluidos en este archivo de importación.
{% endhint %}

6. Seleccione **Iniciar importación**.

Cuando la importación finalice, se enviará un correo electrónico de confirmación. Las importaciones pueden tardar hasta 30 minutos, dependiendo de la cola y el tamaño del archivo.

#### Campos

Las importaciones masivas de usuarios admiten tanto Campos Estándar como campos personalizados en el archivo de carga. **Los campos distinguen entre mayúsculas y minúsculas.**

{% tabs %}
{% tab title="Campos estándar" %}
Los campos estándar se analizan con la misma validación que nuestra [llamada API Open Endpoint User Upsert](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):

| Campo                     | Tipo     | Descripción                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (Obligatorio)   | cadena   | El identificador único de la cuenta a la que pertenece este participante.                                                                                                                                                                                                                                                                                                                                  |
| id (Obligatorio)          | cadena   | El identificador único proporcionado para este participante.                                                                                                                                                                                                                                                                                                                                               |
| firstName                 | cadena   | El nombre del participante.                                                                                                                                                                                                                                                                                                                                                                                |
| lastName                  | cadena   | El apellido del participante.                                                                                                                                                                                                                                                                                                                                                                              |
| email                     | cadena   | La dirección de correo electrónico del participante.                                                                                                                                                                                                                                                                                                                                                       |
| referable                 | booleano | <p>Indicador usado por impact.com para determinar si un participante puede ser referido.</p><p><strong>Nota:</strong> La bandera debe escribirse con solo <em>una</em> <code>r</code> para que el estado se modifique correctamente.</p>                                                                                                                                                                   |
| locale                    | cadena   | La configuración regional del participante, utilizada para [Internacionalización](https://help.impact.com/brand/es/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). La configuración regional debe tener el formato `language_COUNTRY` donde el código de idioma debe estar en minúsculas y el código de país en mayúsculas. El separador debe ser un guion bajo. |
| countryCode               | cadena   | La configuración regional del participante, utilizada para [Internacionalización](https://help.impact.com/brand/es/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). El código de país del usuario (p. ej., CA).                                                                                                                                                   |
| referredBy.code           | cadena   | El código de referencia del defensor de cliente que refirió a este participante.                                                                                                                                                                                                                                                                                                                           |
| referralCodes.{programId} | cadena   | El código de referencia personalizado para que este participante lo comparta para el programa especificado (generado automáticamente si no se incluye).                                                                                                                                                                                                                                                    |
| sharelinks.{programId}    | cadena   | El enlace para compartir personalizado para que este participante lo comparta para el programa especificado (generado automáticamente si no se incluye).                                                                                                                                                                                                                                                   |
| dateCreated               | cadena   | La fecha en que este participante fue creado en su programa Advocate.                                                                                                                                                                                                                                                                                                                                      |
| imageUrl                  | cadena   | Opcionalmente usado en widgets, correos electrónicos y temas. Si proporciona una URL absoluta de imagen de perfil, el tamaño mínimo de la imagen es 80px x 80px.                                                                                                                                                                                                                                           |
| dateUsTaxFormSubmitted    | entero   | La fecha en que el formulario fiscal W-9 de un participante se marcó como recopilado. Se utiliza para el cumplimiento del W-9 en su inquilino, si está configurado.                                                                                                                                                                                                                                        |
| customFields.{fieldName}  | cadena   | Use esta estructura para incluir un campo personalizado de su elección.                                                                                                                                                                                                                                                                                                                                    |
| {% endtab %}              |          |                                                                                                                                                                                                                                                                                                                                                                                                            |

{% tab title="Campos personalizados" %}
[Los campos de usuario personalizados](https://help.impact.com/brand/es/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained) permiten datos únicos para sus participantes. Puede configurar los objetivos de su programa para activarse en función de la información en un campo de usuario personalizado.

{% hint style="info" %}
**Ejemplo**: Recompense a los participantes cuando renueven su suscripción. Primero, incluya el campo personalizado `customFields.subscriptionPaid` con el valor de **sí**. Luego, configure la meta para convertir cuando `customFields.subscriptionPaid` es igual a **sí**.
{% endhint %}

Agregue campos personalizados al encabezado de la columna en este formato: `customFields.yourCustomFieldName`.

{% hint style="info" %}
**Nota:** Los campos personalizados no pueden aceptar valores de matriz u objeto.
{% endhint %}
{% endtab %}
{% endtabs %}

**Resultados**

Le notificamos por correo electrónico cuando su importación esté completa. Puede descargar los resultados de la importación desde ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2)  **\[Engage] → Reporting → Imports & Exports** la página dentro de su programa Advocate.

{% hint style="warning" %}
**Advertencia:** Los enlaces de descarga expirarán después de 30 días.
{% endhint %}

{% tabs %}
{% tab title="Carga exitosa" %}
Si la importación se completa correctamente, se generará un archivo con la información de los participantes y se le enviará por correo electrónico. La información incluida en estos resultados es la misma que se encuentra en nuestro [informe de detalles de usuario](https://help.impact.com/brand/es/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% endtab %}

{% tab title="Errores" %}
Si se encuentran errores durante la importación, se generará un archivo adicional. Este archivo de errores incluye entradas para cada error que ocurrió, incluido el número de fila del registro (del archivo de importación inicial) que falló y cualquier mensaje de error asociado.

| recordNumber | message                                         | apiErrorCode | statusCode |
| ------------ | ----------------------------------------------- | ------------ | ---------- |
| 2            | Esta solicitud requiere un id válido y no vacío | BAD\_REQUEST | 400        |

En el improbable caso de que ocurra un error del sistema y la importación se interrumpa, la importación aparecerá como **aborted** y no se recuperará. Comuníquese con nuestro equipo de Soporte si necesita más ayuda.
{% endtab %}
{% endtabs %}
