@adtrackify/at-tracking-event-types 4.40.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 (75) hide show
  1. package/dist/cjs/__tests__/measure-alias-map.spec.js +14 -0
  2. package/dist/cjs/__tests__/measure-alias-map.spec.js.map +1 -1
  3. package/dist/cjs/types/api/feature.d.ts +22 -22
  4. package/dist/cjs/types/api/feature.js +22 -22
  5. package/dist/cjs/types/api/feature.js.map +1 -1
  6. package/dist/cjs/types/api/measures/definitions/channel-measure-definitions.js +654 -110
  7. package/dist/cjs/types/api/measures/definitions/channel-measure-definitions.js.map +1 -1
  8. package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js +550 -159
  9. package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js.map +1 -1
  10. package/dist/cjs/types/api/measures/definitions/emq-measure-definitions.js +77 -16
  11. package/dist/cjs/types/api/measures/definitions/emq-measure-definitions.js.map +1 -1
  12. package/dist/cjs/types/api/measures/definitions/facebook-measure-definitions.js +552 -105
  13. package/dist/cjs/types/api/measures/definitions/facebook-measure-definitions.js.map +1 -1
  14. package/dist/cjs/types/api/measures/definitions/google-measure-definitions.js +121 -21
  15. package/dist/cjs/types/api/measures/definitions/google-measure-definitions.js.map +1 -1
  16. package/dist/cjs/types/api/measures/definitions/measure-categories.d.ts +47 -0
  17. package/dist/cjs/types/api/measures/definitions/measure-categories.js +49 -1
  18. package/dist/cjs/types/api/measures/definitions/measure-categories.js.map +1 -1
  19. package/dist/cjs/types/api/measures/definitions/measure-definitions.d.ts +12 -3
  20. package/dist/cjs/types/api/measures/definitions/measure-definitions.js.map +1 -1
  21. package/dist/cjs/types/api/measures/definitions/orders-measure-definitions.js +1258 -235
  22. package/dist/cjs/types/api/measures/definitions/orders-measure-definitions.js.map +1 -1
  23. package/dist/cjs/types/api/measures/definitions/session-measure-definitions.js +111 -24
  24. package/dist/cjs/types/api/measures/definitions/session-measure-definitions.js.map +1 -1
  25. package/dist/cjs/types/api/measures/definitions/shopify/shopify-measure-definitions.js +190 -0
  26. package/dist/cjs/types/api/measures/definitions/shopify/shopify-measure-definitions.js.map +1 -1
  27. package/dist/cjs/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js +94 -0
  28. package/dist/cjs/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js.map +1 -1
  29. package/dist/cjs/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js +100 -0
  30. package/dist/cjs/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js.map +1 -1
  31. package/dist/cjs/types/api/measures/definitions/tracked-measure-definitions.js +266 -51
  32. package/dist/cjs/types/api/measures/definitions/tracked-measure-definitions.js.map +1 -1
  33. package/dist/cjs/types/api/measures/measure-alias-map.js +14 -0
  34. package/dist/cjs/types/api/measures/measure-alias-map.js.map +1 -1
  35. package/dist/cjs/types/api/measures/measures.d.ts +14 -1
  36. package/dist/cjs/types/api/measures/measures.js +13 -0
  37. package/dist/cjs/types/api/measures/measures.js.map +1 -1
  38. package/dist/esm/__tests__/measure-alias-map.spec.js +14 -0
  39. package/dist/esm/__tests__/measure-alias-map.spec.js.map +1 -1
  40. package/dist/esm/types/api/feature.d.ts +22 -22
  41. package/dist/esm/types/api/feature.js +22 -22
  42. package/dist/esm/types/api/feature.js.map +1 -1
  43. package/dist/esm/types/api/measures/definitions/channel-measure-definitions.js +655 -111
  44. package/dist/esm/types/api/measures/definitions/channel-measure-definitions.js.map +1 -1
  45. package/dist/esm/types/api/measures/definitions/core-measure-definitions.js +552 -161
  46. package/dist/esm/types/api/measures/definitions/core-measure-definitions.js.map +1 -1
  47. package/dist/esm/types/api/measures/definitions/emq-measure-definitions.js +78 -17
  48. package/dist/esm/types/api/measures/definitions/emq-measure-definitions.js.map +1 -1
  49. package/dist/esm/types/api/measures/definitions/facebook-measure-definitions.js +553 -106
  50. package/dist/esm/types/api/measures/definitions/facebook-measure-definitions.js.map +1 -1
  51. package/dist/esm/types/api/measures/definitions/google-measure-definitions.js +122 -22
  52. package/dist/esm/types/api/measures/definitions/google-measure-definitions.js.map +1 -1
  53. package/dist/esm/types/api/measures/definitions/measure-categories.d.ts +47 -0
  54. package/dist/esm/types/api/measures/definitions/measure-categories.js +48 -0
  55. package/dist/esm/types/api/measures/definitions/measure-categories.js.map +1 -1
  56. package/dist/esm/types/api/measures/definitions/measure-definitions.d.ts +12 -3
  57. package/dist/esm/types/api/measures/definitions/measure-definitions.js.map +1 -1
  58. package/dist/esm/types/api/measures/definitions/orders-measure-definitions.js +1171 -148
  59. package/dist/esm/types/api/measures/definitions/orders-measure-definitions.js.map +1 -1
  60. package/dist/esm/types/api/measures/definitions/session-measure-definitions.js +112 -25
  61. package/dist/esm/types/api/measures/definitions/session-measure-definitions.js.map +1 -1
  62. package/dist/esm/types/api/measures/definitions/shopify/shopify-measure-definitions.js +191 -1
  63. package/dist/esm/types/api/measures/definitions/shopify/shopify-measure-definitions.js.map +1 -1
  64. package/dist/esm/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js +95 -1
  65. package/dist/esm/types/api/measures/definitions/shopify/shopify-nc-measure-definitions.js.map +1 -1
  66. package/dist/esm/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js +101 -1
  67. package/dist/esm/types/api/measures/definitions/shopify/shopify-rc-measure-definitions.js.map +1 -1
  68. package/dist/esm/types/api/measures/definitions/tracked-measure-definitions.js +267 -52
  69. package/dist/esm/types/api/measures/definitions/tracked-measure-definitions.js.map +1 -1
  70. package/dist/esm/types/api/measures/measure-alias-map.js +14 -0
  71. package/dist/esm/types/api/measures/measure-alias-map.js.map +1 -1
  72. package/dist/esm/types/api/measures/measures.d.ts +14 -1
  73. package/dist/esm/types/api/measures/measures.js +13 -0
  74. package/dist/esm/types/api/measures/measures.js.map +1 -1
  75. package/package.json +1 -1
