@adtrackify/at-tracking-event-types 4.41.0 → 4.42.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 (69) hide show
  1. package/dist/cjs/types/api/measures/definitions/channel-measure-definitions.js +765 -220
  2. package/dist/cjs/types/api/measures/definitions/channel-measure-definitions.js.map +1 -1
  3. package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js +557 -225
  4. package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js.map +1 -1
  5. package/dist/cjs/types/api/measures/definitions/emq-measure-definitions.js +94 -32
  6. package/dist/cjs/types/api/measures/definitions/emq-measure-definitions.js.map +1 -1
  7. package/dist/cjs/types/api/measures/definitions/facebook-measure-definitions.js +649 -201
  8. package/dist/cjs/types/api/measures/definitions/facebook-measure-definitions.js.map +1 -1
  9. package/dist/cjs/types/api/measures/definitions/google-measure-definitions.js +143 -42
  10. package/dist/cjs/types/api/measures/definitions/google-measure-definitions.js.map +1 -1
  11. package/dist/cjs/types/api/measures/definitions/index.d.ts +1 -0
  12. package/dist/cjs/types/api/measures/definitions/index.js +1 -0
  13. package/dist/cjs/types/api/measures/definitions/index.js.map +1 -1
  14. package/dist/cjs/types/api/measures/definitions/measure-categories.d.ts +47 -0
  15. package/dist/cjs/types/api/measures/definitions/measure-categories.js +49 -1
  16. package/dist/cjs/types/api/measures/definitions/measure-categories.js.map +1 -1
  17. package/dist/cjs/types/api/measures/definitions/measure-definitions.d.ts +15 -4
  18. package/dist/cjs/types/api/measures/definitions/measure-definitions.js +3 -1
  19. package/dist/cjs/types/api/measures/definitions/measure-definitions.js.map +1 -1
  20. package/dist/cjs/types/api/measures/definitions/measure-icon.d.ts +7 -0
  21. package/dist/cjs/types/api/measures/definitions/measure-icon.js +12 -0
  22. package/dist/cjs/types/api/measures/definitions/measure-icon.js.map +1 -0
  23. package/dist/cjs/types/api/measures/definitions/orders-measure-definitions.js +973 -276
  24. package/dist/cjs/types/api/measures/definitions/orders-measure-definitions.js.map +1 -1
  25. package/dist/cjs/types/api/measures/definitions/session-measure-definitions.js +136 -48
  26. package/dist/cjs/types/api/measures/definitions/session-measure-definitions.js.map +1 -1
  27. package/dist/cjs/types/api/measures/definitions/shopify/shopify-measure-definitions.js +248 -57
  28. package/dist/cjs/types/api/measures/definitions/shopify/shopify-measure-definitions.js.map +1 -1
  29. package/dist/cjs/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js +124 -29
  30. package/dist/cjs/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js.map +1 -1
  31. package/dist/cjs/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js +130 -29
  32. package/dist/cjs/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js.map +1 -1
  33. package/dist/cjs/types/api/measures/definitions/tracked-measure-definitions.js +317 -102
  34. package/dist/cjs/types/api/measures/definitions/tracked-measure-definitions.js.map +1 -1
  35. package/dist/esm/types/api/measures/definitions/channel-measure-definitions.js +766 -221
  36. package/dist/esm/types/api/measures/definitions/channel-measure-definitions.js.map +1 -1
  37. package/dist/esm/types/api/measures/definitions/core-measure-definitions.js +558 -226
  38. package/dist/esm/types/api/measures/definitions/core-measure-definitions.js.map +1 -1
  39. package/dist/esm/types/api/measures/definitions/emq-measure-definitions.js +95 -33
  40. package/dist/esm/types/api/measures/definitions/emq-measure-definitions.js.map +1 -1
  41. package/dist/esm/types/api/measures/definitions/facebook-measure-definitions.js +650 -202
  42. package/dist/esm/types/api/measures/definitions/facebook-measure-definitions.js.map +1 -1
  43. package/dist/esm/types/api/measures/definitions/google-measure-definitions.js +144 -43
  44. package/dist/esm/types/api/measures/definitions/google-measure-definitions.js.map +1 -1
  45. package/dist/esm/types/api/measures/definitions/index.d.ts +1 -0
  46. package/dist/esm/types/api/measures/definitions/index.js +1 -0
  47. package/dist/esm/types/api/measures/definitions/index.js.map +1 -1
  48. package/dist/esm/types/api/measures/definitions/measure-categories.d.ts +47 -0
  49. package/dist/esm/types/api/measures/definitions/measure-categories.js +48 -0
  50. package/dist/esm/types/api/measures/definitions/measure-categories.js.map +1 -1
  51. package/dist/esm/types/api/measures/definitions/measure-definitions.d.ts +15 -4
  52. package/dist/esm/types/api/measures/definitions/measure-definitions.js +1 -0
  53. package/dist/esm/types/api/measures/definitions/measure-definitions.js.map +1 -1
  54. package/dist/esm/types/api/measures/definitions/measure-icon.d.ts +7 -0
  55. package/dist/esm/types/api/measures/definitions/measure-icon.js +9 -0
  56. package/dist/esm/types/api/measures/definitions/measure-icon.js.map +1 -0
  57. package/dist/esm/types/api/measures/definitions/orders-measure-definitions.js +974 -277
  58. package/dist/esm/types/api/measures/definitions/orders-measure-definitions.js.map +1 -1
  59. package/dist/esm/types/api/measures/definitions/session-measure-definitions.js +137 -49
  60. package/dist/esm/types/api/measures/definitions/session-measure-definitions.js.map +1 -1
  61. package/dist/esm/types/api/measures/definitions/shopify/shopify-measure-definitions.js +249 -58
  62. package/dist/esm/types/api/measures/definitions/shopify/shopify-measure-definitions.js.map +1 -1
  63. package/dist/esm/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js +125 -30
  64. package/dist/esm/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js.map +1 -1
  65. package/dist/esm/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js +131 -30
  66. package/dist/esm/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js.map +1 -1
  67. package/dist/esm/types/api/measures/definitions/tracked-measure-definitions.js +318 -103
  68. package/dist/esm/types/api/measures/definitions/tracked-measure-definitions.js.map +1 -1
  69. package/package.json +1 -1
package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js CHANGED
@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.CORE_MEASURES_MAP = void 0;
4
4
  const measures_js_1 = require("../measures.js");
5
5
  const measure_categories_js_1 = require("./measure-categories.js");
6
+ const measure_icon_js_1 = require("./measure-icon.js");
6
7
  const measure_value_type_js_1 = require("./measure-value-type.js");
7
8
  const measure_applicable_contexts_js_1 = require("./measure-applicable-contexts.js");
8
9
  exports.CORE_MEASURES_MAP = {
@@ -13,13 +14,16 @@ exports.CORE_MEASURES_MAP = {
13
14
  sumSuffix: '',
14
15
  avgPrefix: '',
15
16
  avgSuffix: '',
16
- icon: 'upstack',
17
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
17
18
  measure: measures_js_1.MEASURE.CORE_CONVERSIONS,
18
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
19
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
20
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
19
21
  valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
20
22
  decimalPlaces: 0,
21
23
  useCompactNotation: false,
22
24
  applicableContexts: measure_applicable_contexts_js_1.ATTRIBUTION_APPLICABLE_CONTEXTS,
25
+ tooltip: 'The number of conversion events attributed to your marketing touchpoints.',
26
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CONVERSION_VALUE, measures_js_1.MEASURE.CORE_UNIQUE_CONVERTERS, measures_js_1.MEASURE.CORE_CPA],
23
27
  },
24
28
  [measures_js_1.MEASURE.CORE_CONVERSION_VALUE]: {
25
29
  title: 'Conversion Value',
@@ -28,13 +32,16 @@ exports.CORE_MEASURES_MAP = {
28
32
  sumSuffix: '',
29
33
  avgPrefix: '$',
30
34
  avgSuffix: '',
31
- icon: 'upstack',
35
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
32
36
  measure: measures_js_1.MEASURE.CORE_CONVERSION_VALUE,
33
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
37
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
38
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
34
39
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
35
40
  decimalPlaces: 2,
36
41
  useCompactNotation: true,
37
42
  applicableContexts: measure_applicable_contexts_js_1.ATTRIBUTION_APPLICABLE_CONTEXTS,
43
+ tooltip: 'The total monetary value of all attributed conversion events.',
44
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CONVERSIONS, measures_js_1.MEASURE.CORE_AVERAGE_CONVERSION_VALUE, measures_js_1.MEASURE.CORE_ROAS_TOTAL],
38
45
  },
39
46
  [measures_js_1.MEASURE.CORE_UNIQUE_CONVERTERS]: {
40
47
  title: 'Unique Converters',
@@ -43,900 +50,1225 @@ exports.CORE_MEASURES_MAP = {
43
50
  sumSuffix: '',
44
51
  avgPrefix: '',
45
52
  avgSuffix: '',
46
- icon: 'upstack',
53
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
47
54
  measure: measures_js_1.MEASURE.CORE_UNIQUE_CONVERTERS,
48
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
55
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
56
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
49
57
  valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
50
58
  decimalPlaces: 0,
51
59
  useCompactNotation: false,
52
60
  applicableContexts: measure_applicable_contexts_js_1.ATTRIBUTION_APPLICABLE_CONTEXTS,
61
+ tooltip: 'The number of distinct individuals who completed a conversion, regardless of how many times they converted.',
62
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CONVERSIONS, measures_js_1.MEASURE.CORE_CONVERSION_VALUE],
53
63
  },
