Attribution and Affiliate Partners

Attribution platforms tell you which marketing touchpoint earned a sale. Affiliate networks pay partners for the sales they send you. Both need the same thing from your StoreFront: a reliable signal when an order completes.

You configure all of them in one place. Go to Main Menu → StoreFronts, choose your StoreFront host, then open Privacy & Tracking → Other. Each partner has its own section on that tab. Paste the credentials the partner gave you, then select Save.

Most of these integrations are server-to-server, which means UltraCart calls the partner's API after payment succeeds rather than relying on a browser pixel. Server-to-server tracking keeps reporting accurate when a shopper blocks scripts or closes the tab early.

tip

Every server-to-server call is recorded. When a partner's numbers disagree with yours, open the Integration Log Health Report and look at the actual request and response for the order in question.

Which partner pages live where

Partner	Where it is documented
Everflow, Hyros, Northbeam, ReferralCandy, Share-A-Sale, RTB House	This page
Converge	Converge
HubSpot	HubSpot
Smart Attribution, UltraCart's own multi-touch model	Smart Attribution
Commission Junction, Katalys, KISSmetrics, Klaviyo, ONTRAPORT, FullStory, Inspectlet	Privacy and Tracking, on the Other tab

Everflow

Everflow is a partner marketing platform. The integration tracks inbound clicks and reports conversions back after payment.

1. Go to Privacy & Tracking → Other → Everflow.
2. Enter your Everflow domain and any parameter overrides you need.
3. Select Save.

Your StoreFront watches inbound traffic for Everflow's parameters, typically _ef_transaction_id, and stores the associated information against the session. Once payment processes, UltraCart makes a server-to-server call to Everflow with the order details.

Attributing an upsell to Everflow

Each upsell can carry its own Everflow advertiser event ID, set in the upsell's advanced settings. When a customer takes that upsell, UltraCart records the advertiser event ID as an item property on the order and includes it in the transmission to Everflow.

Hyros

Hyros is a tracking and attribution tool for digital businesses.

1. Get your API key from Hyros.
2. Go to Privacy & Tracking → Other → Hyros.
3. Paste the API key into the configuration field, then select Save.

Hyros publishes its own API documentation if you need to understand what the platform does with the data it receives.

Northbeam

Northbeam is an attribution platform built on first-party data.

1. Go to Privacy & Tracking → Other → Northbeam.
2. Enter your Data Client Id and API Key.
3. Select Save.

The Northbeam integration uses the server-to-server Orders API for both initial orders and rebill orders, alongside a tracking pixel injected into the checkout. Rebills are included, so subscription revenue is attributed rather than counted only at the first purchase.

ReferralCandy

ReferralCandy runs referral and affiliate programs, tracking sales through referral links and coupon codes.

Before you start, collect two values from your ReferralCandy account:

• Access Id
• Secret Key

Then go to Privacy & Tracking → Other → ReferralCandy, enter both values, and select Save.

UltraCart then sends server-to-server conversion information to ReferralCandy. Every call to the ReferralCandy Conversion API appears in the Integration Log Health Report.

Share-A-Sale

Share-A-Sale is an affiliate marketing network.

1. Go to Privacy & Tracking → Other.
2. Scroll to Share-A-Sale Merchant Id.
3. Enter your merchant ID, then select Save at the bottom of the page.

Configuring Share-A-Sale here rather than pasting a snippet into your receipt footer means a theme update cannot overwrite it.

note

If you are not using StoreFronts, configure Share-A-Sale through the legacy checkout instructions instead.

RTB House

RTB House receives order information through a webhook rather than a pixel. Provide a webhook URL in Privacy & Tracking → Other, in the RTB House section. UltraCart calls it once per order, after payment succeeds.

The webhook receives a JSON payload in this shape:

{
  "date": "2024-09-08T14:30:15.123Z",
  "order_id": "DEMO-12345",
  "order_value": 149.99,
  "device": "Desktop",
  "browser": "Chrome 118.0.5993.70",
  "host": "shop.example.com",
  "custom_field_4": "some tracking information here",
  "items": [
    {
      "item_id": "PROD-001",
      "description": "Wireless Bluetooth Headphones",
      "quantity": 1
    },
    {
      "item_id": "PROD-002",
      "description": "USB-C Charging Cable",
      "quantity": 2
    }
  ]
}

Next steps

• Privacy and Tracking explains the tab these settings live on, and the privacy controls that govern when tracking fires at all.
• Smart Attribution distributes credit across the whole customer journey instead of giving it all to the last click.
• Offline Conversions feeds upsell and rebill revenue back to Google and Bing after the original order.