package/dist/cjs/types/api/measures/definitions/core-measure-definitions.js CHANGED
@@ -6,877 +6,1268 @@ const measure_categories_js_1 = require("./measure-categories.js");
6
6
  const measure_value_type_js_1 = require("./measure-value-type.js");
7
7
  const measure_applicable_contexts_js_1 = require("./measure-applicable-contexts.js");
8
8
  exports.CORE_MEASURES_MAP = {
9
+ [measures_js_1.MEASURE.CORE_CONVERSIONS]: {
10
+ title: 'Conversions',
11
+ description: 'Attributed conversions.',
12
+ sumPrefix: '',
13
+ sumSuffix: '',
14
+ avgPrefix: '',
15
+ avgSuffix: '',
16
+ icon: 'upstack',
17
+ measure: measures_js_1.MEASURE.CORE_CONVERSIONS,
18
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
19
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
20
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
21
+ decimalPlaces: 0,
22
+ useCompactNotation: false,
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],
26
+ },
27
+ [measures_js_1.MEASURE.CORE_CONVERSION_VALUE]: {
28
+ title: 'Conversion Value',
29
+ description: 'Total value of attributed conversions.',
30
+ sumPrefix: '$',
31
+ sumSuffix: '',
32
+ avgPrefix: '$',
33
+ avgSuffix: '',
34
+ icon: 'upstack',
35
+ measure: measures_js_1.MEASURE.CORE_CONVERSION_VALUE,
36
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
37
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
38
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
39
+ decimalPlaces: 2,
40
+ useCompactNotation: true,
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],
44
+ },
45
+ [measures_js_1.MEASURE.CORE_UNIQUE_CONVERTERS]: {
46
+ title: 'Unique Converters',
47
+ description: 'Unique identities that converted.',
48
+ sumPrefix: '',
49
+ sumSuffix: '',
50
+ avgPrefix: '',
51
+ avgSuffix: '',
52
+ icon: 'upstack',
53
+ measure: measures_js_1.MEASURE.CORE_UNIQUE_CONVERTERS,
54
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
55
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
56
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
57
+ decimalPlaces: 0,
58
+ useCompactNotation: false,
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],
62
+ },
63
+ [measures_js_1.MEASURE.CORE_AVERAGE_CONVERSION_VALUE]: {
64
+ title: 'Average Conversion Value',
65
+ shortTitle: 'Avg Conv Value',
66
+ description: 'Average value per conversion.',
67
+ sumPrefix: '$',
68
+ sumSuffix: '',
69
+ avgPrefix: '$',
70
+ avgSuffix: '',
71
+ icon: 'upstack',
72
+ measure: measures_js_1.MEASURE.CORE_AVERAGE_CONVERSION_VALUE,
73
+ category: measure_categories_js_1.MEASURE_CATEGORY.FUNNEL,
74
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.FUNNEL_CONVERSIONS,
75
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
76
+ decimalPlaces: 2,
77
+ useCompactNotation: true,
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],
83
+ },
9
84
  [measures_js_1.MEASURE.CORE_CPA]: {
10
- title: 'CPA: (Cost Per Acquisition)',
11
- 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.',
12
88
  sumPrefix: '$',
13
89
  sumSuffix: '',
14
90
  avgPrefix: '$',
15
91
  avgSuffix: '',
16
92
  icon: 'upstack',
17
93
  measure: measures_js_1.MEASURE.CORE_CPA,
18
- 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,
19
96
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
20
97
  decimalPlaces: 2,
21
98
  useCompactNotation: true,
22
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],
23
104
  },
24
105
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA]: {
25
- title: 'NCPA: (New Customer Cost Per Acquisition)',
26
- 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.',
27
109
  sumPrefix: '$',
28
110
  sumSuffix: '',
29
111
  avgPrefix: '$',
30
112
  avgSuffix: '',
31
113
  icon: 'upstack',
32
114
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CPA,
33
- 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,
34
117
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
35
118
  decimalPlaces: 2,
36
119
  useCompactNotation: true,
37
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],
38
125
  },
39
126
  [measures_js_1.MEASURE.CORE_RETURNING_CUSTOMER_CPA]: {
40
- title: 'RCPA: (Returning Customer Cost Per Acquisition)',
41
- 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.',
42
130
  sumPrefix: '$',
43
131
  sumSuffix: '',
44
132
  avgPrefix: '$',
45
133
  avgSuffix: '',
46
134
  icon: 'upstack',
47
135
  measure: measures_js_1.MEASURE.CORE_RETURNING_CUSTOMER_CPA,
48
- 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,
49
138
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
50
139
  decimalPlaces: 2,
51
140
  useCompactNotation: true,
52
- applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
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],
53
146
  },
54
147
  [measures_js_1.MEASURE.CORE_MER]: {
55
- title: 'MER (Marketing Efficiency Ratio)',
56
- 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.',
57
151
  sumPrefix: '',
58
152
  sumSuffix: '%',
59
153
  avgPrefix: '',
60
154
  avgSuffix: '%',
61
155
  icon: 'upstack',
62
156
  measure: measures_js_1.MEASURE.CORE_MER,
63
- 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,
64
159
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
65
160
  decimalPlaces: 2,
66
161
  useCompactNotation: false,
67
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],
68
167
  },
