Skip to content
Help Center

Connect Klar ​

Connect Klar so Commander can read your channel attribution, marketing and profit figures. The Klar card sits under Settings > Integrations, in the Analytics category. Its description reads "Attribution & profit analytics."

Problem and intended user ​

The ecommerce manager (the person who runs the store) and the media buyer (the person who runs your paid ads) need to know which channels bring orders, and what those orders earn after costs. Store reports show orders but not the channel that drove them. Ad platforms report their own results, and the platforms can claim the same order. Without one attribution source, traffic and margin figures in Commander can stay thin.

Current workflow ​

Without Commander, the team opens Klar and reads its reports next to Shopify admin reports and the ad platforms. Someone exports figures into a spreadsheet to compare channels and to work out a margin.

Prerequisites ​

  • A Klar account for this store.
  • A Klar API key with the Attribution, Marketing and Revenue & Profit permissions. Only the Klar account owner, or a user who can manage API keys in Klar, can create a key.
  • Your order data in Commander. The audits that use Klar read your store orders from Commander as well.

How Commander works ​

Commander asks Klar for four sets of figures: attribution by channel, attribution by ad, marketing figures by channel, and revenue and profit for the whole store. Fixed rules store them. AI does not write or change any figure.

Commander stores two kinds of attribution:

  • Last touch. Klar credits the order to the last channel the customer touched. This is a fixed rule.
  • Data-driven. Klar models how much each touch contributed. It is Klar's estimate, not a count. Commander stores it as Klar returns it and never recomputes it.

Commander syncs Klar once a day. It reads recent days again on each run, because Klar keeps crediting orders after the sale. Settings > Store Status lists Klar sync with its schedule and its last run. See Store Status.

Klar data feeds these places:

  • The traffic findings of the Growth Audit, when Triple Whale is not connected. They use last-touch attribution only. The page names its source as Klar.
  • The Media Audit, which can read your store orders from Klar when Commander has no order data, and can use Klar's profit figures for the margin checks. A margin line names its source.
  • Performance > Ad performance and the ad detail page. Four Klar columns and a Klar block show Klar's own figures for each ad and campaign, next to what Meta or Google report. See Klar figures on Ad performance.
  • The Insights page. When Klar shows that a platform loses money after all costs, or that your store's margin is shrinking, Commander shows an insight card for it. See Klar insight cards.
  • The Klar card and its activity window in Settings > Integrations.
  • The Klar sync row in Settings > Store Status.

If you connect both Triple Whale and Klar, Commander keeps using Triple Whale for the Growth Audit and the Media Audit. The Klar columns on Ad performance and the Klar insight cards show whenever Klar is connected.

Klar figures never change the matching of orders to ads, the True profit of an ad, or an ad's Verdict. Klar's columns on Ad performance are a second opinion that you read beside the platform's own numbers.

Create the API key in Klar ​

WARNING

Klar shows the key only once, when you create it. Copy it somewhere safe before you close that screen. Neither Klar nor Commander can show it again.

  1. In Klar, go to Account Settings > API Keys.
  2. Click Create New Secret Key, and name the key.
  3. Select the Attribution, Marketing and Revenue & Profit permissions.
  4. Create the key and copy it.

Klar ties a key to the user who created it. If that person is deleted or suspended in Klar, the key stops working. This is the most likely cause if the connection fails later.

Connect Klar ​

  1. Go to Settings > Integrations.
  2. Click the Klar card.
  3. Paste the key into API Key.
  4. Click Save Connection. The button reads Validating… while Commander checks the key with Klar.
  5. If the key can read more than one Klar shop, a Klar shop list appears. Choose the shop that belongs to this store, then click Save Connection again.

On success, Commander shows "Klar connected to" and the shop name, then closes the dialog. The card now shows View activity. Commander starts a first sync at once. Until it finishes, the activity window reads Not synced yet.

Commander checks only that the key works and which shops it can read. It does not check the permissions. A key that lacks a permission connects, and then the first sync fails with Permission missing.

After you connect, the API Key field shows a masked message. Commander never shows a saved key. To replace the key, or to reconnect after a failure, enter the key again and click Save Connection.

Disconnect Klar ​

WARNING

Disconnect Klar acts at once and asks for no confirmation.