54
64
  [measures_js_1.MEASURE.CORE_AVERAGE_CONVERSION_VALUE]: {
55
- title: 'Avg Conversion Value',
65
+ title: 'Average Conversion Value',
66
+ shortTitle: 'Avg Conv Value',
56
67
  description: 'Average value per conversion.',
57
68
  sumPrefix: '$',
58
69
  sumSuffix: '',
59
70
  avgPrefix: '$',
60
71
  avgSuffix: '',
61
- icon: 'upstack',
72
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
62
73
  measure: measures_js_1.MEASURE.CORE_AVERAGE_CONVERSION_VALUE,
63
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
74
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
75
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
64
76
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
65
77
  decimalPlaces: 2,
66
78
  useCompactNotation: true,
67
79
  applicableContexts: measure_applicable_contexts_js_1.ATTRIBUTION_APPLICABLE_CONTEXTS,
80
+ tooltip: 'The average monetary value per conversion event.',
81
+ formulaDisplay: 'Total Conversion Value ÷ Number of Conversions',
82
+ formula: 'conversion_value / conversions',
83
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CONVERSION_VALUE, measures_js_1.MEASURE.CORE_CONVERSIONS],
68
84
  },
69
85
  [measures_js_1.MEASURE.CORE_CPA]: {
70
- title: 'CPA: (Cost Per Acquisition)',
71
- description: 'The amount spent per acquisition. (Total Amount Spent / # Conversions)',
86
+ title: 'Cost Per Acquisition',
87
+ shortTitle: 'CPA',
88
+ description: 'The amount spent per acquisition.',
72
89
  sumPrefix: '$',
73
90
  sumSuffix: '',
74
91
  avgPrefix: '$',
75
92
  avgSuffix: '',
76
- icon: 'upstack',
93
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
77
94
  measure: measures_js_1.MEASURE.CORE_CPA,
78
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
95
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
96
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
79
97
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
80
98
  decimalPlaces: 2,
81
99
  useCompactNotation: true,
82
100
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
101
+ tooltip: 'How much you spend on average to acquire each customer. Lower is better.',
102
+ formulaDisplay: 'Total Ad Spend ÷ Conversions',
103
+ formula: 'spend / conversions',
104
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA, measures_js_1.MEASURE.CORE_RETURNING_CUSTOMER_CPA, measures_js_1.MEASURE.CORE_ROAS_TOTAL, measures_js_1.MEASURE.CHANNEL_SPEND],
83
105
  },
84
106
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA]: {
85
- title: 'NCPA: (New Customer Cost Per Acquisition)',
86
- description: 'The amount spent per new customer acquisition. (Total Amount Spent / # New Customer Conversions)',
107
+ title: 'New Customer Cost Per Acquisition',
108
+ shortTitle: 'NC CPA',
109
+ description: 'The amount spent per new customer acquisition.',
87
110
  sumPrefix: '$',
88
111
  sumSuffix: '',
89
112
  avgPrefix: '$',
90
113
  avgSuffix: '',
91
- icon: 'upstack',
114
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
92
115
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA,
93
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
116
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
117
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
94
118
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
95
119
  decimalPlaces: 2,
96
120
  useCompactNotation: true,
97
121
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
122
+ tooltip: 'How much you spend to acquire each first-time customer. Critical for understanding customer acquisition efficiency.',
123
+ formulaDisplay: 'Total Ad Spend ÷ New Customer Conversions',
124
+ formula: 'spend / new_customer_conversions',
125
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CPA, measures_js_1.MEASURE.CORE_RETURNING_CUSTOMER_CPA, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL],
98
126
  },
99
127
  [measures_js_1.MEASURE.CORE_RETURNING_CUSTOMER_CPA]: {
100
- title: 'RCPA: (Returning Customer Cost Per Acquisition)',
101
- description: 'The amount spent per returning customer acquisition. (Total Amount Spent / # Returning Customer Conversions)',
128
+ title: 'Returning Customer Cost Per Acquisition',
129
+ shortTitle: 'RC CPA',
130
+ description: 'The amount spent per returning customer acquisition.',
102
131
  sumPrefix: '$',
103
132
  sumSuffix: '',
104
133
  avgPrefix: '$',
105
134
  avgSuffix: '',
106
- icon: 'upstack',
135
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
107
136
  measure: measures_js_1.MEASURE.CORE_RETURNING_CUSTOMER_CPA,
108
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
137
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
138
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
109
139
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
110
140
  decimalPlaces: 2,
111
141
  useCompactNotation: true,
112
142
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
143
+ tooltip: 'How much you spend to bring back each returning customer. Useful for measuring retention campaign efficiency.',
144
+ formulaDisplay: 'Total Ad Spend ÷ Returning Customer Conversions',
145
+ formula: 'spend / returning_customer_conversions',
146
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CPA, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA],
113
147
  },
114
148
  [measures_js_1.MEASURE.CORE_MER]: {
115
- title: 'MER (Marketing Efficiency Ratio)',
116
- description: 'Marketing Efficiency Ratio using Total Revenue. (Total Ad Spend / Total Revenue) * 100',
149
+ title: 'Marketing Efficiency Ratio',
150
+ shortTitle: 'MER',
151
+ description: 'Marketing Efficiency Ratio using Total Revenue.',
117
152
  sumPrefix: '',
118
153
  sumSuffix: '%',
119
154
  avgPrefix: '',
120
155
  avgSuffix: '%',
121
- icon: 'upstack',
156
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
122
157
  measure: measures_js_1.MEASURE.CORE_MER,
123
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
158
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
159
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
124
160
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
125
161
  decimalPlaces: 2,
126
162
  useCompactNotation: false,
127
163
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
164
+ tooltip: 'What percentage of your revenue is spent on advertising. Lower is better—it means more revenue per ad dollar.',
165
+ formulaDisplay: '(Total Ad Spend ÷ Total Revenue) × 100',
166
+ formula: '(spend / total_revenue) * 100',
167
+ relatedMeasures: [measures_js_1.MEASURE.CORE_MER_NET, measures_js_1.MEASURE.CORE_MER_GROSS, measures_js_1.MEASURE.CORE_ROAS_TOTAL],
128
168
  },
129
169
  [measures_js_1.MEASURE.CORE_MER_NET]: {
130
- title: 'MER (Net Sales): Marketing Efficiency Ratio using Net Sales',
131
- description: 'Marketing Efficiency Ratio using Net Sales. (Total Ad Spend / Net Sales) * 100',
170
+ title: 'MER (Net Sales)',
171
+ shortTitle: 'MER Net',
172
+ description: 'Marketing Efficiency Ratio using Net Sales.',
132
173
  sumPrefix: '',
133
174
  sumSuffix: '%',
134
175
  avgPrefix: '',
135
176
  avgSuffix: '%',
136
- icon: 'upstack',
177
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
137
178
  measure: measures_js_1.MEASURE.CORE_MER_NET,
138
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
179
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
180
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
139
181
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
140
182
  decimalPlaces: 2,
141
183
  useCompactNotation: false,
142
184
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
185
+ tooltip: 'What percentage of net sales (after discounts and refunds) is spent on advertising.',
186
+ formulaDisplay: '(Total Ad Spend ÷ Net Sales) × 100',
187
+ formula: '(spend / net_sales) * 100',
188
+ relatedMeasures: [measures_js_1.MEASURE.CORE_MER, measures_js_1.MEASURE.CORE_MER_GROSS, measures_js_1.MEASURE.CORE_ROAS_NET],
143
189
  },
144
190
  [measures_js_1.MEASURE.CORE_MER_GROSS]: {
145
- title: 'MER (Gross Sales): Marketing Efficiency Ratio using Gross Sales',
146
- description: 'Marketing Efficiency Ratio using Gross Sales. (Total Ad Spend / Gross Sales) * 100',
191
+ title: 'MER (Gross Sales)',
192
+ shortTitle: 'MER Gross',
193
+ description: 'Marketing Efficiency Ratio using Gross Sales.',
147
194
  sumPrefix: '',
148
195
  sumSuffix: '%',
149
196
  avgPrefix: '',
150
197
  avgSuffix: '%',
151
- icon: 'upstack',
198
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
152
199
  measure: measures_js_1.MEASURE.CORE_MER_GROSS,
153
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
200
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
201
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
154
202
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
155
203
  decimalPlaces: 2,
156
204
  useCompactNotation: false,
157
205
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
206
+ tooltip: 'What percentage of gross sales (before discounts and refunds) is spent on advertising.',
207
+ formulaDisplay: '(Total Ad Spend ÷ Gross Sales) × 100',
208
+ formula: '(spend / gross_sales) * 100',
209
+ relatedMeasures: [measures_js_1.MEASURE.CORE_MER, measures_js_1.MEASURE.CORE_MER_NET, measures_js_1.MEASURE.CORE_ROAS_GROSS],
158
210
  },
