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 y archivo JSONL de importación de muestra para ver la estructura de archivo requerida para su importación.
Nota: Recomendamos que cada importación no exceda los 500.000 registros.
Importar participantes en masa
En el menú de navegación izquierdo, seleccione
[Engage] → Participants.
Seleccione Importar usuarios.
Bajo Tipo de importación, seleccione Usuarios.
Agregue su archivo de importación seleccionando Seleccionar archivo.
[Opcional] Para agregar o eliminar a los participantes importados de un segmento de usuario específico, seleccione el segmento en la lista desplegable.
Nota: Esta selección se aplica a todos los participantes incluidos en este archivo de importación.
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.
Los campos estándar se analizan con la misma validación que nuestra llamada API Open Endpoint User Upsert:
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.
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: La bandera 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 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 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.
Los campos de usuario personalizados 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.
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í.
Agregue campos personalizados al encabezado de la columna en este formato: customFields.yourCustomFieldName.
Nota: Los campos personalizados no pueden aceptar valores de matriz u objeto.
Resultados
Le notificamos por correo electrónico cuando su importación esté completa. Puede descargar los resultados de la importación desde [Engage] → Reporting → Imports & Exports la página dentro de su programa Advocate.
Advertencia: Los enlaces de descarga expirarán después de 30 días.
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.
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.
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.
Última actualización
¿Te fue útil?

