Importar participantes de Advocate en bloque

Advocate acepta importaciones enviadas en .csv o .jsonl formatos de archivo. Consulte nuestro archivo de importación CSV de ejemplo y archivo de importación JSONL de ejemplo para ver la estructura de archivo requerida para su importación.

Nota: Recomendamos que cada importación no supere las 500.000 entradas.

Importar participantes en bloque

1. En el menú de navegación izquierdo, seleccione [Engage] → Participantes.
2. Seleccione Importar usuarios.
3. En Tipo de importación, seleccione Usuarios.
4. Agregue su archivo de importación seleccionando Seleccionar archivo.
5. [Opcional] Para agregar o eliminar los participantes importados de un segmento de usuarios específico, seleccione el segmento de la lista desplegable.

Nota: Esta selección se aplica a todos los participantes incluidos en este archivo de importación.

1. Seleccione Iniciar importación.

Cuando la importación se completa, se envía un correo electrónico de confirmación. Las importaciones pueden tardar hasta 30 minutos, según 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 cargado. Los campos distinguen entre mayúsculas y minúsculas.

Campos estándar

Los campos estándar se analizan con la misma validación que nuestra llamada a la API Upsert de usuario de Open Endpoint:

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.
correo electrónico	cadena	La dirección de correo electrónico del participante.
referable	booleano	Indicador usado por impact.com para determinar si un participante puede ser referido. Nota: El indicador debe escribirse solo con una r para que el estado se modifique correctamente.
locale	cadena	La configuración regional del participante, utilizada para Internacionalización. 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. El código de país del usuario (p. ej., CA).
referredBy.code	cadena	El código de referido del defensor del cliente que refirió a este participante.
referralCodes.{programId}	cadena	El código de referido personalizado que este participante compartirá para el programa especificado (se genera automáticamente si no se incluye).
sharelinks.{programId}	cadena	El enlace de compartición personalizado que este participante compartirá para el programa especificado (se genera automáticamente si no se incluye).
dateCreated	cadena	La fecha en que este participante se creó en su programa Advocate.
imageUrl	cadena	Se usa opcionalmente 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 de 80 px x 80 px.
dateUsTaxFormSubmitted	entero	La fecha en que el formulario fiscal W-9 de un participante se marcó como recogido. Se usa para el cumplimiento W-9 en su cuenta, si está configurado.
customFields.{fieldName}	cadena	Use esta estructura para incluir un campo personalizado de su elección.

Campos personalizados

Los campos personalizados de usuario permiten datos únicos para sus participantes. Puede configurar los objetivos de su programa para que se activen en función de la información de un campo personalizado de usuario.

Ejemplo: Recompense a los participantes cuando renueven su suscripción. Primero, incluya el campo personalizado customFields.subscriptionPaid con el valor de sí. Luego, establezca el objetivo para convertir cuando customFields.subscriptionPaid sea igual a sí.

Añada campos personalizados al encabezado de la columna con este formato: customFields.yourCustomFieldName.

Nota: Los campos personalizados no pueden aceptar valores de array ni de objeto.

Resultados

Le notificamos por correo electrónico cuando su importación esté completa. Puede descargar los resultados de la importación desde la [Engage] → Informes → Importaciones y exportaciones página dentro de su programa Advocate.

Advertencia: Los enlaces de descarga caducarán después de 30 días.

Carga exitosa

Si la importación se completa correctamente, se generará un archivo con la información del participante 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 del usuario.

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.

númeroDeRegistro	mensaje	códigoDeErrorDeApi	códigoDeEstado
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 abortado y no se recuperará. Póngase en contacto con nuestro equipo de soporte si necesita más ayuda.