Open the card and click Disconnect Klar. The button shows only while the card is connected. Commander erases the saved API key and stops syncing. It shows "Klar disconnected." The data it already stored stays. Commander does not delete the key in Klar. Remove the key there if you want it gone.

Exact output ​

Klar figures on Ad performance ​

Open Performance > Ad performance. Select Metrics to open the Metrics shown menu. While Klar is connected, the menu offers four columns tagged Klar. They are hidden until you tick them.

ColumnWhat it shows
Klar ordersOrders Klar credits to the ad or campaign in your dates. Under Data-driven, Klar splits an order across ads, so the number can have decimals.
Klar revenueGross revenue Klar credits to the ad or campaign. It often differs from the revenue Meta or Google report.
Klar ROASKlar revenue divided by the ad spend the platform reports.
Klar CM2Contribution margin 2 that Klar credits to the ad or campaign: net revenue less product, shipping and payment costs, as Klar computes it from your Klar cost settings.

When a Klar column shows, a Klar model list appears with Last touch and Data-driven. The columns follow the model you pick. A note under the toolbar reads, for example, "Klar figures matched for 87% of Klar ad revenue." It tells you how much of Klar's ad revenue Commander could tie to your own ads.

Commander ties a Klar ad to one of your own Meta or Google ads by the ad's id, and checks the campaign too. It never guesses. An ad it cannot tie shows a dash, and so does a row that Klar has no figure for. A dash always comes with a reason in text for screen readers. Klar reports ads and campaigns only, so every other grouping (concept, angle, hook and so on) shows a dash. Klar's channels that Commander does not sync ads for are not in the note's share.

Klar does not state a currency. Unless Klar's currency is on record as another one, Commander reads Klar's figures as your store currency, the same way the Klar insight cards do. When the currency differs from the table's, the money columns show a dash and Klar orders still show.

Some figures can cover only part of your dates: a day whose amounts Commander could not convert to your currency, or a very long date range on a large store. The note under the toolbar then says so, and Klar ROAS shows a dash, because Klar revenue for part of the dates over the spend for all of them would read too low. On a campaign row, Klar ROAS also shows a dash while a status, format or active-ads filter is on: Klar's campaign revenue covers all of the campaign's ads, and the row's spend covers only the filtered ones. If Commander cannot load the Klar figures, the note says so.

On the ad detail page, open the Attributed orders tab. A Klar block under the matched orders shows four tiles: Klar orders, Klar revenue, Klar ROAS and Klar CM2, for the dates you picked, with the same Klar model list. The block says it does not change the ad's profit or verdict.

The Adstein edition does not show the Klar columns.

Klar insight cards ​

Commander reads your stored Klar figures, with fixed rules and no AI, and can add two cards to Insights.

  • "{Platform} loses money after all costs." An ad platform earns less, as Klar counts it, than its product, shipping, payment and ad costs together. The card shows the monthly loss, Klar's contribution after all costs and the ad spend. It names Klar as its source.
  • "Your store's margin is shrinking: {cost line} takes a bigger share of revenue." Your store's margin after product, shipping and payment costs is below its usual range. The headline names the cost line that grew most against your revenue: discounts, returns, product costs, shipping and fulfilment costs, or payment fees. When no single line stands out, the card reads "Your store's margin after product, shipping and payment costs is shrinking."

Neither card appears on the Home dashboard. A store without a connected Klar account sees neither. When a discounts card for a recent promotion already covers a margin drop caused by discounts, Commander shows that one and not the margin card. Each card needs enough Klar history before it appears, so a newly connected store sees none at first.

The activity log ​

Click View activity on the connected card to open Klar activity. It lists the runs Commander recorded over the last 7 days. A health badge sits at the top, with the number of runs found.

BadgeMeaning
HealthyThe recorded runs are fine.
DegradedSome runs failed. The badge reads, for example, "Degraded — 2 of 7 runs failed".
Reconnect neededThe API key no longer works, or it lacks a permission. Save the connection again with a working key.
Not synced yetCommander has recorded no run yet.

Each run is a row with a date, a status badge, how long it took, and the counts of channel rows, ad rows and marketing rows. A run with a problem shows an error code and message under its date. Click Show details for the revenue rows, the API calls, the reports Klar cut short, the time Commander waited for Klar's rate limit, and the start and end times.