69
168
  [measures_js_1.MEASURE.CORE_MER_NET]: {
70
- title: 'MER (Net Sales): Marketing Efficiency Ratio using Net Sales',
71
- 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.',
72
172
  sumPrefix: '',
73
173
  sumSuffix: '%',
74
174
  avgPrefix: '',
75
175
  avgSuffix: '%',
76
176
  icon: 'upstack',
77
177
  measure: measures_js_1.MEASURE.CORE_MER_NET,
78
- 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,
79
180
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
80
181
  decimalPlaces: 2,
81
182
  useCompactNotation: false,
82
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],
83
188
  },
84
189
  [measures_js_1.MEASURE.CORE_MER_GROSS]: {
85
- title: 'MER (Gross Sales): Marketing Efficiency Ratio using Gross Sales',
86
- 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.',
87
193
  sumPrefix: '',
88
194
  sumSuffix: '%',
89
195
  avgPrefix: '',
90
196
  avgSuffix: '%',
91
197
  icon: 'upstack',
92
198
  measure: measures_js_1.MEASURE.CORE_MER_GROSS,
93
- 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,
94
201
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
95
202
  decimalPlaces: 2,
96
203
  useCompactNotation: false,
97
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],
98
209
  },
99
210
  [measures_js_1.MEASURE.CORE_ROAS_TOTAL]: {
100
- title: 'ROAS (Revenue): Return on Ad Spend using Total Sales',
101
- description: 'Total Revenue / Total Ad Spend',
211
+ title: 'Return on Ad Spend',
212
+ shortTitle: 'ROAS',
213
+ description: 'Total Revenue divided by Total Ad Spend.',
102
214
  sumPrefix: '',
103
215
  sumSuffix: 'x',
104
216
  avgPrefix: '',
105
217
  avgSuffix: 'x',
106
218
  icon: 'upstack',
107
219
  measure: measures_js_1.MEASURE.CORE_ROAS_TOTAL,
108
- 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,
109
222
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
110
223
  decimalPlaces: 2,
111
224
  useCompactNotation: false,
112
225
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
113
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],
114
231
  },
115
232
  [measures_js_1.MEASURE.CORE_ROAS_GROSS]: {
116
- title: 'ROAS (Gross Sales): Return on Ad Spend using Gross Sales',
117
- description: 'Gross Sales / Total Ad Spend',
233
+ title: 'ROAS (Gross Sales)',
234
+ shortTitle: 'ROAS Gross',
235
+ description: 'Gross Sales divided by Total Ad Spend.',
118
236
  sumPrefix: '',
119
237
  sumSuffix: 'x',
120
238
  avgPrefix: '',
121
239
  avgSuffix: 'x',
122
240
  icon: 'upstack',
123
241
  measure: measures_js_1.MEASURE.CORE_ROAS_GROSS,
124
- 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,
125
244
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
126
245
  decimalPlaces: 2,
127
246
  useCompactNotation: false,
128
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],
129
252
  },
130
253
  [measures_js_1.MEASURE.CORE_ROAS_NET]: {
131
- title: 'ROAS (Net Sales): Return on Ad Spend using Net Sales',
132
- description: 'Net Sales / Total Ad Spend',
254
+ title: 'ROAS (Net Sales)',
255
+ shortTitle: 'ROAS Net',
256
+ description: 'Net Sales divided by Total Ad Spend.',
133
257
  sumPrefix: '',
134
258
  sumSuffix: 'x',
135
259
  avgPrefix: '',
136
260
  avgSuffix: 'x',
137
261
  icon: 'upstack',
138
262
  measure: measures_js_1.MEASURE.CORE_ROAS_NET,
139
- 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,
140
265
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
141
266
  decimalPlaces: 2,
142
267
  useCompactNotation: false,
143
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],
144
273
  },
145
274
  [measures_js_1.MEASURE.CORE_SPEND_GROSS_PERCENT]: {
146
- title: 'Ad Spend as a percentage of Gross Sales',
147
- 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.',
148
278
  sumPrefix: '',
149
279
  sumSuffix: '%',
150
280
  avgPrefix: '',
151
281
  avgSuffix: '%',
152
282
  icon: 'upstack',
153
283
  measure: measures_js_1.MEASURE.CORE_SPEND_GROSS_PERCENT,
154
- 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,
155
286
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
156
287
  decimalPlaces: 2,
157
288
  useCompactNotation: false,
158
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],
159
294
  },
160
295
  [measures_js_1.MEASURE.CORE_SPEND_NET_PERCENT]: {
161
296
  title: 'Ad Spend % of Net Sales',
162
- 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.',
163
299
  sumPrefix: '',
164
300
  sumSuffix: '%',
165
301
  avgPrefix: '',
166
302
  avgSuffix: '%',
167
303
  icon: 'upstack',
168
304
  measure: measures_js_1.MEASURE.CORE_SPEND_NET_PERCENT,
169
- 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,
170
307
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
171
308
  decimalPlaces: 2,
172
309
  useCompactNotation: false,
173
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],
174
315
  },
175
316
  [measures_js_1.MEASURE.CORE_RAAD]: {
176
- title: 'RAAD - (Revenue after Discounts, Returns, Ad Spend)',
177
- description: 'Total Revenue - Ad Spend',
317
+ title: 'Revenue After Ad Spend',
318
+ shortTitle: 'RAAD',
319
+ description: 'Total Revenue minus Ad Spend.',
178
320
  sumPrefix: '$',
179
321
  sumSuffix: '',
180
322
  avgPrefix: '$',
181
323
  avgSuffix: '',
182
324
  icon: 'upstack',
183
325
  measure: measures_js_1.MEASURE.CORE_RAAD,
184
- 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,
185
328
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
186
329
  decimalPlaces: 2,
187
330
  useCompactNotation: true,
188
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],
189
336
  },
