@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
@@ -1,1449 +1,1896 @@
1
1
  import { MEASURE } from '../measures.js';
2
- import { MEASURE_CATEGORY } from './measure-categories.js';
2
+ import { MEASURE_CATEGORY, MEASURE_SUBCATEGORY } from './measure-categories.js';
3
3
  import { MeasureValueType } from './measure-value-type.js';
4
4
  import { CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS } from './measure-applicable-contexts.js';
5
5
  export const FACEBOOK_MEASURES_MAP = {
6
6
  [MEASURE.CHANNEL_FB_SPEND]: {
7
7
  title: 'Meta Spend',
8
8
  description: 'The total amount spent on your Meta ads.',
9
+ tooltip: 'Total ad budget consumed by Meta during the selected period. This is what Meta billed you.',
9
10
  sumPrefix: '$',
10
11
  sumSuffix: '',
11
12
  avgPrefix: '$',
12
13
  avgSuffix: '',
13
14
  icon: 'facebook',
14
15
  measure: MEASURE.CHANNEL_FB_SPEND,
15
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
16
+ category: MEASURE_CATEGORY.META_ADS,
17
+ subcategory: MEASURE_SUBCATEGORY.META_SPEND,
16
18
  valueType: MeasureValueType.CURRENCY,
17
19
  decimalPlaces: 2,
18
20
  useCompactNotation: true,
19
21
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
22
+ relatedMeasures: [MEASURE.CHANNEL_FB_CPM, MEASURE.CHANNEL_FB_CPC, MEASURE.CHANNEL_FB_ROAS],
20
23
  },
21
24
  [MEASURE.CHANNEL_FB_IMPRESSIONS]: {
22
25
  title: 'Meta Impressions',
23
26
  description: 'The number of times your Meta ads were shown.',
27
+ tooltip: 'How many times your ads appeared on screen. One person can generate multiple impressions.',
24
28
  sumPrefix: '',
25
29
  sumSuffix: '',
26
30
  avgPrefix: '',
27
31
  avgSuffix: '',
28
32
  icon: 'facebook',
29
33
  measure: MEASURE.CHANNEL_FB_IMPRESSIONS,
30
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
34
+ category: MEASURE_CATEGORY.META_ADS,
35
+ subcategory: MEASURE_SUBCATEGORY.META_AUDIENCE,
31
36
  valueType: MeasureValueType.NUMBER,
32
37
  decimalPlaces: 0,
33
38
  useCompactNotation: false,
34
39
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
40
+ relatedMeasures: [MEASURE.CHANNEL_FB_REACH, MEASURE.CHANNEL_FB_FREQUENCY, MEASURE.CHANNEL_FB_CPM],
35
41
  },
36
42
  [MEASURE.CHANNEL_FB_CPM]: {
37
43
  title: 'Meta CPM',
44
+ shortTitle: 'CPM',
38
45
  description: 'The cost per thousand impressions of your Meta ads.',
46
+ tooltip: 'How much you pay for every 1,000 times your ad is shown. Lower CPM means cheaper reach.',
47
+ formulaDisplay: 'Ad Spend ÷ Impressions × 1,000',
48
+ formula: 'spend / impressions * 1000',
39
49
  sumPrefix: '$',
40
50
  sumSuffix: '',
41
51
  avgPrefix: '$',
42
52
  avgSuffix: '',
43
53
  icon: 'facebook',
44
54
  measure: MEASURE.CHANNEL_FB_CPM,
45
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
55
+ category: MEASURE_CATEGORY.META_ADS,
56
+ subcategory: MEASURE_SUBCATEGORY.META_SPEND,
46
57
  valueType: MeasureValueType.CURRENCY,
47
58
  decimalPlaces: 2,
48
59
  useCompactNotation: true,
49
60
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
61
+ relatedMeasures: [MEASURE.CHANNEL_FB_SPEND, MEASURE.CHANNEL_FB_IMPRESSIONS, MEASURE.CHANNEL_FB_CTR],
50
62
  },
51
63
  [MEASURE.CHANNEL_FB_FREQUENCY]: {
52
64
  title: 'Meta Frequency',
53
65
  description: 'The average number of times each person saw your Meta ads.',
66
+ tooltip: 'Average number of times a unique person saw your ad. High frequency can signal ad fatigue.',
67
+ formulaDisplay: 'Impressions ÷ Reach',
68
+ formula: 'impressions / reach',
54
69
  sumPrefix: '',
55
70
  sumSuffix: '',
56
71
  avgPrefix: '',
57
72
  avgSuffix: '',
58
73
  icon: 'facebook',
59
74
  measure: MEASURE.CHANNEL_FB_FREQUENCY,
60
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
75
+ category: MEASURE_CATEGORY.META_ADS,
76
+ subcategory: MEASURE_SUBCATEGORY.META_AUDIENCE,
61
77
  valueType: MeasureValueType.NUMBER,
62
78
  decimalPlaces: 0,
63
79
  useCompactNotation: false,
64
80
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
81
+ relatedMeasures: [MEASURE.CHANNEL_FB_REACH, MEASURE.CHANNEL_FB_IMPRESSIONS],
65
82
  },
66
83
  [MEASURE.CHANNEL_FB_REACH]: {
67
84
  title: 'Meta Reach',
68
85
  description: 'The number of unique people who saw your Meta ads.',
86
+ tooltip: 'How many individual people saw your ad at least once. Unlike impressions, each person is counted only once.',
69
87
  sumPrefix: '',
70
88
  sumSuffix: '',
71
89
  avgPrefix: '',
72
90
  avgSuffix: '',
73
91
  icon: 'facebook',
74
92
  measure: MEASURE.CHANNEL_FB_REACH,
75
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
93
+ category: MEASURE_CATEGORY.META_ADS,
94
+ subcategory: MEASURE_SUBCATEGORY.META_AUDIENCE,
76
95
  valueType: MeasureValueType.NUMBER,
77
96
  decimalPlaces: 0,
78
97
  useCompactNotation: false,
79
98
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
99
+ relatedMeasures: [MEASURE.CHANNEL_FB_IMPRESSIONS, MEASURE.CHANNEL_FB_FREQUENCY, MEASURE.CHANNEL_FB_CPP],
80
100
  },
81
101
  [MEASURE.CHANNEL_FB_CPP]: {
82
102
  title: 'Meta CPP',
103
+ shortTitle: 'CPP',
83
104
  description: 'The cost per 1,000 people reached by your Meta ads.',
105
+ tooltip: 'How much you pay to reach 1,000 unique people. Measures the efficiency of your audience targeting.',
106
+ formulaDisplay: 'Ad Spend ÷ Reach × 1,000',
107
+ formula: 'spend / reach * 1000',
84
108
  sumPrefix: '$',
85
109
  sumSuffix: '',
86
110
  avgPrefix: '$',
87
111
  avgSuffix: '',
88
112
  icon: 'facebook',
89
113
  measure: MEASURE.CHANNEL_FB_CPP,
90
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
114
+ category: MEASURE_CATEGORY.META_ADS,
115
+ subcategory: MEASURE_SUBCATEGORY.META_SPEND,
91
116
  valueType: MeasureValueType.CURRENCY,
92
117
  decimalPlaces: 2,
93
118
  useCompactNotation: true,
94
119
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
120
+ relatedMeasures: [MEASURE.CHANNEL_FB_REACH, MEASURE.CHANNEL_FB_SPEND, MEASURE.CHANNEL_FB_CPM],
95
121
  },
96
122
  [MEASURE.CHANNEL_FB_CLICKS]: {
97
123
  title: 'Meta Clicks',
98
124
  description: 'The number of clicks on your Meta ads.',
125
+ tooltip: 'Total clicks anywhere on your ad, including link clicks, reactions, profile visits, and more.',
99
126
  sumPrefix: '',
100
127
  sumSuffix: '',
101
128
  avgPrefix: '',
102
129
  avgSuffix: '',
103
130
  icon: 'facebook',
104
131
  measure: MEASURE.CHANNEL_FB_CLICKS,
105
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
132
+ category: MEASURE_CATEGORY.META_ADS,
133
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
106
134
  valueType: MeasureValueType.NUMBER,
107
135
  decimalPlaces: 0,
108
136
  useCompactNotation: false,
109
137
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
138
+ relatedMeasures: [MEASURE.CHANNEL_FB_LINK_CLICKS, MEASURE.CHANNEL_FB_CPC, MEASURE.CHANNEL_FB_CTR],
110
139
  },
111
140
  [MEASURE.CHANNEL_FB_CPC]: {
112
141
  title: 'Meta CPC',
142
+ shortTitle: 'CPC',
113
143
  description: 'The cost per click on your Meta ads.',
144
+ tooltip: 'Average cost each time someone clicks your ad. Lower CPC means you are driving traffic more efficiently.',
145
+ formulaDisplay: 'Ad Spend ÷ Clicks',
146
+ formula: 'spend / clicks',
114
147
  sumPrefix: '$',
115
148
  sumSuffix: '',
116
149
  avgPrefix: '$',
117
150
  avgSuffix: '',
118
151
  icon: 'facebook',
119
152
  measure: MEASURE.CHANNEL_FB_CPC,
120
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
153
+ category: MEASURE_CATEGORY.META_ADS,
154
+ subcategory: MEASURE_SUBCATEGORY.META_SPEND,
121
155
  valueType: MeasureValueType.CURRENCY,
122
156
  decimalPlaces: 2,
123
157
  useCompactNotation: true,
124
158
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
159
+ relatedMeasures: [MEASURE.CHANNEL_FB_CLICKS, MEASURE.CHANNEL_FB_SPEND, MEASURE.CHANNEL_FB_CTR, MEASURE.CHANNEL_FB_COST_PER_LINK_CLICK],
125
160
  },
126
161
  [MEASURE.CHANNEL_FB_CTR]: {
127
162
  title: 'Meta CTR',
163
+ shortTitle: 'CTR',
128
164
  description: 'The percentage of impressions that resulted in clicks.',
165
+ tooltip: 'How often people click your ad after seeing it. Higher CTR signals more engaging creative or targeting.',
166
+ formulaDisplay: 'Clicks ÷ Impressions × 100',
167
+ formula: 'clicks / impressions * 100',
129
168
  sumPrefix: '',
130
169
  sumSuffix: '%',
131
170
  avgPrefix: '',
132
171
  avgSuffix: '%',
133
172
  icon: 'facebook',
134
173
  measure: MEASURE.CHANNEL_FB_CTR,
135
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
174
+ category: MEASURE_CATEGORY.META_ADS,
175
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
136
176
  valueType: MeasureValueType.PERCENTAGE,
137
177
  decimalPlaces: 2,
138
178
  useCompactNotation: false,
139
179
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
180
+ relatedMeasures: [MEASURE.CHANNEL_FB_CLICKS, MEASURE.CHANNEL_FB_IMPRESSIONS, MEASURE.CHANNEL_FB_LINK_CLICKS_CTR],
140
181
  },
141
182
  [MEASURE.CHANNEL_FB_UNIQUE_CLICKS]: {
142
183
  title: 'Meta Unique Clicks',
143
184
  description: 'The number of unique people who clicked on your Meta ads.',
185
+ tooltip: 'How many distinct individuals clicked your ad, counting each person only once regardless of how many times they clicked.',
144
186
  sumPrefix: '',
145
187
  sumSuffix: '',
146
188
  avgPrefix: '',
147
189
  avgSuffix: '',
148
190
  icon: 'facebook',
149
191
  measure: MEASURE.CHANNEL_FB_UNIQUE_CLICKS,
150
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
192
+ category: MEASURE_CATEGORY.META_ADS,
193
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
151
194
  valueType: MeasureValueType.NUMBER,
152
195
  decimalPlaces: 0,
153
196
  useCompactNotation: false,
154
197
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
198
+ relatedMeasures: [MEASURE.CHANNEL_FB_CLICKS, MEASURE.CHANNEL_FB_UNIQUE_CLICKS_CTR],
155
199
  },
156
200
  [MEASURE.CHANNEL_FB_UNIQUE_CLICKS_CTR]: {
157
- title: 'Meta Unique Clicks CTR',
201
+ title: 'Meta Unique Click-Through Rate',
202
+ shortTitle: 'Unique CTR',
158
203
  description: 'The percentage of people who clicked on your ad at least once.',
204
+ tooltip: 'Share of reached people who clicked at least once. Removes the inflation from repeat clickers.',
205
+ formulaDisplay: 'Unique Clicks ÷ Reach × 100',
206
+ formula: 'unique_clicks / reach * 100',
159
207
  sumPrefix: '',
160
208
  sumSuffix: '%',
161
209
  avgPrefix: '',
162
210
  avgSuffix: '%',
163
211
  icon: 'facebook',
164
212
  measure: MEASURE.CHANNEL_FB_UNIQUE_CLICKS_CTR,
165
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
213
+ category: MEASURE_CATEGORY.META_ADS,
214
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
166
215
  valueType: MeasureValueType.PERCENTAGE,
167
216
  decimalPlaces: 2,
168
217
  useCompactNotation: false,
169
218
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
219
+ relatedMeasures: [MEASURE.CHANNEL_FB_UNIQUE_CLICKS, MEASURE.CHANNEL_FB_CTR],
170
220
  },
171
221
  [MEASURE.CHANNEL_FB_COST_PER_UNIQUE_CLICK]: {
172
222
  title: 'Meta Cost per Unique Click',
223
+ shortTitle: 'Cost/Unique Click',
173
224
  description: 'The average cost per unique click on your Meta ads.',
225
+ tooltip: 'How much you pay per unique person who clicks. Accounts for the same person clicking multiple times.',
226
+ formulaDisplay: 'Ad Spend ÷ Unique Clicks',
227
+ formula: 'spend / unique_clicks',
174
228
  sumPrefix: '$',
175
229
  sumSuffix: '',
176
230
  avgPrefix: '$',
177
231
  avgSuffix: '',
178
232
  icon: 'facebook',
179
233
  measure: MEASURE.CHANNEL_FB_COST_PER_UNIQUE_CLICK,
180
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
234
+ category: MEASURE_CATEGORY.META_ADS,
235
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
181
236
  valueType: MeasureValueType.CURRENCY,
182
237
  decimalPlaces: 2,
183
238
  useCompactNotation: true,
184
239
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
240
+ relatedMeasures: [MEASURE.CHANNEL_FB_UNIQUE_CLICKS, MEASURE.CHANNEL_FB_CPC],
185
241
  },
186
242
  [MEASURE.CHANNEL_FB_INLINE_CLICKS]: {
187
243
  title: 'Meta Inline Clicks',
188
244
  description: 'The number of clicks on links within your Meta ads.',
245
+ tooltip: 'Clicks on links embedded inside the ad unit itself, such as links in the post body or carousel cards.',
189
246
  sumPrefix: '',
190
247
  sumSuffix: '',
191
248
  avgPrefix: '',
192
249
  avgSuffix: '',
193
250
  icon: 'facebook',
194
251
  measure: MEASURE.CHANNEL_FB_INLINE_CLICKS,
195
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
252
+ category: MEASURE_CATEGORY.META_ADS,
253
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
196
254
  valueType: MeasureValueType.NUMBER,
197
255
  decimalPlaces: 0,
198
256
  useCompactNotation: false,
199
257
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
258
+ relatedMeasures: [MEASURE.CHANNEL_FB_INLINE_CLICKS_CTR, MEASURE.CHANNEL_FB_COST_PER_INLINE_CLICK],
200
259
  },
201
260
  [MEASURE.CHANNEL_FB_INLINE_CLICKS_CTR]: {
202
- title: 'Meta Inline Clicks CTR',
261
+ title: 'Meta Inline Link Click-Through Rate',
262
+ shortTitle: 'Inline CTR',
203
263
  description: 'The percentage of impressions that resulted in inline link clicks.',
264
+ tooltip: 'How often viewers click the inline links in your ad. Indicates how compelling the ad content is.',
265
+ formulaDisplay: 'Inline Clicks ÷ Impressions × 100',
266
+ formula: 'inline_clicks / impressions * 100',
204
267
  sumPrefix: '',
205
268
  sumSuffix: '%',
206
269
  avgPrefix: '',
207
270
  avgSuffix: '%',
208
271
  icon: 'facebook',
209
272
  measure: MEASURE.CHANNEL_FB_INLINE_CLICKS_CTR,
210
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
273
+ category: MEASURE_CATEGORY.META_ADS,
274
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
211
275
  valueType: MeasureValueType.PERCENTAGE,
212
276
  decimalPlaces: 2,
213
277
  useCompactNotation: false,
214
278
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
279
+ relatedMeasures: [MEASURE.CHANNEL_FB_INLINE_CLICKS, MEASURE.CHANNEL_FB_CTR],
215
280
  },
216
281
  [MEASURE.CHANNEL_FB_COST_PER_INLINE_CLICK]: {
217
282
  title: 'Meta Cost per Inline Click',
283
+ shortTitle: 'Cost/Inline Click',
218
284
  description: 'The average cost per inline click on your Meta ads.',
285
+ tooltip: 'Average spend per inline link click. Useful for measuring efficiency of link-focused ad formats.',
286
+ formulaDisplay: 'Ad Spend ÷ Inline Clicks',
287
+ formula: 'spend / inline_clicks',
219
288
  sumPrefix: '$',
220
289
  sumSuffix: '',
221
290
  avgPrefix: '$',
222
291
  avgSuffix: '',
223
292
  icon: 'facebook',
224
293
  measure: MEASURE.CHANNEL_FB_COST_PER_INLINE_CLICK,
225
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
294
+ category: MEASURE_CATEGORY.META_ADS,
295
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
226
296
  valueType: MeasureValueType.CURRENCY,
227
297
  decimalPlaces: 2,
228
298
  useCompactNotation: true,
229
299
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
300
+ relatedMeasures: [MEASURE.CHANNEL_FB_INLINE_CLICKS, MEASURE.CHANNEL_FB_CPC],
230
301
  },
231
302
  [MEASURE.CHANNEL_FB_OUTBOUND_CLICKS]: {
232
303
  title: 'Meta Outbound Clicks',
233
304
  description: 'The number of clicks that took people to destinations off Meta.',
305
+ tooltip: 'Clicks that sent people to your website or app, as opposed to clicks that stayed within Meta properties.',
234
306
  sumPrefix: '',
235
307
  sumSuffix: '',
236
308
  avgPrefix: '',
237
309
  avgSuffix: '',
238
310
  icon: 'facebook',
239
311
  measure: MEASURE.CHANNEL_FB_OUTBOUND_CLICKS,
240
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
312
+ category: MEASURE_CATEGORY.META_ADS,
313
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
241
314
  valueType: MeasureValueType.NUMBER,
242
315
  decimalPlaces: 0,
243
316
  useCompactNotation: false,
244
317
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
318
+ relatedMeasures: [MEASURE.CHANNEL_FB_OUTBOUND_CLICKS_CTR, MEASURE.CHANNEL_FB_COST_PER_OUTBOUND_CLICK, MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS],
245
319
  },
246
320
  [MEASURE.CHANNEL_FB_OUTBOUND_CLICKS_CTR]: {
247
- title: 'Meta Outbound Clicks CTR',
321
+ title: 'Meta Outbound Click-Through Rate',
322
+ shortTitle: 'Outbound CTR',
248
323
  description: 'The percentage of impressions that resulted in outbound clicks.',
324
+ tooltip: 'Share of impressions that drove someone off Meta to your destination. The most relevant CTR for website-focused campaigns.',
325
+ formulaDisplay: 'Outbound Clicks ÷ Impressions × 100',
326
+ formula: 'outbound_clicks / impressions * 100',
249
327
  sumPrefix: '',
250
328
  sumSuffix: '%',
251
329
  avgPrefix: '',
252
330
  avgSuffix: '%',
253
331
  icon: 'facebook',
254
332
  measure: MEASURE.CHANNEL_FB_OUTBOUND_CLICKS_CTR,
255
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
333
+ category: MEASURE_CATEGORY.META_ADS,
334
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
256
335
  valueType: MeasureValueType.PERCENTAGE,
257
336
  decimalPlaces: 2,
258
337
  useCompactNotation: false,
259
338
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
339
+ relatedMeasures: [MEASURE.CHANNEL_FB_OUTBOUND_CLICKS, MEASURE.CHANNEL_FB_CTR, MEASURE.CHANNEL_FB_LINK_CLICKS_CTR],
260
340
  },
261
341
  [MEASURE.CHANNEL_FB_COST_PER_OUTBOUND_CLICK]: {
262
342
  title: 'Meta Cost per Outbound Click',
343
+ shortTitle: 'Cost/Outbound Click',
263
344
  description: 'The average cost per click that took people off Meta.',
345
+ tooltip: 'How much you pay each time someone leaves Meta for your site. A key efficiency metric for traffic campaigns.',
346
+ formulaDisplay: 'Ad Spend ÷ Outbound Clicks',
347
+ formula: 'spend / outbound_clicks',
264
348
  sumPrefix: '$',
265
349
  sumSuffix: '',
266
350
  avgPrefix: '$',
267
351
  avgSuffix: '',
268
352
  icon: 'facebook',
269
353
  measure: MEASURE.CHANNEL_FB_COST_PER_OUTBOUND_CLICK,
270
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
354
+ category: MEASURE_CATEGORY.META_ADS,
355
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
271
356
  valueType: MeasureValueType.CURRENCY,
272
357
  decimalPlaces: 2,
273
358
  useCompactNotation: true,
274
359
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
360
+ relatedMeasures: [MEASURE.CHANNEL_FB_OUTBOUND_CLICKS, MEASURE.CHANNEL_FB_COST_PER_LINK_CLICK],
275
361
  },
276
362
  [MEASURE.CHANNEL_FB_LINK_CLICKS]: {
277
363
  title: 'Meta Link Clicks',
278
364
  description: 'The number of clicks on links in your Meta ads.',
365
+ tooltip: 'Clicks specifically on your ad\'s call-to-action button or primary link, directing people to your website or app.',
279
366
  sumPrefix: '',
280
367
  sumSuffix: '',
281
368
  avgPrefix: '',
282
369
  avgSuffix: '',
283
370
  icon: 'facebook',
284
371
  measure: MEASURE.CHANNEL_FB_LINK_CLICKS,
285
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
372
+ category: MEASURE_CATEGORY.META_ADS,
373
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
286
374
  valueType: MeasureValueType.NUMBER,
287
375
  decimalPlaces: 0,
288
376
  useCompactNotation: false,
289
377
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
378
+ relatedMeasures: [MEASURE.CHANNEL_FB_LINK_CLICKS_CTR, MEASURE.CHANNEL_FB_COST_PER_LINK_CLICK, MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS],
290
379
  },
291
380
  [MEASURE.CHANNEL_FB_LINK_CLICKS_CTR]: {
292
- title: 'Meta Link Clicks CTR',
381
+ title: 'Meta Link Click-Through Rate',
382
+ shortTitle: 'Link CTR',
293
383
  description: 'The percentage of impressions that resulted in link clicks.',
384
+ tooltip: 'How often people click your primary link after seeing the ad. A core measure of ad creative and targeting quality.',
385
+ formulaDisplay: 'Link Clicks ÷ Impressions × 100',
386
+ formula: 'link_clicks / impressions * 100',
294
387
  sumPrefix: '',
295
388
  sumSuffix: '%',
296
389
  avgPrefix: '',
297
390
  avgSuffix: '%',
298
391
  icon: 'facebook',
299
392
  measure: MEASURE.CHANNEL_FB_LINK_CLICKS_CTR,
300
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
393
+ category: MEASURE_CATEGORY.META_ADS,
394
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
301
395
  valueType: MeasureValueType.PERCENTAGE,
302
396
  decimalPlaces: 2,
303
397
  useCompactNotation: false,
304
398
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
399
+ relatedMeasures: [MEASURE.CHANNEL_FB_LINK_CLICKS, MEASURE.CHANNEL_FB_CTR, MEASURE.CHANNEL_FB_OUTBOUND_CLICKS_CTR],
305
400
  },
306
401
  [MEASURE.CHANNEL_FB_COST_PER_LINK_CLICK]: {
307
402
  title: 'Meta Cost per Link Click',
403
+ shortTitle: 'Cost/Link Click',
308
404
  description: 'The average cost per link click on your Meta ads.',
405
+ tooltip: 'Average spend per primary link click. The standard cost-per-click metric for website traffic campaigns.',
406
+ formulaDisplay: 'Ad Spend ÷ Link Clicks',
407
+ formula: 'spend / link_clicks',
309
408
  sumPrefix: '$',
310
409
  sumSuffix: '',
311
410
  avgPrefix: '$',
312
411
  avgSuffix: '',
313
412
  icon: 'facebook',
314
413
  measure: MEASURE.CHANNEL_FB_COST_PER_LINK_CLICK,
315
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
414
+ category: MEASURE_CATEGORY.META_ADS,
415
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
316
416
  valueType: MeasureValueType.CURRENCY,
317
417
  decimalPlaces: 2,
318
418
  useCompactNotation: true,
319
419
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
420
+ relatedMeasures: [MEASURE.CHANNEL_FB_LINK_CLICKS, MEASURE.CHANNEL_FB_CPC, MEASURE.CHANNEL_FB_COST_PER_OUTBOUND_CLICK],
320
421
  },
321
422
  [MEASURE.CHANNEL_FB_PURCHASES]: {
322
423
  title: 'Meta Purchases',
323
424
  description: 'The number of purchases attributed to your Meta ads.',
425
+ tooltip: 'How many completed purchases Meta attributes to your ads, based on the pixel or Conversions API.',
324
426
  sumPrefix: '',
325
427
  sumSuffix: '',
326
428
  avgPrefix: '',
327
429
  avgSuffix: '',
328
430
  icon: 'facebook',
329
431
  measure: MEASURE.CHANNEL_FB_PURCHASES,
330
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
432
+ category: MEASURE_CATEGORY.META_ADS,
433
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
331
434
  valueType: MeasureValueType.NUMBER,
332
435
  decimalPlaces: 0,
333
436
  useCompactNotation: false,
334
437
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
438
+ relatedMeasures: [MEASURE.CHANNEL_FB_PURCHASES_VALUE, MEASURE.CHANNEL_FB_CPA, MEASURE.CHANNEL_FB_ROAS],
335
439
  },
336
440
  [MEASURE.CHANNEL_FB_PURCHASES_VALUE]: {
337
441
  title: 'Meta Purchases Value',
442
+ shortTitle: 'Meta Revenue',
338
443
  description: 'The total revenue from purchases attributed to your Meta ads.',
444
+ tooltip: 'Total revenue Meta credits to your ads. Used to calculate ROAS and evaluate campaign profitability.',
339
445
  sumPrefix: '$',
340
446
  sumSuffix: '',
341
447
  avgPrefix: '$',
342
448
  avgSuffix: '',
343
449
  icon: 'facebook',
344
450
  measure: MEASURE.CHANNEL_FB_PURCHASES_VALUE,
345
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
451
+ category: MEASURE_CATEGORY.META_ADS,
452
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
346
453
  valueType: MeasureValueType.CURRENCY,
347
454
  decimalPlaces: 2,
348
455
  useCompactNotation: true,
349
456
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
457
+ relatedMeasures: [MEASURE.CHANNEL_FB_PURCHASES, MEASURE.CHANNEL_FB_ROAS, MEASURE.CHANNEL_FB_SPEND],
350
458
  },
351
459
  [MEASURE.CHANNEL_FB_CPA]: {
352
460
  title: 'Meta CPA',
461
+ shortTitle: 'CPA',
353
462
  description: 'The cost per purchase conversion from your Meta ads.',
463
+ tooltip: 'How much you spend on average for each purchase Meta attributes to your ads. Lower is better.',
464
+ formulaDisplay: 'Ad Spend ÷ Purchases',
465
+ formula: 'spend / purchases',
354
466
  sumPrefix: '$',
355
467
  sumSuffix: '',
356
468
  avgPrefix: '$',
357
469
  avgSuffix: '',
358
470
  icon: 'facebook',
359
471
  measure: MEASURE.CHANNEL_FB_CPA,
360
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
472
+ category: MEASURE_CATEGORY.META_ADS,
473
+ subcategory: MEASURE_SUBCATEGORY.META_SPEND,
361
474
  valueType: MeasureValueType.CURRENCY,
362
475
  decimalPlaces: 2,
363
476
  useCompactNotation: true,
364
477
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
365
478
  aliases: [MEASURE.CHANNEL_FB_PURCHASES_COST],
479
+ relatedMeasures: [MEASURE.CHANNEL_FB_PURCHASES, MEASURE.CHANNEL_FB_ROAS, MEASURE.CHANNEL_FB_NEW_CUSTOMER_CPA],
366
480
  },
367
481
  [MEASURE.CHANNEL_FB_ROAS]: {
368
482
  title: 'Meta ROAS',
483
+ shortTitle: 'ROAS',
369
484
  description: 'The return on ad spend from your Meta ads.',
485
+ tooltip: 'Revenue Meta reports per dollar spent on ads. A ROAS of 3x means $3 in attributed revenue for every $1 spent.',
486
+ formulaDisplay: 'Purchases Value ÷ Ad Spend',
487
+ formula: 'purchases_value / spend',
370
488
  sumPrefix: '',
371
489
  sumSuffix: 'x',
372
490
  avgPrefix: '',
373
491
  avgSuffix: 'x',
374
492
  icon: 'facebook',
375
493
  measure: MEASURE.CHANNEL_FB_ROAS,
376
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
494
+ category: MEASURE_CATEGORY.META_ADS,
495
+ subcategory: MEASURE_SUBCATEGORY.META_EFFICIENCY,
377
496
  valueType: MeasureValueType.MULTIPLIER,
378
497
  decimalPlaces: 2,
379
498
  useCompactNotation: false,
380
499
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
500
+ relatedMeasures: [MEASURE.CHANNEL_FB_SPEND, MEASURE.CHANNEL_FB_PURCHASES_VALUE, MEASURE.CHANNEL_FB_CPA, MEASURE.CHANNEL_FB_NEW_CUSTOMER_ROAS],
381
501
  },
382
502
  [MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES]: {
383
503
  title: 'Meta New Customer Purchases',
504
+ shortTitle: 'NC Purchases',
384
505
  description: 'The number of new customer purchases attributed to your Meta ads.',
506
+ tooltip: 'Purchases from first-time buyers that Meta credits to your ads. Requires new customer signal configuration.',
385
507
  sumPrefix: '',
386
508
  sumSuffix: '',
387
509
  avgPrefix: '',
388
510
  avgSuffix: '',
389
511
  icon: 'facebook',
390
512
  measure: MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES,
391
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
513
+ category: MEASURE_CATEGORY.META_ADS,
514
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
392
515
  valueType: MeasureValueType.NUMBER,
393
516
  decimalPlaces: 0,
394
517
  useCompactNotation: false,
395
518
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
519
+ relatedMeasures: [MEASURE.CHANNEL_FB_PURCHASES, MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES_VALUE, MEASURE.CHANNEL_FB_NEW_CUSTOMER_CPA],
396
520
  },
397
521
  [MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES_VALUE]: {
398
522
  title: 'Meta New Customer Purchases Value',
523
+ shortTitle: 'NC Revenue',
399
524
  description: 'The total revenue from new customer purchases attributed to your Meta ads.',
525
+ tooltip: 'Revenue from first-time buyers that Meta credits to your ads. Indicates how well campaigns attract new shoppers.',
400
526
  sumPrefix: '$',
401
527
  sumSuffix: '',
402
528
  avgPrefix: '$',
403
529
  avgSuffix: '',
404
530
  icon: 'facebook',
405
531
  measure: MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES_VALUE,
406
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
532
+ category: MEASURE_CATEGORY.META_ADS,
533
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
407
534
  valueType: MeasureValueType.CURRENCY,
408
535
  decimalPlaces: 2,
409
536
  useCompactNotation: true,
410
537
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
538
+ relatedMeasures: [MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES, MEASURE.CHANNEL_FB_NEW_CUSTOMER_ROAS, MEASURE.CHANNEL_FB_PURCHASES_VALUE],
411
539
  },
412
540
  [MEASURE.CHANNEL_FB_NEW_CUSTOMER_CPA]: {
413
541
  title: 'Meta New Customer CPA',
542
+ shortTitle: 'NC CPA',
414
543
  description: 'The cost per acquisition for new customers from Meta ads.',
544
+ tooltip: 'Average spend to acquire one new customer via Meta. Key metric for evaluating customer acquisition efficiency.',
545
+ formulaDisplay: 'Ad Spend ÷ New Customer Purchases',
546
+ formula: 'spend / new_customer_purchases',
415
547
  sumPrefix: '$',
416
548
  sumSuffix: '',
417
549
  avgPrefix: '$',
418
550
  avgSuffix: '',
419
551
  icon: 'facebook',
420
552
  measure: MEASURE.CHANNEL_FB_NEW_CUSTOMER_CPA,
421
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
553
+ category: MEASURE_CATEGORY.META_ADS,
554
+ subcategory: MEASURE_SUBCATEGORY.META_SPEND,
422
555
  valueType: MeasureValueType.CURRENCY,
423
556
  decimalPlaces: 2,
424
557
  useCompactNotation: true,
425
558
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
426
559
  aliases: [MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES_COST],
560
+ relatedMeasures: [MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES, MEASURE.CHANNEL_FB_CPA, MEASURE.CHANNEL_FB_NEW_CUSTOMER_ROAS],
427
561
  },
428
562
  [MEASURE.CHANNEL_FB_NEW_CUSTOMER_ROAS]: {
429
563
  title: 'Meta New Customer ROAS',
564
+ shortTitle: 'NC ROAS',
430
565
  description: 'The return on ad spend from new customers acquired via Meta ads.',
566
+ tooltip: 'Revenue from new customers per dollar spent on Meta ads. Measures how effectively you are converting ad spend into new buyers.',
567
+ formulaDisplay: 'New Customer Revenue ÷ Ad Spend',
568
+ formula: 'new_customer_purchases_value / spend',
431
569
  sumPrefix: '',
432
570
  sumSuffix: 'x',
433
571
  avgPrefix: '',
434
572
  avgSuffix: 'x',
435
573
  icon: 'facebook',
436
574
  measure: MEASURE.CHANNEL_FB_NEW_CUSTOMER_ROAS,
437
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
575
+ category: MEASURE_CATEGORY.META_ADS,
576
+ subcategory: MEASURE_SUBCATEGORY.META_EFFICIENCY,
438
577
  valueType: MeasureValueType.MULTIPLIER,
439
578
  decimalPlaces: 2,
440
579
  useCompactNotation: false,
441
580
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
581
+ relatedMeasures: [MEASURE.CHANNEL_FB_ROAS, MEASURE.CHANNEL_FB_NEW_CUSTOMER_PURCHASES_VALUE, MEASURE.CHANNEL_FB_NEW_CUSTOMER_CPA],
442
582
  },
443
583
  [MEASURE.CHANNEL_FB_VIEW_CONTENTS]: {
444
584
  title: 'Meta View Contents',
585
+ shortTitle: 'View Content',
445
586
  description: 'The number of product or content page views attributed to your Meta ads.',
587
+ tooltip: 'How many times visitors viewed a product detail page after clicking your ad. A top-of-funnel engagement signal.',
446
588
  sumPrefix: '',
447
589
  sumSuffix: '',
448
590
  avgPrefix: '',
449
591
  avgSuffix: '',
450
592
  icon: 'facebook',
451
593
  measure: MEASURE.CHANNEL_FB_VIEW_CONTENTS,
452
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
594
+ category: MEASURE_CATEGORY.META_ADS,
595
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
453
596
  valueType: MeasureValueType.NUMBER,
454
597
  decimalPlaces: 0,
455
598
  useCompactNotation: false,
456
599
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
600
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIEW_CONTENTS_COST, MEASURE.CHANNEL_FB_ADD_TO_CARTS, MEASURE.CHANNEL_FB_PURCHASES],
457
601
  },
