Conecta Squarespace y vincula sus pedidos con visitas

01Conectar con un clic

1. 1

   En la página Integrations de tu sitio, abre Squarespace y pulsa Connect with Squarespace.

2. 2

   Tally indica qué se le dará: tus pedidos y sus transacciones, en solo lectura, y una suscripción de webhook. Nunca cambia un pedido. Pulsa Continue to Squarespace.

3. 3

   Squarespace te pide que inicies sesión, como propietario del sitio o como administrador, y que elijas el sitio. Su página de confirmación pide permiso para que Tally lea tus pedidos y transacciones con acceso offline, para que siga leyendo mientras no estás. Pulsa Allow.

4. 4

   Vuelves a Integrations: Squarespace is connected, y se está importando un año de pedidos, reembolsos incluidos.

A partir de ahí, cada pedido nuevo llega en segundos a través de la suscripción de webhook. Cada 30 minutos, Tally también lee los pedidos que cambiaron, así que un pedido cuya notificación se perdió llega igualmente.

02O conecta con una clave de API

1. 1

   Crea una clave de API en Squarespace

   Una clave de API funciona en los planes Core, Plus, Advanced y Commerce Advanced. En Squarespace, abre Settings › Developer Tools › Developer API Keys, elige Generate Key y dale solo estos permisos (guía de Squarespace):

   Permiso	Acceso	Por qué
   Orders	Lectura	Cada pedido pagado: su total e impuestos, y el email del cliente (convertido en hash al instante, nunca guardado). Nunca se guardan nombres ni direcciones.
   Transactions	Lectura	Cuándo ocurrió cada reembolso y cuánto devolvió.

   Read Only para ambos. Squarespace solo da webhooks a las apps conectadas con un clic, así que con una clave Tally lee los pedidos nuevos cada 10 minutos. Borra la clave en el mismo lugar cuando quieras.

2. 2

   Pega la clave de API

   En la página Integrations de tu sitio (o en el paso Payments al añadir un sitio), abre Squarespace y rellena:

   • API key: se muestra una sola vez, al crear la clave. Tally la guarda cifrada y nunca vuelve a mostrarla.

   Después pulsa Connect Squarespace.

3. 3

   Tally lo comprueba e importa el último año

   Comprueba la clave contra tu sitio e importa los últimos 365 días, reembolsos incluidos, y después lee los pedidos nuevos y modificados cada 10 minutos. Para vincular cada pedido con la visita de su comprador, añade el snippet de Tally en Pages › Custom Code › Code Injection: la etiqueta en Header, y las líneas de estado del pedido de Coverage and fixes en los campos Order Status Page y Order Confirmation Page.

03Añade el código en Code Injection

Squarespace no ejecuta el código de ninguna app en una tienda, así que el código se añade a mano. En Squarespace, abre Pages › Custom Code › Code Injection (antes estaba en Developer Tools). Squarespace ofrece Code Injection en los planes Core, Plus y Advanced y en algunos antiguos, no en Basic ni en Personal.

Header

El snippet, para que cada página de la tienda cuente sus visitas:

<script defer data-site="k3xq2mfa7twp" src="https://t.tallybyoutpost.com/script.js"></script>

Order Status Page y Order Confirmation Page

Estas líneas, en los dos campos. Squarespace muestra la página de estado del pedido después del checkout para productos físicos, descargas y servicios, y la página de confirmación del pedido para tarjetas regalo, suscripciones y membresías. Rellena {orderId} con el número de pedido, y las líneas lo envían:

{.if firstPageView}
<script>
  window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
  String('{orderId}').split(/[^0-9]+/).filter(Boolean).forEach(function (order) {
    tally('squarespace_order', { order: order });
  });
</script>
{.end}

La visita del comprador a esa página vincula el pedido con él: confianza alta. {.if firstPageView} evita que una visita posterior a la página, desde el enlace del email, vuelva a contar. Sin estas líneas, un pedido se vincula por su email cuando tu sitio llama a identify con la dirección del comprador, con confianza media (objetivos e identify).

04Qué cuenta como venta

• Un pedido cuenta en cuanto está pagado, en la fecha en que se hizo: su total menos impuestos, con el envío incluido y los descuentos ya restados, en la moneda del pedido.
• Cada reembolso cuenta en la fecha en que se hizo, leído de las transacciones del pedido, con su parte proporcional de los impuestos del pedido.

05Qué se guarda

De cada pedido, Tally guarda los importes, las fechas y el estado del pago, y dos hashes: uno del email del cliente y otro del número de pedido. El número de la página de estado del pedido se convierte en hash al llegar, así que solo se guarda el hash. Nunca se guardan nombres, direcciones, teléfonos, artículos, respuestas de formularios ni notas.

06Desconectar

• En Squarespace: desconecta Tally en el panel Extensions, en Connected extensions.
• En Tally: desconéctalo en la página Integrations. Tally borra su suscripción de webhook y olvida su acceso, pero Squarespace lo sigue mostrando en Connected extensions hasta que lo desconectes también allí. Una clave que hayas creado tú, bórrala en Squarespace.
• En cualquier caso, los pedidos ya importados se quedan, con sus comprobantes.

07Comprueba que funciona

08Cuando no aparecen tus propias visitas

Con la sesión iniciada en Squarespace, al propietario de un sitio se le envía al editor y nunca ve la tienda como un visitante, así que esas visitas no se cuentan. Prueba en una ventana privada, sin sesión iniciada y tras introducir la contraseña del sitio, si tiene una.