For the complete documentation index, see llms.txt. This page is also available as Markdown.

Importar datos del programa de referidos desde SaaSquatch

Este artículo contiene referencias útiles para ayudarte a importar los datos de tu plataforma de referidos de SaaSquatch a impact.com.

Referencia de columnas del archivo CSV

Archivo de datos de usuarios
Columna
Obligatorio
Descripción

ID de usuario

El identificador del participante.

ID de cuenta

El identificador de cuenta del participante.

Correo electrónico

La dirección de correo electrónico del participante.

Nombre

El nombre del participante.

Apellido

El apellido del participante.

Código de referido

El código de referido principal del programa del participante (si se especifica).

URL de la imagen

La URL de la imagen del participante.

IP vista por primera vez

La dirección IP del participante la primera vez que realizó un upsert fuera de la API.

Última IP vista

La dirección IP del participante la última vez que realizó un upsert fuera de la API.

Fecha de creación

La fecha en que se creó este usuario participante, formateada en milisegundos desde la época Unix .

Hash del correo electrónico

El valor hash MD5 de la dirección de correo electrónico de un participante.

Configuración regional

La ubicación geográfica del participante.

Código de país

El código de país del participante.

Segmentos

Los segmentos de usuario del participante.

Enlace para compartir

Enlace para compartir del programa principal del participante (si se especifica).

Enlace para compartir en Facebook

Enlace para compartir en Facebook del programa principal del participante (si se especifica).

Enlace para compartir en Twitter

Enlace para compartir en Twitter/X del programa principal del participante (si se especifica).

Enlace para compartir por correo electrónico

Enlace para compartir por correo electrónico del programa principal del participante (si se especifica).

Enlace para compartir en LinkedIn

Enlace para compartir en LinkedIn del programa principal del participante (si se especifica).

Enlace limpio para compartir

El enlace vanity principal del participante sin codificación.

Campo personalizado

Si un participante tiene un campo personalizado, {ExampleName} será el nombre del campo.

Archivo de datos de referencias
Columna
Obligatorio
Descripción

Usuario referido - ID de usuario

El ID de usuario externo del amigo referido.

Usuario referido - ID de cuenta

El ID de cuenta externo del amigo referido.

Usuario referente - ID de usuario

El ID de usuario externo del defensor del cliente.

Usuario referente - ID de cuenta

El ID de cuenta externo del defensor del cliente.

ID de referencia

El identificador único de la referencia.

Fecha de modificación

La fecha en que la referencia se modificó por última vez (es decir, se inició, se convirtió, se moderó, etc.), formateada en milisegundos desde la época Unix .

Fecha de inicio del referido

La fecha en que se creó la referencia, formateada en milisegundos desde la época Unix .

Fecha de conversión

La fecha en que se logró el primer objetivo, formateada en milisegundos desde la época Unix .

Fecha de modificación del usuario

La fecha en que se eliminó un usuario de una referencia (eliminación de usuario) o se añadió a una referencia, formateada en milisegundos desde la época Unix .

ID del programa

El identificador del programa para el que se creó la referencia.

Nombre del programa

El nombre del programa para el que se creó la referencia.

Usuario referido - Correo electrónico

La dirección de correo electrónico del amigo referido.

Usuario referido - Nombre

El nombre del amigo referido.

Usuario referido - Apellido

El apellido del amigo referido.

Usuario referido - Código de referido