458
602
  [MEASURE.CHANNEL_FB_VIEW_CONTENTS_VALUE]: {
459
603
  title: 'Meta View Contents Value',
604
+ shortTitle: 'View Content Value',
460
605
  description: 'The total value of products viewed from your Meta ads.',
606
+ tooltip: 'Combined catalog value of all product pages viewed by visitors from your Meta ads.',
461
607
  sumPrefix: '$',
462
608
  sumSuffix: '',
463
609
  avgPrefix: '$',
464
610
  avgSuffix: '',
465
611
  icon: 'facebook',
466
612
  measure: MEASURE.CHANNEL_FB_VIEW_CONTENTS_VALUE,
467
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
613
+ category: MEASURE_CATEGORY.META_ADS,
614
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
468
615
  valueType: MeasureValueType.CURRENCY,
469
616
  decimalPlaces: 2,
470
617
  useCompactNotation: true,
471
618
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
619
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIEW_CONTENTS, MEASURE.CHANNEL_FB_ADD_TO_CARTS_VALUE],
472
620
  },
473
621
  [MEASURE.CHANNEL_FB_VIEW_CONTENTS_COST]: {
474
622
  title: 'Meta Cost per View Content',
623
+ shortTitle: 'Cost/View Content',
475
624
  description: 'The cost per product or content page view from your Meta ads.',
625
+ tooltip: 'Average spend per product page view. Useful for optimizing top-of-funnel traffic cost.',
626
+ formulaDisplay: 'Ad Spend ÷ View Contents',
627
+ formula: 'spend / view_contents',
476
628
  sumPrefix: '$',
477
629
  sumSuffix: '',
478
630
  avgPrefix: '$',
479
631
  avgSuffix: '',
480
632
  icon: 'facebook',
481
633
  measure: MEASURE.CHANNEL_FB_VIEW_CONTENTS_COST,
482
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
634
+ category: MEASURE_CATEGORY.META_ADS,
635
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
483
636
  valueType: MeasureValueType.CURRENCY,
484
637
  decimalPlaces: 2,
485
638
  useCompactNotation: true,
486
639
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
640
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIEW_CONTENTS, MEASURE.CHANNEL_FB_ADD_TO_CARTS_COST],
487
641
  },