190
337
  [measures_js_1.MEASURE.CORE_RAAD_GROSS]: {
191
- title: 'RAAD (Gross Sales): Revenue after Discounts, Returns, Ad Spend',
192
- description: 'Gross Sales - Ad Spend',
338
+ title: 'RAAD (Gross Sales)',
339
+ shortTitle: 'RAAD Gross',
340
+ description: 'Gross Sales minus Ad Spend.',
193
341
  sumPrefix: '$',
194
342
  sumSuffix: '',
195
343
  avgPrefix: '$',
196
344
  avgSuffix: '',
197
345
  icon: 'upstack',
198
346
  measure: measures_js_1.MEASURE.CORE_RAAD_GROSS,
199
- 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,
200
349
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
201
350
  decimalPlaces: 2,
202
351
  useCompactNotation: true,
203
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],
204
357
  },
205
358
  [measures_js_1.MEASURE.CORE_RAAD_NET]: {
206
- title: 'RAAD (Net Sales): Revenue after Discounts, Returns, Ad Spend',
207
- description: 'Net Sales - Ad Spend',
359
+ title: 'RAAD (Net Sales)',
360
+ shortTitle: 'RAAD Net',
361
+ description: 'Net Sales minus Ad Spend.',
208
362
  sumPrefix: '$',
209
363
  sumSuffix: '',
210
364
  avgPrefix: '$',
211
365
  avgSuffix: '',
212
366
  icon: 'upstack',
213
367
  measure: measures_js_1.MEASURE.CORE_RAAD_NET,
214
- 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,
215
370
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
216
371
  decimalPlaces: 2,
217
372
  useCompactNotation: true,
218
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],
219
378
  },
220
379
  [measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT]: {
221
- title: 'RAAD % of Total',
222
- 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.',
223
383
  sumPrefix: '',
224
384
  sumSuffix: '%',
225
385
  avgPrefix: '',
226
386
  avgSuffix: '%',
227
387
  icon: 'upstack',
228
388
  measure: measures_js_1.MEASURE.CORE_RAAD_TOTAL_PERCENT,
229
- 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,
230
391
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
231
392
  decimalPlaces: 2,
232
393
  useCompactNotation: false,
233
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],
234
399
  },
235
400
  [measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT]: {
236
- title: 'RAAD % of Gross',
237
- 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.',
238
404
  sumPrefix: '',
239
405
  sumSuffix: '%',
240
406
  avgPrefix: '',
241
407
  avgSuffix: '%',
242
408
  icon: 'upstack',
243
409
  measure: measures_js_1.MEASURE.CORE_RAAD_GROSS_PERCENT,
244
- 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,
245
412
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
246
413
  decimalPlaces: 2,
247
414
  useCompactNotation: false,
248
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],
249
420
  },
250
421
  [measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT]: {
251
- title: 'RAAD % of Net',
252
- 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.',
253
425
  sumPrefix: '',
254
426
  sumSuffix: '%',
255
427
  avgPrefix: '',
256
428
  avgSuffix: '%',
257
429
  icon: 'upstack',
258
430
  measure: measures_js_1.MEASURE.CORE_RAAD_NET_PERCENT,
259
- 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,
260
433
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
261
434
  decimalPlaces: 2,
262
435
  useCompactNotation: false,
263
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],
264
441
  },
265
442
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD]: {
266
- title: 'NC-RAAD - (Revenue after Discounts, Returns, Ad Spend)',
267
- 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.',
268
446
  sumPrefix: '$',
269
447
  sumSuffix: '',
270
448
  avgPrefix: '$',
271
449
  avgSuffix: '',
272
450
  icon: 'upstack',
273
451
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD,
274
- 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,
275
454
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
276
455
  decimalPlaces: 2,
277
456
  useCompactNotation: true,
278
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],
279
462
  },
280
463
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS]: {
281
- title: 'NC-RAAD (Gross Sales): Revenue after Discounts, Returns, Ad Spend',
282
- 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.',
283
467
  sumPrefix: '$',
284
468
  sumSuffix: '',
285
469
  avgPrefix: '$',
286
470
  avgSuffix: '',
287
471
  icon: 'upstack',
288
472
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS,
289
- 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,
290
475
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
291
476
  decimalPlaces: 2,
292
477
  useCompactNotation: true,
293
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],
294
483
  },
295
484
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET]: {
296
- title: 'NC-RAAD (Net Sales): Revenue after Discounts, Returns, Ad Spend',
297
- 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.',
298
488
  sumPrefix: '$',
299
489
  sumSuffix: '',
300
490
  avgPrefix: '$',
301
491
  avgSuffix: '',
302
492
  icon: 'upstack',
303
493
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET,
304
- 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,
305
496
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
306
497
  decimalPlaces: 2,
307
498
  useCompactNotation: true,
308
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],
309
504
  },
310
505
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_TOTAL_PERCENT]: {
311
- title: 'NC-RAAD % of Total',
312
- 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.',
313
509
  sumPrefix: '',
314
510
  sumSuffix: '%',
315
511
  avgPrefix: '',
316
512
  avgSuffix: '%',
317
513
  icon: 'upstack',
318
514
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_TOTAL_PERCENT,
319
- 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,
320
517
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
321
518
  decimalPlaces: 2,
322
519
  useCompactNotation: false,
323
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],
324
525
  },
325
526
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT]: {
326
- title: 'NC-RAAD % of Gross',
327
- 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.',
328
530
  sumPrefix: '',
329
531
  sumSuffix: '%',
330
532
  avgPrefix: '',
331
533
  avgSuffix: '%',
332
534
  icon: 'upstack',
333
535
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_GROSS_PERCENT,
334
- 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,
335
538
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
336
539
  decimalPlaces: 2,
337
540
  useCompactNotation: false,
338
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],
339
546
  },