El código de referido principal del amigo referido (depende del programa en el que se creó esta referencia.

Usuario referido - IP vista por primera vez

La primera dirección IP que usó el amigo referido al cargar un widget.

Usuario referido - IP vista más recientemente

La dirección IP más reciente que usó el amigo referido al cargar un widget.

Usuario referido - URL de la imagen

La imagen del usuario referido.

Usuario referido - Configuración regional

La configuración regional del amigo referido.

Usuario referido - Fecha de creación

La fecha en que SaaSquatch vio por primera vez al amigo referido (creado en SaaSquatch), formateada en milisegundos desde la época Unix .

Usuario referido - Segmentos

Los segmentos de usuario del amigo referido.

referredUserCustomFields.<fieldName>

Los campos personalizados del amigo referido.

Usuario referente - Correo electrónico

La dirección de correo electrónico del defensor del cliente.

Usuario referente - Nombre

El nombre del defensor del cliente.

Usuario referente - Apellido

El apellido del defensor del cliente.

Usuario referente - Código de referido

El código de referido principal del defensor del cliente (p. ej., el código de referido usado para crear esta referencia).

Usuario referente - IP vista por primera vez

La primera dirección IP que usó el defensor del cliente al cargar un widget.

Usuario referente - IP vista más recientemente

La dirección IP más reciente que usó el defensor del cliente al cargar un widget.

Usuario referente - URL de la imagen

La imagen del defensor del cliente.

Usuario referente - Configuración regional

La configuración regional del defensor del cliente.

Usuario referente - Fecha de creación

La fecha en que SaaSquatch vio por primera vez al defensor del cliente (creado en SaaSquatch), formateada en milisegundos desde la época Unix .

Estado de moderación

El estado de moderación del fraude de la referencia (p. ej., PENDING, ACTIONED).

Fecha de moderación

La fecha en que se inició la referencia, formateada en milisegundos desde la época Unix .

Usuario referido - ID de recompensa

El identificador de recompensa del amigo referido.

Usuario referente - ID de recompensa

El identificador de recompensa del defensor del cliente.

Usuario referente - Segmentos

Los segmentos de usuario del defensor del cliente.

referrerUserCustomFields.<fieldName>

Los campos personalizados del defensor del cliente.

Código de referido utilizado

El código de referido del defensor del cliente que se usó para la referencia.

Enlace para compartir utilizado

El enlace para compartir del defensor del cliente que se usó para la referencia.

Archivo de datos de recompensas
Columna
Obligatorio
Descripción

ID de usuario

El identificador del usuario.

ID de cuenta

El identificador de cuenta del usuario.

Tipo

El tipo de recompensa, p. ej., crédito, descuento, tarjeta de regalo, etc.

Unidad de recompensa

La unidad en la que se ganan las recompensas, p. ej., efectivo, puntos, meses, etc.

Valor de la recompensa

El valor numérico de la recompensa en su unidad de medida más pequeña; por ejemplo, para una recompensa en efectivo de $1.00, el valor sería 100 (centavos).

Nombre de la recompensa

El nombre que asignaste a la recompensa al crearla en tu programa.

Valor en USD

El valor de la recompensa en USD.

ID del programa

El identificador del programa para el que se creó la recompensa.

Clave global de recompensa

Clave de la configuración global de la recompensa en el catálogo de recompensas. Esto se encuentra en Recompensas → Catálogo → Crear recompensas → Nombre de la recompensa.

Fuente de la recompensa

Cómo se creó la recompensa, p. ej., Manual, Usuario referido, Registro de un amigo.

Fecha de creación

La fecha en que se ganó la recompensa, formateada en milisegundos desde la época Unix .

Fecha otorgada

La fecha en que se otorgó la recompensa, formateada en milisegundos desde la época Unix . (Este valor puede diferir de Fecha de creación si la recompensa estaba pendiente).

Fecha programada para

La fecha en que se programó la entrega de la recompensa al usuario, formateada en milisegundos desde la época Unix .

Fecha de caducidad

La fecha después de la cual la recompensa ya no se puede canjear, formateada en milisegundos desde la época Unix .

Fecha de cancelación

La fecha en que cancelaste la recompensa, formateada en milisegundos desde la época Unix .

Fecha de modificación

La fecha en que realizaste modificaciones en la recompensa, formateada en milisegundos desde la época Unix .

Fecha canjeada

La fecha en que el usuario canjeó la recompensa completa, formateada en milisegundos desde la época Unix .

Crédito asignado

La cantidad en la unidad base para las recompensas de crédito. Es el equivalente a Valor de la recompensa, pero para las recompensas de crédito.

Importe canjeado

El Valor de la parte de la recompensa que se canjeó.

Tipo de Fuel Tank

Puede ser cualquiera de los siguientes Crédito o % de descuento.

Código de Fuel Tank

Esto es como un código de cupón, p. ej., SummerSave20, 20%OFF, etc.

ID de usuario referido

El identificador de usuario del amigo referido.

ID de cuenta referida

El identificador de la cuenta del amigo referido.

referral.referredUser.id

Se usa junto con ID del programa para vincular una referencia a un ID de programa, si queremos asociar una referencia a una recompensa. Esto no siempre coincidirá con el ID de usuario.

referral.referredUser.accountId

Se usa junto con ID del programa para vincular una referencia a un ID de programa, si queremos asociar una referencia a una recompensa. Esto no siempre coincidirá con el ID de cuenta.

Referencia de errores de validación

Puedes obtener 3 tipos de errores de validación:

  1. Mensaje de error en línea: aparecen en la tabla de validación previa y hacen que las filas con errores se resalten en rojo:

    • INVALID_FIELD — p. ej., el Fecha de creación campo no se formateó en milisegundos desde la época Unix .

    • MISSING_FIELD — p. ej., un campo obligatorio como ID de usuario o ID de cuenta falta.

  2. Aviso de error: aparecen en lugar de la tabla de validación previa como mensajes de advertencia rojos:

    • MISSING_HEADER — p. ej., un encabezado de columna obligatorio como ID de cuenta o Valor de la recompensa falta.

    • CSV_PARSING — p. ej., el archivo CSV contiene caracteres especiales que están formateados incorrectamente.

    • FILE_REF_IO — p. ej., el archivo está dañado y no se puede leer.

  3. Errores listados: aparecen como una lista de recuentos de errores en la Importaciones y exportaciones pantalla cuando el tipo de importación no tiene una tabla de validación previa. Los errores de fila y los errores de archivo se mostrarán juntos:

    1. En la barra de navegación izquierda, seleccione [Engage] → Informes.

    2. Seleccione Importaciones y exportaciones para ver el informe.

Última actualización

¿Te fue útil?