Run statusMeaning
PendingThe run started and has not finished.
SuccessCommander wrote every day of the window.
PartialCommander wrote some days, or Klar cut a report short. A line reads "Klar cut N reports short, so this day is partial."
HTTP errorKlar returned a server error.
Credentials invalidKlar rejected the key.
Permission missingThe key works but lacks a permission that a report needs.
Rate limitedKlar asked Commander to slow down.
Failed (permanent)Klar refused the request, Commander could not read the stored key, or an unexpected error occurred.

A day with no entry means Commander did not sync that day: the sync is switched off, or no active connection exists.

Commander does not retry a failed run on the same day. The next daily run reads the window again. Credentials invalid and Permission missing are the statuses you fix yourself, in Klar.

What to do with it ​

What you seeDecision or actionOwner
Reconnect needed, Credentials invalid or Permission missingCreate a new key in Klar with all three permissions, then click Save Connection in Commander.ecommerce manager
Degraded, Partial or Rate limitedRead the error message on the failed runs. The next daily run tries again.ecommerce manager
Klar named as the source of a margin or of traffic in an auditRead the figure as Klar's, not as a Shopify figure.media buyer
Not enough data on a Media Audit store checkRead the check's message. See Media Audit.media buyer

Expected value and measurement ​

Klar can give the audits a channel view of your orders and a margin from your own costs. That can make the traffic and margin findings more complete.

To check the effect:

  • Open the Growth Audit after the first runs and compare its traffic findings with Klar's own report for the same weeks.
  • Open Settings > Store Status and check that Klar sync ran today.
  • Open View activity and check that recent runs read Success.

Seasons, promotions and ad changes run at the same time, so you cannot isolate the effect of Klar alone.

Limitations and exceptions ​

  • Display only on Ad performance. The Klar columns and the Klar block do not feed the matching of orders to ads, an ad's True profit or its Verdict. Klar's order report carries no ad id, so Commander cannot match single orders to ads with Klar.
  • Ad ids can differ. If Klar's ad ids are not your Meta or Google ad ids, the columns show dashes and the coverage note reads a low share. That is a fact about the ids, not an error.
  • Klar insight cards. Klar's contribution figures can be empty for some days. Commander counts an empty figure as missing, never as zero, and waits for enough days before it judges. Whether Klar's net revenue already deducts discounts and returns changes how the cost-line headline reads, not whether the margin card appears.
  • Data-driven is modelled. Klar's data-driven attribution is an estimate that Klar runs. Commander cannot reproduce it.
  • No currency. Klar does not state a currency for its amounts. Commander shows them as Klar returns them and does not convert them.
  • Recent days first. The sync reads recent days. Pages that compare weeks need several weeks of stored data, so they stay thin until the days build up.
  • Channel names. Commander matches Klar channel names to your ad platforms with a strict list. A channel it does not know stays under its own name, and an organic channel never counts as paid.
  • Media Audit setup. The Media Audit store checks that rely on Klar orders can show Not enough data until the setup for your store is finished. Contact support if they stay empty. See Contact support.
  • A missing row means Commander did not run that day. It does not mean Commander ran and found nothing.

If the save fails, the dialog stays open and shows one of these messages.

MessageWhat to do
Klar rejected this API key. Check that you copied the whole key, or create a new one in Klar.Copy the whole key again, or create a new key in Klar.
This API key cannot read any Klar shop. Create the key in the Klar account that owns your store.Create the key in the right Klar account.
This key can read more than one Klar shop. Choose the shop for this store, then save again.Pick a shop in Klar shop, then click Save Connection.
Klar did not find that shop for this API key. Choose a shop from the list, or check the key.Pick a shop from the list, or check the key.
Klar is temporarily unavailable. Try again shortly — this is not a problem with your key.Wait, then try again. Your key is not the problem.
Enter the API key created in Klar (Account Settings > API Keys).API Key is empty or too short. Fill it in.

When a connected store has no run in the window, the activity log reads "No runs in the last 7 days." If the log fails to load, it reads "Could not load Klar activity. Try again shortly."

In Demo Mode, connecting and disconnecting are turned off. Commander shows "Disable demo mode to connect Klar" or "Disable demo mode to disconnect Klar". The demo stores show a connected Klar card and an activity log, but the Growth Audit and the Media Audit in Demo Mode keep their own sources.

Commander is built by Omniconvert.