@adtrackify/at-tracking-event-types 4.44.0 → 4.46.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/dist/cjs/__tests__/measure-alias-map.spec.js +100 -7
  2. package/dist/cjs/__tests__/measure-alias-map.spec.js.map +1 -1
  3. package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js +12 -891
  4. package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js.map +1 -1
  5. package/dist/cjs/types/api/measures/definitions/measure-applicable-contexts.d.ts +4 -2
  6. package/dist/cjs/types/api/measures/definitions/measure-applicable-contexts.js +6 -4
  7. package/dist/cjs/types/api/measures/definitions/measure-applicable-contexts.js.map +1 -1
  8. package/dist/cjs/types/api/measures/definitions/measure-categories.d.ts +12 -6
  9. package/dist/cjs/types/api/measures/definitions/measure-categories.js +12 -6
  10. package/dist/cjs/types/api/measures/definitions/measure-categories.js.map +1 -1
  11. package/dist/cjs/types/api/measures/definitions/measure-definitions.d.ts +1 -0
  12. package/dist/cjs/types/api/measures/definitions/measure-definitions.js +6 -6
  13. package/dist/cjs/types/api/measures/definitions/measure-definitions.js.map +1 -1
  14. package/dist/cjs/types/api/measures/definitions/orders-measure-definitions.js +2312 -826
  15. package/dist/cjs/types/api/measures/definitions/orders-measure-definitions.js.map +1 -1
  16. package/dist/cjs/types/api/measures/definitions/shopify/shopify-measure-definitions.js +0 -54
  17. package/dist/cjs/types/api/measures/definitions/shopify/shopify-measure-definitions.js.map +1 -1
  18. package/dist/cjs/types/api/measures/deprecated-measures.d.ts +78 -0
  19. package/dist/cjs/types/api/measures/deprecated-measures.js +83 -0
  20. package/dist/cjs/types/api/measures/deprecated-measures.js.map +1 -0
  21. package/dist/cjs/types/api/measures/index.d.ts +1 -0
  22. package/dist/cjs/types/api/measures/index.js +1 -0
  23. package/dist/cjs/types/api/measures/index.js.map +1 -1
  24. package/dist/cjs/types/api/measures/measure-alias-map.d.ts +7 -4
  25. package/dist/cjs/types/api/measures/measure-alias-map.js +95 -21
  26. package/dist/cjs/types/api/measures/measure-alias-map.js.map +1 -1
  27. package/dist/cjs/types/api/measures/measures.d.ts +78 -94
  28. package/dist/cjs/types/api/measures/measures.js +78 -94
  29. package/dist/cjs/types/api/measures/measures.js.map +1 -1
  30. package/dist/esm/__tests__/measure-alias-map.spec.js +100 -7
  31. package/dist/esm/__tests__/measure-alias-map.spec.js.map +1 -1
  32. package/dist/esm/types/api/measures/definitions/core-measure-definitions.js +13 -892
  33. package/dist/esm/types/api/measures/definitions/core-measure-definitions.js.map +1 -1
  34. package/dist/esm/types/api/measures/definitions/measure-applicable-contexts.d.ts +4 -2
  35. package/dist/esm/types/api/measures/definitions/measure-applicable-contexts.js +5 -3
  36. package/dist/esm/types/api/measures/definitions/measure-applicable-contexts.js.map +1 -1
  37. package/dist/esm/types/api/measures/definitions/measure-categories.d.ts +12 -6
  38. package/dist/esm/types/api/measures/definitions/measure-categories.js +12 -6
  39. package/dist/esm/types/api/measures/definitions/measure-categories.js.map +1 -1
  40. package/dist/esm/types/api/measures/definitions/measure-definitions.d.ts +1 -0
  41. package/dist/esm/types/api/measures/definitions/measure-definitions.js +6 -6
  42. package/dist/esm/types/api/measures/definitions/measure-definitions.js.map +1 -1
  43. package/dist/esm/types/api/measures/definitions/orders-measure-definitions.js +2313 -827
  44. package/dist/esm/types/api/measures/definitions/orders-measure-definitions.js.map +1 -1
  45. package/dist/esm/types/api/measures/definitions/shopify/shopify-measure-definitions.js +0 -54
  46. package/dist/esm/types/api/measures/definitions/shopify/shopify-measure-definitions.js.map +1 -1
  47. package/dist/esm/types/api/measures/deprecated-measures.d.ts +78 -0
  48. package/dist/esm/types/api/measures/deprecated-measures.js +80 -0
  49. package/dist/esm/types/api/measures/deprecated-measures.js.map +1 -0
  50. package/dist/esm/types/api/measures/index.d.ts +1 -0
  51. package/dist/esm/types/api/measures/index.js +1 -0
  52. package/dist/esm/types/api/measures/index.js.map +1 -1
  53. package/dist/esm/types/api/measures/measure-alias-map.d.ts +7 -4
  54. package/dist/esm/types/api/measures/measure-alias-map.js +95 -21
  55. package/dist/esm/types/api/measures/measure-alias-map.js.map +1 -1
  56. package/dist/esm/types/api/measures/measures.d.ts +78 -94
  57. package/dist/esm/types/api/measures/measures.js +78 -94
  58. package/dist/esm/types/api/measures/measures.js.map +1 -1
  59. package/package.json +1 -1
@@ -2,7 +2,7 @@ import { MEASURE } from '../measures.js';
2
2
  import { MEASURE_CATEGORY, MEASURE_SUBCATEGORY } from './measure-categories.js';
3
3
  import { MEASURE_ICON } from './measure-icon.js';
4
4
  import { MeasureValueType } from './measure-value-type.js';