488
642
  [MEASURE.CHANNEL_FB_ADD_TO_CARTS]: {
489
643
  title: 'Meta Add to Carts',
644
+ shortTitle: 'Add to Cart',
490
645
  description: 'The number of add to cart actions attributed to your Meta ads.',
646
+ tooltip: 'How many times shoppers added items to their cart after engaging with your ad. A mid-funnel purchase intent signal.',
491
647
  sumPrefix: '',
492
648
  sumSuffix: '',
493
649
  avgPrefix: '',
494
650
  avgSuffix: '',
495
651
  icon: 'facebook',
496
652
  measure: MEASURE.CHANNEL_FB_ADD_TO_CARTS,
497
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
653
+ category: MEASURE_CATEGORY.META_ADS,
654
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
498
655
  valueType: MeasureValueType.NUMBER,
499
656
  decimalPlaces: 0,
500
657
  useCompactNotation: false,
501
658
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
659
+ relatedMeasures: [MEASURE.CHANNEL_FB_ADD_TO_CARTS_COST, MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS, MEASURE.CHANNEL_FB_PURCHASES],
502
660
  },
503
661
  [MEASURE.CHANNEL_FB_ADD_TO_CARTS_VALUE]: {
504
662
  title: 'Meta Add to Carts Value',
663
+ shortTitle: 'Cart Value',
505
664
  description: 'The total value of products added to cart from your Meta ads.',
665
+ tooltip: 'Combined value of all items added to carts by visitors from your Meta ads.',
506
666
  sumPrefix: '$',
507
667
  sumSuffix: '',
508
668
  avgPrefix: '$',
509
669
  avgSuffix: '',
510
670
  icon: 'facebook',
511
671
  measure: MEASURE.CHANNEL_FB_ADD_TO_CARTS_VALUE,
512
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
672
+ category: MEASURE_CATEGORY.META_ADS,
673
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
513
674
  valueType: MeasureValueType.CURRENCY,
514
675
  decimalPlaces: 2,
515
676
  useCompactNotation: true,
516
677
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
678
+ relatedMeasures: [MEASURE.CHANNEL_FB_ADD_TO_CARTS, MEASURE.CHANNEL_FB_PURCHASES_VALUE],
517
679
  },