159
211
  [measures_js_1.MEASURE.CORE_ROAS_TOTAL]: {
160
- title: 'ROAS (Revenue): Return on Ad Spend using Total Sales',
161
- description: 'Total Revenue / Total Ad Spend',
212
+ title: 'Return on Ad Spend',
213
+ shortTitle: 'ROAS',
214
+ description: 'Total Revenue divided by Total Ad Spend.',
162
215
  sumPrefix: '',
163
216
  sumSuffix: 'x',
164
217
  avgPrefix: '',
165
218
  avgSuffix: 'x',
166
- icon: 'upstack',
219
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
167
220
  measure: measures_js_1.MEASURE.CORE_ROAS_TOTAL,
168
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
221
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
222
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
169
223
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
170
224
  decimalPlaces: 2,
171
225
  useCompactNotation: false,
172
226
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
173
227
  aliases: [measures_js_1.MEASURE.CORE_ROAS],
228
+ tooltip: 'How much revenue you earn for every dollar spent on advertising. A 3x ROAS means $3 revenue per $1 spent.',
229
+ formulaDisplay: 'Total Revenue ÷ Total Ad Spend',
230
+ formula: 'total_revenue / spend',
231
+ relatedMeasures: [measures_js_1.MEASURE.CORE_ROAS_GROSS, measures_js_1.MEASURE.CORE_ROAS_NET, measures_js_1.MEASURE.CORE_CPA, measures_js_1.MEASURE.CORE_MER],
174
232
  },
175
233
  [measures_js_1.MEASURE.CORE_ROAS_GROSS]: {
176
- title: 'ROAS (Gross Sales): Return on Ad Spend using Gross Sales',
177
- description: 'Gross Sales / Total Ad Spend',
234
+ title: 'ROAS (Gross Sales)',
235
+ shortTitle: 'ROAS Gross',
236
+ description: 'Gross Sales divided by Total Ad Spend.',
178
237
  sumPrefix: '',
179
238
  sumSuffix: 'x',
180
239
  avgPrefix: '',
181
240
  avgSuffix: 'x',
182
- icon: 'upstack',
241
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
183
242
  measure: measures_js_1.MEASURE.CORE_ROAS_GROSS,
184
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
243
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
244
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
185
245
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
186
246
  decimalPlaces: 2,
187
247
  useCompactNotation: false,
188
248
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
249
+ tooltip: 'Return on ad spend using gross sales (before discounts and refunds are applied).',
250
+ formulaDisplay: 'Gross Sales ÷ Total Ad Spend',
251
+ formula: 'gross_sales / spend',
252
+ relatedMeasures: [measures_js_1.MEASURE.CORE_ROAS_TOTAL, measures_js_1.MEASURE.CORE_ROAS_NET, measures_js_1.MEASURE.CORE_MER_GROSS],
189
253
  },
190
254
  [measures_js_1.MEASURE.CORE_ROAS_NET]: {
191
- title: 'ROAS (Net Sales): Return on Ad Spend using Net Sales',
192
- description: 'Net Sales / Total Ad Spend',
255
+ title: 'ROAS (Net Sales)',
256
+ shortTitle: 'ROAS Net',
257
+ description: 'Net Sales divided by Total Ad Spend.',
193
258
  sumPrefix: '',
194
259
  sumSuffix: 'x',
195
260
  avgPrefix: '',
196
261
  avgSuffix: 'x',
197
- icon: 'upstack',
262
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
198
263
  measure: measures_js_1.MEASURE.CORE_ROAS_NET,
199
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
264
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
265
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
200
266
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
201
267
  decimalPlaces: 2,
202
268
  useCompactNotation: false,
203
269
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
270
+ tooltip: 'Return on ad spend using net sales (after discounts and refunds). Most accurate for true profitability.',
271
+ formulaDisplay: 'Net Sales ÷ Total Ad Spend',
272
+ formula: 'net_sales / spend',
273
+ relatedMeasures: [measures_js_1.MEASURE.CORE_ROAS_TOTAL, measures_js_1.MEASURE.CORE_ROAS_GROSS, measures_js_1.MEASURE.CORE_MER_NET],
204
274
  },
205
275
  [measures_js_1.MEASURE.CORE_SPEND_GROSS_PERCENT]: {
206
- title: 'Ad Spend as a percentage of Gross Sales',
207
- description: 'The percentage of gross sales that were spent on ads. (Amount Spent / Gross Sales) * 100',
276
+ title: 'Ad Spend % of Gross Sales',
277
+ shortTitle: 'Spend % Gross',
278
+ description: 'The percentage of gross sales that were spent on ads.',
208
279
  sumPrefix: '',
209
280
  sumSuffix: '%',
210
281
  avgPrefix: '',
211
282
  avgSuffix: '%',
212
- icon: 'upstack',
283
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
213
284
  measure: measures_js_1.MEASURE.CORE_SPEND_GROSS_PERCENT,
214
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
285
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
286
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
215
287
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
216
288
  decimalPlaces: 2,
217
289
  useCompactNotation: false,
218
290
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
291
+ tooltip: 'What portion of your gross sales goes toward advertising costs. Lower is more efficient.',
292
+ formulaDisplay: '(Ad Spend ÷ Gross Sales) × 100',
293
+ formula: '(spend / gross_sales) * 100',
294
+ relatedMeasures: [measures_js_1.MEASURE.CORE_SPEND_NET_PERCENT, measures_js_1.MEASURE.CORE_MER_GROSS],
219
295
  },
220
296
  [measures_js_1.MEASURE.CORE_SPEND_NET_PERCENT]: {
221
297
  title: 'Ad Spend % of Net Sales',
222
- description: 'The percentage of net sales that were spent on ads. (Amount Spent / Net Sales) * 100',
298
+ shortTitle: 'Spend % Net',
299
+ description: 'The percentage of net sales that were spent on ads.',
223
300
  sumPrefix: '',
224
301
  sumSuffix: '%',
225
302
  avgPrefix: '',
226
303
  avgSuffix: '%',
227
- icon: 'upstack',
304
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
228
305
  measure: measures_js_1.MEASURE.CORE_SPEND_NET_PERCENT,
229
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
306
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
307
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
230
308
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
231
309
  decimalPlaces: 2,
232
310
  useCompactNotation: false,
233
311
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
312
+ tooltip: 'What portion of your net sales goes toward advertising costs. Lower is more efficient.',
313
+ formulaDisplay: '(Ad Spend ÷ Net Sales) × 100',
314
+ formula: '(spend / net_sales) * 100',
315
+ relatedMeasures: [measures_js_1.MEASURE.CORE_SPEND_GROSS_PERCENT, measures_js_1.MEASURE.CORE_MER_NET],
234
316
  },
235
317
  [measures_js_1.MEASURE.CORE_RAAD]: {
236
- title: 'RAAD - (Revenue after Discounts, Returns, Ad Spend)',
237
- description: 'Total Revenue - Ad Spend',
318
+ title: 'Revenue After Ad Spend',
319
+ shortTitle: 'RAAD',
320
+ description: 'Total Revenue minus Ad Spend.',
238
321
  sumPrefix: '$',
239
322
  sumSuffix: '',
240
323
  avgPrefix: '$',
241
324
  avgSuffix: '',
242
- icon: 'upstack',
325
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
243
326
  measure: measures_js_1.MEASURE.CORE_RAAD,
244
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
327
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
328
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
245
329
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
246
330
  decimalPlaces: 2,
247
331
  useCompactNotation: true,
248
332
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
333
+ tooltip: 'Revenue remaining after subtracting advertising costs. A quick measure of marketing profitability.',
334
+ formulaDisplay: 'Total Revenue − Ad Spend',
335
+ formula: 'total_revenue - spend',
336
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD_GROSS, measures_js_1.MEASURE.CORE_RAAD_NET, measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT],
249
337
  },
250
338
  [measures_js_1.MEASURE.CORE_RAAD_GROSS]: {
251
- title: 'RAAD (Gross Sales): Revenue after Discounts, Returns, Ad Spend',
252
- description: 'Gross Sales - Ad Spend',
339
+ title: 'RAAD (Gross Sales)',
340
+ shortTitle: 'RAAD Gross',
341
+ description: 'Gross Sales minus Ad Spend.',
253
342
  sumPrefix: '$',
254
343
  sumSuffix: '',
255
344
  avgPrefix: '$',
256
345
  avgSuffix: '',
257
- icon: 'upstack',
346
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
258
347
  measure: measures_js_1.MEASURE.CORE_RAAD_GROSS,
259
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
348
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
349
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
260
350
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
261
351
  decimalPlaces: 2,
262
352
  useCompactNotation: true,
263
353
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
354
+ tooltip: 'Gross sales remaining after subtracting advertising costs.',
355
+ formulaDisplay: 'Gross Sales − Ad Spend',
356
+ formula: 'gross_sales - spend',
357
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD, measures_js_1.MEASURE.CORE_RAAD_NET, measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT],
264
358
  },
265
359
  [measures_js_1.MEASURE.CORE_RAAD_NET]: {
266
- title: 'RAAD (Net Sales): Revenue after Discounts, Returns, Ad Spend',
267
- description: 'Net Sales - Ad Spend',
360
+ title: 'RAAD (Net Sales)',
361
+ shortTitle: 'RAAD Net',
362
+ description: 'Net Sales minus Ad Spend.',
268
363
  sumPrefix: '$',
269
364
  sumSuffix: '',
270
365
  avgPrefix: '$',
271
366
  avgSuffix: '',
272
- icon: 'upstack',
367
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
273
368
  measure: measures_js_1.MEASURE.CORE_RAAD_NET,
274
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
369
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
370
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
275
371
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
276
372
  decimalPlaces: 2,
277
373
  useCompactNotation: true,
278
374
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
375
+ tooltip: 'Net sales remaining after subtracting advertising costs. Most conservative RAAD calculation.',
376
+ formulaDisplay: 'Net Sales − Ad Spend',
377
+ formula: 'net_sales - spend',
378
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD, measures_js_1.MEASURE.CORE_RAAD_GROSS, measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT],
279
379
  },