340
547
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT]: {
341
- title: 'NC-RAAD % of Net',
342
- 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.',
343
551
  sumPrefix: '',
344
552
  sumSuffix: '%',
345
553
  avgPrefix: '',
346
554
  avgSuffix: '%',
347
555
  icon: 'upstack',
348
556
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_RAAD_NET_PERCENT,
349
- 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,
350
559
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
351
560
  decimalPlaces: 2,
352
561
  useCompactNotation: false,
353
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],
354
567
  },
355
568
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL]: {
356
- title: 'NC-ROAS (New Customer Return On Ad Spend)',
357
- 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.',
358
572
  sumPrefix: '',
359
573
  sumSuffix: 'x',
360
574
  avgPrefix: '',
361
575
  avgSuffix: 'x',
362
576
  icon: 'upstack',
363
577
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_TOTAL,
364
- 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,
365
580
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
366
581
  decimalPlaces: 2,
367
582
  useCompactNotation: false,
368
583
  applicableContexts: measure_applicable_contexts_js_1.STANDARD_APPLICABLE_CONTEXTS,
369
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],
370
589
  },
371
590
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS]: {
372
- title: 'NC-ROAS GROSS (New Customer Return On Ad Spend)',
373
- 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.',
374
594
  sumPrefix: '',
375
595
  sumSuffix: 'x',
376
596
  avgPrefix: '',
377
597
  avgSuffix: 'x',
378
598
  icon: 'upstack',
379
599
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_GROSS,
380
- 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,
381
602
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
382
603
  decimalPlaces: 2,
383
604
  useCompactNotation: false,
384
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],
385
610
  },
386
611
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_NET]: {
387
- title: 'NC-ROAS NET (New Customer Return On Ad Spend)',
388
- 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.',
389
615
  sumPrefix: '',
390
616
  sumSuffix: 'x',
391
617
  avgPrefix: '',
392
618
  avgSuffix: 'x',
393
619
  icon: 'upstack',
394
620
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_ROAS_NET,
395
- 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,
396
623
  valueType: measure_value_type_js_1.MeasureValueType.MULTIPLIER,
397
624
  decimalPlaces: 2,
398
625
  useCompactNotation: false,
399
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],
400
631
  },
401
632
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER]: {
402
- title: 'NC-MER (New Customer Marketing Efficiency Ratio)',
403
- 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.',
404
636
  sumPrefix: '',
405
637
  sumSuffix: '%',
406
638
  avgPrefix: '',
407
639
  avgSuffix: '%',
408
640
  icon: 'upstack',
409
641
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER,
410
- 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,
411
644
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
412
645
  decimalPlaces: 2,
413
646
  useCompactNotation: false,
414
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],
415
652
  },
416
653
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_GROSS]: {
417
- title: 'NC-MER GROSS (New Customer Marketing Efficiency Ratio)',
418
- 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.',
419
657
  sumPrefix: '',
420
658
  sumSuffix: '%',
421
659
  avgPrefix: '',
422
660
  avgSuffix: '%',
423
661
  icon: 'upstack',
424
662
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_GROSS,
425
- 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,
426
665
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
427
666
  decimalPlaces: 2,
428
667
  useCompactNotation: false,
429
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],
430
673
  },
431
674
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_NET]: {
432
- title: 'NC-MER NET (New Customer Marketing Efficiency Ratio)',
433
- 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.',
434
678
  sumPrefix: '',
435
679
  sumSuffix: '%',
436
680
  avgPrefix: '',
437
681
  avgSuffix: '%',
438
682
  icon: 'upstack',
439
683
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_MER_NET,
440
- 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,
441
686
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
442
687
  decimalPlaces: 2,
443
688
  useCompactNotation: false,
444
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],
445
694
  },
446
695
  [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS]: {
447
- title: 'Effective COGS',
448
- 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).',
449
699
  sumPrefix: '$',
450
700
  sumSuffix: '',
451
701
  avgPrefix: '$',
452
702
  avgSuffix: '',
453
703
  icon: 'upstack',
454
704
  measure: measures_js_1.MEASURE.CORE_EFFECTIVE_COGS,
455
- 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,
456
707
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
457
708
  decimalPlaces: 2,
458
709
  useCompactNotation: true,
459
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],
460
715
  },
461
716
  [measures_js_1.MEASURE.CORE_EFFECTIVE_COGS_PERCENT]: {
462
717
  title: 'Effective COGS %',
463
- description: 'Effective COGS as a percentage of Net Sales',
718
+ shortTitle: 'COGS %',
719
+ description: 'Effective COGS as a percentage of Net Sales.',
464
720
  sumPrefix: '',
465
721
  sumSuffix: '%',
466
722
  avgPrefix: '',
467
723
  avgSuffix: '%',
468
724
  icon: 'upstack',
469
725
  measure: measures_js_1.MEASURE.CORE_EFFECTIVE_COGS_PERCENT,
470
- 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,
471
728
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
472
729
  decimalPlaces: 2,
473
730
  useCompactNotation: false,
474
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],
475
736
  },
476
737
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_EFFECTIVE_COGS]: {
477
- title: 'NC Effective COGS',
478
- description: 'New Customer Effective COGS',
738
+ title: 'New Customer Effective COGS',
739
+ shortTitle: 'NC COGS',
740
+ description: 'Effective COGS for new customer orders.',
479
741
  sumPrefix: '$',
480
742
  sumSuffix: '',
481
743
  avgPrefix: '$',
482
744
  avgSuffix: '',
483
745
  icon: 'upstack',
484
746
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_EFFECTIVE_COGS,
485
- 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,
486
749
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
487
750
  decimalPlaces: 2,
488
751
  useCompactNotation: true,
489
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],
490
755
  },