518
680
  [MEASURE.CHANNEL_FB_ADD_TO_CARTS_COST]: {
519
681
  title: 'Meta Cost per Add to Cart',
682
+ shortTitle: 'Cost/Add to Cart',
520
683
  description: 'The cost per add to cart action from your Meta ads.',
684
+ tooltip: 'Average spend per add-to-cart event. Helps gauge how efficiently your ads drive purchase intent.',
685
+ formulaDisplay: 'Ad Spend ÷ Add to Carts',
686
+ formula: 'spend / add_to_carts',
521
687
  sumPrefix: '$',
522
688
  sumSuffix: '',
523
689
  avgPrefix: '$',
524
690
  avgSuffix: '',
525
691
  icon: 'facebook',
526
692
  measure: MEASURE.CHANNEL_FB_ADD_TO_CARTS_COST,
527
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
693
+ category: MEASURE_CATEGORY.META_ADS,
694
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
528
695
  valueType: MeasureValueType.CURRENCY,
529
696
  decimalPlaces: 2,
530
697
  useCompactNotation: true,
531
698
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
699
+ relatedMeasures: [MEASURE.CHANNEL_FB_ADD_TO_CARTS, MEASURE.CHANNEL_FB_CPA, MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS_COST],
532
700
  },
533
701
  [MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS]: {
534
702
  title: 'Meta Initiate Checkouts',
703
+ shortTitle: 'Checkouts',
535
704
  description: 'The number of checkout initiations attributed to your Meta ads.',
705
+ tooltip: 'How many shoppers started the checkout process after engaging with your ad. A strong bottom-of-funnel conversion signal.',
536
706
  sumPrefix: '',
537
707
  sumSuffix: '',
538
708
  avgPrefix: '',
539
709
  avgSuffix: '',
540
710
  icon: 'facebook',
541
711
  measure: MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS,
542
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
712
+ category: MEASURE_CATEGORY.META_ADS,
713
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
543
714
  valueType: MeasureValueType.NUMBER,
544
715
  decimalPlaces: 0,
545
716
  useCompactNotation: false,
546
717
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
718
+ relatedMeasures: [MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS_COST, MEASURE.CHANNEL_FB_PURCHASES, MEASURE.CHANNEL_FB_ADD_TO_CARTS],
547
719
  },
548
720
  [MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS_VALUE]: {
549
721
  title: 'Meta Initiate Checkouts Value',
722
+ shortTitle: 'Checkout Value',
550
723
  description: 'The total value of carts at checkout from your Meta ads.',
724
+ tooltip: 'Combined cart value at checkout for all visitors from your Meta ads.',
551
725
  sumPrefix: '$',
552
726
  sumSuffix: '',
553
727
  avgPrefix: '$',
554
728
  avgSuffix: '',
555
729
  icon: 'facebook',
556
730
  measure: MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS_VALUE,
557
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
731
+ category: MEASURE_CATEGORY.META_ADS,
732
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
558
733
  valueType: MeasureValueType.CURRENCY,
559
734
  decimalPlaces: 2,
560
735
  useCompactNotation: true,
561
736
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
737
+ relatedMeasures: [MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS, MEASURE.CHANNEL_FB_PURCHASES_VALUE],
562
738
  },
563
739
  [MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS_COST]: {
564
740
  title: 'Meta Cost per Initiate Checkout',
741
+ shortTitle: 'Cost/Checkout',
565
742
  description: 'The cost per checkout initiation from your Meta ads.',
743
+ tooltip: 'Average spend per checkout started. A lower figure indicates efficient bottom-of-funnel performance.',
744
+ formulaDisplay: 'Ad Spend ÷ Initiate Checkouts',
745
+ formula: 'spend / initiate_checkouts',
566
746
  sumPrefix: '$',
567
747
  sumSuffix: '',
568
748
  avgPrefix: '$',
569
749
  avgSuffix: '',
570
750
  icon: 'facebook',
571
751
  measure: MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS_COST,
572
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
752
+ category: MEASURE_CATEGORY.META_ADS,
753
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
573
754
  valueType: MeasureValueType.CURRENCY,
574
755
  decimalPlaces: 2,
575
756
  useCompactNotation: true,
576
757
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
758
+ relatedMeasures: [MEASURE.CHANNEL_FB_INITIATE_CHECKOUTS, MEASURE.CHANNEL_FB_CPA, MEASURE.CHANNEL_FB_ADD_TO_CARTS_COST],
577
759
  },
578
760
  [MEASURE.CHANNEL_FB_SEARCHES]: {
579
761
  title: 'Meta Searches',
580
762
  description: 'The number of on-site searches attributed to your Meta ads.',
763
+ tooltip: 'How many times visitors from your Meta ads used your site search. Indicates active product discovery intent.',
581
764
  sumPrefix: '',
582
765
  sumSuffix: '',
583
766
  avgPrefix: '',
584
767
  avgSuffix: '',
585
768
  icon: 'facebook',
586
769
  measure: MEASURE.CHANNEL_FB_SEARCHES,
587
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
770
+ category: MEASURE_CATEGORY.META_ADS,
771
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
588
772
  valueType: MeasureValueType.NUMBER,
589
773
  decimalPlaces: 0,
590
774
  useCompactNotation: false,
591
775
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
776
+ relatedMeasures: [MEASURE.CHANNEL_FB_SEARCHES_COST, MEASURE.CHANNEL_FB_VIEW_CONTENTS],
592
777
  },
593
778
  [MEASURE.CHANNEL_FB_SEARCHES_VALUE]: {
594
779
  title: 'Meta Searches Value',
780
+ shortTitle: 'Search Value',
595
781
  description: 'The total value of on-site searches attributed to your Meta ads.',
782
+ tooltip: 'Assigned value of all search events generated by visitors from your Meta ads.',
596
783
  sumPrefix: '$',
597
784
  sumSuffix: '',
598
785
  avgPrefix: '$',
599
786
  avgSuffix: '',
600
787
  icon: 'facebook',
601
788
  measure: MEASURE.CHANNEL_FB_SEARCHES_VALUE,
602
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
789
+ category: MEASURE_CATEGORY.META_ADS,
790
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
603
791
  valueType: MeasureValueType.CURRENCY,
604
792
  decimalPlaces: 2,
605
793
  useCompactNotation: true,
606
794
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
795
+ relatedMeasures: [MEASURE.CHANNEL_FB_SEARCHES, MEASURE.CHANNEL_FB_SEARCHES_COST],
607
796
  },
608
797
  [MEASURE.CHANNEL_FB_SEARCHES_COST]: {
609
798
  title: 'Meta Cost per Search',
799
+ shortTitle: 'Cost/Search',
610
800
  description: 'The cost per on-site search attributed to your Meta ads.',
801
+ tooltip: 'Average spend per on-site search event from Meta ad visitors.',
802
+ formulaDisplay: 'Ad Spend ÷ Searches',
803
+ formula: 'spend / searches',
611
804
  sumPrefix: '$',
612
805
  sumSuffix: '',
613
806
  avgPrefix: '$',
614
807
  avgSuffix: '',
615
808
  icon: 'facebook',
616
809
  measure: MEASURE.CHANNEL_FB_SEARCHES_COST,
617
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
810
+ category: MEASURE_CATEGORY.META_ADS,
811
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
618
812
  valueType: MeasureValueType.CURRENCY,
619
813
  decimalPlaces: 2,
620
814
  useCompactNotation: true,
621
815
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
816
+ relatedMeasures: [MEASURE.CHANNEL_FB_SEARCHES],
622
817
  },
623
818
  [MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS]: {
624
819
  title: 'Meta Add to Wishlists',
820
+ shortTitle: 'Wishlists',
625
821
  description: 'The number of add to wishlist actions attributed to your Meta ads.',
822
+ tooltip: 'How many times shoppers saved items to their wishlist after engaging with your ad. Signals future purchase intent.',
626
823
  sumPrefix: '',
627
824
  sumSuffix: '',
628
825
  avgPrefix: '',
629
826
  avgSuffix: '',
630
827
  icon: 'facebook',
631
828
  measure: MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS,
632
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
829
+ category: MEASURE_CATEGORY.META_ADS,
830
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
633
831
  valueType: MeasureValueType.NUMBER,
634
832
  decimalPlaces: 0,
635
833
  useCompactNotation: false,
636
834
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
835
+ relatedMeasures: [MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS_COST, MEASURE.CHANNEL_FB_ADD_TO_CARTS],
637
836
  },
638
837
  [MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS_VALUE]: {
639
838
  title: 'Meta Add to Wishlists Value',
839
+ shortTitle: 'Wishlist Value',
640
840
  description: 'The total value of products added to wishlist from your Meta ads.',
841
+ tooltip: 'Combined catalog value of all items saved to wishlists by visitors from your Meta ads.',
641
842
  sumPrefix: '$',
642
843
  sumSuffix: '',
643
844
  avgPrefix: '$',
644
845
  avgSuffix: '',
645
846
  icon: 'facebook',
646
847
  measure: MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS_VALUE,
647
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
848
+ category: MEASURE_CATEGORY.META_ADS,
849
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
648
850
  valueType: MeasureValueType.CURRENCY,
649
851
  decimalPlaces: 2,
650
852
  useCompactNotation: true,
651
853
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
854
+ relatedMeasures: [MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS, MEASURE.CHANNEL_FB_ADD_TO_CARTS_VALUE],
652
855
  },
653
856
  [MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS_COST]: {
654
857
  title: 'Meta Cost per Add to Wishlist',
858
+ shortTitle: 'Cost/Wishlist',
655
859
  description: 'The cost per add to wishlist action from your Meta ads.',
860
+ tooltip: 'Average spend per wishlist add from your Meta ads.',
861
+ formulaDisplay: 'Ad Spend ÷ Add to Wishlists',
862
+ formula: 'spend / add_to_wishlists',
656
863
  sumPrefix: '$',
657
864
  sumSuffix: '',
658
865
  avgPrefix: '$',
659
866
  avgSuffix: '',
660
867
  icon: 'facebook',
661
868
  measure: MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS_COST,
662
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
869
+ category: MEASURE_CATEGORY.META_ADS,
870
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
663
871
  valueType: MeasureValueType.CURRENCY,
664
872
  decimalPlaces: 2,
665
873
  useCompactNotation: true,
666
874
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
875
+ relatedMeasures: [MEASURE.CHANNEL_FB_ADD_TO_WISHLISTS, MEASURE.CHANNEL_FB_ADD_TO_CARTS_COST],
667
876
  },
668
877
  [MEASURE.CHANNEL_FB_ENGAGEMENTS]: {
669
878
  title: 'Meta Engagements',
670
879
  description: 'The total interactions with your Meta ads (likes, comments, shares, etc.).',
880
+ tooltip: 'All social interactions on your ad including reactions, comments, shares, and saves. High engagement signals resonant creative.',
671
881
  sumPrefix: '',
672
882
  sumSuffix: '',
673
883
  avgPrefix: '',
674
884
  avgSuffix: '',
675
885
  icon: 'facebook',
676
886
  measure: MEASURE.CHANNEL_FB_ENGAGEMENTS,
677
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
887
+ category: MEASURE_CATEGORY.META_ADS,
888
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
678
889
  valueType: MeasureValueType.NUMBER,
679
890
  decimalPlaces: 0,
680
891
  useCompactNotation: false,
681
892
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
893
+ relatedMeasures: [MEASURE.CHANNEL_FB_ENGAGEMENTS_COST, MEASURE.CHANNEL_FB_ENGAGEMENT_RATE, MEASURE.CHANNEL_FB_REACTIONS, MEASURE.CHANNEL_FB_SHARES],
682
894
  },
683
895
  [MEASURE.CHANNEL_FB_ENGAGEMENTS_COST]: {
684
896
  title: 'Meta Cost per Engagement',
897
+ shortTitle: 'Cost/Engagement',
685
898
  description: 'The cost per engagement on your Meta ads.',
899
+ tooltip: 'Average spend per social interaction. Useful for evaluating brand awareness and community-building campaigns.',
900
+ formulaDisplay: 'Ad Spend ÷ Engagements',
901
+ formula: 'spend / engagements',
686
902
  sumPrefix: '$',
687
903
  sumSuffix: '',
688
904
  avgPrefix: '$',
689
905
  avgSuffix: '',
690
906
  icon: 'facebook',
691
907
  measure: MEASURE.CHANNEL_FB_ENGAGEMENTS_COST,
692
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
908
+ category: MEASURE_CATEGORY.META_ADS,
909
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
693
910
  valueType: MeasureValueType.CURRENCY,
694
911
  decimalPlaces: 2,
695
912
  useCompactNotation: true,
696
913
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
914
+ relatedMeasures: [MEASURE.CHANNEL_FB_ENGAGEMENTS, MEASURE.CHANNEL_FB_ENGAGEMENT_RATE],
697
915
  },
698
916
  [MEASURE.CHANNEL_FB_ENGAGEMENT_RATE]: {
699
917
  title: 'Meta Engagement Rate',
918
+ shortTitle: 'Engagement Rate',
700
919
  description: 'The percentage of people who engaged with your Meta ads after seeing them.',
920
+ tooltip: 'Share of people who interacted with your ad after seeing it. Higher rates indicate more compelling content.',
921
+ formulaDisplay: 'Engagements ÷ Reach × 100',
922
+ formula: 'engagements / reach * 100',
701
923
  sumPrefix: '',
702
924
  sumSuffix: '%',
703
925
  avgPrefix: '',
704
926
  avgSuffix: '%',
705
927
  icon: 'facebook',
706
928
  measure: MEASURE.CHANNEL_FB_ENGAGEMENT_RATE,
707
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
929
+ category: MEASURE_CATEGORY.META_ADS,
930
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
708
931
  valueType: MeasureValueType.PERCENTAGE,
709
932
  decimalPlaces: 2,
710
933
  useCompactNotation: false,
711
934
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
935
+ relatedMeasures: [MEASURE.CHANNEL_FB_ENGAGEMENTS, MEASURE.CHANNEL_FB_ENGAGEMENTS_COST],
712
936
  },