280
380
  [measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT]: {
281
- title: 'RAAD % of Total',
282
- description: 'RAAD as a percentage of Total Revenue. (RAAD / Total Revenue) * 100',
381
+ title: 'RAAD % of Total Revenue',
382
+ shortTitle: 'RAAD %',
383
+ description: 'RAAD as a percentage of Total Revenue.',
283
384
  sumPrefix: '',
284
385
  sumSuffix: '%',
285
386
  avgPrefix: '',
286
387
  avgSuffix: '%',
287
- icon: 'upstack',
388
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
288
389
  measure: measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT,
289
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
390
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
391
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
290
392
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
291
393
  decimalPlaces: 2,
292
394
  useCompactNotation: false,
293
395
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
396
+ tooltip: 'What percentage of total revenue remains after ad spend. Higher is better.',
397
+ formulaDisplay: '(RAAD ÷ Total Revenue) × 100',
398
+ formula: '(raad / total_revenue) * 100',
399
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD, measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT, measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT],
294
400
  },
295
401
  [measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT]: {
296
- title: 'RAAD % of Gross',
297
- description: 'RAAD as a percentage of Gross Sales. (RAAD / Gross Sales) * 100',
402
+ title: 'RAAD % of Gross Sales',
403
+ shortTitle: 'RAAD % Gross',
404
+ description: 'RAAD as a percentage of Gross Sales.',
298
405
  sumPrefix: '',
299
406
  sumSuffix: '%',
300
407
  avgPrefix: '',
301
408
  avgSuffix: '%',
302
- icon: 'upstack',
409
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
303
410
  measure: measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT,
304
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
411
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
412
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
305
413
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
306
414
  decimalPlaces: 2,
307
415
  useCompactNotation: false,
308
416
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
417
+ tooltip: 'What percentage of gross sales remains after ad spend.',
418
+ formulaDisplay: '(RAAD Gross ÷ Gross Sales) × 100',
419
+ formula: '(raad_gross / gross_sales) * 100',
420
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD_GROSS, measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT, measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT],
309
421
  },
310
422
  [measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT]: {
311
- title: 'RAAD % of Net',
312
- description: 'RAAD as a percentage of Net Sales. (RAAD / Net Sales) * 100',
423
+ title: 'RAAD % of Net Sales',
424
+ shortTitle: 'RAAD % Net',
425
+ description: 'RAAD as a percentage of Net Sales.',
313
426
  sumPrefix: '',
314
427
  sumSuffix: '%',
315
428
  avgPrefix: '',
316
429
  avgSuffix: '%',
317
- icon: 'upstack',
430
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
318
431
  measure: measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT,
319
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
432
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
433
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
320
434
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
321
435
  decimalPlaces: 2,
322
436
  useCompactNotation: false,
323
437
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
438
+ tooltip: 'What percentage of net sales remains after ad spend.',
439
+ formulaDisplay: '(RAAD Net ÷ Net Sales) × 100',
440
+ formula: '(raad_net / net_sales) * 100',
441
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD_NET, measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT, measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT],
324
442
  },
325
443
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD]: {
326
- title: 'NC-RAAD - (Revenue after Discounts, Returns, Ad Spend)',
327
- description: 'Total Revenue - New Customer Ad Spend',
444
+ title: 'New Customer Revenue After Ad Spend',
445
+ shortTitle: 'NC RAAD',
446
+ description: 'New Customer Revenue minus Ad Spend.',
328
447
  sumPrefix: '$',
329
448
  sumSuffix: '',
330
449
  avgPrefix: '$',
331
450
  avgSuffix: '',
332
- icon: 'upstack',
451
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
333
452
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD,
334
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
453
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
454
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
335
455
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
336
456
  decimalPlaces: 2,
337
457
  useCompactNotation: true,
338
458
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
459
+ tooltip: 'Revenue from new customers minus the ad spend to acquire them.',
460
+ formulaDisplay: 'New Customer Revenue − Ad Spend',
461
+ formula: 'nc_revenue - spend',
462
+ relatedMeasures: [measures_js_1.MEASURE.CORE_RAAD, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET],
339
463
  },
340
464
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS]: {
341
- title: 'NC-RAAD (Gross Sales): Revenue after Discounts, Returns, Ad Spend',
342
- description: 'Gross Sales - New Customer Ad Spend',
465
+ title: 'NC RAAD (Gross Sales)',
466
+ shortTitle: 'NC RAAD Gross',
467
+ description: 'New Customer Gross Sales minus Ad Spend.',
343
468
  sumPrefix: '$',
344
469
  sumSuffix: '',
345
470
  avgPrefix: '$',
346
471
  avgSuffix: '',
347
- icon: 'upstack',
472
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
348
473
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS,
349
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
474
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
475
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
350
476
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
351
477
  decimalPlaces: 2,
352
478
  useCompactNotation: true,
353
479
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
480
+ tooltip: 'Gross sales from new customers minus ad spend.',
481
+ formulaDisplay: 'NC Gross Sales − Ad Spend',
482
+ formula: 'nc_gross_sales - spend',
483
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET],
354
484
  },
355
485
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET]: {
356
- title: 'NC-RAAD (Net Sales): Revenue after Discounts, Returns, Ad Spend',
357
- description: 'Net Sales - New Customer Ad Spend',
486
+ title: 'NC RAAD (Net Sales)',
487
+ shortTitle: 'NC RAAD Net',
488
+ description: 'New Customer Net Sales minus Ad Spend.',
358
489
  sumPrefix: '$',
359
490
  sumSuffix: '',
360
491
  avgPrefix: '$',
361
492
  avgSuffix: '',
362
- icon: 'upstack',
493
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
363
494
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET,
364
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
495
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
496
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
365
497
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
366
498
  decimalPlaces: 2,
367
499
  useCompactNotation: true,
368
500
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
501
+ tooltip: 'Net sales from new customers minus ad spend. Most conservative NC RAAD calculation.',
502
+ formulaDisplay: 'NC Net Sales − Ad Spend',
503
+ formula: 'nc_net_sales - spend',
504
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS],
369
505
  },
370
506
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_TOTAL_PERCENT]: {
371
- title: 'NC-RAAD % of Total',
372
- description: 'NC-RAAD as a percentage of Total Revenue. (NC-RAAD / Total Revenue) * 100',
507
+ title: 'NC RAAD % of Total Revenue',
508
+ shortTitle: 'NC RAAD %',
509
+ description: 'NC-RAAD as a percentage of Total Revenue.',
373
510
  sumPrefix: '',
374
511
  sumSuffix: '%',
375
512
  avgPrefix: '',
376
513
  avgSuffix: '%',
377
- icon: 'upstack',
514
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
378
515
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_TOTAL_PERCENT,
379
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
516
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
517
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
380
518
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
381
519
  decimalPlaces: 2,
382
520
  useCompactNotation: false,
383
521
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
522
+ tooltip: 'What percentage of total revenue remains after new customer acquisition costs.',
523
+ formulaDisplay: '(NC RAAD ÷ Total Revenue) × 100',
524
+ formula: '(nc_raad / total_revenue) * 100',
525
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD, measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT],
384
526
  },
385
527
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT]: {
386
- title: 'NC-RAAD % of Gross',
387
- description: 'NC-RAAD as a percentage of Gross Sales. (NC-RAAD / Gross Sales) * 100',
528
+ title: 'NC RAAD % of Gross Sales',
529
+ shortTitle: 'NC RAAD % Gross',
530
+ description: 'NC-RAAD as a percentage of Gross Sales.',
388
531
  sumPrefix: '',
389
532
  sumSuffix: '%',
390
533
  avgPrefix: '',
391
534
  avgSuffix: '%',
392
- icon: 'upstack',
535
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
393
536
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT,
394
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
537
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
538
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
395
539
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
396
540
  decimalPlaces: 2,
397
541
  useCompactNotation: false,
398
542
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
543
+ tooltip: 'What percentage of gross sales remains after new customer acquisition costs.',
544
+ formulaDisplay: '(NC RAAD Gross ÷ Gross Sales) × 100',
545
+ formula: '(nc_raad_gross / gross_sales) * 100',
546
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS, measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT],
399
547
  },
400
548
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT]: {
401
- title: 'NC-RAAD % of Net',
402
- description: 'NC-RAAD as a percentage of Net Sales. (NC-RAAD / Net Sales) * 100',
549
+ title: 'NC RAAD % of Net Sales',
550
+ shortTitle: 'NC RAAD % Net',
551
+ description: 'NC-RAAD as a percentage of Net Sales.',
403
552
  sumPrefix: '',
404
553
  sumSuffix: '%',
405
554
  avgPrefix: '',
406
555
  avgSuffix: '%',
407
- icon: 'upstack',
556
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
408
557
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT,
409
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
558
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
559
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
410
560
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
411
561
  decimalPlaces: 2,
412
562
  useCompactNotation: false,
413
563
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
564
+ tooltip: 'What percentage of net sales remains after new customer acquisition costs.',
565
+ formulaDisplay: '(NC RAAD Net ÷ Net Sales) × 100',
566
+ formula: '(nc_raad_net / net_sales) * 100',
567
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET, measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT],
414
568
  },
415
569
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL]: {
416
- title: 'NC-ROAS (New Customer Return On Ad Spend)',
417
- description: '(New Customer Revenue / Ad Spend)',
570
+ title: 'New Customer Return on Ad Spend',
571
+ shortTitle: 'NC ROAS',
572
+ description: 'New Customer Revenue divided by Ad Spend.',
418
573
  sumPrefix: '',
419
574
  sumSuffix: 'x',
420
575
  avgPrefix: '',
421
576
  avgSuffix: 'x',
422
- icon: 'upstack',
577
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
423
578
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL,
424
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
579
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
580
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
425
581
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
426
582
  decimalPlaces: 2,
427
583
  useCompactNotation: false,
428
584
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
429
585
  aliases: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS],
