@adtrackify/at-tracking-event-types 4.41.0 → 4.41.1

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