713
937
  [MEASURE.CHANNEL_FB_SHARES]: {
714
938
  title: 'Meta Shares',
715
939
  description: 'The number of times your Meta ads were shared.',
940
+ tooltip: 'How many times people shared your ad to their own feed or stories. Shares extend organic reach at no extra cost.',
716
941
  sumPrefix: '',
717
942
  sumSuffix: '',
718
943
  avgPrefix: '',
719
944
  avgSuffix: '',
720
945
  icon: 'facebook',
721
946
  measure: MEASURE.CHANNEL_FB_SHARES,
722
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
947
+ category: MEASURE_CATEGORY.META_ADS,
948
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
723
949
  valueType: MeasureValueType.NUMBER,
724
950
  decimalPlaces: 0,
725
951
  useCompactNotation: false,
726
952
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
953
+ relatedMeasures: [MEASURE.CHANNEL_FB_SHARES_COST, MEASURE.CHANNEL_FB_ENGAGEMENTS],
727
954
  },
728
955
  [MEASURE.CHANNEL_FB_SHARES_COST]: {
729
956
  title: 'Meta Cost per Share',
957
+ shortTitle: 'Cost/Share',
730
958
  description: 'The cost per share of your Meta ads.',
959
+ tooltip: 'Average spend per ad share. A lower cost-per-share can signal strong word-of-mouth potential.',
960
+ formulaDisplay: 'Ad Spend ÷ Shares',
961
+ formula: 'spend / shares',
731
962
  sumPrefix: '$',
732
963
  sumSuffix: '',
733
964
  avgPrefix: '$',
734
965
  avgSuffix: '',
735
966
  icon: 'facebook',
736
967
  measure: MEASURE.CHANNEL_FB_SHARES_COST,
737
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
968
+ category: MEASURE_CATEGORY.META_ADS,
969
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
738
970
  valueType: MeasureValueType.CURRENCY,
739
971
  decimalPlaces: 2,
740
972
  useCompactNotation: true,
741
973
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
974
+ relatedMeasures: [MEASURE.CHANNEL_FB_SHARES, MEASURE.CHANNEL_FB_ENGAGEMENTS_COST],
742
975
  },
743
976
  [MEASURE.CHANNEL_FB_REACTIONS]: {
744
977
  title: 'Meta Reactions',
745
978
  description: 'The number of reactions (like, love, wow, etc.) on your Meta ads.',
979
+ tooltip: 'Total emoji reactions on your ad. Reactions are a quick signal of emotional resonance with your audience.',
746
980
  sumPrefix: '',
747
981
  sumSuffix: '',
748
982
  avgPrefix: '',
749
983
  avgSuffix: '',
750
984
  icon: 'facebook',
751
985
  measure: MEASURE.CHANNEL_FB_REACTIONS,
752
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
986
+ category: MEASURE_CATEGORY.META_ADS,
987
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
753
988
  valueType: MeasureValueType.NUMBER,
754
989
  decimalPlaces: 0,
755
990
  useCompactNotation: false,
756
991
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
992
+ relatedMeasures: [MEASURE.CHANNEL_FB_REACTIONS_COST, MEASURE.CHANNEL_FB_LIKES, MEASURE.CHANNEL_FB_ENGAGEMENTS],
757
993
  },
758
994
  [MEASURE.CHANNEL_FB_REACTIONS_COST]: {
759
995
  title: 'Meta Cost per Reaction',
996
+ shortTitle: 'Cost/Reaction',
760
997
  description: 'The cost per reaction on your Meta ads.',
998
+ tooltip: 'Average spend per emoji reaction on your ad.',
999
+ formulaDisplay: 'Ad Spend ÷ Reactions',
1000
+ formula: 'spend / reactions',
761
1001
  sumPrefix: '$',
762
1002
  sumSuffix: '',
763
1003
  avgPrefix: '$',
764
1004
  avgSuffix: '',
765
1005
  icon: 'facebook',
766
1006
  measure: MEASURE.CHANNEL_FB_REACTIONS_COST,
767
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1007
+ category: MEASURE_CATEGORY.META_ADS,
1008
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
768
1009
  valueType: MeasureValueType.CURRENCY,
769
1010
  decimalPlaces: 2,
770
1011
  useCompactNotation: true,
771
1012
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1013
+ relatedMeasures: [MEASURE.CHANNEL_FB_REACTIONS, MEASURE.CHANNEL_FB_ENGAGEMENTS_COST],
772
1014
  },
773
1015
  [MEASURE.CHANNEL_FB_LIKES]: {
774
1016
  title: 'Meta Likes',
775
1017
  description: 'The number of likes on your Meta ads.',
1018
+ tooltip: 'Total thumbs-up reactions on your ad. Likes are a basic positive engagement signal.',
776
1019
  sumPrefix: '',
777
1020
  sumSuffix: '',
778
1021
  avgPrefix: '',
779
1022
  avgSuffix: '',
780
1023
  icon: 'facebook',
781
1024
  measure: MEASURE.CHANNEL_FB_LIKES,
782
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1025
+ category: MEASURE_CATEGORY.META_ADS,
1026
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
783
1027
  valueType: MeasureValueType.NUMBER,
784
1028
  decimalPlaces: 0,
785
1029
  useCompactNotation: false,
786
1030
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1031
+ relatedMeasures: [MEASURE.CHANNEL_FB_LIKES_COST, MEASURE.CHANNEL_FB_REACTIONS],
787
1032
  },
788
1033
  [MEASURE.CHANNEL_FB_LIKES_COST]: {
789
1034
  title: 'Meta Cost per Like',
1035
+ shortTitle: 'Cost/Like',
790
1036
  description: 'The cost per like on your Meta ads.',
1037
+ tooltip: 'Average spend per like on your ad.',
1038
+ formulaDisplay: 'Ad Spend ÷ Likes',
1039
+ formula: 'spend / likes',
791
1040
  sumPrefix: '$',
792
1041
  sumSuffix: '',
793
1042
  avgPrefix: '$',
794
1043
  avgSuffix: '',
795
1044
  icon: 'facebook',
796
1045
  measure: MEASURE.CHANNEL_FB_LIKES_COST,
797
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1046
+ category: MEASURE_CATEGORY.META_ADS,
1047
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
798
1048
  valueType: MeasureValueType.CURRENCY,
799
1049
  decimalPlaces: 2,
800
1050
  useCompactNotation: true,
801
1051
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1052
+ relatedMeasures: [MEASURE.CHANNEL_FB_LIKES, MEASURE.CHANNEL_FB_REACTIONS_COST],
802
1053
  },
803
1054
  [MEASURE.CHANNEL_FB_COMMENTS]: {
804
1055
  title: 'Meta Comments',
805
1056
  description: 'The number of comments on your Meta ads.',
1057
+ tooltip: 'Total comments left on your ad. Comments often indicate strong opinions or questions about your product.',
806
1058
  sumPrefix: '',
807
1059
  sumSuffix: '',
808
1060
  avgPrefix: '',
809
1061
  avgSuffix: '',
810
1062
  icon: 'facebook',
811
1063
  measure: MEASURE.CHANNEL_FB_COMMENTS,
812
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1064
+ category: MEASURE_CATEGORY.META_ADS,
1065
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
813
1066
  valueType: MeasureValueType.NUMBER,
814
1067
  decimalPlaces: 0,
815
1068
  useCompactNotation: false,
816
1069
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1070
+ relatedMeasures: [MEASURE.CHANNEL_FB_COMMENTS_COST, MEASURE.CHANNEL_FB_ENGAGEMENTS],
817
1071
  },
818
1072
  [MEASURE.CHANNEL_FB_COMMENTS_COST]: {
819
1073
  title: 'Meta Cost per Comment',
1074
+ shortTitle: 'Cost/Comment',
820
1075
  description: 'The cost per comment on your Meta ads.',
1076
+ tooltip: 'Average spend per comment on your ad.',
1077
+ formulaDisplay: 'Ad Spend ÷ Comments',
1078
+ formula: 'spend / comments',
821
1079
  sumPrefix: '$',
822
1080
  sumSuffix: '',
823
1081
  avgPrefix: '$',
824
1082
  avgSuffix: '',
825
1083
  icon: 'facebook',
826
1084
  measure: MEASURE.CHANNEL_FB_COMMENTS_COST,
827
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1085
+ category: MEASURE_CATEGORY.META_ADS,
1086
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
828
1087
  valueType: MeasureValueType.CURRENCY,
829
1088
  decimalPlaces: 2,
830
1089
  useCompactNotation: true,
831
1090
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1091
+ relatedMeasures: [MEASURE.CHANNEL_FB_COMMENTS, MEASURE.CHANNEL_FB_ENGAGEMENTS_COST],
832
1092
  },
833
1093
  [MEASURE.CHANNEL_FB_SAVES]: {
834
1094
  title: 'Meta Saves',
835
1095
  description: 'The number of times people saved your Meta ads for later viewing.',
1096
+ tooltip: 'How many people bookmarked your ad to revisit later. Saves indicate strong product interest.',
836
1097
  sumPrefix: '',
837
1098
  sumSuffix: '',
838
1099
  avgPrefix: '',
839
1100
  avgSuffix: '',
840
1101
  icon: 'facebook',
841
1102
  measure: MEASURE.CHANNEL_FB_SAVES,
842
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1103
+ category: MEASURE_CATEGORY.META_ADS,
1104
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
843
1105
  valueType: MeasureValueType.NUMBER,
844
1106
  decimalPlaces: 0,
845
1107
  useCompactNotation: false,
846
1108
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1109
+ relatedMeasures: [MEASURE.CHANNEL_FB_SAVES_COST, MEASURE.CHANNEL_FB_ENGAGEMENTS],
847
1110
  },
848
1111
  [MEASURE.CHANNEL_FB_SAVES_COST]: {
849
1112
  title: 'Meta Cost per Save',
1113
+ shortTitle: 'Cost/Save',
850
1114
  description: 'The cost per save on your Meta ads.',
1115
+ tooltip: 'Average spend per ad save.',
1116
+ formulaDisplay: 'Ad Spend ÷ Saves',
1117
+ formula: 'spend / saves',
851
1118
  sumPrefix: '$',
852
1119
  sumSuffix: '',
853
1120
  avgPrefix: '$',
854
1121
  avgSuffix: '',
855
1122
  icon: 'facebook',
856
1123
  measure: MEASURE.CHANNEL_FB_SAVES_COST,
857
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1124
+ category: MEASURE_CATEGORY.META_ADS,
1125
+ subcategory: MEASURE_SUBCATEGORY.META_ENGAGEMENT,
858
1126
  valueType: MeasureValueType.CURRENCY,
859
1127
  decimalPlaces: 2,
860
1128
  useCompactNotation: true,
861
1129
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1130
+ relatedMeasures: [MEASURE.CHANNEL_FB_SAVES, MEASURE.CHANNEL_FB_ENGAGEMENTS_COST],
862
1131
  },
863
1132
  [MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS]: {
864
1133
  title: 'Meta Landing Page Views',
1134
+ shortTitle: 'LP Views',
865
1135
  description: 'The number of times your landing page loaded after people clicked your ads.',
1136
+ tooltip: 'How many people fully loaded your landing page after clicking. Lower than link clicks indicates drop-off before the page loaded.',
866
1137
  sumPrefix: '',
867
1138
  sumSuffix: '',
868
1139
  avgPrefix: '',
869
1140
  avgSuffix: '',
870
1141
  icon: 'facebook',
871
1142
  measure: MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS,
872
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1143
+ category: MEASURE_CATEGORY.META_ADS,
1144
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
873
1145
  valueType: MeasureValueType.NUMBER,
874
1146
  decimalPlaces: 0,
875
1147
  useCompactNotation: false,
876
1148
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1149
+ relatedMeasures: [MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS_COST, MEASURE.CHANNEL_FB_LANDING_PAGE_VIEW_RATE, MEASURE.CHANNEL_FB_LINK_CLICKS],
877
1150
  },
878
1151
  [MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS_COST]: {
879
1152
  title: 'Meta Cost per Landing Page View',
1153
+ shortTitle: 'Cost/LP View',
880
1154
  description: 'The cost per landing page view from your Meta ads.',
1155
+ tooltip: 'Average spend per landing page load. A more reliable traffic metric than clicks alone.',
1156
+ formulaDisplay: 'Ad Spend ÷ Landing Page Views',
1157
+ formula: 'spend / landing_page_views',
881
1158
  sumPrefix: '$',
882
1159
  sumSuffix: '',
883
1160
  avgPrefix: '$',
884
1161
  avgSuffix: '',
885
1162
  icon: 'facebook',
886
1163
  measure: MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS_COST,
887
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1164
+ category: MEASURE_CATEGORY.META_ADS,
1165
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
888
1166
  valueType: MeasureValueType.CURRENCY,
889
1167
  decimalPlaces: 2,
890
1168
  useCompactNotation: true,
891
1169
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1170
+ relatedMeasures: [MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS, MEASURE.CHANNEL_FB_COST_PER_LINK_CLICK],
892
1171
  },
