Importar y exportar

Trae miembros desde otra app de fidelidad con un CSV o exporta tus miembros actuales como copia de seguridad. Ambas opciones están en Ajustes, dentro de Importación y exportación de miembros.

GB GibbondDev

Importación y exportación de miembros

Exportar miembros
Exportar miembros a CSV
Importar miembros
⚠️ Reemplazo total — sobrescribe los miembros coincidentes
Añadir archivo CSV o suelta un .csv aquí
Entiendo que esto sobrescribe los saldos existentes
Iniciar importación
La exportación y la importación conviven en Ajustes. Las importaciones se ejecutan en segundo plano con progreso en directo.

Exportar miembros

Haz clic en Exportar miembros a CSV para descargar cada miembro inscrito como un archivo CSV. Úsalo como copia de seguridad, para revisar los saldos en una hoja de cálculo o como plantilla de partida para una importación: las columnas de la exportación son un superconjunto de lo que lee el importador, así que un archivo exportado puede editarse y volver a importarse tal cual.

Formato del CSV

El importador solo necesita tres columnas. Cualquier columna extra de una exportación se ignora. La fila de cabecera es obligatoria y los nombres de columna no distinguen mayúsculas de minúsculas.

ColumnaObligatoriaQué es
emailEl correo del miembro. Se usa para encontrar el cliente de Shopify coincidente.
pointsUn número entero ≥ 0. Se convierte en el saldo de puntos del miembro (y en la base de puntos históricos).
tierNoUn slug de nivel (p. ej. gold). Déjalo en blanco para que los puntos decidan el nivel.
💡

El valor de tier debe ser el slug del nivel, no su nombre visible: por ejemplo vip-member, no "VIP Member". Una exportación ya usa slugs, así que los viajes de ida y vuelta son seguros.

Un archivo de importación mínimo tiene este aspecto:

email,points,tier
alice@example.com,1200,gold
bob@example.com,350,silver
carol@example.com,0,

Qué hace una importación

Por cada fila cuyo correo coincide con un cliente de Shopify existente, la importación:

  • Inscribe al miembrosin bonificación de registro, independientemente de tu ajuste de bonificación por inscripción.
  • Fija sus puntos al valor del CSV (es una asignación, no una suma).
  • Asigna el nivel a partir de la columna tier, o lo calcula a partir de los puntos si la columna está en blanco.
  • Fecha los puntos en el día de la importación — así, si usas caducidad progresiva (FIFO), el reloj empieza de cero desde el día que importas.
⚠️

La importación es un reemplazo total. Para cualquier correo que coincida con un miembro existente, la importación sobrescribe su saldo actual y borra su historial de puntos anterior (conservado solo como filas canceladas para auditoría). Los códigos de descuento ya emitidos no se ven afectados. Esto no se puede deshacer, así que para una migración puntual, importa antes de que los miembros empiecen a ganar puntos.

Cómo funciona la coincidencia

Los miembros se emparejan con los clientes de Shopify por correo. Si un correo no tiene cliente de Shopify coincidente, esa fila se omite y aparece en el resultado: la importación nunca crea clientes de Shopify nuevos. Los correos omitidos se muestran al terminar la importación, para que puedas crear esos clientes en Shopify y volver a ejecutarla si lo necesitas.

Niveles tras la importación

Un nivel del CSV se aplica de inmediato. Gibbond también revisa el nivel de cada miembro una vez al día comparándolo con tus umbrales de nivel, de modo que el nivel lo determinan en última instancia los puntos del miembro. Si importas un nivel para el que los puntos no cualifican, se conciliará al nivel basado en puntos en la siguiente ejecución diaria. Para mantener estables los niveles importados, asegúrate de que tus umbrales de nivel encajen con los puntos que importas.

Ejecutar una importación

Las importaciones se ejecutan en segundo plano, así que puedes salir de la página mientras una está en curso. Una franja de estado muestra el progreso en directo y un resumen al terminar (importados, omitidos y los errores que haya). Una vez escritos los datos, Gibbond actualiza automáticamente el saldo de puntos del escaparate y el nivel de cada miembro.

LímiteValor
Tamaño máximo del archivo5 MB
Filas máximas por importación10.000
Correos duplicados en un archivoGana la última fila de un correo
💡

Volver a ejecutar el mismo archivo es seguro: como cada importación es un reemplazo total, reimportar simplemente reajusta los miembros a los valores del archivo en lugar de acumular puntos.