5
- import { ATTRIBUTION_APPLICABLE_CONTEXTS, CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS, STANDARD_APPLICABLE_CONTEXTS, } from './measure-applicable-contexts.js';
5
+ import { EVENTS_ATTRIBUTION_APPLICABLE_CONTEXTS, CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS, STANDARD_APPLICABLE_CONTEXTS, } from './measure-applicable-contexts.js';
6
6
  export const CORE_MEASURES_MAP = {
7
7
  [MEASURE.CORE_CONVERSIONS]: {
8
8
  title: 'Conversions',
@@ -18,7 +18,7 @@ export const CORE_MEASURES_MAP = {
18
18
  valueType: MeasureValueType.NUMBER,
19
19
  decimalPlaces: 0,
20
20
  useCompactNotation: false,
21
- applicableContexts: ATTRIBUTION_APPLICABLE_CONTEXTS,
21
+ applicableContexts: EVENTS_ATTRIBUTION_APPLICABLE_CONTEXTS,
22
22
  tooltip: 'The number of conversion events attributed to your marketing touchpoints.',
23
23
  relatedMeasures: [MEASURE.CORE_CONVERSION_VALUE, MEASURE.CORE_UNIQUE_CONVERTERS, MEASURE.CORE_CPA],
24
24
  },
@@ -36,7 +36,7 @@ export const CORE_MEASURES_MAP = {
36
36
  valueType: MeasureValueType.CURRENCY,
37
37
  decimalPlaces: 2,
38
38
  useCompactNotation: true,
39
- applicableContexts: ATTRIBUTION_APPLICABLE_CONTEXTS,
39
+ applicableContexts: EVENTS_ATTRIBUTION_APPLICABLE_CONTEXTS,
40
40
  tooltip: 'The total monetary value of all attributed conversion events.',
41
41
  relatedMeasures: [MEASURE.CORE_CONVERSIONS, MEASURE.CORE_AVERAGE_CONVERSION_VALUE, MEASURE.CORE_ROAS_TOTAL],
42
42
  },
@@ -54,7 +54,7 @@ export const CORE_MEASURES_MAP = {
54
54
  valueType: MeasureValueType.NUMBER,
55
55
  decimalPlaces: 0,
56
56
  useCompactNotation: false,
57
- applicableContexts: ATTRIBUTION_APPLICABLE_CONTEXTS,
57
+ applicableContexts: EVENTS_ATTRIBUTION_APPLICABLE_CONTEXTS,
58
58
  tooltip: 'The number of distinct individuals who completed a conversion, regardless of how many times they converted.',
59
59
  relatedMeasures: [MEASURE.CORE_CONVERSIONS, MEASURE.CORE_CONVERSION_VALUE],
60
60
  },
@@ -73,7 +73,7 @@ export const CORE_MEASURES_MAP = {
73
73
  valueType: MeasureValueType.CURRENCY,
74
74
  decimalPlaces: 2,
75
75
  useCompactNotation: true,
76
- applicableContexts: ATTRIBUTION_APPLICABLE_CONTEXTS,
76
+ applicableContexts: EVENTS_ATTRIBUTION_APPLICABLE_CONTEXTS,
77
77
  tooltip: 'The average monetary value per conversion event.',
78
78
  formulaDisplay: 'Total Conversion Value ÷ Number of Conversions',
79
79
  formula: 'conversion_value / conversions',
@@ -161,49 +161,7 @@ export const CORE_MEASURES_MAP = {
161
161
  tooltip: 'What percentage of your revenue is spent on advertising. Lower is better—it means more revenue per ad dollar.',
162
162
  formulaDisplay: '(Total Ad Spend ÷ Total Revenue) × 100',
163
163
  formula: '(spend / total_revenue) * 100',
164
- relatedMeasures: [MEASURE.CORE_MER_NET, MEASURE.CORE_MER_GROSS, MEASURE.CORE_ROAS_TOTAL],
165
- },
166
- [MEASURE.CORE_MER_NET]: {
167
- title: 'MER (Net Sales)',
168
- shortTitle: 'MER Net',
169
- description: 'Marketing Efficiency Ratio using Net Sales.',
170
- sumPrefix: '',
171
- sumSuffix: '%',
172
- avgPrefix: '',
173
- avgSuffix: '%',
174
- icon: MEASURE_ICON.UPSTACK,
175
- measure: MEASURE.CORE_MER_NET,
176
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
177
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
178
- valueType: MeasureValueType.PERCENTAGE,
179
- decimalPlaces: 2,
180
- useCompactNotation: false,
181
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
182
- tooltip: 'What percentage of net sales (after discounts and refunds) is spent on advertising.',
183
- formulaDisplay: '(Total Ad Spend ÷ Net Sales) × 100',
184
- formula: '(spend / net_sales) * 100',
185
- relatedMeasures: [MEASURE.CORE_MER, MEASURE.CORE_MER_GROSS, MEASURE.CORE_ROAS_NET],
186
- },
187
- [MEASURE.CORE_MER_GROSS]: {
188
- title: 'MER (Gross Sales)',
189
- shortTitle: 'MER Gross',
190
- description: 'Marketing Efficiency Ratio using Gross Sales.',
191
- sumPrefix: '',
192
- sumSuffix: '%',
193
- avgPrefix: '',
194
- avgSuffix: '%',
195
- icon: MEASURE_ICON.UPSTACK,
196
- measure: MEASURE.CORE_MER_GROSS,
197
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
198
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
199
- valueType: MeasureValueType.PERCENTAGE,
200
- decimalPlaces: 2,
201
- useCompactNotation: false,
202
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
203
- tooltip: 'What percentage of gross sales (before discounts and refunds) is spent on advertising.',
204
- formulaDisplay: '(Total Ad Spend ÷ Gross Sales) × 100',
205
- formula: '(spend / gross_sales) * 100',
206
- relatedMeasures: [MEASURE.CORE_MER, MEASURE.CORE_MER_NET, MEASURE.CORE_ROAS_GROSS],
164
+ relatedMeasures: [MEASURE.CORE_ROAS_TOTAL],
207
165
  },
208
166
  [MEASURE.CORE_ROAS_TOTAL]: {
209
167
  title: 'Return on Ad Spend',
@@ -225,91 +183,7 @@ export const CORE_MEASURES_MAP = {
225
183
  tooltip: 'How much revenue you earn for every dollar spent on advertising. A 3x ROAS means $3 revenue per $1 spent.',
226
184
  formulaDisplay: 'Total Revenue ÷ Total Ad Spend',
227
185
  formula: 'total_revenue / spend',
228
- relatedMeasures: [MEASURE.CORE_ROAS_GROSS, MEASURE.CORE_ROAS_NET, MEASURE.CORE_CPA, MEASURE.CORE_MER],
229
- },
230
- [MEASURE.CORE_ROAS_GROSS]: {
231
- title: 'ROAS (Gross Sales)',
232
- shortTitle: 'ROAS Gross',
233
- description: 'Gross Sales divided by Total Ad Spend.',
234
- sumPrefix: '',
235
- sumSuffix: 'x',
236
- avgPrefix: '',
237
- avgSuffix: 'x',
238
- icon: MEASURE_ICON.UPSTACK,
239
- measure: MEASURE.CORE_ROAS_GROSS,
240
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
241
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
242
- valueType: MeasureValueType.MULTIPLIER,
243
- decimalPlaces: 2,
244
- useCompactNotation: false,
245
- applicableContexts: STANDARD_APPLICABLE_CONTEXTS,
246
- tooltip: 'Return on ad spend using gross sales (before discounts and refunds are applied).',
247
- formulaDisplay: 'Gross Sales ÷ Total Ad Spend',
248
- formula: 'gross_sales / spend',
249
- relatedMeasures: [MEASURE.CORE_ROAS_TOTAL, MEASURE.CORE_ROAS_NET, MEASURE.CORE_MER_GROSS],
250
- },
251
- [MEASURE.CORE_ROAS_NET]: {
252
- title: 'ROAS (Net Sales)',
253
- shortTitle: 'ROAS Net',
254
- description: 'Net Sales divided by Total Ad Spend.',
255
- sumPrefix: '',
256
- sumSuffix: 'x',
257
- avgPrefix: '',
258
- avgSuffix: 'x',
259
- icon: MEASURE_ICON.UPSTACK,
260
- measure: MEASURE.CORE_ROAS_NET,
261
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
262
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
263
- valueType: MeasureValueType.MULTIPLIER,
264
- decimalPlaces: 2,
265
- useCompactNotation: false,
266
- applicableContexts: STANDARD_APPLICABLE_CONTEXTS,
267
- tooltip: 'Return on ad spend using net sales (after discounts and refunds). Most accurate for true profitability.',
268
- formulaDisplay: 'Net Sales ÷ Total Ad Spend',
269
- formula: 'net_sales / spend',
270
- relatedMeasures: [MEASURE.CORE_ROAS_TOTAL, MEASURE.CORE_ROAS_GROSS, MEASURE.CORE_MER_NET],
271
- },
272
- [MEASURE.CORE_SPEND_GROSS_PERCENT]: {
273
- title: 'Ad Spend % of Gross Sales',
274
- shortTitle: 'Spend % Gross',
275
- description: 'The percentage of gross sales that were spent on ads.',
276
- sumPrefix: '',
277
- sumSuffix: '%',
278
- avgPrefix: '',
279
- avgSuffix: '%',
280
- icon: MEASURE_ICON.UPSTACK,
281
- measure: MEASURE.CORE_SPEND_GROSS_PERCENT,
282
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
283
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
284
- valueType: MeasureValueType.PERCENTAGE,
285
- decimalPlaces: 2,
286
- useCompactNotation: false,
287
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
288
- tooltip: 'What portion of your gross sales goes toward advertising costs. Lower is more efficient.',
289
- formulaDisplay: '(Ad Spend ÷ Gross Sales) × 100',
290
- formula: '(spend / gross_sales) * 100',
291
- relatedMeasures: [MEASURE.CORE_SPEND_NET_PERCENT, MEASURE.CORE_MER_GROSS],
292
- },
293
- [MEASURE.CORE_SPEND_NET_PERCENT]: {
294
- title: 'Ad Spend % of Net Sales',
295
- shortTitle: 'Spend % Net',
296
- description: 'The percentage of net sales that were spent on ads.',
297
- sumPrefix: '',
298
- sumSuffix: '%',
299
- avgPrefix: '',
300
- avgSuffix: '%',
301
- icon: MEASURE_ICON.UPSTACK,
302
- measure: MEASURE.CORE_SPEND_NET_PERCENT,
303
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
304
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
305
- valueType: MeasureValueType.PERCENTAGE,
306
- decimalPlaces: 2,
307
- useCompactNotation: false,
308
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
309
- tooltip: 'What portion of your net sales goes toward advertising costs. Lower is more efficient.',
310
- formulaDisplay: '(Ad Spend ÷ Net Sales) × 100',
311
- formula: '(spend / net_sales) * 100',
312
- relatedMeasures: [MEASURE.CORE_SPEND_GROSS_PERCENT, MEASURE.CORE_MER_NET],
186
+ relatedMeasures: [MEASURE.CORE_CPA, MEASURE.CORE_MER],
313
187
  },
314
188
  [MEASURE.CORE_RAAD]: {
315
189
  title: 'Revenue After Ad Spend',
@@ -330,49 +204,7 @@ export const CORE_MEASURES_MAP = {
330
204
  tooltip: 'Revenue remaining after subtracting advertising costs. A quick measure of marketing profitability.',
331
205
  formulaDisplay: 'Total Revenue − Ad Spend',
332
206
  formula: 'total_revenue - spend',
333
- relatedMeasures: [MEASURE.CORE_RAAD_GROSS, MEASURE.CORE_RAAD_NET, MEASURE.CORE_RAAD_TOTAL_PERCENT],
334
- },
335
- [MEASURE.CORE_RAAD_GROSS]: {
336
- title: 'RAAD (Gross Sales)',
337
- shortTitle: 'RAAD Gross',
338
- description: 'Gross Sales minus Ad Spend.',
339
- sumPrefix: '$',
340
- sumSuffix: '',
341
- avgPrefix: '$',
342
- avgSuffix: '',
343
- icon: MEASURE_ICON.UPSTACK,
344
- measure: MEASURE.CORE_RAAD_GROSS,
345
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
346
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
347
- valueType: MeasureValueType.CURRENCY,
348
- decimalPlaces: 2,
349
- useCompactNotation: true,
350
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
351
- tooltip: 'Gross sales remaining after subtracting advertising costs.',
352
- formulaDisplay: 'Gross Sales − Ad Spend',
353
- formula: 'gross_sales - spend',
354
- relatedMeasures: [MEASURE.CORE_RAAD, MEASURE.CORE_RAAD_NET, MEASURE.CORE_RAAD_GROSS_PERCENT],
355
- },
356
- [MEASURE.CORE_RAAD_NET]: {
357
- title: 'RAAD (Net Sales)',
358
- shortTitle: 'RAAD Net',
359
- description: 'Net Sales minus Ad Spend.',
360
- sumPrefix: '$',
361
- sumSuffix: '',
362
- avgPrefix: '$',
363
- avgSuffix: '',
364
- icon: MEASURE_ICON.UPSTACK,
365
- measure: MEASURE.CORE_RAAD_NET,
366
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
367
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
368
- valueType: MeasureValueType.CURRENCY,
369
- decimalPlaces: 2,
370
- useCompactNotation: true,
371
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
372
- tooltip: 'Net sales remaining after subtracting advertising costs. Most conservative RAAD calculation.',
373
- formulaDisplay: 'Net Sales − Ad Spend',
374
- formula: 'net_sales - spend',
375
- relatedMeasures: [MEASURE.CORE_RAAD, MEASURE.CORE_RAAD_GROSS, MEASURE.CORE_RAAD_NET_PERCENT],
207
+ relatedMeasures: [MEASURE.CORE_RAAD_TOTAL_PERCENT],
376
208
  },
377
209
  [MEASURE.CORE_RAAD_TOTAL_PERCENT]: {
378
210
  title: 'RAAD % of Total Revenue',
@@ -393,49 +225,7 @@ export const CORE_MEASURES_MAP = {
393
225
  tooltip: 'What percentage of total revenue remains after ad spend. Higher is better.',
394
226
  formulaDisplay: '(RAAD ÷ Total Revenue) × 100',
395
227
  formula: '(raad / total_revenue) * 100',
396
- relatedMeasures: [MEASURE.CORE_RAAD, MEASURE.CORE_RAAD_GROSS_PERCENT, MEASURE.CORE_RAAD_NET_PERCENT],
397
- },
398
- [MEASURE.CORE_RAAD_GROSS_PERCENT]: {
399
- title: 'RAAD % of Gross Sales',
400
- shortTitle: 'RAAD % Gross',
401
- description: 'RAAD as a percentage of Gross Sales.',
402
- sumPrefix: '',
403
- sumSuffix: '%',
404
- avgPrefix: '',
405
- avgSuffix: '%',
406
- icon: MEASURE_ICON.UPSTACK,
407
- measure: MEASURE.CORE_RAAD_GROSS_PERCENT,
408
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
409
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
410
- valueType: MeasureValueType.PERCENTAGE,
411
- decimalPlaces: 2,
412
- useCompactNotation: false,
413
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
414
- tooltip: 'What percentage of gross sales remains after ad spend.',
415
- formulaDisplay: '(RAAD Gross ÷ Gross Sales) × 100',
416
- formula: '(raad_gross / gross_sales) * 100',
417
- relatedMeasures: [MEASURE.CORE_RAAD_GROSS, MEASURE.CORE_RAAD_TOTAL_PERCENT, MEASURE.CORE_RAAD_NET_PERCENT],
418
- },
419
- [MEASURE.CORE_RAAD_NET_PERCENT]: {
420
- title: 'RAAD % of Net Sales',
421
- shortTitle: 'RAAD % Net',
422
- description: 'RAAD as a percentage of Net Sales.',
423
- sumPrefix: '',
424
- sumSuffix: '%',
425
- avgPrefix: '',
426
- avgSuffix: '%',
427
- icon: MEASURE_ICON.UPSTACK,
428
- measure: MEASURE.CORE_RAAD_NET_PERCENT,
429
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
430
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
431
- valueType: MeasureValueType.PERCENTAGE,
432
- decimalPlaces: 2,
433
- useCompactNotation: false,
434
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
435
- tooltip: 'What percentage of net sales remains after ad spend.',
436
- formulaDisplay: '(RAAD Net ÷ Net Sales) × 100',
437
- formula: '(raad_net / net_sales) * 100',
438
- relatedMeasures: [MEASURE.CORE_RAAD_NET, MEASURE.CORE_RAAD_TOTAL_PERCENT, MEASURE.CORE_RAAD_GROSS_PERCENT],
228
+ relatedMeasures: [MEASURE.CORE_RAAD],
439
229
  },
440
230
  [MEASURE.CORE_NEW_CUSTOMER_RAAD]: {
441
231
  title: 'New Customer Revenue After Ad Spend',
@@ -456,49 +246,7 @@ export const CORE_MEASURES_MAP = {
456
246
  tooltip: 'Revenue from new customers minus the ad spend to acquire them.',
457
247
  formulaDisplay: 'New Customer Revenue − Ad Spend',
458
248
  formula: 'nc_revenue - spend',
459
- relatedMeasures: [MEASURE.CORE_RAAD, MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS, MEASURE.CORE_NEW_CUSTOMER_RAAD_NET],
460
- },
461
- [MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS]: {
462
- title: 'NC RAAD (Gross Sales)',
463
- shortTitle: 'NC RAAD Gross',
464
- description: 'New Customer Gross Sales minus Ad Spend.',
465
- sumPrefix: '$',
466
- sumSuffix: '',
467
- avgPrefix: '$',
468
- avgSuffix: '',
469
- icon: MEASURE_ICON.UPSTACK,
470
- measure: MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS,
471
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
472
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
473
- valueType: MeasureValueType.CURRENCY,
474
- decimalPlaces: 2,
475
- useCompactNotation: true,
476
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
477
- tooltip: 'Gross sales from new customers minus ad spend.',
478
- formulaDisplay: 'NC Gross Sales − Ad Spend',
479
- formula: 'nc_gross_sales - spend',
480
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_RAAD, MEASURE.CORE_NEW_CUSTOMER_RAAD_NET],
481
- },
482
- [MEASURE.CORE_NEW_CUSTOMER_RAAD_NET]: {
483
- title: 'NC RAAD (Net Sales)',
484
- shortTitle: 'NC RAAD Net',
485
- description: 'New Customer Net Sales minus Ad Spend.',
486
- sumPrefix: '$',
487
- sumSuffix: '',
488
- avgPrefix: '$',
489
- avgSuffix: '',
490
- icon: MEASURE_ICON.UPSTACK,
491
- measure: MEASURE.CORE_NEW_CUSTOMER_RAAD_NET,
492
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
493
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
494
- valueType: MeasureValueType.CURRENCY,
495
- decimalPlaces: 2,
496
- useCompactNotation: true,
497
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
498
- tooltip: 'Net sales from new customers minus ad spend. Most conservative NC RAAD calculation.',
499
- formulaDisplay: 'NC Net Sales − Ad Spend',
500
- formula: 'nc_net_sales - spend',
501
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_RAAD, MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS],
249
+ relatedMeasures: [MEASURE.CORE_RAAD, MEASURE.CORE_NEW_CUSTOMER_RAAD_TOTAL_PERCENT],
502
250
  },
503
251
  [MEASURE.CORE_NEW_CUSTOMER_RAAD_TOTAL_PERCENT]: {
504
252
  title: 'NC RAAD % of Total Revenue',
@@ -521,48 +269,6 @@ export const CORE_MEASURES_MAP = {
521
269
  formula: '(nc_raad / total_revenue) * 100',
522
270
  relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_RAAD, MEASURE.CORE_RAAD_TOTAL_PERCENT],
523
271
  },
524
- [MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT]: {
525
- title: 'NC RAAD % of Gross Sales',
526
- shortTitle: 'NC RAAD % Gross',
527
- description: 'NC-RAAD as a percentage of Gross Sales.',
528
- sumPrefix: '',
529
- sumSuffix: '%',
530
- avgPrefix: '',
531
- avgSuffix: '%',
532
- icon: MEASURE_ICON.UPSTACK,
533
- measure: MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT,
534
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
535
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
536
- valueType: MeasureValueType.PERCENTAGE,
537
- decimalPlaces: 2,
538
- useCompactNotation: false,
539
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
540
- tooltip: 'What percentage of gross sales remains after new customer acquisition costs.',
541
- formulaDisplay: '(NC RAAD Gross ÷ Gross Sales) × 100',
542
- formula: '(nc_raad_gross / gross_sales) * 100',
543
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS, MEASURE.CORE_RAAD_GROSS_PERCENT],
544
- },
545
- [MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT]: {
546
- title: 'NC RAAD % of Net Sales',
547
- shortTitle: 'NC RAAD % Net',
548
- description: 'NC-RAAD as a percentage of Net Sales.',
549
- sumPrefix: '',
550
- sumSuffix: '%',
551
- avgPrefix: '',
552
- avgSuffix: '%',
553
- icon: MEASURE_ICON.UPSTACK,
554
- measure: MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT,
555
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
556
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
557
- valueType: MeasureValueType.PERCENTAGE,
558
- decimalPlaces: 2,
559
- useCompactNotation: false,
560
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
561
- tooltip: 'What percentage of net sales remains after new customer acquisition costs.',
562
- formulaDisplay: '(NC RAAD Net ÷ Net Sales) × 100',
563
- formula: '(nc_raad_net / net_sales) * 100',
564
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_RAAD_NET, MEASURE.CORE_RAAD_NET_PERCENT],
565
- },
566
272
  [MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL]: {
567
273
  title: 'New Customer Return on Ad Spend',
568
274
  shortTitle: 'NC ROAS',
@@ -583,49 +289,7 @@ export const CORE_MEASURES_MAP = {
583
289
  tooltip: 'Revenue from new customers per dollar spent on advertising. Key metric for customer acquisition efficiency.',
584
290
  formulaDisplay: 'New Customer Revenue ÷ Ad Spend',
585
291
  formula: 'nc_revenue / spend',
586
- relatedMeasures: [MEASURE.CORE_ROAS_TOTAL, MEASURE.CORE_NEW_CUSTOMER_CPA, MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS, MEASURE.CORE_NEW_CUSTOMER_ROAS_NET],
587
- },
588
- [MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS]: {
589
- title: 'NC ROAS (Gross Sales)',
590
- shortTitle: 'NC ROAS Gross',
591
- description: 'New Customer Gross Sales divided by Ad Spend.',
592
- sumPrefix: '',
593
- sumSuffix: 'x',
594
- avgPrefix: '',
595
- avgSuffix: 'x',
596
- icon: MEASURE_ICON.UPSTACK,
597
- measure: MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS,
598
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
599
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
600
- valueType: MeasureValueType.MULTIPLIER,
601
- decimalPlaces: 2,
602
- useCompactNotation: false,
603
- applicableContexts: STANDARD_APPLICABLE_CONTEXTS,
604
- tooltip: 'Gross sales from new customers per dollar spent on advertising.',
605
- formulaDisplay: 'NC Gross Sales ÷ Ad Spend',
606
- formula: 'nc_gross_sales / spend',
607
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL, MEASURE.CORE_NEW_CUSTOMER_ROAS_NET, MEASURE.CORE_ROAS_GROSS],
608
- },
609
- [MEASURE.CORE_NEW_CUSTOMER_ROAS_NET]: {
610
- title: 'NC ROAS (Net Sales)',
611
- shortTitle: 'NC ROAS Net',
612
- description: 'New Customer Net Sales divided by Ad Spend.',
613
- sumPrefix: '',
614
- sumSuffix: 'x',
615
- avgPrefix: '',
616
- avgSuffix: 'x',
617
- icon: MEASURE_ICON.UPSTACK,
618
- measure: MEASURE.CORE_NEW_CUSTOMER_ROAS_NET,
619
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
620
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
621
- valueType: MeasureValueType.MULTIPLIER,
622
- decimalPlaces: 2,
623
- useCompactNotation: false,
624
- applicableContexts: STANDARD_APPLICABLE_CONTEXTS,
625
- tooltip: 'Net sales from new customers per dollar spent on advertising. Most accurate for true acquisition profitability.',
626
- formulaDisplay: 'NC Net Sales ÷ Ad Spend',
627
- formula: 'nc_net_sales / spend',
628
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL, MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS, MEASURE.CORE_ROAS_NET],
292
+ relatedMeasures: [MEASURE.CORE_ROAS_TOTAL, MEASURE.CORE_NEW_CUSTOMER_CPA],
629
293
  },
630
294
  [MEASURE.CORE_NEW_CUSTOMER_MER]: {
631
295
  title: 'New Customer Marketing Efficiency Ratio',
@@ -646,383 +310,7 @@ export const CORE_MEASURES_MAP = {
646
310
  tooltip: 'What percentage of new customer revenue is spent on advertising. Lower is better.',
647
311
  formulaDisplay: '(Ad Spend ÷ NC Revenue) × 100',
648
312
  formula: '(spend / nc_revenue) * 100',
649
- relatedMeasures: [MEASURE.CORE_MER, MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL, MEASURE.CORE_NEW_CUSTOMER_MER_GROSS, MEASURE.CORE_NEW_CUSTOMER_MER_NET],
650
- },
651
- [MEASURE.CORE_NEW_CUSTOMER_MER_GROSS]: {
652
- title: 'NC MER (Gross Sales)',
653
- shortTitle: 'NC MER Gross',
654
- description: 'Marketing Efficiency Ratio using New Customer Gross Sales.',
655
- sumPrefix: '',
656
- sumSuffix: '%',
657
- avgPrefix: '',
658
- avgSuffix: '%',
659
- icon: MEASURE_ICON.UPSTACK,
660
- measure: MEASURE.CORE_NEW_CUSTOMER_MER_GROSS,
661
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
662
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
663
- valueType: MeasureValueType.PERCENTAGE,
664
- decimalPlaces: 2,
665
- useCompactNotation: false,
666
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
667
- tooltip: 'What percentage of new customer gross sales is spent on advertising.',
668
- formulaDisplay: '(Ad Spend ÷ NC Gross Sales) × 100',
669
- formula: '(spend / nc_gross_sales) * 100',
670
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_MER, MEASURE.CORE_NEW_CUSTOMER_MER_NET, MEASURE.CORE_MER_GROSS],
671
- },
672
- [MEASURE.CORE_NEW_CUSTOMER_MER_NET]: {
673
- title: 'NC MER (Net Sales)',
674
- shortTitle: 'NC MER Net',
675
- description: 'Marketing Efficiency Ratio using New Customer Net Sales.',
676
- sumPrefix: '',
677
- sumSuffix: '%',
678
- avgPrefix: '',
679
- avgSuffix: '%',
680
- icon: MEASURE_ICON.UPSTACK,
681
- measure: MEASURE.CORE_NEW_CUSTOMER_MER_NET,
682
- category: MEASURE_CATEGORY.AD_PERFORMANCE,
683
- subcategory: MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
684
- valueType: MeasureValueType.PERCENTAGE,
685
- decimalPlaces: 2,
686
- useCompactNotation: false,
687
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
688
- tooltip: 'What percentage of new customer net sales is spent on advertising.',
689
- formulaDisplay: '(Ad Spend ÷ NC Net Sales) × 100',
690
- formula: '(spend / nc_net_sales) * 100',
691
- relatedMeasures: [MEASURE.CORE_NEW_CUSTOMER_MER, MEASURE.CORE_NEW_CUSTOMER_MER_GROSS, MEASURE.CORE_MER_NET],
692
- },
693
- [MEASURE.CORE_EFFECTIVE_COGS]: {
694
- title: 'Effective Cost of Goods Sold',
695
- shortTitle: 'Effective COGS',
696
- description: 'Net Cost of Goods Sold (Orders COGS + Handling - Refund COGS).',
697
- sumPrefix: '$',
698
- sumSuffix: '',
699
- avgPrefix: '$',
700
- avgSuffix: '',
701
- icon: MEASURE_ICON.UPSTACK,
702
- measure: MEASURE.CORE_EFFECTIVE_COGS,
703
- category: MEASURE_CATEGORY.PROFITABILITY,
704
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
705
- valueType: MeasureValueType.CURRENCY,
706
- decimalPlaces: 2,
707
- useCompactNotation: true,
708
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
709
- tooltip: 'The true cost of products sold, accounting for returns and handling fees.',
710
- formulaDisplay: 'Orders COGS + Handling − Refund COGS',
711
- formula: 'orders_cogs + handling - refund_cogs',
712
- relatedMeasures: [MEASURE.CORE_EFFECTIVE_COGS_PERCENT, MEASURE.CORE_COGS_ORDERS, MEASURE.CORE_COGS_REFUNDS, MEASURE.CORE_GROSS_PROFIT],
713
- },
714
- [MEASURE.CORE_EFFECTIVE_COGS_PERCENT]: {
715
- title: 'Effective COGS %',
716
- shortTitle: 'COGS %',
717
- description: 'Effective COGS as a percentage of Net Sales.',
718
- sumPrefix: '',
719
- sumSuffix: '%',
720
- avgPrefix: '',
721
- avgSuffix: '%',
722
- icon: MEASURE_ICON.UPSTACK,
723
- measure: MEASURE.CORE_EFFECTIVE_COGS_PERCENT,
724
- category: MEASURE_CATEGORY.PROFITABILITY,
725
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
726
- valueType: MeasureValueType.PERCENTAGE,
727
- decimalPlaces: 2,
728
- useCompactNotation: false,
729
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
730
- tooltip: 'What percentage of net sales goes toward product costs. Lower means higher gross margins.',
731
- formulaDisplay: '(Effective COGS ÷ Net Sales) × 100',
732
- formula: '(effective_cogs / net_sales) * 100',
733
- relatedMeasures: [MEASURE.CORE_EFFECTIVE_COGS, MEASURE.CORE_GROSS_PROFIT_PERCENT],
734
- },
735
- [MEASURE.CORE_NEW_CUSTOMER_EFFECTIVE_COGS]: {
736
- title: 'New Customer Effective COGS',
737
- shortTitle: 'NC COGS',
738
- description: 'Effective COGS for new customer orders.',
739
- sumPrefix: '$',
740
- sumSuffix: '',
741
- avgPrefix: '$',
742
- avgSuffix: '',
743
- icon: MEASURE_ICON.UPSTACK,
744
- measure: MEASURE.CORE_NEW_CUSTOMER_EFFECTIVE_COGS,
745
- category: MEASURE_CATEGORY.PROFITABILITY,
746
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
747
- valueType: MeasureValueType.CURRENCY,
748
- decimalPlaces: 2,
749
- useCompactNotation: true,
750
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
751
- tooltip: 'Cost of goods sold for orders from first-time customers.',
752
- relatedMeasures: [MEASURE.CORE_EFFECTIVE_COGS, MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT],
753
- },
754
- [MEASURE.CORE_NEW_CUSTOMER_VARIABLE_COSTS]: {
755
- title: 'New Customer Variable Costs',
756
- shortTitle: 'NC Variable',
757
- description: 'Variable costs attributed to new customer orders.',
758
- sumPrefix: '$',
759
- sumSuffix: '',
760
- avgPrefix: '$',
761
- avgSuffix: '',
762
- icon: MEASURE_ICON.UPSTACK,
763
- measure: MEASURE.CORE_NEW_CUSTOMER_VARIABLE_COSTS,
764
- category: MEASURE_CATEGORY.PROFITABILITY,
765
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
766
- valueType: MeasureValueType.CURRENCY,
767
- decimalPlaces: 2,
768
- useCompactNotation: true,
769
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
770
- tooltip: 'Per-order variable expenses for new customer acquisitions.',
771
- relatedMeasures: [MEASURE.CORE_VARIABLE_COSTS, MEASURE.CORE_NEW_CUSTOMER_CM2],
772
- },
773
- [MEASURE.CORE_NEW_CUSTOMER_FIXED_COSTS]: {
774
- title: 'New Customer Fixed Costs',
775
- shortTitle: 'NC Fixed',
776
- description: 'Fixed costs attributed to new customer orders.',
777
- sumPrefix: '$',
778
- sumSuffix: '',
779
- avgPrefix: '$',
780
- avgSuffix: '',
781
- icon: MEASURE_ICON.UPSTACK,
782
- measure: MEASURE.CORE_NEW_CUSTOMER_FIXED_COSTS,
783
- category: MEASURE_CATEGORY.PROFITABILITY,
784
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
785
- valueType: MeasureValueType.CURRENCY,
786
- decimalPlaces: 2,
787
- useCompactNotation: true,
788
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
789
- tooltip: 'Allocated fixed expenses for new customer acquisitions.',
790
- relatedMeasures: [MEASURE.CORE_FIXED_COSTS, MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT],
791
- },
792
- [MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT]: {
793
- title: 'New Customer Gross Profit',
794
- shortTitle: 'NC Gross Profit',
795
- description: 'Gross profit from new customer orders (CM1).',
796
- sumPrefix: '$',
797
- sumSuffix: '',
798
- avgPrefix: '$',
799
- avgSuffix: '',
800
- icon: MEASURE_ICON.UPSTACK,
801
- measure: MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT,
802
- category: MEASURE_CATEGORY.PROFITABILITY,
803
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_GROSS_MARGIN,
804
- valueType: MeasureValueType.CURRENCY,
805
- decimalPlaces: 2,
806
- useCompactNotation: true,
807
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
808
- tooltip: 'Revenue from new customers minus their cost of goods. First level of contribution margin.',
809
- formulaDisplay: 'NC Net Sales − NC Effective COGS',
810
- formula: 'nc_net_sales - nc_effective_cogs',
811
- relatedMeasures: [MEASURE.CORE_GROSS_PROFIT, MEASURE.CORE_NEW_CUSTOMER_CM2],
812
- },
813
- [MEASURE.CORE_NEW_CUSTOMER_CM2]: {
814
- title: 'New Customer Contribution Margin 2',
815
- shortTitle: 'NC CM2',
816
- description: 'New customer gross profit minus shipping, gateway, and variable costs.',
817
- sumPrefix: '$',
818
- sumSuffix: '',
819
- avgPrefix: '$',
820
- avgSuffix: '',
821
- icon: MEASURE_ICON.UPSTACK,
822
- measure: MEASURE.CORE_NEW_CUSTOMER_CM2,
823
- category: MEASURE_CATEGORY.PROFITABILITY,
824
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
825
- valueType: MeasureValueType.CURRENCY,
826
- decimalPlaces: 2,
827
- useCompactNotation: true,
828
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
829
- tooltip: 'Profit from new customers after subtracting fulfillment and variable costs.',
830
- formulaDisplay: 'NC Gross Profit − Shipping − Gateway − Variable Costs',
831
- formula: 'nc_gross_profit - nc_shipping - nc_gateway - nc_variable_costs',
832
- relatedMeasures: [MEASURE.CORE_CM2, MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT, MEASURE.CORE_NEW_CUSTOMER_CM3],
833
- },
834
- [MEASURE.CORE_NEW_CUSTOMER_CM3]: {
835
- title: 'New Customer Contribution Margin 3',
836
- shortTitle: 'NC CM3',
837
- description: 'New customer CM2 minus blended ad spend.',
838
- sumPrefix: '$',
839
- sumSuffix: '',
840
- avgPrefix: '$',
841
- avgSuffix: '',
842
- icon: MEASURE_ICON.UPSTACK,
843
- measure: MEASURE.CORE_NEW_CUSTOMER_CM3,
844
- category: MEASURE_CATEGORY.PROFITABILITY,
845
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
846
- valueType: MeasureValueType.CURRENCY,
847
- decimalPlaces: 2,
848
- useCompactNotation: true,
849
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
850
- tooltip: 'Profit from new customers after subtracting all variable costs including advertising.',
851
- formulaDisplay: 'NC CM2 − NC Ad Spend',
852
- formula: 'nc_cm2 - nc_ad_spend',
853
- relatedMeasures: [MEASURE.CORE_CM3, MEASURE.CORE_NEW_CUSTOMER_CM2, MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT],
854
- },
855
- [MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT]: {
856
- title: 'New Customer Net Profit',
857
- shortTitle: 'NC Net Profit',
858
- description: 'New customer CM3 minus fixed expenses.',
859
- sumPrefix: '$',
860
- sumSuffix: '',
861
- avgPrefix: '$',
862
- avgSuffix: '',
863
- icon: MEASURE_ICON.UPSTACK,
864
- measure: MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT,
865
- category: MEASURE_CATEGORY.PROFITABILITY,
866
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_NET_PROFIT,
867
- valueType: MeasureValueType.CURRENCY,
868
- decimalPlaces: 2,
869
- useCompactNotation: true,
870
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
871
- tooltip: 'Final profit from new customer acquisitions after all costs.',
872
- formulaDisplay: 'NC CM3 − NC Fixed Costs',
873
- formula: 'nc_cm3 - nc_fixed_costs',
874
- relatedMeasures: [MEASURE.CORE_NET_PROFIT, MEASURE.CORE_NEW_CUSTOMER_CM3],
875
- },
876
- [MEASURE.CORE_COGS_ORDERS]: {
877
- title: 'COGS (Orders)',
878
- shortTitle: 'Order COGS',
879
- description: 'Cost of Goods Sold from orders.',
880
- sumPrefix: '$',
881
- sumSuffix: '',
882
- avgPrefix: '$',
883
- avgSuffix: '',
884
- icon: MEASURE_ICON.UPSTACK,
885
- measure: MEASURE.CORE_COGS_ORDERS,
886
- category: MEASURE_CATEGORY.PROFITABILITY,
887
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
888
- valueType: MeasureValueType.CURRENCY,
889
- decimalPlaces: 2,
890
- useCompactNotation: true,
891
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
892
- tooltip: 'Direct product costs for fulfilled orders before accounting for returns.',
893
- relatedMeasures: [MEASURE.CORE_COGS_REFUNDS, MEASURE.CORE_EFFECTIVE_COGS],
894
- },
895
- [MEASURE.CORE_COGS_REFUNDS]: {
896
- title: 'COGS (Refunds)',
897
- shortTitle: 'Refund COGS',
898
- description: 'Cost of Goods Sold recovered from refunds.',
899
- sumPrefix: '$',
900
- sumSuffix: '',
901
- avgPrefix: '$',
902
- avgSuffix: '',
903
- icon: MEASURE_ICON.UPSTACK,
904
- measure: MEASURE.CORE_COGS_REFUNDS,
905
- category: MEASURE_CATEGORY.PROFITABILITY,
906
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
907
- valueType: MeasureValueType.CURRENCY,
908
- decimalPlaces: 2,
909
- useCompactNotation: true,
910
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
911
- tooltip: 'Product costs recovered when orders are refunded.',
912
- relatedMeasures: [MEASURE.CORE_COGS_ORDERS, MEASURE.CORE_EFFECTIVE_COGS],
913
- },
914
- [MEASURE.CORE_VARIABLE_COSTS]: {
915
- title: 'Variable Costs',
916
- description: 'Total custom variable expenses (per-order fees, % of sales, etc.).',
917
- sumPrefix: '$',
918
- sumSuffix: '',
919
- avgPrefix: '$',
920
- avgSuffix: '',
921
- icon: MEASURE_ICON.UPSTACK,
922
- measure: MEASURE.CORE_VARIABLE_COSTS,
923
- category: MEASURE_CATEGORY.PROFITABILITY,
924
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
925
- valueType: MeasureValueType.CURRENCY,
926
- decimalPlaces: 2,
927
- useCompactNotation: true,
928
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
929
- tooltip: 'Costs that scale with order volume, such as transaction fees and fulfillment costs.',
930
- relatedMeasures: [MEASURE.CORE_VARIABLE_COSTS_PERCENT, MEASURE.CORE_FIXED_COSTS, MEASURE.CORE_CM2],
931
- },
932
- [MEASURE.CORE_VARIABLE_COSTS_PERCENT]: {
933
- title: 'Variable Costs %',
934
- description: 'Variable costs as a percentage of Net Sales.',
935
- sumPrefix: '',
936
- sumSuffix: '%',
937
- avgPrefix: '',
938
- avgSuffix: '%',
939
- icon: MEASURE_ICON.UPSTACK,
940
- measure: MEASURE.CORE_VARIABLE_COSTS_PERCENT,
941
- category: MEASURE_CATEGORY.PROFITABILITY,
942
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
943
- valueType: MeasureValueType.PERCENTAGE,
944
- decimalPlaces: 2,
945
- useCompactNotation: false,
946
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
947
- tooltip: 'What percentage of net sales goes toward variable costs.',
948
- formulaDisplay: '(Variable Costs ÷ Net Sales) × 100',
949
- formula: '(variable_costs / net_sales) * 100',
950
- relatedMeasures: [MEASURE.CORE_VARIABLE_COSTS, MEASURE.CORE_FIXED_COSTS_PERCENT],
951
- },
952
- [MEASURE.CORE_FIXED_COSTS]: {
953
- title: 'Fixed Costs',
954
- description: 'Total fixed expenses (rent, salaries, software, etc.).',
955
- sumPrefix: '$',
956
- sumSuffix: '',
957
- avgPrefix: '$',
958
- avgSuffix: '',
959
- icon: MEASURE_ICON.UPSTACK,
960
- measure: MEASURE.CORE_FIXED_COSTS,
961
- category: MEASURE_CATEGORY.PROFITABILITY,
962
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
963
- valueType: MeasureValueType.CURRENCY,
964
- decimalPlaces: 2,
965
- useCompactNotation: true,
966
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
967
- tooltip: 'Overhead costs that remain constant regardless of order volume.',
968
- relatedMeasures: [MEASURE.CORE_FIXED_COSTS_PERCENT, MEASURE.CORE_VARIABLE_COSTS, MEASURE.CORE_NET_PROFIT],
969
- },
970
- [MEASURE.CORE_FIXED_COSTS_PERCENT]: {
971
- title: 'Fixed Costs %',
972
- description: 'Fixed costs as a percentage of Net Sales.',
973
- sumPrefix: '',
974
- sumSuffix: '%',
975
- avgPrefix: '',
976
- avgSuffix: '%',
977
- icon: MEASURE_ICON.UPSTACK,
978
- measure: MEASURE.CORE_FIXED_COSTS_PERCENT,
979
- category: MEASURE_CATEGORY.PROFITABILITY,
980
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
981
- valueType: MeasureValueType.PERCENTAGE,
982
- decimalPlaces: 2,
983
- useCompactNotation: false,
984
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
985
- tooltip: 'What percentage of net sales goes toward fixed overhead costs.',
986
- formulaDisplay: '(Fixed Costs ÷ Net Sales) × 100',
987
- formula: '(fixed_costs / net_sales) * 100',
988
- relatedMeasures: [MEASURE.CORE_FIXED_COSTS, MEASURE.CORE_VARIABLE_COSTS_PERCENT],
989
- },
990
- [MEASURE.CORE_SHIPPING_COSTS]: {
991
- title: 'Shipping Costs',
992
- description: 'Seller-side shipping expenses.',
993
- sumPrefix: '$',
994
- sumSuffix: '',
995
- avgPrefix: '$',
996
- avgSuffix: '',
997
- icon: MEASURE_ICON.UPSTACK,
998
- measure: MEASURE.CORE_SHIPPING_COSTS,
999
- category: MEASURE_CATEGORY.PROFITABILITY,
1000
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
1001
- valueType: MeasureValueType.CURRENCY,
1002
- decimalPlaces: 2,
1003
- useCompactNotation: true,
1004
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1005
- tooltip: 'What you pay to ship orders to customers (not what customers pay for shipping).',
1006
- relatedMeasures: [MEASURE.CORE_CM2, MEASURE.CORE_VARIABLE_COSTS],
1007
- },
1008
- [MEASURE.CORE_PAYMENT_GATEWAY_COSTS]: {
1009
- title: 'Payment Gateway Costs',
1010
- shortTitle: 'Gateway Costs',
1011
- description: 'Payment processing fees (flat + percentage per gateway).',
1012
- sumPrefix: '$',
1013
- sumSuffix: '',
1014
- avgPrefix: '$',
1015
- avgSuffix: '',
1016
- icon: MEASURE_ICON.UPSTACK,
1017
- measure: MEASURE.CORE_PAYMENT_GATEWAY_COSTS,
1018
- category: MEASURE_CATEGORY.PROFITABILITY,
1019
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
1020
- valueType: MeasureValueType.CURRENCY,
1021
- decimalPlaces: 2,
1022
- useCompactNotation: true,
1023
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1024
- tooltip: 'Transaction fees paid to payment processors like Stripe, PayPal, or Shopify Payments.',
1025
- relatedMeasures: [MEASURE.CORE_CM2, MEASURE.CORE_VARIABLE_COSTS],
313
+ relatedMeasures: [MEASURE.CORE_MER, MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL],
1026
314
  },
1027
315
  [MEASURE.CORE_VARIABLE_AD_SPEND]: {
1028
316
  title: 'Variable Ad Spend',
@@ -1098,174 +386,7 @@ export const CORE_MEASURES_MAP = {
1098
386
  tooltip: 'Your total advertising investment across all channels including custom entries.',
1099
387
  formulaDisplay: 'Channel Spend + Custom Ad Spend',
1100
388
  formula: 'channel_spend + custom_ad_spend',
1101
- relatedMeasures: [MEASURE.CHANNEL_SPEND, MEASURE.CORE_CUSTOM_AD_SPEND, MEASURE.CORE_CM3],
1102
- },
1103
- [MEASURE.CORE_GROSS_PROFIT]: {
1104
- title: 'Gross Profit',
1105
- shortTitle: 'Gross Profit',
1106
- description: 'Net Sales minus Effective COGS. Also known as Contribution Margin 1 (CM1).',
1107
- sumPrefix: '$',
1108
- sumSuffix: '',
1109
- avgPrefix: '$',
1110
- avgSuffix: '',
1111
- icon: MEASURE_ICON.UPSTACK,
1112
- measure: MEASURE.CORE_GROSS_PROFIT,
1113
- category: MEASURE_CATEGORY.PROFITABILITY,
1114
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_GROSS_MARGIN,
1115
- valueType: MeasureValueType.CURRENCY,
1116
- decimalPlaces: 2,
1117
- useCompactNotation: true,
1118
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1119
- tooltip: 'Revenue remaining after product costs. The first level of contribution margin.',
1120
- formulaDisplay: 'Net Sales − Effective COGS',
1121
- formula: 'net_sales - effective_cogs',
1122
- relatedMeasures: [MEASURE.CORE_GROSS_PROFIT_PERCENT, MEASURE.CORE_EFFECTIVE_COGS, MEASURE.CORE_CM2],
1123
- },
1124
- [MEASURE.CORE_GROSS_PROFIT_PERCENT]: {
1125
- title: 'Gross Profit Margin',
1126
- shortTitle: 'Gross Margin',
1127
- description: 'Gross Profit as a percentage of Net Sales.',
1128
- sumPrefix: '',
1129
- sumSuffix: '%',
1130
- avgPrefix: '',
1131
- avgSuffix: '%',
1132
- icon: MEASURE_ICON.UPSTACK,
1133
- measure: MEASURE.CORE_GROSS_PROFIT_PERCENT,
1134
- category: MEASURE_CATEGORY.PROFITABILITY,
1135
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_GROSS_MARGIN,
1136
- valueType: MeasureValueType.PERCENTAGE,
1137
- decimalPlaces: 2,
1138
- useCompactNotation: false,
1139
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1140
- tooltip: 'What percentage of net sales remains after product costs. Higher is better.',
1141
- formulaDisplay: '(Gross Profit ÷ Net Sales) × 100',
1142
- formula: '(gross_profit / net_sales) * 100',
1143
- relatedMeasures: [MEASURE.CORE_GROSS_PROFIT, MEASURE.CORE_CM2_PERCENT, MEASURE.CORE_NET_PROFIT_PERCENT],
1144
- },
1145
- [MEASURE.CORE_CM2]: {
1146
- title: 'Contribution Margin 2',
1147
- shortTitle: 'CM2',
1148
- description: 'Gross Profit minus shipping, gateway, and variable costs.',
1149
- sumPrefix: '$',
1150
- sumSuffix: '',
1151
- avgPrefix: '$',
1152
- avgSuffix: '',
1153
- icon: MEASURE_ICON.UPSTACK,
1154
- measure: MEASURE.CORE_CM2,
1155
- category: MEASURE_CATEGORY.PROFITABILITY,
1156
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
1157
- valueType: MeasureValueType.CURRENCY,
1158
- decimalPlaces: 2,
1159
- useCompactNotation: true,
1160
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1161
- tooltip: 'Profit after deducting fulfillment and variable operating costs.',
1162
- formulaDisplay: 'Gross Profit − Shipping − Gateway − Variable Costs',
1163
- formula: 'gross_profit - shipping - gateway - variable_costs',
1164
- relatedMeasures: [MEASURE.CORE_GROSS_PROFIT, MEASURE.CORE_CM2_PERCENT, MEASURE.CORE_CM3],
1165
- },
1166
- [MEASURE.CORE_CM2_PERCENT]: {
1167
- title: 'CM2 Margin',
1168
- shortTitle: 'CM2 %',
1169
- description: 'CM2 as a percentage of Net Sales.',
1170
- sumPrefix: '',
1171
- sumSuffix: '%',
1172
- avgPrefix: '',
1173
- avgSuffix: '%',
1174
- icon: MEASURE_ICON.UPSTACK,
1175
- measure: MEASURE.CORE_CM2_PERCENT,
1176
- category: MEASURE_CATEGORY.PROFITABILITY,
1177
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
1178
- valueType: MeasureValueType.PERCENTAGE,
1179
- decimalPlaces: 2,
1180
- useCompactNotation: false,
1181
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1182
- tooltip: 'What percentage of net sales remains after product and variable costs.',
1183
- formulaDisplay: '(CM2 ÷ Net Sales) × 100',
1184
- formula: '(cm2 / net_sales) * 100',
1185
- relatedMeasures: [MEASURE.CORE_CM2, MEASURE.CORE_GROSS_PROFIT_PERCENT, MEASURE.CORE_CM3_PERCENT],
1186
- },
1187
- [MEASURE.CORE_CM3]: {
1188
- title: 'Contribution Margin 3',
1189
- shortTitle: 'CM3',
1190
- description: 'CM2 minus blended ad spend.',
1191
- sumPrefix: '$',
1192
- sumSuffix: '',
1193
- avgPrefix: '$',
1194
- avgSuffix: '',
1195
- icon: MEASURE_ICON.UPSTACK,
1196
- measure: MEASURE.CORE_CM3,
1197
- category: MEASURE_CATEGORY.PROFITABILITY,
1198
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
1199
- valueType: MeasureValueType.CURRENCY,
1200
- decimalPlaces: 2,
1201
- useCompactNotation: true,
1202
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1203
- tooltip: 'Profit after all variable costs including advertising. Key metric for marketing profitability.',
1204
- formulaDisplay: 'CM2 − Blended Ad Spend',
1205
- formula: 'cm2 - blended_ad_spend',
1206
- relatedMeasures: [MEASURE.CORE_CM2, MEASURE.CORE_BLENDED_AD_SPEND, MEASURE.CORE_CM3_PERCENT, MEASURE.CORE_NET_PROFIT],
1207
- },
1208
- [MEASURE.CORE_CM3_PERCENT]: {
1209
- title: 'CM3 Margin',
1210
- shortTitle: 'CM3 %',
1211
- description: 'CM3 as a percentage of Net Sales.',
1212
- sumPrefix: '',
1213
- sumSuffix: '%',
1214
- avgPrefix: '',
1215
- avgSuffix: '%',
1216
- icon: MEASURE_ICON.UPSTACK,
1217
- measure: MEASURE.CORE_CM3_PERCENT,
1218
- category: MEASURE_CATEGORY.PROFITABILITY,
1219
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
1220
- valueType: MeasureValueType.PERCENTAGE,
1221
- decimalPlaces: 2,
1222
- useCompactNotation: false,
1223
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1224
- tooltip: 'What percentage of net sales remains after all variable costs including advertising.',
1225
- formulaDisplay: '(CM3 ÷ Net Sales) × 100',
1226
- formula: '(cm3 / net_sales) * 100',
1227
- relatedMeasures: [MEASURE.CORE_CM3, MEASURE.CORE_CM2_PERCENT, MEASURE.CORE_NET_PROFIT_PERCENT],
1228
- },
1229
- [MEASURE.CORE_NET_PROFIT]: {
1230
- title: 'Net Profit',
1231
- description: 'CM3 minus fixed expenses. Your bottom line.',
1232
- sumPrefix: '$',
1233
- sumSuffix: '',
1234
- avgPrefix: '$',
1235
- avgSuffix: '',
1236
- icon: MEASURE_ICON.UPSTACK,
1237
- measure: MEASURE.CORE_NET_PROFIT,
1238
- category: MEASURE_CATEGORY.PROFITABILITY,
1239
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_NET_PROFIT,
1240
- valueType: MeasureValueType.CURRENCY,
1241
- decimalPlaces: 2,
1242
- useCompactNotation: true,
1243
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1244
- tooltip: 'Your final profit after all costs. The true measure of business profitability.',
1245
- formulaDisplay: 'CM3 − Fixed Costs',
1246
- formula: 'cm3 - fixed_costs',
1247
- relatedMeasures: [MEASURE.CORE_CM3, MEASURE.CORE_FIXED_COSTS, MEASURE.CORE_NET_PROFIT_PERCENT],
1248
- },
1249
- [MEASURE.CORE_NET_PROFIT_PERCENT]: {
1250
- title: 'Net Profit Margin',
1251
- shortTitle: 'Net Margin',
1252
- description: 'Net Profit as a percentage of Net Sales.',
1253
- sumPrefix: '',
1254
- sumSuffix: '%',
1255
- avgPrefix: '',
1256
- avgSuffix: '%',
1257
- icon: MEASURE_ICON.UPSTACK,
1258
- measure: MEASURE.CORE_NET_PROFIT_PERCENT,
1259
- category: MEASURE_CATEGORY.PROFITABILITY,
1260
- subcategory: MEASURE_SUBCATEGORY.PROFITABILITY_NET_PROFIT,
1261
- valueType: MeasureValueType.PERCENTAGE,
1262
- decimalPlaces: 2,
1263
- useCompactNotation: false,
1264
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1265
- tooltip: 'What percentage of net sales becomes profit. The ultimate efficiency metric.',
1266
- formulaDisplay: '(Net Profit ÷ Net Sales) × 100',
1267
- formula: '(net_profit / net_sales) * 100',
1268
- relatedMeasures: [MEASURE.CORE_NET_PROFIT, MEASURE.CORE_CM3_PERCENT, MEASURE.CORE_GROSS_PROFIT_PERCENT],
389
+ relatedMeasures: [MEASURE.CHANNEL_SPEND, MEASURE.CORE_CUSTOM_AD_SPEND],
1269
390
  },
1270
391
  };
1271
392
  //# sourceMappingURL=core-measure-definitions.js.map