893
1172
  [MEASURE.CHANNEL_FB_LANDING_PAGE_VIEW_RATE]: {
894
1173
  title: 'Meta Landing Page View Rate',
1174
+ shortTitle: 'LP View Rate',
895
1175
  description: 'The percentage of clicks that resulted in landing page loads.',
1176
+ tooltip: 'Share of link clicks that actually loaded your landing page. Low rates suggest slow load times or bounce issues.',
1177
+ formulaDisplay: 'Landing Page Views ÷ Link Clicks × 100',
1178
+ formula: 'landing_page_views / link_clicks * 100',
896
1179
  sumPrefix: '',
897
1180
  sumSuffix: '%',
898
1181
  avgPrefix: '',
899
1182
  avgSuffix: '%',
900
1183
  icon: 'facebook',
901
1184
  measure: MEASURE.CHANNEL_FB_LANDING_PAGE_VIEW_RATE,
902
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1185
+ category: MEASURE_CATEGORY.META_ADS,
1186
+ subcategory: MEASURE_SUBCATEGORY.META_CLICKS,
903
1187
  valueType: MeasureValueType.PERCENTAGE,
904
1188
  decimalPlaces: 2,
905
1189
  useCompactNotation: false,
906
1190
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1191
+ relatedMeasures: [MEASURE.CHANNEL_FB_LANDING_PAGE_VIEWS, MEASURE.CHANNEL_FB_LINK_CLICKS],
907
1192
  },
908
1193
  [MEASURE.CHANNEL_FB_LEADS]: {
909
1194
  title: 'Meta Leads',
910
1195
  description: 'The number of leads generated from your Meta ads.',
1196
+ tooltip: 'How many people submitted a lead form or completed a lead event from your Meta ads.',
911
1197
  sumPrefix: '',
912
1198
  sumSuffix: '',
913
1199
  avgPrefix: '',
914
1200
  avgSuffix: '',
915
1201
  icon: 'facebook',
916
1202
  measure: MEASURE.CHANNEL_FB_LEADS,
917
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1203
+ category: MEASURE_CATEGORY.META_ADS,
1204
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
918
1205
  valueType: MeasureValueType.NUMBER,
919
1206
  decimalPlaces: 0,
920
1207
  useCompactNotation: false,
921
1208
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1209
+ relatedMeasures: [MEASURE.CHANNEL_FB_LEADS_COST, MEASURE.CHANNEL_FB_LEADS_VALUE, MEASURE.CHANNEL_FB_PURCHASES],
922
1210
  },
923
1211
  [MEASURE.CHANNEL_FB_LEADS_VALUE]: {
924
1212
  title: 'Meta Leads Value',
1213
+ shortTitle: 'Lead Value',
925
1214
  description: 'The total value of leads generated from your Meta ads.',
1215
+ tooltip: 'Combined assigned value of all leads generated via Meta ads.',
926
1216
  sumPrefix: '$',
927
1217
  sumSuffix: '',
928
1218
  avgPrefix: '$',
929
1219
  avgSuffix: '',
930
1220
  icon: 'facebook',
931
1221
  measure: MEASURE.CHANNEL_FB_LEADS_VALUE,
932
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1222
+ category: MEASURE_CATEGORY.META_ADS,
1223
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
933
1224
  valueType: MeasureValueType.CURRENCY,
934
1225
  decimalPlaces: 2,
935
1226
  useCompactNotation: true,
936
1227
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1228
+ relatedMeasures: [MEASURE.CHANNEL_FB_LEADS, MEASURE.CHANNEL_FB_LEADS_COST],
937
1229
  },
938
1230
  [MEASURE.CHANNEL_FB_LEADS_COST]: {
939
1231
  title: 'Meta Cost per Lead',
1232
+ shortTitle: 'CPL',
940
1233
  description: 'The cost per lead generated from your Meta ads.',
1234
+ tooltip: 'Average spend per lead from Meta ads. Key metric for lead generation campaigns.',
1235
+ formulaDisplay: 'Ad Spend ÷ Leads',
1236
+ formula: 'spend / leads',
941
1237
  sumPrefix: '$',
942
1238
  sumSuffix: '',
943
1239
  avgPrefix: '$',
944
1240
  avgSuffix: '',
945
1241
  icon: 'facebook',
946
1242
  measure: MEASURE.CHANNEL_FB_LEADS_COST,
947
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1243
+ category: MEASURE_CATEGORY.META_ADS,
1244
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
948
1245
  valueType: MeasureValueType.CURRENCY,
949
1246
  decimalPlaces: 2,
950
1247
  useCompactNotation: true,
951
1248
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1249
+ relatedMeasures: [MEASURE.CHANNEL_FB_LEADS, MEASURE.CHANNEL_FB_CPA],
952
1250
  },
953
1251
  [MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES]: {
954
1252
  title: 'Meta Appointments Scheduled',
1253
+ shortTitle: 'Appointments',
955
1254
  description: 'The number of appointments scheduled from your Meta ads.',
1255
+ tooltip: 'How many people booked an appointment after engaging with your Meta ad.',
956
1256
  sumPrefix: '',
957
1257
  sumSuffix: '',
958
1258
  avgPrefix: '',
959
1259
  avgSuffix: '',
960
1260
  icon: 'facebook',
961
1261
  measure: MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES,
962
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1262
+ category: MEASURE_CATEGORY.META_ADS,
1263
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
963
1264
  valueType: MeasureValueType.NUMBER,
964
1265
  decimalPlaces: 0,
965
1266
  useCompactNotation: false,
966
1267
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1268
+ relatedMeasures: [MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES_COST, MEASURE.CHANNEL_FB_LEADS],
967
1269
  },
968
1270
  [MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES_VALUE]: {
969
1271
  title: 'Meta Appointments Scheduled Value',
1272
+ shortTitle: 'Appointment Value',
970
1273
  description: 'The total value of appointments scheduled from your Meta ads.',
1274
+ tooltip: 'Combined assigned value of all appointments booked from Meta ads.',
971
1275
  sumPrefix: '$',
972
1276
  sumSuffix: '',
973
1277
  avgPrefix: '$',
974
1278
  avgSuffix: '',
975
1279
  icon: 'facebook',
976
1280
  measure: MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES_VALUE,
977
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1281
+ category: MEASURE_CATEGORY.META_ADS,
1282
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
978
1283
  valueType: MeasureValueType.CURRENCY,
979
1284
  decimalPlaces: 2,
980
1285
  useCompactNotation: true,
981
1286
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1287
+ relatedMeasures: [MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES, MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES_COST],
982
1288
  },
983
1289
  [MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES_COST]: {
984
1290
  title: 'Meta Cost per Appointment Scheduled',
1291
+ shortTitle: 'Cost/Appointment',
985
1292
  description: 'The cost per appointment scheduled from your Meta ads.',
1293
+ tooltip: 'Average spend per appointment booked from Meta ads.',
1294
+ formulaDisplay: 'Ad Spend ÷ Appointments Scheduled',
1295
+ formula: 'spend / appointment_schedules',
986
1296
  sumPrefix: '$',
987
1297
  sumSuffix: '',
988
1298
  avgPrefix: '$',
989
1299
  avgSuffix: '',
990
1300
  icon: 'facebook',
991
1301
  measure: MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES_COST,
992
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1302
+ category: MEASURE_CATEGORY.META_ADS,
1303
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
993
1304
  valueType: MeasureValueType.CURRENCY,
994
1305
  decimalPlaces: 2,
995
1306
  useCompactNotation: true,
996
1307
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1308
+ relatedMeasures: [MEASURE.CHANNEL_FB_APPOINTMENT_SCHEDULES, MEASURE.CHANNEL_FB_LEADS_COST],
997
1309
  },
998
1310
  [MEASURE.CHANNEL_FB_SUBSCRIBES]: {
999
1311
  title: 'Meta Subscriptions',
1000
1312
  description: 'The number of subscription sign-ups from your Meta ads.',
1313
+ tooltip: 'How many people signed up for a subscription after engaging with your Meta ad.',
1001
1314
  sumPrefix: '',
1002
1315
  sumSuffix: '',
1003
1316
  avgPrefix: '',
1004
1317
  avgSuffix: '',
1005
1318
  icon: 'facebook',
1006
1319
  measure: MEASURE.CHANNEL_FB_SUBSCRIBES,
1007
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1320
+ category: MEASURE_CATEGORY.META_ADS,
1321
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1008
1322
  valueType: MeasureValueType.NUMBER,
1009
1323
  decimalPlaces: 0,
1010
1324
  useCompactNotation: false,
1011
1325
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1326
+ relatedMeasures: [MEASURE.CHANNEL_FB_SUBSCRIBES_COST, MEASURE.CHANNEL_FB_START_TRIALS],
1012
1327
  },
1013
1328
  [MEASURE.CHANNEL_FB_SUBSCRIBES_VALUE]: {
1014
1329
  title: 'Meta Subscriptions Value',
1330
+ shortTitle: 'Subscription Value',
1015
1331
  description: 'The total value of subscriptions from your Meta ads.',
1332
+ tooltip: 'Combined value of all subscription sign-ups attributed to Meta ads.',
1016
1333
  sumPrefix: '$',
1017
1334
  sumSuffix: '',
1018
1335
  avgPrefix: '$',
1019
1336
  avgSuffix: '',
1020
1337
  icon: 'facebook',
1021
1338
  measure: MEASURE.CHANNEL_FB_SUBSCRIBES_VALUE,
1022
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1339
+ category: MEASURE_CATEGORY.META_ADS,
1340
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1023
1341
  valueType: MeasureValueType.CURRENCY,
1024
1342
  decimalPlaces: 2,
1025
1343
  useCompactNotation: true,
1026
1344
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1345
+ relatedMeasures: [MEASURE.CHANNEL_FB_SUBSCRIBES, MEASURE.CHANNEL_FB_SUBSCRIBES_COST],
1027
1346
  },
1028
1347
  [MEASURE.CHANNEL_FB_SUBSCRIBES_COST]: {
1029
1348
  title: 'Meta Cost per Subscription',
1349
+ shortTitle: 'Cost/Subscription',
1030
1350
  description: 'The cost per subscription sign-up from your Meta ads.',
1351
+ tooltip: 'Average spend per subscription acquired from Meta ads.',
1352
+ formulaDisplay: 'Ad Spend ÷ Subscriptions',
1353
+ formula: 'spend / subscribes',
1031
1354
  sumPrefix: '$',
1032
1355
  sumSuffix: '',
1033
1356
  avgPrefix: '$',
1034
1357
  avgSuffix: '',
1035
1358
  icon: 'facebook',
1036
1359
  measure: MEASURE.CHANNEL_FB_SUBSCRIBES_COST,
1037
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1360
+ category: MEASURE_CATEGORY.META_ADS,
1361
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1038
1362
  valueType: MeasureValueType.CURRENCY,
1039
1363
  decimalPlaces: 2,
1040
1364
  useCompactNotation: true,
1041
1365
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1366
+ relatedMeasures: [MEASURE.CHANNEL_FB_SUBSCRIBES, MEASURE.CHANNEL_FB_CPA],
1042
1367
  },
1043
1368
  [MEASURE.CHANNEL_FB_START_TRIALS]: {
1044
1369
  title: 'Meta Trial Starts',
1045
1370
  description: 'The number of trial starts from your Meta ads.',
1371
+ tooltip: 'How many people started a free or paid trial after engaging with your Meta ad.',
1046
1372
  sumPrefix: '',
1047
1373
  sumSuffix: '',
1048
1374
  avgPrefix: '',
1049
1375
  avgSuffix: '',
1050
1376
  icon: 'facebook',
1051
1377
  measure: MEASURE.CHANNEL_FB_START_TRIALS,
1052
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1378
+ category: MEASURE_CATEGORY.META_ADS,
1379
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1053
1380
  valueType: MeasureValueType.NUMBER,
1054
1381
  decimalPlaces: 0,
1055
1382
  useCompactNotation: false,
1056
1383
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1384
+ relatedMeasures: [MEASURE.CHANNEL_FB_START_TRIALS_COST, MEASURE.CHANNEL_FB_SUBSCRIBES],
1057
1385
  },
1058
1386
  [MEASURE.CHANNEL_FB_START_TRIALS_VALUE]: {
1059
1387
  title: 'Meta Trial Starts Value',
1388
+ shortTitle: 'Trial Value',
1060
1389
  description: 'The total value of trials started from your Meta ads.',
1390
+ tooltip: 'Combined assigned value of all trial starts attributed to Meta ads.',
1061
1391
  sumPrefix: '$',
1062
1392
  sumSuffix: '',
1063
1393
  avgPrefix: '$',
1064
1394
  avgSuffix: '',
1065
1395
  icon: 'facebook',
1066
1396
  measure: MEASURE.CHANNEL_FB_START_TRIALS_VALUE,
1067
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1397
+ category: MEASURE_CATEGORY.META_ADS,
1398
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1068
1399
  valueType: MeasureValueType.CURRENCY,
1069
1400
  decimalPlaces: 2,
1070
1401
  useCompactNotation: true,
1071
1402
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1403
+ relatedMeasures: [MEASURE.CHANNEL_FB_START_TRIALS, MEASURE.CHANNEL_FB_START_TRIALS_COST],
1072
1404
  },