586
+ tooltip: 'Revenue from new customers per dollar spent on advertising. Key metric for customer acquisition efficiency.',
587
+ formulaDisplay: 'New Customer Revenue ÷ Ad Spend',
588
+ formula: 'nc_revenue / spend',
589
+ relatedMeasures: [measures_js_1.MEASURE.CORE_ROAS_TOTAL, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_NET],
430
590
  },
431
591
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS]: {
432
- title: 'NC-ROAS GROSS (New Customer Return On Ad Spend)',
433
- description: '(New Customer Gross Sales / Ad Spend)',
592
+ title: 'NC ROAS (Gross Sales)',
593
+ shortTitle: 'NC ROAS Gross',
594
+ description: 'New Customer Gross Sales divided by Ad Spend.',
434
595
  sumPrefix: '',
435
596
  sumSuffix: 'x',
436
597
  avgPrefix: '',
437
598
  avgSuffix: 'x',
438
- icon: 'upstack',
599
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
439
600
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS,
440
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
601
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
602
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
441
603
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
442
604
  decimalPlaces: 2,
443
605
  useCompactNotation: false,
444
606
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
607
+ tooltip: 'Gross sales from new customers per dollar spent on advertising.',
608
+ formulaDisplay: 'NC Gross Sales ÷ Ad Spend',
609
+ formula: 'nc_gross_sales / spend',
610
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_NET, measures_js_1.MEASURE.CORE_ROAS_GROSS],
445
611
  },
446
612
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_NET]: {
447
- title: 'NC-ROAS NET (New Customer Return On Ad Spend)',
448
- description: '(New Customer Net Sales / Ad Spend)',
613
+ title: 'NC ROAS (Net Sales)',
614
+ shortTitle: 'NC ROAS Net',
615
+ description: 'New Customer Net Sales divided by Ad Spend.',
449
616
  sumPrefix: '',
450
617
  sumSuffix: 'x',
451
618
  avgPrefix: '',
452
619
  avgSuffix: 'x',
453
- icon: 'upstack',
620
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
454
621
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_NET,
455
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
622
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
623
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
456
624
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
457
625
  decimalPlaces: 2,
458
626
  useCompactNotation: false,
459
627
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
628
+ tooltip: 'Net sales from new customers per dollar spent on advertising. Most accurate for true acquisition profitability.',
629
+ formulaDisplay: 'NC Net Sales ÷ Ad Spend',
630
+ formula: 'nc_net_sales / spend',
631
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS, measures_js_1.MEASURE.CORE_ROAS_NET],
460
632
  },
461
633
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER]: {
462
- title: 'NC-MER (New Customer Marketing Efficiency Ratio)',
463
- description: 'Marketing Efficiency Ratio using Total Revenue. (Total Ad Spend / New Customer Revenue)',
634
+ title: 'New Customer Marketing Efficiency Ratio',
635
+ shortTitle: 'NC MER',
636
+ description: 'Marketing Efficiency Ratio using New Customer Revenue.',
464
637
  sumPrefix: '',
465
638
  sumSuffix: '%',
466
639
  avgPrefix: '',
467
640
  avgSuffix: '%',
468
- icon: 'upstack',
641
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
469
642
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER,
470
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
643
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
644
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
471
645
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
472
646
  decimalPlaces: 2,
473
647
  useCompactNotation: false,
474
648
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
649
+ tooltip: 'What percentage of new customer revenue is spent on advertising. Lower is better.',
650
+ formulaDisplay: '(Ad Spend ÷ NC Revenue) × 100',
651
+ formula: '(spend / nc_revenue) * 100',
652
+ relatedMeasures: [measures_js_1.MEASURE.CORE_MER, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_GROSS, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_NET],
475
653
  },
476
654
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_GROSS]: {
477
- title: 'NC-MER GROSS (New Customer Marketing Efficiency Ratio)',
478
- description: 'Marketing Efficiency Ratio using Gross Sales. (Total Ad Spend / New Customer Gross Sales)',
655
+ title: 'NC MER (Gross Sales)',
656
+ shortTitle: 'NC MER Gross',
657
+ description: 'Marketing Efficiency Ratio using New Customer Gross Sales.',
479
658
  sumPrefix: '',
480
659
  sumSuffix: '%',
481
660
  avgPrefix: '',
482
661
  avgSuffix: '%',
483
- icon: 'upstack',
662
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
484
663
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_GROSS,
485
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
664
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
665
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
486
666
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
487
667
  decimalPlaces: 2,
488
668
  useCompactNotation: false,
489
669
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
670
+ tooltip: 'What percentage of new customer gross sales is spent on advertising.',
671
+ formulaDisplay: '(Ad Spend ÷ NC Gross Sales) × 100',
672
+ formula: '(spend / nc_gross_sales) * 100',
673
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_NET, measures_js_1.MEASURE.CORE_MER_GROSS],
490
674
  },
491
675
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_NET]: {
492
- title: 'NC-MER NET (New Customer Marketing Efficiency Ratio)',
493
- description: 'Marketing Efficiency Ratio using Net Sales. (Total Ad Spend / New Customer Net Sales)',
676
+ title: 'NC MER (Net Sales)',
677
+ shortTitle: 'NC MER Net',
678
+ description: 'Marketing Efficiency Ratio using New Customer Net Sales.',
494
679
  sumPrefix: '',
495
680
  sumSuffix: '%',
496
681
  avgPrefix: '',
497
682
  avgSuffix: '%',
498
- icon: 'upstack',
683
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
499
684
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_NET,
500
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
685
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
686
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_EFFICIENCY,
501
687
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
502
688
  decimalPlaces: 2,
503
689
  useCompactNotation: false,
504
690
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
691
+ tooltip: 'What percentage of new customer net sales is spent on advertising.',
692
+ formulaDisplay: '(Ad Spend ÷ NC Net Sales) × 100',
693
+ formula: '(spend / nc_net_sales) * 100',
694
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_GROSS, measures_js_1.MEASURE.CORE_MER_NET],
505
695
  },
506
696
  [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS]: {
507
- title: 'Effective COGS',
508
- description: 'Net Cost of Goods Sold (Orders COGS + Handling - Refund COGS)',
697
+ title: 'Effective Cost of Goods Sold',
698
+ shortTitle: 'Effective COGS',
699
+ description: 'Net Cost of Goods Sold (Orders COGS + Handling - Refund COGS).',
509
700
  sumPrefix: '$',
510
701
  sumSuffix: '',
511
702
  avgPrefix: '$',
512
703
  avgSuffix: '',
513
- icon: 'upstack',
704
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
514
705
  measure: measures_js_1.MEASURE.CORE_EFFECTIVE_COGS,
515
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
706
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
707
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
516
708
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
517
709
  decimalPlaces: 2,
518
710
  useCompactNotation: true,
519
711
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
712
+ tooltip: 'The true cost of products sold, accounting for returns and handling fees.',
713
+ formulaDisplay: 'Orders COGS + Handling − Refund COGS',
714
+ formula: 'orders_cogs + handling - refund_cogs',
715
+ relatedMeasures: [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS_PERCENT, measures_js_1.MEASURE.CORE_COGS_ORDERS, measures_js_1.MEASURE.CORE_COGS_REFUNDS, measures_js_1.MEASURE.CORE_GROSS_PROFIT],
520
716
  },
521
717
  [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS_PERCENT]: {
522
718
  title: 'Effective COGS %',
523
- description: 'Effective COGS as a percentage of Net Sales',
719
+ shortTitle: 'COGS %',
720
+ description: 'Effective COGS as a percentage of Net Sales.',
524
721
  sumPrefix: '',
525
722
  sumSuffix: '%',
526
723
  avgPrefix: '',
527
724
  avgSuffix: '%',
528
- icon: 'upstack',
725
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
529
726
  measure: measures_js_1.MEASURE.CORE_EFFECTIVE_COGS_PERCENT,
530
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
727
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
728
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
531
729
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
532
730
  decimalPlaces: 2,
533
731
  useCompactNotation: false,
534
732
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
733
+ tooltip: 'What percentage of net sales goes toward product costs. Lower means higher gross margins.',
734
+ formulaDisplay: '(Effective COGS ÷ Net Sales) × 100',
735
+ formula: '(effective_cogs / net_sales) * 100',
736
+ relatedMeasures: [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS, measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT],
535
737
  },
536
738
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_EFFECTIVE_COGS]: {
537
- title: 'NC Effective COGS',
538
- description: 'New Customer Effective COGS',
739
+ title: 'New Customer Effective COGS',
740
+ shortTitle: 'NC COGS',
741
+ description: 'Effective COGS for new customer orders.',
539
742
  sumPrefix: '$',
540
743
  sumSuffix: '',
541
744
  avgPrefix: '$',
542
745
  avgSuffix: '',
543
- icon: 'upstack',
746
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
544
747
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_EFFECTIVE_COGS,
545
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
748
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
749
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
546
750
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
547
751
  decimalPlaces: 2,
548
752
  useCompactNotation: true,
549
753
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
754
+ tooltip: 'Cost of goods sold for orders from first-time customers.',
755
+ relatedMeasures: [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT],
550
756
  },