491
756
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_VARIABLE_COSTS]: {
492
- title: 'NC Variable Costs',
493
- description: 'New Customer Variable Costs',
757
+ title: 'New Customer Variable Costs',
758
+ shortTitle: 'NC Variable',
759
+ description: 'Variable costs attributed to new customer orders.',
494
760
  sumPrefix: '$',
495
761
  sumSuffix: '',
496
762
  avgPrefix: '$',
497
763
  avgSuffix: '',
498
764
  icon: 'upstack',
499
765
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_VARIABLE_COSTS,
500
- 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,
501
768
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
502
769
  decimalPlaces: 2,
503
770
  useCompactNotation: true,
504
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],
505
774
  },
506
775
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_FIXED_COSTS]: {
507
- title: 'NC Fixed Costs',
508
- description: 'New Customer Fixed Costs',
776
+ title: 'New Customer Fixed Costs',
777
+ shortTitle: 'NC Fixed',
778
+ description: 'Fixed costs attributed to new customer orders.',
509
779
  sumPrefix: '$',
510
780
  sumSuffix: '',
511
781
  avgPrefix: '$',
512
782
  avgSuffix: '',
513
783
  icon: 'upstack',
514
784
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_FIXED_COSTS,
515
- 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,
516
787
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
517
788
  decimalPlaces: 2,
518
789
  useCompactNotation: true,
519
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],
520
793
  },
521
794
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT]: {
522
- title: 'New Customer Gross Profit (CM1)',
523
- 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).',
524
798
  sumPrefix: '$',
525
799
  sumSuffix: '',
526
800
  avgPrefix: '$',
527
801
  avgSuffix: '',
528
802
  icon: 'upstack',
529
803
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_GROSS_PROFIT,
530
- 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,
531
806
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
532
807
  decimalPlaces: 2,
533
808
  useCompactNotation: true,
534
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],
535
814
  },
536
815
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2]: {
537
- title: 'New Customer CM2',
538
- 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.',
539
819
  sumPrefix: '$',
540
820
  sumSuffix: '',
541
821
  avgPrefix: '$',
542
822
  avgSuffix: '',
543
823
  icon: 'upstack',
544
824
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM2,
545
- 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,
546
827
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
547
828
  decimalPlaces: 2,
548
829
  useCompactNotation: true,
549
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],
550
835
  },
551
836
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM3]: {
552
- title: 'New Customer CM3',
553
- 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.',
554
840
  sumPrefix: '$',
555
841
  sumSuffix: '',
556
842
  avgPrefix: '$',
557
843
  avgSuffix: '',
558
844
  icon: 'upstack',
559
845
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_CM3,
560
- 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,
561
848
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
562
849
  decimalPlaces: 2,
563
850
  useCompactNotation: true,
564
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],
565
856
  },
566
857
  [measures_js_1.MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT]: {
567
858
  title: 'New Customer Net Profit',
568
- description: 'New Customer CM3 - NC Fixed Expenses',
859
+ shortTitle: 'NC Net Profit',
860
+ description: 'New customer CM3 minus fixed expenses.',
569
861
  sumPrefix: '$',
570
862
  sumSuffix: '',
571
863
  avgPrefix: '$',
572
864
  avgSuffix: '',
573
865
  icon: 'upstack',
574
866
  measure: measures_js_1.MEASURE.CORE_NEW_CUSTOMER_NET_PROFIT,
575
- 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,
576
869
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
577
870
  decimalPlaces: 2,
578
871
  useCompactNotation: true,
579
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],
580
877
  },
581
878
  [measures_js_1.MEASURE.CORE_COGS_ORDERS]: {
582
879
  title: 'COGS (Orders)',
583
- description: 'Cost of Goods Sold from orders',
880
+ shortTitle: 'Order COGS',
881
+ description: 'Cost of Goods Sold from orders.',
584
882
  sumPrefix: '$',
585
883
  sumSuffix: '',
586
884
  avgPrefix: '$',
587
885
  avgSuffix: '',
588
886
  icon: 'upstack',
589
887
  measure: measures_js_1.MEASURE.CORE_COGS_ORDERS,
590
- 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,
591
890
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
592
891
  decimalPlaces: 2,
593
892
  useCompactNotation: true,
594
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],
595
896
  },
596
897
  [measures_js_1.MEASURE.CORE_COGS_REFUNDS]: {
597
898
  title: 'COGS (Refunds)',
598
- description: 'Cost of Goods Sold recovered from refunds',
899
+ shortTitle: 'Refund COGS',
900
+ description: 'Cost of Goods Sold recovered from refunds.',
599
901
  sumPrefix: '$',
600
902
  sumSuffix: '',
601
903
  avgPrefix: '$',
602
904
  avgSuffix: '',
603
905
  icon: 'upstack',
604
906
  measure: measures_js_1.MEASURE.CORE_COGS_REFUNDS,
605
- 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,
606
909
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
607
910
  decimalPlaces: 2,
608
911
  useCompactNotation: true,
609
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],
610
915
  },
611
916
  [measures_js_1.MEASURE.CORE_VARIABLE_COSTS]: {
612
917
  title: 'Variable Costs',
613
- description: 'Total custom variable expenses (per-order fees, % of sales, etc.)',
918
+ description: 'Total custom variable expenses (per-order fees, % of sales, etc.).',
614
919
  sumPrefix: '$',
615
920
  sumSuffix: '',
616
921
  avgPrefix: '$',
617
922
  avgSuffix: '',
618
923
  icon: 'upstack',
619
924
  measure: measures_js_1.MEASURE.CORE_VARIABLE_COSTS,
620
- 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,
621
927
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
622
928
  decimalPlaces: 2,
623
929
  useCompactNotation: true,
624
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],
625
933
  },
