Importar participantes de Advocate en masa

Advocate acepta importaciones enviadas en .csv o .jsonl formatos de archivo. Consulte nuestro archivo de importación CSV de muestra y archivo de importación JSONL de muestra 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] → Participants.

2. Selecciona Importar usuarios.

3. En Tipo de importación, selecciona 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. Selecciona Iniciar importación.

Cuando se complete la importación, se enviará 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 Standard Fields como campos personalizados en el archivo cargado. Los campos distinguen entre mayúsculas y minúsculas.

Standard Fields

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

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	Marca utilizada por impact.com para determinar si un participante puede ser referido. Nota: La marca debe escribirse con solo 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 debe estar 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 (por ejemplo, CA).
referredBy.code	cadena	El código de referencia del customer advocate que refirió a este participante.
referralCodes.{programId}	cadena	El código de referencia personalizado para que este participante comparta para el programa especificado (se genera automáticamente si no se incluye).
sharelinks.{programId}	cadena	El enlace de compartición personalizado para que este participante comparta para el programa especificado (se genera automáticamente si no se incluye).
dateCreated	cadena	La fecha en que este participante fue creado 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 80 px x 80 px.
dateUsTaxFormSubmitted	entero	La fecha en que el Formulario de impuestos W-9 de un participante se marcó como recopilado. Se usa para el cumplimiento W-9 en su tenant, si está configurado.
customFields.{fieldName}	cadena	Use esta estructura para incluir el campo personalizado que elija.

Campos personalizados

Resultados

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

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

Carga exitosa

Si la importación se completa correctamente, se generará y le enviará por correo electrónico un archivo con la información de los participantes. La información incluida en estos resultados es la misma que se encuentra en nuestro informe de detalles de usuario.

Errores