1073
1405
  [MEASURE.CHANNEL_FB_START_TRIALS_COST]: {
1074
1406
  title: 'Meta Cost per Trial Start',
1407
+ shortTitle: 'Cost/Trial',
1075
1408
  description: 'The cost per trial start from your Meta ads.',
1409
+ tooltip: 'Average spend per trial started from Meta ads.',
1410
+ formulaDisplay: 'Ad Spend ÷ Trial Starts',
1411
+ formula: 'spend / start_trials',
1076
1412
  sumPrefix: '$',
1077
1413
  sumSuffix: '',
1078
1414
  avgPrefix: '$',
1079
1415
  avgSuffix: '',
1080
1416
  icon: 'facebook',
1081
1417
  measure: MEASURE.CHANNEL_FB_START_TRIALS_COST,
1082
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1418
+ category: MEASURE_CATEGORY.META_ADS,
1419
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1083
1420
  valueType: MeasureValueType.CURRENCY,
1084
1421
  decimalPlaces: 2,
1085
1422
  useCompactNotation: true,
1086
1423
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1424
+ relatedMeasures: [MEASURE.CHANNEL_FB_START_TRIALS, MEASURE.CHANNEL_FB_SUBSCRIBES_COST],
1087
1425
  },
1088
1426
  [MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS]: {
1089
1427
  title: 'Meta Application Submissions',
1428
+ shortTitle: 'Applications',
1090
1429
  description: 'The number of application submissions from your Meta ads.',
1430
+ tooltip: 'How many people submitted an application form after engaging with your Meta ad.',
1091
1431
  sumPrefix: '',
1092
1432
  sumSuffix: '',
1093
1433
  avgPrefix: '',
1094
1434
  avgSuffix: '',
1095
1435
  icon: 'facebook',
1096
1436
  measure: MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS,
1097
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1437
+ category: MEASURE_CATEGORY.META_ADS,
1438
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1098
1439
  valueType: MeasureValueType.NUMBER,
1099
1440
  decimalPlaces: 0,
1100
1441
  useCompactNotation: false,
1101
1442
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1443
+ relatedMeasures: [MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS_COST, MEASURE.CHANNEL_FB_LEADS],
1102
1444
  },
1103
1445
  [MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS_VALUE]: {
1104
1446
  title: 'Meta Application Submissions Value',
1447
+ shortTitle: 'Application Value',
1105
1448
  description: 'The total value of applications submitted from your Meta ads.',
1449
+ tooltip: 'Combined assigned value of all application submissions attributed to Meta ads.',
1106
1450
  sumPrefix: '$',
1107
1451
  sumSuffix: '',
1108
1452
  avgPrefix: '$',
1109
1453
  avgSuffix: '',
1110
1454
  icon: 'facebook',
1111
1455
  measure: MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS_VALUE,
1112
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1456
+ category: MEASURE_CATEGORY.META_ADS,
1457
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1113
1458
  valueType: MeasureValueType.CURRENCY,
1114
1459
  decimalPlaces: 2,
1115
1460
  useCompactNotation: true,
1116
1461
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1462
+ relatedMeasures: [MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS, MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS_COST],
1117
1463
  },
1118
1464
  [MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS_COST]: {
1119
1465
  title: 'Meta Cost per Application Submission',
1466
+ shortTitle: 'Cost/Application',
1120
1467
  description: 'The cost per application submission from your Meta ads.',
1468
+ tooltip: 'Average spend per application submitted from Meta ads.',
1469
+ formulaDisplay: 'Ad Spend ÷ Application Submissions',
1470
+ formula: 'spend / submit_applications',
1121
1471
  sumPrefix: '$',
1122
1472
  sumSuffix: '',
1123
1473
  avgPrefix: '$',
1124
1474
  avgSuffix: '',
1125
1475
  icon: 'facebook',
1126
1476
  measure: MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS_COST,
1127
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1477
+ category: MEASURE_CATEGORY.META_ADS,
1478
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1128
1479
  valueType: MeasureValueType.CURRENCY,
1129
1480
  decimalPlaces: 2,
1130
1481
  useCompactNotation: true,
1131
1482
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1483
+ relatedMeasures: [MEASURE.CHANNEL_FB_SUBMIT_APPLICATIONS, MEASURE.CHANNEL_FB_LEADS_COST],
1132
1484
  },
1133
1485
  [MEASURE.CHANNEL_FB_APP_INSTALLS]: {
1134
1486
  title: 'Meta App Installs',
1135
1487
  description: 'The number of app installs from your Meta ads.',
1488
+ tooltip: 'How many people installed your app after engaging with your Meta ad.',
1136
1489
  sumPrefix: '',
1137
1490
  sumSuffix: '',
1138
1491
  avgPrefix: '',
1139
1492
  avgSuffix: '',
1140
1493
  icon: 'facebook',
1141
1494
  measure: MEASURE.CHANNEL_FB_APP_INSTALLS,
1142
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1495
+ category: MEASURE_CATEGORY.META_ADS,
1496
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1143
1497
  valueType: MeasureValueType.NUMBER,
1144
1498
  decimalPlaces: 0,
1145
1499
  useCompactNotation: false,
1146
1500
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1501
+ relatedMeasures: [MEASURE.CHANNEL_FB_APP_INSTALLS_COST, MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS],
1147
1502
  },
1148
1503
  [MEASURE.CHANNEL_FB_APP_INSTALLS_VALUE]: {
1149
1504
  title: 'Meta App Installs Value',
1505
+ shortTitle: 'Install Value',
1150
1506
  description: 'The total value of app installs from your Meta ads.',
1507
+ tooltip: 'Combined assigned value of all app installs attributed to Meta ads.',
1151
1508
  sumPrefix: '$',
1152
1509
  sumSuffix: '',
1153
1510
  avgPrefix: '$',
1154
1511
  avgSuffix: '',
1155
1512
  icon: 'facebook',
1156
1513
  measure: MEASURE.CHANNEL_FB_APP_INSTALLS_VALUE,
1157
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1514
+ category: MEASURE_CATEGORY.META_ADS,
1515
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1158
1516
  valueType: MeasureValueType.CURRENCY,
1159
1517
  decimalPlaces: 2,
1160
1518
  useCompactNotation: true,
1161
1519
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1520
+ relatedMeasures: [MEASURE.CHANNEL_FB_APP_INSTALLS, MEASURE.CHANNEL_FB_APP_INSTALLS_COST],
1162
1521
  },
1163
1522
  [MEASURE.CHANNEL_FB_APP_INSTALLS_COST]: {
1164
1523
  title: 'Meta Cost per App Install',
1524
+ shortTitle: 'CPI',
1165
1525
  description: 'The cost per app install from your Meta ads.',
1526
+ tooltip: 'Average spend per app install from Meta ads. The primary efficiency metric for app install campaigns.',
1527
+ formulaDisplay: 'Ad Spend ÷ App Installs',
1528
+ formula: 'spend / app_installs',
1166
1529
  sumPrefix: '$',
1167
1530
  sumSuffix: '',
1168
1531
  avgPrefix: '$',
1169
1532
  avgSuffix: '',
1170
1533
  icon: 'facebook',
1171
1534
  measure: MEASURE.CHANNEL_FB_APP_INSTALLS_COST,
1172
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1535
+ category: MEASURE_CATEGORY.META_ADS,
1536
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1173
1537
  valueType: MeasureValueType.CURRENCY,
1174
1538
  decimalPlaces: 2,
1175
1539
  useCompactNotation: true,
1176
1540
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1541
+ relatedMeasures: [MEASURE.CHANNEL_FB_APP_INSTALLS, MEASURE.CHANNEL_FB_CPA],
1177
1542
  },
1178
1543
  [MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS]: {
1179
1544
  title: 'Meta Completed Registrations',
1545
+ shortTitle: 'Registrations',
1180
1546
  description: 'The number of completed registrations from your Meta ads.',
1547
+ tooltip: 'How many people completed a registration form or sign-up flow after engaging with your Meta ad.',
1181
1548
  sumPrefix: '',
1182
1549
  sumSuffix: '',
1183
1550
  avgPrefix: '',
1184
1551
  avgSuffix: '',
1185
1552
  icon: 'facebook',
1186
1553
  measure: MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS,
1187
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1554
+ category: MEASURE_CATEGORY.META_ADS,
1555
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1188
1556
  valueType: MeasureValueType.NUMBER,
1189
1557
  decimalPlaces: 0,
1190
1558
  useCompactNotation: false,
1191
1559
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1560
+ relatedMeasures: [MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS_COST, MEASURE.CHANNEL_FB_LEADS],
1192
1561
  },
1193
1562
  [MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS_VALUE]: {
1194
1563
  title: 'Meta Completed Registrations Value',
1564
+ shortTitle: 'Registration Value',
1195
1565
  description: 'The total value of completed registrations from your Meta ads.',
1566
+ tooltip: 'Combined assigned value of all completed registrations attributed to Meta ads.',
1196
1567
  sumPrefix: '$',
1197
1568
  sumSuffix: '',
1198
1569
  avgPrefix: '$',
1199
1570
  avgSuffix: '',
1200
1571
  icon: 'facebook',
1201
1572
  measure: MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS_VALUE,
1202
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1573
+ category: MEASURE_CATEGORY.META_ADS,
1574
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1203
1575
  valueType: MeasureValueType.CURRENCY,
1204
1576
  decimalPlaces: 2,
1205
1577
  useCompactNotation: true,
1206
1578
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1579
+ relatedMeasures: [MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS, MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS_COST],
1207
1580
  },
1208
1581
  [MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS_COST]: {
1209
1582
  title: 'Meta Cost per Completed Registration',
1583
+ shortTitle: 'Cost/Registration',
1210
1584
  description: 'The cost per completed registration from your Meta ads.',
1585
+ tooltip: 'Average spend per completed registration from Meta ads.',
1586
+ formulaDisplay: 'Ad Spend ÷ Completed Registrations',
1587
+ formula: 'spend / complete_registrations',
1211
1588
  sumPrefix: '$',
1212
1589
  sumSuffix: '',
1213
1590
  avgPrefix: '$',
1214
1591
  avgSuffix: '',
1215
1592
  icon: 'facebook',
1216
1593
  measure: MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS_COST,
1217
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1594
+ category: MEASURE_CATEGORY.META_ADS,
1595
+ subcategory: MEASURE_SUBCATEGORY.META_CONVERSIONS,
1218
1596
  valueType: MeasureValueType.CURRENCY,
1219
1597
  decimalPlaces: 2,
1220
1598
  useCompactNotation: true,
1221
1599
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1600
+ relatedMeasures: [MEASURE.CHANNEL_FB_COMPLETE_REGISTRATIONS, MEASURE.CHANNEL_FB_LEADS_COST],
1222
1601
  },
1223
1602
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS]: {
1224
1603
  title: 'Meta Video Views',
1225
1604
  description: 'The number of video views on your Meta ads.',
1605
+ tooltip: 'How many times your video ad was watched for at least 3 seconds (Meta\'s default view threshold).',
1226
1606
  sumPrefix: '',
1227
1607
  sumSuffix: '',
1228
1608
  avgPrefix: '',
1229
1609
  avgSuffix: '',
1230
1610
  icon: 'facebook',
1231
1611
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS,
1232
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1612
+ category: MEASURE_CATEGORY.META_ADS,
1613
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1233
1614
  valueType: MeasureValueType.NUMBER,
1234
1615
  decimalPlaces: 0,
1235
1616
  useCompactNotation: false,
1236
1617
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1618
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_COST, MEASURE.CHANNEL_FB_VIDEO_PLAYS, MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY],
1237
1619
  },
1238
1620
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_COST]: {
1239
1621
  title: 'Meta Cost per Video View',
1622
+ shortTitle: 'Cost/Video View',
1240
1623
  description: 'The cost per video view on your Meta ads.',
1624
+ tooltip: 'Average spend per 3-second video view. The standard cost metric for video awareness campaigns.',
1625
+ formulaDisplay: 'Ad Spend ÷ Video Views',
1626
+ formula: 'spend / video_views',
1241
1627
  sumPrefix: '$',
1242
1628
  sumSuffix: '',
1243
1629
  avgPrefix: '$',
1244
1630
  avgSuffix: '',
1245
1631
  icon: 'facebook',
1246
1632
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_COST,
1247
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1633
+ category: MEASURE_CATEGORY.META_ADS,
1634
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1248
1635
  valueType: MeasureValueType.CURRENCY,
1249
1636
  decimalPlaces: 2,
1250
1637
  useCompactNotation: true,
1251
1638
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1639
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS, MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY_COST],
1252
1640
  },
1253
1641
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC]: {
1254
1642
  title: 'Meta 15-Second Video Views',
1643
+ shortTitle: '15s Video Views',
1255
1644
  description: 'The number of times your video ads were watched for at least 15 seconds.',
1645
+ tooltip: 'Views where the viewer watched at least 15 continuous seconds. Indicates deeper engagement than the 3-second threshold.',
1256
1646
  sumPrefix: '',
1257
1647
  sumSuffix: '',
1258
1648
  avgPrefix: '',
1259
1649
  avgSuffix: '',
1260
1650
  icon: 'facebook',
1261
1651
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC,
1262
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1652
+ category: MEASURE_CATEGORY.META_ADS,
1653
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1263
1654
  valueType: MeasureValueType.NUMBER,
1264
1655
  decimalPlaces: 0,
1265
1656
  useCompactNotation: false,
1266
1657
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1658
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC_COST, MEASURE.CHANNEL_FB_VIDEO_VIEWS, MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY],
1267
1659
  },