626
934
  [measures_js_1.MEASURE.CORE_VARIABLE_COSTS_PERCENT]: {
627
935
  title: 'Variable Costs %',
628
- description: 'Variable costs as a percentage of Net Sales',
936
+ description: 'Variable costs as a percentage of Net Sales.',
629
937
  sumPrefix: '',
630
938
  sumSuffix: '%',
631
939
  avgPrefix: '',
632
940
  avgSuffix: '%',
633
941
  icon: 'upstack',
634
942
  measure: measures_js_1.MEASURE.CORE_VARIABLE_COSTS_PERCENT,
635
- 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,
636
945
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
637
946
  decimalPlaces: 2,
638
947
  useCompactNotation: false,
639
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],
640
953
  },
641
954
  [measures_js_1.MEASURE.CORE_FIXED_COSTS]: {
642
955
  title: 'Fixed Costs',
643
- description: 'Total fixed expenses (rent, salaries, software, etc.)',
956
+ description: 'Total fixed expenses (rent, salaries, software, etc.).',
644
957
  sumPrefix: '$',
645
958
  sumSuffix: '',
646
959
  avgPrefix: '$',
647
960
  avgSuffix: '',
648
961
  icon: 'upstack',
649
962
  measure: measures_js_1.MEASURE.CORE_FIXED_COSTS,
650
- 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,
651
965
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
652
966
  decimalPlaces: 2,
653
967
  useCompactNotation: true,
654
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],
655
971
  },
656
972
  [measures_js_1.MEASURE.CORE_FIXED_COSTS_PERCENT]: {
657
973
  title: 'Fixed Costs %',
658
- description: 'Fixed costs as a percentage of Net Sales',
974
+ description: 'Fixed costs as a percentage of Net Sales.',
659
975
  sumPrefix: '',
660
976
  sumSuffix: '%',
661
977
  avgPrefix: '',
662
978
  avgSuffix: '%',
663
979
  icon: 'upstack',
664
980
  measure: measures_js_1.MEASURE.CORE_FIXED_COSTS_PERCENT,
665
- 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,
666
983
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
667
984
  decimalPlaces: 2,
668
985
  useCompactNotation: false,
669
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],
670
991
  },
671
992
  [measures_js_1.MEASURE.CORE_SHIPPING_COSTS]: {
672
993
  title: 'Shipping Costs',
673
- description: 'Seller-side shipping expenses',
994
+ description: 'Seller-side shipping expenses.',
674
995
  sumPrefix: '$',
675
996
  sumSuffix: '',
676
997
  avgPrefix: '$',
677
998
  avgSuffix: '',
678
999
  icon: 'upstack',
679
1000
  measure: measures_js_1.MEASURE.CORE_SHIPPING_COSTS,
680
- 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,
681
1003
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
682
1004
  decimalPlaces: 2,
683
1005
  useCompactNotation: true,
684
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],
685
1009
  },
686
1010
  [measures_js_1.MEASURE.CORE_PAYMENT_GATEWAY_COSTS]: {
687
1011
  title: 'Payment Gateway Costs',
688
- description: 'Payment processing fees (flat + percentage per gateway)',
1012
+ shortTitle: 'Gateway Costs',
1013
+ description: 'Payment processing fees (flat + percentage per gateway).',
689
1014
  sumPrefix: '$',
690
1015
  sumSuffix: '',
691
1016
  avgPrefix: '$',
692
1017
  avgSuffix: '',
693
1018
  icon: 'upstack',
694
1019
  measure: measures_js_1.MEASURE.CORE_PAYMENT_GATEWAY_COSTS,
695
- 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,
696
1022
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
697
1023
  decimalPlaces: 2,
698
1024
  useCompactNotation: true,
699
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],
700
1028
  },
701
1029
  [measures_js_1.MEASURE.CORE_VARIABLE_AD_SPEND]: {
702
1030
  title: 'Variable Ad Spend',
703
- description: 'Internal: variable expenses marked as ad spend (per-order calculation)',
1031
+ description: 'Variable expenses marked as ad spend (per-order calculation).',
704
1032
  sumPrefix: '$',
705
1033
  sumSuffix: '',
706
1034
  avgPrefix: '$',
707
1035
  avgSuffix: '',
708
1036
  icon: 'upstack',
709
1037
  measure: measures_js_1.MEASURE.CORE_VARIABLE_AD_SPEND,
710
- 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,
711
1040
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
712
1041
  decimalPlaces: 2,
713
1042
  useCompactNotation: true,
714
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],
715
1046
  },
716
1047
  [measures_js_1.MEASURE.CORE_FIXED_AD_SPEND]: {
717
1048
  title: 'Fixed Ad Spend',
718
- description: 'Internal: fixed expenses marked as ad spend (date-allocated)',
1049
+ description: 'Fixed expenses marked as ad spend (date-allocated).',
719
1050
  sumPrefix: '$',
720
1051
  sumSuffix: '',
721
1052
  avgPrefix: '$',
722
1053
  avgSuffix: '',
723
1054
  icon: 'upstack',
724
1055
  measure: measures_js_1.MEASURE.CORE_FIXED_AD_SPEND,
725
- 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,
726
1058
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
727
1059
  decimalPlaces: 2,
728
1060
  useCompactNotation: true,
729
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],
730
1064
  },
731
1065
  [measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND]: {
732
1066
  title: 'Custom Ad Spend',
733
- 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.',
734
1068
  sumPrefix: '$',
735
1069
  sumSuffix: '',
736
1070
  avgPrefix: '$',
737
1071
  avgSuffix: '',
738
1072
  icon: 'upstack',
739
1073
  measure: measures_js_1.MEASURE.CORE_CUSTOM_AD_SPEND,
740
- 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,
741
1076
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
742
1077
  decimalPlaces: 2,
743
1078
  useCompactNotation: true,
744
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],
745
1084
  },
746
1085
  [measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND]: {
747
1086
  title: 'Blended Ad Spend',
748
- 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.',
749
1088
  sumPrefix: '$',
750
1089
  sumSuffix: '',
751
1090
  avgPrefix: '$',
752
1091
  avgSuffix: '',
753
1092
  icon: 'upstack',
754
1093
  measure: measures_js_1.MEASURE.CORE_BLENDED_AD_SPEND,
755
- 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,
756
1096
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
757
1097
  decimalPlaces: 2,
758
1098
  useCompactNotation: true,
759
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],
760
1104
  },
