Referencia de datos de PAR Punchh
Objetivos del artículo
Descubre qué datos se sincronizan de PAR Punchh a Klaviyo y dónde puedes verlos. Esto incluye datos relacionados con la actividad de la cuenta, las recompensas y los registros.
Si aún no lo has hecho, lee nuestra guía sobre los primeros pasos con PAR Punchh para obtener instrucciones paso a paso sobre la integración, antes de continuar con este artículo.
Cómo ver tus datos
Para ver tus datos de PAR Punchh:
- Haz clic en el menú desplegable «Analytics» en la barra de navegación de la izquierda.
- Select métrica. Aquí puedes ver todas las métricas de tu cuenta.
- Filtra esta vista para ver la métrica PAR Punchh usando el selector de filtros que está al lado de la barra de búsqueda y seleccionando PAR Punchh.
Métrica sincronizada
Registro Completado
Esto ocurre cuando un cliente se inscribe en tu programa de fidelidad PAR Punchh. Puedes filtrar y seleccionar los eventos de «Registrado» según los siguientes criterios:
- URL de confirmación por correo electrónico
URL de confirmación por correo electrónico - Suscripcióna correos electrónicos de marketing
: si el usuario final se ha suscrito o no a los correos electrónicos de marketing - Suscripcióna notificaciones push de marketing
: si el usuario final se ha suscrito o no a las notificaciones push de marketing - SMS Suscripción
Independientemente de si el usuario final se ha suscrito a los servicios de SMS o no
Redención métrica
Redención creada, Redención actualizada
Esto ocurre cuando un cliente crea o actualiza un canje. Puedes filtrar y seleccionar eventos de canje según los siguientes criterios:
- Código de barras
Código de barras generado para el pedido - Canalde canje «
» (por ejemplo, punto de venta, pedido en línea) - Vence el
: código de canje que vence en la fecha y hora indicadas - ID de ubicación
: el ID del lugar donde se realizó el canje - Nombrede la ubicación
: Nombre del lugar donde se realizó el canje - Propiedades adicionales:
Redemption cumple con los criterios establecidos en caso de que se haya configurado - IDdel administrador
: ID del administrador que creó el código de canje - Creado en
Código de canje creado en la fecha y hora indicadas - Caducado alas
. El código de canje ha caducado a la hora indicada. - Mensajede canje forzado
Mensaje en caso de canje forzado - Código de seguimiento interno
: código de canje generado para la oferta (por ejemplo, una recompensa, una recompensa canjeable o una recompensa acumulada) - Código de canje:
Código para canjear - Actualizado el
. Código de canje generado en la fecha y hora indicadas - Puntos solicitados
: puntos que se quieren canjear en el pedido - ID canjeable
: ID para el canje - Nombredel título rescatable
: Nombre del título rescatable - Propiedades rescatables
- Puntos canjeados
: Puntos canjeados en el pedido - ID del código de canje
: ID del código de canje generado para la oferta por PAR Punchh (es decir, recompensa, canjeable o acumulada) - Código de canje
- ID de canje
: ID de canje único generado en PAR Punchh para un canje - Estado de canje
Estado del canje (es decir, canjeado, vencido, canjeable, transferido, force_redeemed, cancelado) - Tipo de canje
: Tipo de canje (por ejemplo, BankedRewardRedemption, RedeemableRedemption, Redemption, RewardRedemption) - ID de la recompensa
ID de la recompensa en caso de canjearla - Número de tienda
: número de la tienda donde se realizó el canje - Transferido al ID
: el ID del tipo de transferencia (por ejemplo, el ID de la campaña en el caso de una campaña por una causa social) - Transferido a Tipo
: Tipo de transferencia (por ejemplo, campaña por una causa social) - Sitio web:
. Independientemente de si el canje se realiza a través de un iFrame o no
Canje Aplicado
Este evento se genera cuando se aplica un canje. Puedes filtrar y seleccionar eventos de «Canje aplicado» según los siguientes criterios:
- discountAmount
: Importe del descuento asociado al canje - InternalTrackingCode
Código de seguimiento de canje generado para la oferta (es decir, recompensa, recompensa canjeable o recompensa acumulada) - locationName
: nombre de la ubicación del check-in - processedAt
: Fecha y hora en que se procesó el canje - rewardName
: Nombre de la recompensa
Métrica de registro
Registrado por fidelidad, registrado por regalo
Esto pasa cuando un usuario se registra en el programa de fidelidad o para conseguir un regalo específico. Puedes filtrar y seleccionar los eventos registrados según los siguientes criterios:
- Aprobado
Estado de registro aprobado - ID de campaña
. ID de campaña creado en PAR Punchh - Nombrede la campaña
ar el nombre de la campaña - Tipo de campaña
: Tipo de campaña - canal
: canal a través del cual se realiza el check-in (por ejemplo, punto de venta, pedido en línea, web, móvil) - ID de registro
: ID de registro único generado por PAR Punchh - Tipo de registro
, registro en línea, registro en TPV, registro con imagen del recibo, registro con código de barras, registro con código QR, registro en consola de TPV - Importe ganable
Importe ganable según los requisitos de calificación del pedido - «Primer registro en la página de empresa»
Indica si se trata del primer registro de la empresa - «Primer registro en la ubicación»
Indica si se trata del primer registro en esa ubicación - Motivo del regalo
: motivo por el que se le han regalado puntos al usuario - Regalo por tipo
Tipo de regalo (p. ej., administrativo, de bienvenida, etc.) - Regalo para el tipo
Tipo de regalo (por ejemplo, regalo masivo, respuesta a un comentario, juego, etc.) - Elementosdel menú «
» - ID de ubicación
. ID de ubicación generado en PAR Punchh - Nombre del lugar
: nombre del lugar donde te registraste - Manual
- Puntos obtenidos
: Puntos obtenidos con el pedido - Puntos gastados
Puntos canjeados en el pedido - de la clavePAR Punchh: clave PAR Punchh única generada para el pedido
- Importe del recibo
: importe del recibo correspondiente al pedido - ID de canje
: se rellena el ID de canje en caso de que el canje se haya completado en el pedido - N.ºde tienda
: número de tienda de la ubicación - Código de barras
Código de barras generado para el pedido - Creado en
: marca de tiempo en la que se crea el registro de entrada en PAR Punchh - Caducado el
Fecha en la que caducó el check-in - Vence el
: fecha en la que caduca el check-in - UID externo
: UID externo generado para la transacción - ID de referencia
: ID del primer inicio de sesión del usuario referido - Nombre completodel remitente
: Nombre del usuario de referencia - IDdel usuario que realiza la referencia
: ID del usuario al que se hace la referencia - Regalo de ID
ID del administrador que regaló los puntos - Gifted For ID
: ID del tipo de donativo - QR descodificado
: valor del código QR generado para el pedido - Número de transacción
: número de transacción del pedido - Actualizado alas
: hora en la que se actualiza el registro de entrada en PAR Punchh - Fecha de recepción
: Fecha y hora de recepción del pedido - Actualización pendiente
Activado según la configuración de puntos pendientes - Importe del recibo sin verificar:
. El campo «Receipt_amount» se rellena en caso de registro manual (es decir, basado en la verificación de la imagen del recibo). - Actualizado en
Fecha y hora de actualización del registro - Recuento de verificaciones
Este recuento aumenta si varios revisores o administradores han aprobado un registro (aplicable a los registros basados en la verificación de imágenes de recibos). - Verificado en
: marca de tiempo de registro aprobado (aplicable al registro basado en la verificación de la imagen del recibo) - ID del revisor
: ID del administrador del revisor que está verificando un registro (aplicable a los registros basados en la verificación de imágenes de recibos)
Registrado en el Escáner del POS
Este evento se genera tras un registro en el punto de venta. Puedes filtrar y orientar esta acción de registro según los puntos.
- Puntos
Puntos ganados al registrarse
Métrica de recompensa
Recompensa Ganada
Esto incluye las recompensas para usuarios que se otorgan o emiten en eventos que se activan en el momento en que ocurren en PAR Punchh. Puedes filtrar y seleccionar eventos de recompensas ganadas según los siguientes criterios:
- Canal de descuentos
: un canal donde puedes usar la recompensa. Los valores posibles son:- "solo en línea" para pedidos en línea
- "solo_sin_conexión" para puntos de venta
- "todo" para ambos
- Motivo del regalo
: motivo del regalo otorgado al usuario - URLde la imagen de la recompensa
URL de la imagen que muestra la recompensa - Vence alas
: Fecha y hora en que vence la recompensa (UTC) - Estado
. Los estados incluyen: canjeado, sin canjear, activo, caducado, vencido - Nombre de la campaña
: nombre de la campaña de Punchh utilizada para la recompensa - Tipo de campaña
: tipo de campaña de Punchh utilizada para la recompensa - Descripción
Descripción de la recompensa - Importe del descuento
: importe del descuento asociado a la recompensa - Regalos para el tipo«
» Tipo de regalo (por ejemplo, regalo masivo, respuesta a un comentario, juego, etc.) - Nombrede la recompensa
a Nombre de la recompensa - Puntos de recompensa canjeados
Número de puntos de recompensa canjeados - Propiedades de la recompensa
Propiedades adicionales de la recompensa configuradas en Punchh - Números de tienda
: los números de tienda de todos los establecimientos donde se puede canjear la recompensa
Puntos convertidos en recompensas
Este evento se activa cuando los puntos que ha acumulado un cliente se convierten en recompensas. Puedes filtrar y seleccionar los eventos de «Puntos convertidos en recompensas» según los siguientes criterios:
- Saldo del banco
Valor de las recompensas acumuladas - Recompensas acumuladas actuales
Valor actual de las recompensas acumuladas - Recompensa
Otras métricas
Tarjeta completada
Este evento se activa cuando se completa la tarjeta de fidelidad de un cliente. Puedes filtrar y seleccionar eventos de «Tarjeta completada» según los siguientes criterios:
- Finalización de la tarjeta
: si se realizan o no las visitas necesarias para completar una sola tarjeta - Recordatoriode la primera tarjeta
: si se envía o no un recordatorio al completar la primera tarjeta - Recordatorio de la segunda tarjeta
: si se envía o no un recordatorio al completar la segunda tarjeta - Nombre
: Nombre de la recompensa - Descripción
: Descripción del cupón canjeable que aparece en la app - Importe del descuento
: importe del descuento asociado al título canjeable - Canal de descuentos
: un canal donde puedes usar la recompensa. Los valores posibles son:- "solo en línea" para pedidos en línea
- "solo_sin_conexión" para puntos de venta
- "todo" para ambos
- Fecha de vencimiento
Fecha de vencimiento del título canjeable - Puntos necesarios para canjear
Valor de los puntos necesarios para canjear un artículo concreto - ID del producto canjeable
: ID único para identificar un producto canjeable en el sistema - Vencimiento del rescate
Fecha de vencimiento del título rescatable - Estado
. Los estados del cupón canjeable son: activado, desactivado, borrador, caducado - Aplicable como canje de fidelidad
: si se permite o no el canje de puntos de fidelidad - Creado en
: fecha y hora en que se creó el cupón canjeable para un usuario final en el sistema - ¿Caduca el código de canje junto con la fecha de finalización de la recompensa?
¿Caduca el código de canje junto con la fecha de finalización de la recompensa o no? - Metadatos
Metadatos que se pueden añadir a un cupón canjeable. Esto se puede usar para programar aplicaciones móviles de modo que se comporten de cierta manera cuando se reciban datos específicos del servidor, o se puede usar como la empresa lo desee. Esto se puede configurar desde el panel de control de PAR Punchh y tiene una longitud máxima de 255 caracteres. - Actualizado el
Fecha y hora en que se actualizó el cupón canjeable para un usuario final en el sistema. - URL de la imagen del cupón: URL de la imagen que se muestra en la app para representar el cupón
- Productos canjeables
Productos como "Artículos", "Productos alimenticios", etc., añadidos a un canjeable concreto
Objetos sincronizados
Recompensa
Este objeto se sincronizará cuando se haya emitido una recompensa a un cliente mediante tu programa de lealtad de Punchh a través de una campaña de Punchh creada en Klaviyo. Este objeto se actualizará cada vez que se actualice la recompensa en Punchh. Para obtener más información sobre cómo usar objetos en Klaviyo, consulta estos artículos.
Puedes filtrar y seleccionar objetos de recompensa según los siguientes criterios:
- RewardID
Identificador único de la recompensa. - Descripción
Descripción de la recompensa - GiftReason
Motivo del regalo para la recompensa otorgada al usuario - Nombrede la recompensa
: Nombre de la recompensa - Vence el
Fecha y hora en que vence la recompensa - Estado
. El estado incluye: canjeado, sin canjear, caducado, vencido - Nombrede la campaña
: Nombre de la campaña de Punchh - CampaignType
: indica el tipo de campaña a través de la cual un usuario final obtuvo una recompensa. Por ahora, el único valor posible es "loyalty". - RewardImageURL
URL de la imagen que muestra la recompensa - DiscountChannel
: un canal donde se puede usar la recompensa. Los valores posibles son: «online_only», «offline_only», «all». - Importe del descuento
: importe del descuento asociado a la recompensa - GiftedForType
Tipo de don - Puntos de recompensa canjeados
Puntos de recompensa canjeados a través de esta recompensa - RewardProperties
Propiedades adicionales de la recompensa (por ejemplo, ",", ",", ",", etc.) que se pueden configurar en la plataforma Punchh
Datos de huéspedes sincronizados
Además de la métrica « Klaviyo » que se sincroniza desde PAR Punchh, « Klaviyo » también creará un perfil único para cada cliente que sincronicemos. Cuando sincronizamos la información de contacto, también pueden añadirse ciertas propiedades personalizadas a cada perfil de Klaviyo. Puedes usar estas propiedades en segmentos y en Flujo. Estas son las propiedades que se sincronizan automáticamente desde PAR Punchh:
- Correo electrónico
- Número de teléfono
- Nombre
- Apellido
- Aniversario de Punchh
- cumpleaños
- Género
- Tipo de invitado en Punchh
- Punchh se unió el
- Última actividad de Punchh a las
- Lugares favoritos de Punchh
- Números de tiendas favoritas de Punchh
- Idioma preferido
- Código de referencia de Punchh
- Canal de registro de Punchh
- Pulsar para cancelar la suscripción. Motivo
- Punchh: cancelar la suscripción | Estado
- Punchh ID
- Estado de usuario de Punchh
- Nivel de membresía de Punchh
- Punchh Última visita
- Puntos de fidelidad Punchh
- Punchh: Créditos totales
- Puntos totales acumulados en Punchh
- Créditos de puntos totales de Punchh
- Total de visitas a Punchh
- Punchh: Puntos para quienes no tienen cuenta bancaria
El consentimiento para recibir correos electrónicos se sincroniza de Punchh a Klaviyo. Ten en cuenta que no sincronizamos el consentimiento por SMS de Punchh.