551
757
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_VARIABLE_COSTS]: {
552
- title: 'NC Variable Costs',
553
- description: 'New Customer Variable Costs',
758
+ title: 'New Customer Variable Costs',
759
+ shortTitle: 'NC Variable',
760
+ description: 'Variable costs attributed to new customer orders.',
554
761
  sumPrefix: '$',
555
762
  sumSuffix: '',
556
763
  avgPrefix: '$',
557
764
  avgSuffix: '',
558
- icon: 'upstack',
765
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
559
766
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_VARIABLE_COSTS,
560
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
767
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
768
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
561
769
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
562
770
  decimalPlaces: 2,
563
771
  useCompactNotation: true,
564
772
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
773
+ tooltip: 'Per-order variable expenses for new customer acquisitions.',
774
+ relatedMeasures: [measures_js_1.MEASURE.CORE_VARIABLE_COSTS, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2],
565
775
  },
566
776
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_FIXED_COSTS]: {
567
- title: 'NC Fixed Costs',
568
- description: 'New Customer Fixed Costs',
777
+ title: 'New Customer Fixed Costs',
778
+ shortTitle: 'NC Fixed',
779
+ description: 'Fixed costs attributed to new customer orders.',
569
780
  sumPrefix: '$',
570
781
  sumSuffix: '',
571
782
  avgPrefix: '$',
572
783
  avgSuffix: '',
573
- icon: 'upstack',
784
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
574
785
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_FIXED_COSTS,
575
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
786
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
787
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
576
788
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
577
789
  decimalPlaces: 2,
578
790
  useCompactNotation: true,
579
791
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
792
+ tooltip: 'Allocated fixed expenses for new customer acquisitions.',
793
+ relatedMeasures: [measures_js_1.MEASURE.CORE_FIXED_COSTS, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT],
580
794
  },
581
795
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT]: {
582
- title: 'New Customer Gross Profit (CM1)',
583
- description: 'New Customer Net Sales - New Customer Effective COGS',
796
+ title: 'New Customer Gross Profit',
797
+ shortTitle: 'NC Gross Profit',
798
+ description: 'Gross profit from new customer orders (CM1).',
584
799
  sumPrefix: '$',
585
800
  sumSuffix: '',
586
801
  avgPrefix: '$',
587
802
  avgSuffix: '',
588
- icon: 'upstack',
803
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
589
804
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT,
590
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
805
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
806
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_GROSS_MARGIN,
591
807
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
592
808
  decimalPlaces: 2,
593
809
  useCompactNotation: true,
594
810
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
811
+ tooltip: 'Revenue from new customers minus their cost of goods. First level of contribution margin.',
812
+ formulaDisplay: 'NC Net Sales − NC Effective COGS',
813
+ formula: 'nc_net_sales - nc_effective_cogs',
814
+ relatedMeasures: [measures_js_1.MEASURE.CORE_GROSS_PROFIT, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2],
595
815
  },
596
816
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2]: {
597
- title: 'New Customer CM2',
598
- description: 'New Customer Gross Profit - NC Shipping - NC Gateway Costs - NC Variable Expenses',
817
+ title: 'New Customer Contribution Margin 2',
818
+ shortTitle: 'NC CM2',
819
+ description: 'New customer gross profit minus shipping, gateway, and variable costs.',
599
820
  sumPrefix: '$',
600
821
  sumSuffix: '',
601
822
  avgPrefix: '$',
602
823
  avgSuffix: '',
603
- icon: 'upstack',
824
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
604
825
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2,
605
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
826
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
827
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
606
828
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
607
829
  decimalPlaces: 2,
608
830
  useCompactNotation: true,
609
831
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
832
+ tooltip: 'Profit from new customers after subtracting fulfillment and variable costs.',
833
+ formulaDisplay: 'NC Gross Profit − Shipping − Gateway − Variable Costs',
834
+ formula: 'nc_gross_profit - nc_shipping - nc_gateway - nc_variable_costs',
835
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM2, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM3],
610
836
  },
611
837
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM3]: {
612
- title: 'New Customer CM3',
613
- description: 'New Customer CM2 - NC Blended Ad Spend',
838
+ title: 'New Customer Contribution Margin 3',
839
+ shortTitle: 'NC CM3',
840
+ description: 'New customer CM2 minus blended ad spend.',
614
841
  sumPrefix: '$',
615
842
  sumSuffix: '',
616
843
  avgPrefix: '$',
617
844
  avgSuffix: '',
618
- icon: 'upstack',
845
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
619
846
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM3,
620
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
847
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
848
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
621
849
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
622
850
  decimalPlaces: 2,
623
851
  useCompactNotation: true,
624
852
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
853
+ tooltip: 'Profit from new customers after subtracting all variable costs including advertising.',
854
+ formulaDisplay: 'NC CM2 − NC Ad Spend',
855
+ formula: 'nc_cm2 - nc_ad_spend',
856
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM3, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT],
625
857
  },
626
858
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT]: {
627
859
  title: 'New Customer Net Profit',
628
- description: 'New Customer CM3 - NC Fixed Expenses',
860
+ shortTitle: 'NC Net Profit',
861
+ description: 'New customer CM3 minus fixed expenses.',
629
862
  sumPrefix: '$',
630
863
  sumSuffix: '',
631
864
  avgPrefix: '$',
632
865
  avgSuffix: '',
633
- icon: 'upstack',
866
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
634
867
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT,
635
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
868
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
869
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_NET_PROFIT,
636
870
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
637
871
  decimalPlaces: 2,
638
872
  useCompactNotation: true,
639
873
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
874
+ tooltip: 'Final profit from new customer acquisitions after all costs.',
875
+ formulaDisplay: 'NC CM3 − NC Fixed Costs',
876
+ formula: 'nc_cm3 - nc_fixed_costs',
877
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NET_PROFIT, measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM3],
640
878
  },
641
879
  [measures_js_1.MEASURE.CORE_COGS_ORDERS]: {
642
880
  title: 'COGS (Orders)',
643
- description: 'Cost of Goods Sold from orders',
881
+ shortTitle: 'Order COGS',
882
+ description: 'Cost of Goods Sold from orders.',
644
883
  sumPrefix: '$',
645
884
  sumSuffix: '',
646
885
  avgPrefix: '$',
647
886
  avgSuffix: '',
648
- icon: 'upstack',
887
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
649
888
  measure: measures_js_1.MEASURE.CORE_COGS_ORDERS,
650
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
889
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
890
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
651
891
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
652
892
  decimalPlaces: 2,
653
893
  useCompactNotation: true,
654
894
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
895
+ tooltip: 'Direct product costs for fulfilled orders before accounting for returns.',
896
+ relatedMeasures: [measures_js_1.MEASURE.CORE_COGS_REFUNDS, measures_js_1.MEASURE.CORE_EFFECTIVE_COGS],
655
897
  },
656
898
  [measures_js_1.MEASURE.CORE_COGS_REFUNDS]: {
657
899
  title: 'COGS (Refunds)',
658
- description: 'Cost of Goods Sold recovered from refunds',
900
+ shortTitle: 'Refund COGS',
901
+ description: 'Cost of Goods Sold recovered from refunds.',
659
902
  sumPrefix: '$',
660
903
  sumSuffix: '',
661
904
  avgPrefix: '$',
662
905
  avgSuffix: '',
663
- icon: 'upstack',
906
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
664
907
  measure: measures_js_1.MEASURE.CORE_COGS_REFUNDS,
665
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
908
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
909
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_COGS,
666
910
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
667
911
  decimalPlaces: 2,
668
912
  useCompactNotation: true,
669
913
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
914
+ tooltip: 'Product costs recovered when orders are refunded.',
915
+ relatedMeasures: [measures_js_1.MEASURE.CORE_COGS_ORDERS, measures_js_1.MEASURE.CORE_EFFECTIVE_COGS],
670
916
  },
671
917
  [measures_js_1.MEASURE.CORE_VARIABLE_COSTS]: {
672
918
  title: 'Variable Costs',
673
- description: 'Total custom variable expenses (per-order fees, % of sales, etc.)',
919
+ description: 'Total custom variable expenses (per-order fees, % of sales, etc.).',
674
920
  sumPrefix: '$',
675
921
  sumSuffix: '',
676
922
  avgPrefix: '$',
677
923
  avgSuffix: '',
678
- icon: 'upstack',
924
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
679
925
  measure: measures_js_1.MEASURE.CORE_VARIABLE_COSTS,
680
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
926
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
927
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
681
928
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
682
929
  decimalPlaces: 2,
683
930
  useCompactNotation: true,
684
931
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
932
+ tooltip: 'Costs that scale with order volume, such as transaction fees and fulfillment costs.',
933
+ relatedMeasures: [measures_js_1.MEASURE.CORE_VARIABLE_COSTS_PERCENT, measures_js_1.MEASURE.CORE_FIXED_COSTS, measures_js_1.MEASURE.CORE_CM2],
685
934
  },
686
935
  [measures_js_1.MEASURE.CORE_VARIABLE_COSTS_PERCENT]: {
687
936
  title: 'Variable Costs %',
688
- description: 'Variable costs as a percentage of Net Sales',
937
+ description: 'Variable costs as a percentage of Net Sales.',
689
938
  sumPrefix: '',
690
939
  sumSuffix: '%',
691
940
  avgPrefix: '',
692
941
  avgSuffix: '%',
693
- icon: 'upstack',
942
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
694
943
  measure: measures_js_1.MEASURE.CORE_VARIABLE_COSTS_PERCENT,
695
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
944
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
945
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
696
946
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
697
947
  decimalPlaces: 2,
698
948
  useCompactNotation: false,
699
949
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
950
+ tooltip: 'What percentage of net sales goes toward variable costs.',
951
+ formulaDisplay: '(Variable Costs ÷ Net Sales) × 100',
952
+ formula: '(variable_costs / net_sales) * 100',
953
+ relatedMeasures: [measures_js_1.MEASURE.CORE_VARIABLE_COSTS, measures_js_1.MEASURE.CORE_FIXED_COSTS_PERCENT],
700
954
  },