761
1105
  [measures_js_1.MEASURE.CORE_GROSS_PROFIT]: {
762
- title: 'Gross Profit (CM1)',
763
- 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).',
764
1109
  sumPrefix: '$',
765
1110
  sumSuffix: '',
766
1111
  avgPrefix: '$',
767
1112
  avgSuffix: '',
768
1113
  icon: 'upstack',
769
1114
  measure: measures_js_1.MEASURE.CORE_GROSS_PROFIT,
770
- 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,
771
1117
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
772
1118
  decimalPlaces: 2,
773
1119
  useCompactNotation: true,
774
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],
775
1125
  },
776
1126
  [measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT]: {
777
- title: 'Gross Profit Margin %',
778
- 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.',
779
1130
  sumPrefix: '',
780
1131
  sumSuffix: '%',
781
1132
  avgPrefix: '',
782
1133
  avgSuffix: '%',
783
1134
  icon: 'upstack',
784
1135
  measure: measures_js_1.MEASURE.CORE_GROSS_PROFIT_PERCENT,
785
- 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,
786
1138
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
787
1139
  decimalPlaces: 2,
788
1140
  useCompactNotation: false,
789
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],
790
1146
  },
791
1147
  [measures_js_1.MEASURE.CORE_CM2]: {
792
- title: 'CM2 (Contribution Margin 2)',
793
- 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.',
794
1151
  sumPrefix: '$',
795
1152
  sumSuffix: '',
796
1153
  avgPrefix: '$',
797
1154
  avgSuffix: '',
798
1155
  icon: 'upstack',
799
1156
  measure: measures_js_1.MEASURE.CORE_CM2,
800
- 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,
801
1159
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
802
1160
  decimalPlaces: 2,
803
1161
  useCompactNotation: true,
804
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],
805
1167
  },
806
1168
  [measures_js_1.MEASURE.CORE_CM2_PERCENT]: {
807
- title: 'CM2 %',
808
- description: 'CM2 as a percentage of Net Sales',
1169
+ title: 'CM2 Margin',
1170
+ shortTitle: 'CM2 %',
1171
+ description: 'CM2 as a percentage of Net Sales.',
809
1172
  sumPrefix: '',
810
1173
  sumSuffix: '%',
811
1174
  avgPrefix: '',
812
1175
  avgSuffix: '%',
813
1176
  icon: 'upstack',
814
1177
  measure: measures_js_1.MEASURE.CORE_CM2_PERCENT,
815
- 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,
816
1180
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
817
1181
  decimalPlaces: 2,
818
1182
  useCompactNotation: false,
819
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],
820
1188
  },
821
1189
  [measures_js_1.MEASURE.CORE_CM3]: {
822
- title: 'CM3 (Contribution Margin 3)',
823
- description: 'CM2 - Blended Ad Spend',
1190
+ title: 'Contribution Margin 3',
1191
+ shortTitle: 'CM3',
1192
+ description: 'CM2 minus blended ad spend.',
824
1193
  sumPrefix: '$',
825
1194
  sumSuffix: '',
826
1195
  avgPrefix: '$',
827
1196
  avgSuffix: '',
828
1197
  icon: 'upstack',
829
1198
  measure: measures_js_1.MEASURE.CORE_CM3,
830
- 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,
831
1201
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
832
1202
  decimalPlaces: 2,
833
1203
  useCompactNotation: true,
834
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],
835
1209
  },
836
1210
  [measures_js_1.MEASURE.CORE_CM3_PERCENT]: {
837
- title: 'CM3 %',
838
- description: 'CM3 as a percentage of Net Sales',
1211
+ title: 'CM3 Margin',
1212
+ shortTitle: 'CM3 %',
1213
+ description: 'CM3 as a percentage of Net Sales.',
839
1214
  sumPrefix: '',
840
1215
  sumSuffix: '%',
841
1216
  avgPrefix: '',
842
1217
  avgSuffix: '%',
843
1218
  icon: 'upstack',
844
1219
  measure: measures_js_1.MEASURE.CORE_CM3_PERCENT,
845
- 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,
846
1222
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
847
1223
  decimalPlaces: 2,
848
1224
  useCompactNotation: false,
849
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],
850
1230
  },
851
1231
  [measures_js_1.MEASURE.CORE_NET_PROFIT]: {
852
1232
  title: 'Net Profit',
853
- description: 'CM3 - Fixed Expenses',
1233
+ description: 'CM3 minus fixed expenses. Your bottom line.',
854
1234
  sumPrefix: '$',
855
1235
  sumSuffix: '',
856
1236
  avgPrefix: '$',
857
1237
  avgSuffix: '',
858
1238
  icon: 'upstack',
859
1239
  measure: measures_js_1.MEASURE.CORE_NET_PROFIT,
860
- 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,
861
1242
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
862
1243
  decimalPlaces: 2,
863
1244
  useCompactNotation: true,
864
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],
865
1250
  },
866
1251
  [measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT]: {
867
- title: 'Net Profit Margin %',
868
- 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.',
869
1255
  sumPrefix: '',
870
1256
  sumSuffix: '%',
871
1257
  avgPrefix: '',
872
1258
  avgSuffix: '%',
873
1259
  icon: 'upstack',
874
1260
  measure: measures_js_1.MEASURE.CORE_NET_PROFIT_PERCENT,
875
- 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,
876
1263
  valueType: measure_value_type_js_1.MeasureValueType.PERCENTAGE,
877
1264
  decimalPlaces: 2,
878
1265
  useCompactNotation: false,
879
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],
880
1271
  },
881
1272
  };
882
1273
  //# sourceMappingURL=core-measure-definitions.js.map