BlendedMetrics

The merchant’s advertising totals across every platform at once — what a customer actually costs, rather than what each channel reports on its own. Platforms the merchant is only trialling are reported alongside these totals and left out of them, so trialling a channel cannot move the number a lender reads.

type BlendedMetrics {
  totalSpend: Money!
  connectedSpend: Money!
  totalCustomers: Int!
  totalConversions: Int! @deprecated
  attributedRevenue: Money!
  monthlyBudgetCap: Money
  blendedCac: Money
  returnOnAdSpend: Float
  healthScore: Float
}

Fields

BlendedMetrics.totalSpend ● Money! non-null object

Everything the merchant has spent on advertising this month, across every platform in the blend — including platforms they have not connected, because the money was still spent.

BlendedMetrics.connectedSpend ● Money! non-null object

The part of totalSpend that runs on platforms the merchant has actually connected to this workspace. The difference between the two is the spend this product can see but not yet act on.

BlendedMetrics.totalCustomers ● Int! non-null scalar

Customers attributed across every platform in the blend this month. Each platform attributes with its own window, so this is a sum of several platforms’ opinions rather than a de-duplicated count of people.

BlendedMetrics.attributedRevenue ● Money! non-null object

The revenue the platforms attribute to this month’s advertising, added up across the blend. It is each platform’s own attribution, so it may double-count a customer two channels both claim.

BlendedMetrics.monthlyBudgetCap ● Money object

The most the merchant has decided to spend across the blend this month, added up from the per-platform caps. Null when they have capped nothing, which is not the same as a cap of zero.

BlendedMetrics.blendedCac ● Money object

totalSpend divided by totalCustomers, TRUNCATED to the minor unit rather than rounded — a merchant’s cost per customer is quoted back to them and to their lender, and reporting a cost they have not incurred would be the wrong error to make. This is the number the whole module exists for, and it is NOT the average of the per-platform figures: a channel with eighteen customers must not weigh the same as one with a hundred and fourteen. Null when there are no customers at all.

BlendedMetrics.returnOnAdSpend ● Float scalar

attributedRevenue over connectedSpend, to one decimal place: 3.1 means three and a bit currency units of attributed revenue for every one the merchant spends on the platforms they have connected here. The two halves are on DIFFERENT bases and deliberately so — the numerator spans the whole blend, the denominator only the connected part of it — because spend on a platform the merchant has not connected is not spend this product is helping them manage, while the revenue it attributes is still revenue they earned. Every input is published separately (attributedRevenue, connectedSpend, totalSpend), so a reader who wants the single-basis ratio can divide it themselves. Null when nothing is connected.

BlendedMetrics.healthScore ● Float scalar

How well the merchant’s advertising is set up overall, from 0 to 10 and to one decimal place — each platform’s own score weighted by what that platform costs them this month, so a channel carrying most of the budget carries most of the number. Counted over the platforms that are in the blend, CONNECTED and assessed: an unconnected platform’s health card is a projection of what connecting would find (see AdPlatform.health), and a projection has no place in a headline figure. Null when no platform meets all three, which is not the same as a score of zero.

Show deprecated

BlendedMetrics.totalConversions ● Int! deprecated non-null scalar

DEPRECATED

Renamed to totalCustomers, which is what the platforms report and what blendedCac divides by. Identical value; this spelling is removed on 2027-01-31.

Customers attributed across every platform in the blend this month. The same number as totalCustomers.

Returned By

blendedMetrics query