701
955
  [measures_js_1.MEASURE.CORE_FIXED_COSTS]: {
702
956
  title: 'Fixed Costs',
703
- description: 'Total fixed expenses (rent, salaries, software, etc.)',
957
+ description: 'Total fixed expenses (rent, salaries, software, etc.).',
704
958
  sumPrefix: '$',
705
959
  sumSuffix: '',
706
960
  avgPrefix: '$',
707
961
  avgSuffix: '',
708
- icon: 'upstack',
962
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
709
963
  measure: measures_js_1.MEASURE.CORE_FIXED_COSTS,
710
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
964
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
965
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
711
966
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
712
967
  decimalPlaces: 2,
713
968
  useCompactNotation: true,
714
969
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
970
+ tooltip: 'Overhead costs that remain constant regardless of order volume.',
971
+ relatedMeasures: [measures_js_1.MEASURE.CORE_FIXED_COSTS_PERCENT, measures_js_1.MEASURE.CORE_VARIABLE_COSTS, measures_js_1.MEASURE.CORE_NET_PROFIT],
715
972
  },
716
973
  [measures_js_1.MEASURE.CORE_FIXED_COSTS_PERCENT]: {
717
974
  title: 'Fixed Costs %',
718
- description: 'Fixed costs as a percentage of Net Sales',
975
+ description: 'Fixed costs as a percentage of Net Sales.',
719
976
  sumPrefix: '',
720
977
  sumSuffix: '%',
721
978
  avgPrefix: '',
722
979
  avgSuffix: '%',
723
- icon: 'upstack',
980
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
724
981
  measure: measures_js_1.MEASURE.CORE_FIXED_COSTS_PERCENT,
725
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
982
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
983
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
726
984
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
727
985
  decimalPlaces: 2,
728
986
  useCompactNotation: false,
729
987
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
988
+ tooltip: 'What percentage of net sales goes toward fixed overhead costs.',
989
+ formulaDisplay: '(Fixed Costs ÷ Net Sales) × 100',
990
+ formula: '(fixed_costs / net_sales) * 100',
991
+ relatedMeasures: [measures_js_1.MEASURE.CORE_FIXED_COSTS, measures_js_1.MEASURE.CORE_VARIABLE_COSTS_PERCENT],
730
992
  },
731
993
  [measures_js_1.MEASURE.CORE_SHIPPING_COSTS]: {
732
994
  title: 'Shipping Costs',
733
- description: 'Seller-side shipping expenses',
995
+ description: 'Seller-side shipping expenses.',
734
996
  sumPrefix: '$',
735
997
  sumSuffix: '',
736
998
  avgPrefix: '$',
737
999
  avgSuffix: '',
738
- icon: 'upstack',
1000
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
739
1001
  measure: measures_js_1.MEASURE.CORE_SHIPPING_COSTS,
740
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1002
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1003
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
741
1004
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
742
1005
  decimalPlaces: 2,
743
1006
  useCompactNotation: true,
744
1007
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1008
+ tooltip: 'What you pay to ship orders to customers (not what customers pay for shipping).',
1009
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM2, measures_js_1.MEASURE.CORE_VARIABLE_COSTS],
745
1010
  },
746
1011
  [measures_js_1.MEASURE.CORE_PAYMENT_GATEWAY_COSTS]: {
747
1012
  title: 'Payment Gateway Costs',
748
- description: 'Payment processing fees (flat + percentage per gateway)',
1013
+ shortTitle: 'Gateway Costs',
1014
+ description: 'Payment processing fees (flat + percentage per gateway).',
749
1015
  sumPrefix: '$',
750
1016
  sumSuffix: '',
751
1017
  avgPrefix: '$',
752
1018
  avgSuffix: '',
753
- icon: 'upstack',
1019
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
754
1020
  measure: measures_js_1.MEASURE.CORE_PAYMENT_GATEWAY_COSTS,
755
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1021
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1022
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
756
1023
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
757
1024
  decimalPlaces: 2,
758
1025
  useCompactNotation: true,
759
1026
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1027
+ tooltip: 'Transaction fees paid to payment processors like Stripe, PayPal, or Shopify Payments.',
1028
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM2, measures_js_1.MEASURE.CORE_VARIABLE_COSTS],
760
1029
  },
761
1030
  [measures_js_1.MEASURE.CORE_VARIABLE_AD_SPEND]: {
762
1031
  title: 'Variable Ad Spend',
763
- description: 'Internal: variable expenses marked as ad spend (per-order calculation)',
1032
+ description: 'Variable expenses marked as ad spend (per-order calculation).',
764
1033
  sumPrefix: '$',
765
1034
  sumSuffix: '',
766
1035
  avgPrefix: '$',
767
1036
  avgSuffix: '',
768
- icon: 'upstack',
1037
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
769
1038
  measure: measures_js_1.MEASURE.CORE_VARIABLE_AD_SPEND,
770
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1039
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
1040
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_SPEND,
771
1041
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
772
1042
  decimalPlaces: 2,
773
1043
  useCompactNotation: true,
774
1044
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1045
+ tooltip: 'Custom variable expenses you have marked as advertising spend, allocated per order.',
1046
+ relatedMeasures: [measures_js_1.MEASURE.CORE_FIXED_AD_SPEND, measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND, measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND],
775
1047
  },
776
1048
  [measures_js_1.MEASURE.CORE_FIXED_AD_SPEND]: {
777
1049
  title: 'Fixed Ad Spend',
778
- description: 'Internal: fixed expenses marked as ad spend (date-allocated)',
1050
+ description: 'Fixed expenses marked as ad spend (date-allocated).',
779
1051
  sumPrefix: '$',
780
1052
  sumSuffix: '',
781
1053
  avgPrefix: '$',
782
1054
  avgSuffix: '',
783
- icon: 'upstack',
1055
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
784
1056
  measure: measures_js_1.MEASURE.CORE_FIXED_AD_SPEND,
785
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1057
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
1058
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_SPEND,
786
1059
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
787
1060
  decimalPlaces: 2,
788
1061
  useCompactNotation: true,
789
1062
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1063
+ tooltip: 'Custom fixed expenses you have marked as advertising spend, allocated by date.',
1064
+ relatedMeasures: [measures_js_1.MEASURE.CORE_VARIABLE_AD_SPEND, measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND, measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND],
790
1065
  },
791
1066
  [measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND]: {
792
1067
  title: 'Custom Ad Spend',
793
- description: 'User-entered ad spend from custom variable/fixed expenses marked as ad spend',
1068
+ description: 'User-entered ad spend from custom variable/fixed expenses marked as ad spend.',
794
1069
  sumPrefix: '$',
795
1070
  sumSuffix: '',
796
1071
  avgPrefix: '$',
797
1072
  avgSuffix: '',
798
- icon: 'upstack',
1073
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
799
1074
  measure: measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND,
800
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1075
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
1076
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_SPEND,
801
1077
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
802
1078
  decimalPlaces: 2,
803
1079
  useCompactNotation: true,
804
1080
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1081
+ tooltip: 'Total of all custom expenses you have tagged as advertising spend.',
1082
+ formulaDisplay: 'Variable Ad Spend + Fixed Ad Spend',
1083
+ formula: 'variable_ad_spend + fixed_ad_spend',
1084
+ relatedMeasures: [measures_js_1.MEASURE.CORE_VARIABLE_AD_SPEND, measures_js_1.MEASURE.CORE_FIXED_AD_SPEND, measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND],
805
1085
  },
806
1086
  [measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND]: {
807
1087
  title: 'Blended Ad Spend',
808
- description: 'Total ad spend combining API channel spend and custom ad spend expenses',
1088
+ description: 'Total ad spend combining API channel spend and custom ad spend expenses.',
809
1089
  sumPrefix: '$',
810
1090
  sumSuffix: '',
811
1091
  avgPrefix: '$',
812
1092
  avgSuffix: '',
813
- icon: 'upstack',
1093
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
814
1094
  measure: measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND,
815
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1095
+ category: measure_categories_js_1.MEASURE_CATEGORY.AD_PERFORMANCE,
1096
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.AD_PERFORMANCE_SPEND,
816
1097
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
817
1098
  decimalPlaces: 2,
818
1099
  useCompactNotation: true,
819
1100
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1101
+ tooltip: 'Your total advertising investment across all channels including custom entries.',
1102
+ formulaDisplay: 'Channel Spend + Custom Ad Spend',
1103
+ formula: 'channel_spend + custom_ad_spend',
1104
+ relatedMeasures: [measures_js_1.MEASURE.CHANNEL_SPEND, measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND, measures_js_1.MEASURE.CORE_CM3],
820
1105
  },