1268
1660
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC_COST]: {
1269
1661
  title: 'Meta Cost per 15-Second Video View',
1662
+ shortTitle: 'Cost/15s View',
1270
1663
  description: 'The cost per 15-second video view on your Meta ads.',
1664
+ tooltip: 'Average spend per 15-second video view. Measures efficiency of engaging longer video content.',
1665
+ formulaDisplay: 'Ad Spend ÷ 15-Second Video Views',
1666
+ formula: 'spend / video_views_15_sec',
1271
1667
  sumPrefix: '$',
1272
1668
  sumSuffix: '',
1273
1669
  avgPrefix: '$',
1274
1670
  avgSuffix: '',
1275
1671
  icon: 'facebook',
1276
1672
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC_COST,
1277
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1673
+ category: MEASURE_CATEGORY.META_ADS,
1674
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1278
1675
  valueType: MeasureValueType.CURRENCY,
1279
1676
  decimalPlaces: 2,
1280
1677
  useCompactNotation: true,
1281
1678
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1679
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC, MEASURE.CHANNEL_FB_VIDEO_VIEWS_COST],
1282
1680
  },
1283
1681
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_30_SEC]: {
1284
1682
  title: 'Meta 30-Second Video Views',
1683
+ shortTitle: '30s Video Views',
1285
1684
  description: 'The number of times your video ads were watched for at least 30 seconds.',
1685
+ tooltip: 'Views where the viewer watched at least 30 continuous seconds. A strong engagement signal for longer video content.',
1286
1686
  sumPrefix: '',
1287
1687
  sumSuffix: '',
1288
1688
  avgPrefix: '',
1289
1689
  avgSuffix: '',
1290
1690
  icon: 'facebook',
1291
1691
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_30_SEC,
1292
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1692
+ category: MEASURE_CATEGORY.META_ADS,
1693
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1293
1694
  valueType: MeasureValueType.NUMBER,
1294
1695
  decimalPlaces: 0,
1295
1696
  useCompactNotation: false,
1296
1697
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1698
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_30_SEC_COST, MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC],
1297
1699
  },
1298
1700
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_30_SEC_COST]: {
1299
1701
  title: 'Meta Cost per 30-Second Video View',
1702
+ shortTitle: 'Cost/30s View',
1300
1703
  description: 'The cost per 30-second video view on your Meta ads.',
1704
+ tooltip: 'Average spend per 30-second video view.',
1705
+ formulaDisplay: 'Ad Spend ÷ 30-Second Video Views',
1706
+ formula: 'spend / video_views_30_sec',
1301
1707
  sumPrefix: '$',
1302
1708
  sumSuffix: '',
1303
1709
  avgPrefix: '$',
1304
1710
  avgSuffix: '',
1305
1711
  icon: 'facebook',
1306
1712
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_30_SEC_COST,
1307
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1713
+ category: MEASURE_CATEGORY.META_ADS,
1714
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1308
1715
  valueType: MeasureValueType.CURRENCY,
1309
1716
  decimalPlaces: 2,
1310
1717
  useCompactNotation: true,
1311
1718
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1719
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_30_SEC, MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC_COST],
1312
1720
  },
1313
1721
  [MEASURE.CHANNEL_FB_VIDEO_P25_WATCHED_VIEWS]: {
1314
- title: 'Meta Video 25% Watched Views',
1722
+ title: 'Meta Video 25% Completion Views',
1723
+ shortTitle: 'Video 25% Views',
1315
1724
  description: 'The number of times your video ads were watched to at least 25% completion.',
1725
+ tooltip: 'Views where the audience watched at least a quarter of your video. Part of the completion rate funnel.',
1316
1726
  sumPrefix: '',
1317
1727
  sumSuffix: '',
1318
1728
  avgPrefix: '',
1319
1729
  avgSuffix: '',
1320
1730
  icon: 'facebook',
1321
1731
  measure: MEASURE.CHANNEL_FB_VIDEO_P25_WATCHED_VIEWS,
1322
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1732
+ category: MEASURE_CATEGORY.META_ADS,
1733
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1323
1734
  valueType: MeasureValueType.NUMBER,
1324
1735
  decimalPlaces: 0,
1325
1736
  useCompactNotation: false,
1326
1737
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1738
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_P50_WATCHED_VIEWS, MEASURE.CHANNEL_FB_VIDEO_VIEWS],
1327
1739
  },
1328
1740
  [MEASURE.CHANNEL_FB_VIDEO_P50_WATCHED_VIEWS]: {
1329
- title: 'Meta Video 50% Watched Views',
1741
+ title: 'Meta Video 50% Completion Views',
1742
+ shortTitle: 'Video 50% Views',
1330
1743
  description: 'The number of times your video ads were watched to at least 50% completion.',
1744
+ tooltip: 'Views where the audience watched at least half of your video. Indicates moderate viewing engagement.',
1331
1745
  sumPrefix: '',
1332
1746
  sumSuffix: '',
1333
1747
  avgPrefix: '',
1334
1748
  avgSuffix: '',
1335
1749
  icon: 'facebook',
1336
1750
  measure: MEASURE.CHANNEL_FB_VIDEO_P50_WATCHED_VIEWS,
1337
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1751
+ category: MEASURE_CATEGORY.META_ADS,
1752
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1338
1753
  valueType: MeasureValueType.NUMBER,
1339
1754
  decimalPlaces: 0,
1340
1755
  useCompactNotation: false,
1341
1756
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1757
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_P25_WATCHED_VIEWS, MEASURE.CHANNEL_FB_VIDEO_P75_WATCHED_VIEWS],
1342
1758
  },
1343
1759
  [MEASURE.CHANNEL_FB_VIDEO_P75_WATCHED_VIEWS]: {
1344
- title: 'Meta Video 75% Watched Views',
1760
+ title: 'Meta Video 75% Completion Views',
1761
+ shortTitle: 'Video 75% Views',
1345
1762
  description: 'The number of times your video ads were watched to at least 75% completion.',
1763
+ tooltip: 'Views where the audience watched at least three quarters of your video. Signals strong content retention.',
1346
1764
  sumPrefix: '',
1347
1765
  sumSuffix: '',
1348
1766
  avgPrefix: '',
1349
1767
  avgSuffix: '',
1350
1768
  icon: 'facebook',
1351
1769
  measure: MEASURE.CHANNEL_FB_VIDEO_P75_WATCHED_VIEWS,
1352
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1770
+ category: MEASURE_CATEGORY.META_ADS,
1771
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1353
1772
  valueType: MeasureValueType.NUMBER,
1354
1773
  decimalPlaces: 0,
1355
1774
  useCompactNotation: false,
1356
1775
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1776
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_P50_WATCHED_VIEWS, MEASURE.CHANNEL_FB_VIDEO_P95_WATCHED_VIEWS],
1357
1777
  },
1358
1778
  [MEASURE.CHANNEL_FB_VIDEO_P95_WATCHED_VIEWS]: {
1359
- title: 'Meta Video 95% Watched Views',
1779
+ title: 'Meta Video 95% Completion Views',
1780
+ shortTitle: 'Video 95% Views',
1360
1781
  description: 'The number of times your video ads were watched to at least 95% completion.',
1782
+ tooltip: 'Views where the audience watched nearly all of your video. Near-complete views indicate very high content engagement.',
1361
1783
  sumPrefix: '',
1362
1784
  sumSuffix: '',
1363
1785
  avgPrefix: '',
1364
1786
  avgSuffix: '',
1365
1787
  icon: 'facebook',
1366
1788
  measure: MEASURE.CHANNEL_FB_VIDEO_P95_WATCHED_VIEWS,
1367
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1789
+ category: MEASURE_CATEGORY.META_ADS,
1790
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1368
1791
  valueType: MeasureValueType.NUMBER,
1369
1792
  decimalPlaces: 0,
1370
1793
  useCompactNotation: false,
1371
1794
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1795
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_P75_WATCHED_VIEWS, MEASURE.CHANNEL_FB_VIDEO_P100_WATCHED_VIEWS],
1372
1796
  },
1373
1797
  [MEASURE.CHANNEL_FB_VIDEO_P100_WATCHED_VIEWS]: {
1374
- title: 'Meta Video 100% Watched Views',
1798
+ title: 'Meta Video Completions',
1799
+ shortTitle: 'Video Completions',
1375
1800
  description: 'The number of times your video ads were watched to 100% completion.',
1801
+ tooltip: 'Views where the audience watched your entire video from start to finish. The strongest video engagement signal.',
1376
1802
  sumPrefix: '',
1377
1803
  sumSuffix: '',
1378
1804
  avgPrefix: '',
1379
1805
  avgSuffix: '',
1380
1806
  icon: 'facebook',
1381
1807
  measure: MEASURE.CHANNEL_FB_VIDEO_P100_WATCHED_VIEWS,
1382
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1808
+ category: MEASURE_CATEGORY.META_ADS,
1809
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1383
1810
  valueType: MeasureValueType.NUMBER,
1384
1811
  decimalPlaces: 0,
1385
1812
  useCompactNotation: false,
1386
1813
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1814
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_P95_WATCHED_VIEWS, MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY],
1387
1815
  },
1388
1816
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY]: {
1389
1817
  title: 'Meta Video Thruplay Views',
1818
+ shortTitle: 'Thruplay Views',
1390
1819
  description: 'The number of videos watched to completion or for at least 15 seconds.',
1820
+ tooltip: 'Views counted as "ThruPlay" by Meta: either completed or watched 15+ seconds. The recommended metric for video campaign optimization.',
1391
1821
  sumPrefix: '',
1392
1822
  sumSuffix: '',
1393
1823
  avgPrefix: '',
1394
1824
  avgSuffix: '',
1395
1825
  icon: 'facebook',
1396
1826
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY,
1397
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1827
+ category: MEASURE_CATEGORY.META_ADS,
1828
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1398
1829
  valueType: MeasureValueType.NUMBER,
1399
1830
  decimalPlaces: 0,
1400
1831
  useCompactNotation: false,
1401
1832
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1833
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY_COST, MEASURE.CHANNEL_FB_VIDEO_P100_WATCHED_VIEWS, MEASURE.CHANNEL_FB_VIDEO_VIEWS_15_SEC],
1402
1834
  },
1403
1835
  [MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY_COST]: {
1404
1836
  title: 'Meta Cost per Video Thruplay',
1837
+ shortTitle: 'Cost/Thruplay',
1405
1838
  description: 'The cost per video watched to completion or for at least 15 seconds.',
1839
+ tooltip: 'Average spend per ThruPlay view. The standard efficiency metric when optimizing for video completion campaigns.',
1840
+ formulaDisplay: 'Ad Spend ÷ Thruplay Views',
1841
+ formula: 'spend / video_views_thruplay',
1406
1842
  sumPrefix: '$',
1407
1843
  sumSuffix: '',
1408
1844
  avgPrefix: '$',
1409
1845
  avgSuffix: '',
1410
1846
  icon: 'facebook',
1411
1847
  measure: MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY_COST,
1412
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1848
+ category: MEASURE_CATEGORY.META_ADS,
1849
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1413
1850
  valueType: MeasureValueType.CURRENCY,
1414
1851
  decimalPlaces: 2,
1415
1852
  useCompactNotation: true,
1416
1853
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1854
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_VIEWS_THRUPLAY, MEASURE.CHANNEL_FB_VIDEO_VIEWS_COST],
1417
1855
  },
1418
1856
  [MEASURE.CHANNEL_FB_VIDEO_PLAYS]: {
1419
1857
  title: 'Meta Video Plays',
1420
1858
  description: 'The number of video plays on your Meta ads.',
1859
+ tooltip: 'Total times your video started playing, including auto-plays. Higher than views due to very short watches being excluded from "views".',
1421
1860
  sumPrefix: '',
1422
1861
  sumSuffix: '',
1423
1862
  avgPrefix: '',
1424
1863
  avgSuffix: '',
1425
1864
  icon: 'facebook',
1426
1865
  measure: MEASURE.CHANNEL_FB_VIDEO_PLAYS,
1427
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1866
+ category: MEASURE_CATEGORY.META_ADS,
1867
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1428
1868
  valueType: MeasureValueType.NUMBER,
1429
1869
  decimalPlaces: 0,
1430
1870
  useCompactNotation: false,
1431
1871
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1872
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_PLAYS_COST, MEASURE.CHANNEL_FB_VIDEO_VIEWS],
1432
1873
  },
1433
1874
  [MEASURE.CHANNEL_FB_VIDEO_PLAYS_COST]: {
1434
1875
  title: 'Meta Cost per Video Play',
1876
+ shortTitle: 'Cost/Video Play',
1435
1877
  description: 'The cost per video play on your Meta ads.',
1878
+ tooltip: 'Average spend per video play initiation, including auto-plays.',
1879
+ formulaDisplay: 'Ad Spend ÷ Video Plays',
1880
+ formula: 'spend / video_plays',
1436
1881
  sumPrefix: '$',
1437
1882
  sumSuffix: '',
1438
1883
  avgPrefix: '$',
1439
1884
  avgSuffix: '',
1440
1885
  icon: 'facebook',
1441
1886
  measure: MEASURE.CHANNEL_FB_VIDEO_PLAYS_COST,
1442
- category: MEASURE_CATEGORY.FACEBOOK_REPORTED,
1887
+ category: MEASURE_CATEGORY.META_ADS,
1888
+ subcategory: MEASURE_SUBCATEGORY.META_VIDEO,
1443
1889
  valueType: MeasureValueType.CURRENCY,
1444
1890
  decimalPlaces: 2,
1445
1891
  useCompactNotation: true,
1446
1892
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
1893
+ relatedMeasures: [MEASURE.CHANNEL_FB_VIDEO_PLAYS, MEASURE.CHANNEL_FB_VIDEO_VIEWS_COST],
1447
1894
  },
1448
1895
  };
1449
1896
  //# sourceMappingURL=facebook-measure-definitions.js.map