Squarespace

Attribute sales to creators on Squarespace — Code injection site-wide, plus the order-confirmation page.

Yonto attributes sales to the individual creator who drove them. On Squarespace that works several ways, and the honest summary is that browser pixel does most of the work:

Browser pixel — primary on this platform
A small script on your confirmation page reports the order. Depends on the shopper accepting cookies and not blocking scripts.
Discount code
The shopper types the creator's code at checkout. Works on every platform and survives a refused cookie, but only catches shoppers who use it.

Setting it up#

Every campaign has its own tracking code. The snippets below use YOUR_TRACKING_CODE as a placeholder — copy the real ones from the campaign's Setup screen, which fills them in for you.

Conversions are reported from: Order Confirmation Page injection.

  1. 1
    Add the pixel
    Settings → Advanced → Code Injection → Header. This loads on every page, which is what lets the click be remembered between landing and checkout.
    html
    <script async src="https://yontosales.com/p.js" data-proof="YOUR_TRACKING_CODE"></script>
  2. 2
    Fire the conversion
    Same screen, the Order Confirmation Page box. Squarespace exposes the order there as a global, so no selectors are involved.
    html
    <script>
      (function () {
        var o = window.Static && window.Static.SQUARESPACE_CONTEXT
          && window.Static.SQUARESPACE_CONTEXT.order;
        if (!o) return;
        proof('conversion', {
          value: o.grandTotal.value,
          id: o.orderNumber,
          currency: o.grandTotal.currencyCode
        });
      })();
    </script>
  3. 3
    Create a matching discount
    Selling → Discounts, named exactly as your campaign's code.
Warning.on a sale campaign, value and id are both required. The order id is what makes a retry or a refreshed confirmation page idempotent instead of a second sale. A call missing either is rejected — see the Conversion endpoint reference.

What this can and cannot see#

Attribution is never complete, on any platform. You are about to pay a creator on the strength of these numbers, so here is exactly what is behind them on Squarespace.

Counted
  • Orders completed in the same browser that clicked the link, within 30 days.
  • Orders that used the creator's discount code, whatever the shopper's cookie settings.
  • The order's real total and currency, from Squarespace's own order object.
Not counted
  • Shoppers who refuse tracking cookies — the click is never linked to the sale.
  • Purchases made on a different device from the click.
  • Anyone running an ad blocker that blocks our script.
  • Sales where the shopper cleared their browser data between clicking and buying.
  • Refunds — Squarespace does not notify Yonto, so a refunded order stays counted.

This is why every figure Yonto reports is described as a confident floor rather than a total. The sales in the right-hand column happened; we simply cannot prove the creator caused them, and we would rather undercount than invent.

Worth knowing#

  • Code injection requires a Business plan or above. On Personal plans there is no way to install the pixel, and discount-code attribution is your only option.

Making it more accurate#

  • Ask the creator to lead with the discount code. It is the only method that survives a shopper refusing cookies, and it converts better anyway.
  • Report refunds. Squarespace does not tell us when you refund an order, so a refunded sale stays counted unless you reverse it yourself.
  • Use one discount code per campaign. Codes are matched before click ids, and a code shared across campaigns resolves to whichever matches first.