821
1106
  [measures_js_1.MEASURE.CORE_GROSS_PROFIT]: {
822
- title: 'Gross Profit (CM1)',
823
- description: 'Net Sales - Effective COGS',
1107
+ title: 'Gross Profit',
1108
+ shortTitle: 'Gross Profit',
1109
+ description: 'Net Sales minus Effective COGS. Also known as Contribution Margin 1 (CM1).',
824
1110
  sumPrefix: '$',
825
1111
  sumSuffix: '',
826
1112
  avgPrefix: '$',
827
1113
  avgSuffix: '',
828
- icon: 'upstack',
1114
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
829
1115
  measure: measures_js_1.MEASURE.CORE_GROSS_PROFIT,
830
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1116
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1117
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_GROSS_MARGIN,
831
1118
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
832
1119
  decimalPlaces: 2,
833
1120
  useCompactNotation: true,
834
1121
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1122
+ tooltip: 'Revenue remaining after product costs. The first level of contribution margin.',
1123
+ formulaDisplay: 'Net Sales − Effective COGS',
1124
+ formula: 'net_sales - effective_cogs',
1125
+ relatedMeasures: [measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT, measures_js_1.MEASURE.CORE_EFFECTIVE_COGS, measures_js_1.MEASURE.CORE_CM2],
835
1126
  },
836
1127
  [measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT]: {
837
- title: 'Gross Profit Margin %',
838
- description: 'Gross Profit as a percentage of Net Sales',
1128
+ title: 'Gross Profit Margin',
1129
+ shortTitle: 'Gross Margin',
1130
+ description: 'Gross Profit as a percentage of Net Sales.',
839
1131
  sumPrefix: '',
840
1132
  sumSuffix: '%',
841
1133
  avgPrefix: '',
842
1134
  avgSuffix: '%',
843
- icon: 'upstack',
1135
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
844
1136
  measure: measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT,
845
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1137
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1138
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_GROSS_MARGIN,
846
1139
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
847
1140
  decimalPlaces: 2,
848
1141
  useCompactNotation: false,
849
1142
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1143
+ tooltip: 'What percentage of net sales remains after product costs. Higher is better.',
1144
+ formulaDisplay: '(Gross Profit ÷ Net Sales) × 100',
1145
+ formula: '(gross_profit / net_sales) * 100',
1146
+ relatedMeasures: [measures_js_1.MEASURE.CORE_GROSS_PROFIT, measures_js_1.MEASURE.CORE_CM2_PERCENT, measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT],
850
1147
  },
851
1148
  [measures_js_1.MEASURE.CORE_CM2]: {
852
- title: 'CM2 (Contribution Margin 2)',
853
- description: 'Gross Profit - Shipping - Gateway Costs - Variable Expenses',
1149
+ title: 'Contribution Margin 2',
1150
+ shortTitle: 'CM2',
1151
+ description: 'Gross Profit minus shipping, gateway, and variable costs.',
854
1152
  sumPrefix: '$',
855
1153
  sumSuffix: '',
856
1154
  avgPrefix: '$',
857
1155
  avgSuffix: '',
858
- icon: 'upstack',
1156
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
859
1157
  measure: measures_js_1.MEASURE.CORE_CM2,
860
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1158
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1159
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
861
1160
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
862
1161
  decimalPlaces: 2,
863
1162
  useCompactNotation: true,
864
1163
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1164
+ tooltip: 'Profit after deducting fulfillment and variable operating costs.',
1165
+ formulaDisplay: 'Gross Profit − Shipping − Gateway − Variable Costs',
1166
+ formula: 'gross_profit - shipping - gateway - variable_costs',
1167
+ relatedMeasures: [measures_js_1.MEASURE.CORE_GROSS_PROFIT, measures_js_1.MEASURE.CORE_CM2_PERCENT, measures_js_1.MEASURE.CORE_CM3],
865
1168
  },
866
1169
  [measures_js_1.MEASURE.CORE_CM2_PERCENT]: {
867
- title: 'CM2 %',
868
- description: 'CM2 as a percentage of Net Sales',
1170
+ title: 'CM2 Margin',
1171
+ shortTitle: 'CM2 %',
1172
+ description: 'CM2 as a percentage of Net Sales.',
869
1173
  sumPrefix: '',
870
1174
  sumSuffix: '%',
871
1175
  avgPrefix: '',
872
1176
  avgSuffix: '%',
873
- icon: 'upstack',
1177
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
874
1178
  measure: measures_js_1.MEASURE.CORE_CM2_PERCENT,
875
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1179
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1180
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
876
1181
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
877
1182
  decimalPlaces: 2,
878
1183
  useCompactNotation: false,
879
1184
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1185
+ tooltip: 'What percentage of net sales remains after product and variable costs.',
1186
+ formulaDisplay: '(CM2 ÷ Net Sales) × 100',
1187
+ formula: '(cm2 / net_sales) * 100',
1188
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM2, measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT, measures_js_1.MEASURE.CORE_CM3_PERCENT],
880
1189
  },
881
1190
  [measures_js_1.MEASURE.CORE_CM3]: {
882
- title: 'CM3 (Contribution Margin 3)',
883
- description: 'CM2 - Blended Ad Spend',
1191
+ title: 'Contribution Margin 3',
1192
+ shortTitle: 'CM3',
1193
+ description: 'CM2 minus blended ad spend.',
884
1194
  sumPrefix: '$',
885
1195
  sumSuffix: '',
886
1196
  avgPrefix: '$',
887
1197
  avgSuffix: '',
888
- icon: 'upstack',
1198
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
889
1199
  measure: measures_js_1.MEASURE.CORE_CM3,
890
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1200
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1201
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
891
1202
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
892
1203
  decimalPlaces: 2,
893
1204
  useCompactNotation: true,
894
1205
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1206
+ tooltip: 'Profit after all variable costs including advertising. Key metric for marketing profitability.',
1207
+ formulaDisplay: 'CM2 − Blended Ad Spend',
1208
+ formula: 'cm2 - blended_ad_spend',
1209
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM2, measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND, measures_js_1.MEASURE.CORE_CM3_PERCENT, measures_js_1.MEASURE.CORE_NET_PROFIT],
895
1210
  },
896
1211
  [measures_js_1.MEASURE.CORE_CM3_PERCENT]: {
897
- title: 'CM3 %',
898
- description: 'CM3 as a percentage of Net Sales',
1212
+ title: 'CM3 Margin',
1213
+ shortTitle: 'CM3 %',
1214
+ description: 'CM3 as a percentage of Net Sales.',
899
1215
  sumPrefix: '',
900
1216
  sumSuffix: '%',
901
1217
  avgPrefix: '',
902
1218
  avgSuffix: '%',
903
- icon: 'upstack',
1219
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
904
1220
  measure: measures_js_1.MEASURE.CORE_CM3_PERCENT,
905
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1221
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1222
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_CONTRIBUTION_MARGIN,
906
1223
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
907
1224
  decimalPlaces: 2,
908
1225
  useCompactNotation: false,
909
1226
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1227
+ tooltip: 'What percentage of net sales remains after all variable costs including advertising.',
1228
+ formulaDisplay: '(CM3 ÷ Net Sales) × 100',
1229
+ formula: '(cm3 / net_sales) * 100',
1230
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM3, measures_js_1.MEASURE.CORE_CM2_PERCENT, measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT],
910
1231
  },
911
1232
  [measures_js_1.MEASURE.CORE_NET_PROFIT]: {
912
1233
  title: 'Net Profit',
913
- description: 'CM3 - Fixed Expenses',
1234
+ description: 'CM3 minus fixed expenses. Your bottom line.',
914
1235
  sumPrefix: '$',
915
1236
  sumSuffix: '',
916
1237
  avgPrefix: '$',
917
1238
  avgSuffix: '',
918
- icon: 'upstack',
1239
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
919
1240
  measure: measures_js_1.MEASURE.CORE_NET_PROFIT,
920
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1241
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1242
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_NET_PROFIT,
921
1243
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
922
1244
  decimalPlaces: 2,
923
1245
  useCompactNotation: true,
924
1246
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1247
+ tooltip: 'Your final profit after all costs. The true measure of business profitability.',
1248
+ formulaDisplay: 'CM3 − Fixed Costs',
1249
+ formula: 'cm3 - fixed_costs',
1250
+ relatedMeasures: [measures_js_1.MEASURE.CORE_CM3, measures_js_1.MEASURE.CORE_FIXED_COSTS, measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT],
925
1251
  },
926
1252
  [measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT]: {
927
- title: 'Net Profit Margin %',
928
- description: 'Net Profit as a percentage of Net Sales',
1253
+ title: 'Net Profit Margin',
1254
+ shortTitle: 'Net Margin',
1255
+ description: 'Net Profit as a percentage of Net Sales.',
929
1256
  sumPrefix: '',
930
1257
  sumSuffix: '%',
931
1258
  avgPrefix: '',
932
1259
  avgSuffix: '%',
933
- icon: 'upstack',
1260
+ icon: measure_icon_js_1.MEASURE_ICON.UPSTACK,
934
1261
  measure: measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT,
935
- category: measure_categories_js_1.MEASURE_CATEGORY.UPSTACK_DATA,
1262
+ category: measure_categories_js_1.MEASURE_CATEGORY.PROFITABILITY,
1263
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.PROFITABILITY_NET_PROFIT,
936
1264
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
937
1265
  decimalPlaces: 2,
938
1266
  useCompactNotation: false,
939
1267
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1268
+ tooltip: 'What percentage of net sales becomes profit. The ultimate efficiency metric.',
1269
+ formulaDisplay: '(Net Profit ÷ Net Sales) × 100',
1270
+ formula: '(net_profit / net_sales) * 100',
1271
+ relatedMeasures: [measures_js_1.MEASURE.CORE_NET_PROFIT, measures_js_1.MEASURE.CORE_CM3_PERCENT, measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT],
940
1272
  },
941
1273
  };
942
1274
  //# sourceMappingURL=core-measure-definitions.js.map