@adtrackify/at-tracking-event-types 4.66.29 → 4.66.31

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.
@@ -7,7 +7,7 @@ export const TIKTOK_MEASURES_MAP = {
7
7
  [MEASURE.TIKTOK_SPEND]: {
8
8
  title: 'TikTok Spend',
9
9
  description: 'The total amount spent on your TikTok ads.',
10
- tooltip: 'Total amount billed by TikTok for your ads in the selected period.',
10
+ tooltip: 'Total ad budget consumed by TikTok during the selected period. This is what TikTok billed you.',
11
11
  sumPrefix: '$',
12
12
  sumSuffix: '',
13
13
  avgPrefix: '$',
@@ -20,11 +20,12 @@ export const TIKTOK_MEASURES_MAP = {
20
20
  decimalPlaces: 2,
21
21
  useCompactNotation: true,
22
22
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
23
+ relatedMeasures: [MEASURE.TIKTOK_CPM, MEASURE.TIKTOK_CPC, MEASURE.TIKTOK_ROAS],
23
24
  },
24
25
  [MEASURE.TIKTOK_IMPRESSIONS]: {
25
26
  title: 'TikTok Impressions',
26
27
  description: 'The number of times your TikTok ads were shown.',
27
- tooltip: 'How many times your TikTok ads appeared in front of users.',
28
+ tooltip: 'How many times your ads appeared on screen. One person can generate multiple impressions.',
28
29
  sumPrefix: '',
29
30
  sumSuffix: '',
30
31
  avgPrefix: '',
@@ -35,14 +36,35 @@ export const TIKTOK_MEASURES_MAP = {
35
36
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_AUDIENCE,
36
37
  valueType: MeasureValueType.NUMBER,
37
38
  decimalPlaces: 0,
39
+ useCompactNotation: false,
40
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
41
+ relatedMeasures: [MEASURE.TIKTOK_CPM, MEASURE.TIKTOK_CTR],
42
+ },
43
+ [MEASURE.TIKTOK_CPM]: {
44
+ title: 'TikTok CPM',
45
+ shortTitle: 'CPM',
46
+ description: 'The cost per thousand impressions of your TikTok ads.',
47
+ tooltip: 'How much you pay for every 1,000 times your ad is shown. Lower CPM means cheaper reach.',
48
+ formulaDisplay: 'Ad Spend ÷ Impressions × 1,000',
49
+ formula: 'spend / impressions * 1000',
50
+ sumPrefix: '$',
51
+ sumSuffix: '',
52
+ avgPrefix: '$',
53
+ avgSuffix: '',
54
+ icon: MEASURE_ICON.TIKTOK,
55
+ measure: MEASURE.TIKTOK_CPM,
56
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
57
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_AUDIENCE,
58
+ valueType: MeasureValueType.CURRENCY,
59
+ decimalPlaces: 2,
38
60
  useCompactNotation: true,
39
61
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
62
+ relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_IMPRESSIONS, MEASURE.TIKTOK_CTR],
40
63
  },
41
64
  [MEASURE.TIKTOK_CLICKS]: {
42
65
  title: 'TikTok Clicks',
43
66
  description: 'The number of clicks on your TikTok ads.',
44
- tooltip: 'Total number of times users clicked on your TikTok ads.',
45
- relatedMeasures: [MEASURE.TIKTOK_CTR, MEASURE.TIKTOK_CPC],
67
+ tooltip: 'Total clicks on your TikTok ads, including destination clicks and other interactions.',
46
68
  sumPrefix: '',
47
69
  sumSuffix: '',
48
70
  avgPrefix: '',
@@ -53,38 +75,17 @@ export const TIKTOK_MEASURES_MAP = {
53
75
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_CLICKS,
54
76
  valueType: MeasureValueType.NUMBER,
55
77
  decimalPlaces: 0,
56
- useCompactNotation: true,
57
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
58
- },
59
- [MEASURE.TIKTOK_CTR]: {
60
- title: 'TikTok CTR',
61
- description: 'The percentage of impressions that resulted in clicks.',
62
- shortTitle: 'CTR',
63
- tooltip: 'What percentage of people who saw your ad clicked on it. Higher CTR signals your ad is relevant and compelling.',
64
- formulaDisplay: 'Clicks ÷ Impressions × 100',
65
- formula: 'clicks / impressions * 100',
66
- relatedMeasures: [MEASURE.TIKTOK_CLICKS, MEASURE.TIKTOK_IMPRESSIONS],
67
- sumPrefix: '',
68
- sumSuffix: '%',
69
- avgPrefix: '',
70
- avgSuffix: '%',
71
- icon: MEASURE_ICON.TIKTOK,
72
- measure: MEASURE.TIKTOK_CTR,
73
- category: MEASURE_CATEGORY.TIKTOK_ADS,
74
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_CLICKS,
75
- valueType: MeasureValueType.PERCENTAGE,
76
- decimalPlaces: 2,
77
78
  useCompactNotation: false,
78
79
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
80
+ relatedMeasures: [MEASURE.TIKTOK_CPC, MEASURE.TIKTOK_CTR],
79
81
  },
80
82
  [MEASURE.TIKTOK_CPC]: {
81
83
  title: 'TikTok CPC',
82
- description: 'The cost per click on your TikTok ads.',
83
84
  shortTitle: 'CPC',
84
- tooltip: 'Average amount you pay each time someone clicks your TikTok ad. Lower CPC means more traffic for your budget.',
85
+ description: 'The cost per click on your TikTok ads.',
86
+ tooltip: 'Average cost each time someone clicks your ad. Lower CPC means you are driving traffic more efficiently.',
85
87
  formulaDisplay: 'Ad Spend ÷ Clicks',
86
88
  formula: 'spend / clicks',
87
- relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_CLICKS],
88
89
  sumPrefix: '$',
89
90
  sumSuffix: '',
90
91
  avgPrefix: '$',
@@ -97,33 +98,33 @@ export const TIKTOK_MEASURES_MAP = {
97
98
  decimalPlaces: 2,
98
99
  useCompactNotation: true,
99
100
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
101
+ relatedMeasures: [MEASURE.TIKTOK_CLICKS, MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_CTR],
100
102
  },
101
- [MEASURE.TIKTOK_CPM]: {
102
- title: 'TikTok CPM',
103
- description: 'The cost per thousand impressions of your TikTok ads.',
104
- shortTitle: 'CPM',
105
- tooltip: 'How much you pay for every 1,000 times your TikTok ad is shown. Lower CPM means your budget reaches more people.',
106
- formulaDisplay: 'Ad Spend ÷ Impressions × 1,000',
107
- formula: 'spend / impressions * 1000',
108
- relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_IMPRESSIONS],
109
- sumPrefix: '$',
110
- sumSuffix: '',
111
- avgPrefix: '$',
112
- avgSuffix: '',
103
+ [MEASURE.TIKTOK_CTR]: {
104
+ title: 'TikTok CTR',
105
+ shortTitle: 'CTR',
106
+ description: 'The percentage of impressions that resulted in clicks.',
107
+ tooltip: 'How often people click your ad after seeing it. Higher CTR signals more engaging creative or targeting.',
108
+ formulaDisplay: 'Clicks ÷ Impressions × 100',
109
+ formula: 'clicks / impressions * 100',
110
+ sumPrefix: '',
111
+ sumSuffix: '%',
112
+ avgPrefix: '',
113
+ avgSuffix: '%',
113
114
  icon: MEASURE_ICON.TIKTOK,
114
- measure: MEASURE.TIKTOK_CPM,
115
+ measure: MEASURE.TIKTOK_CTR,
115
116
  category: MEASURE_CATEGORY.TIKTOK_ADS,
116
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_AUDIENCE,
117
- valueType: MeasureValueType.CURRENCY,
117
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CLICKS,
118
+ valueType: MeasureValueType.PERCENTAGE,
118
119
  decimalPlaces: 2,
119
- useCompactNotation: true,
120
+ useCompactNotation: false,
120
121
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
122
+ relatedMeasures: [MEASURE.TIKTOK_CLICKS, MEASURE.TIKTOK_IMPRESSIONS],
121
123
  },
122
124
  [MEASURE.TIKTOK_PURCHASES]: {
123
125
  title: 'TikTok Purchases',
124
126
  description: 'The number of purchases attributed to your TikTok ads.',
125
- tooltip: 'Total conversions reported by TikTok as purchases driven by your ads (web + TikTok Shop).',
126
- relatedMeasures: [MEASURE.TIKTOK_PURCHASES_VALUE, MEASURE.TIKTOK_ROAS, MEASURE.TIKTOK_CPA],
127
+ tooltip: 'How many completed purchases TikTok attributes to your ads, including web and TikTok Shop conversions.',
127
128
  sumPrefix: '',
128
129
  sumSuffix: '',
129
130
  avgPrefix: '',
@@ -136,13 +137,13 @@ export const TIKTOK_MEASURES_MAP = {
136
137
  decimalPlaces: 0,
137
138
  useCompactNotation: false,
138
139
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
140
+ relatedMeasures: [MEASURE.TIKTOK_PURCHASES_VALUE, MEASURE.TIKTOK_CPA, MEASURE.TIKTOK_ROAS],
139
141
  },
140
142
  [MEASURE.TIKTOK_PURCHASES_VALUE]: {
141
143
  title: 'TikTok Purchases Value',
144
+ shortTitle: 'TikTok Revenue',
142
145
  description: 'The total revenue from purchases attributed to your TikTok ads.',
143
- shortTitle: 'TikTok Rev.',
144
- tooltip: 'Total revenue TikTok attributes to your ads based on purchase conversion events.',
145
- relatedMeasures: [MEASURE.TIKTOK_PURCHASES, MEASURE.TIKTOK_ROAS],
146
+ tooltip: 'Total revenue TikTok credits to your ads. Used to calculate ROAS and evaluate campaign profitability.',
146
147
  sumPrefix: '$',
147
148
  sumSuffix: '',
148
149
  avgPrefix: '$',
@@ -155,15 +156,15 @@ export const TIKTOK_MEASURES_MAP = {
155
156
  decimalPlaces: 2,
156
157
  useCompactNotation: true,
157
158
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
159
+ relatedMeasures: [MEASURE.TIKTOK_PURCHASES, MEASURE.TIKTOK_ROAS, MEASURE.TIKTOK_SPEND],
158
160
  },
159
161
  [MEASURE.TIKTOK_CPA]: {
160
162
  title: 'TikTok CPA',
161
- description: 'The cost per purchase conversion from your TikTok ads.',
162
163
  shortTitle: 'CPA',
163
- tooltip: 'How much you spend on average to drive each purchase through TikTok. Lower is better.',
164
+ description: 'The cost per purchase conversion from your TikTok ads.',
165
+ tooltip: 'How much you spend on average for each purchase TikTok attributes to your ads. Lower is better.',
164
166
  formulaDisplay: 'Ad Spend ÷ Purchases',
165
167
  formula: 'spend / purchases',
166
- relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_PURCHASES, MEASURE.TIKTOK_ROAS],
167
168
  sumPrefix: '$',
168
169
  sumSuffix: '',
169
170
  avgPrefix: '$',
@@ -176,15 +177,15 @@ export const TIKTOK_MEASURES_MAP = {
176
177
  decimalPlaces: 2,
177
178
  useCompactNotation: true,
178
179
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
180
+ relatedMeasures: [MEASURE.TIKTOK_PURCHASES, MEASURE.TIKTOK_ROAS, MEASURE.TIKTOK_SPEND],
179
181
  },
180
182
  [MEASURE.TIKTOK_ROAS]: {
181
183
  title: 'TikTok ROAS',
182
- description: 'The return on ad spend from your TikTok ads.',
183
184
  shortTitle: 'ROAS',
184
- tooltip: 'How much revenue you earn for every dollar spent on TikTok ads. A 3x ROAS means $3 in revenue per $1 spent.',
185
+ description: 'The return on ad spend from your TikTok ads.',
186
+ tooltip: 'Revenue TikTok reports per dollar spent on ads. A ROAS of 3x means $3 in attributed revenue for every $1 spent.',
185
187
  formulaDisplay: 'Purchases Value ÷ Ad Spend',
186
188
  formula: 'purchases_value / spend',
187
- relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_PURCHASES_VALUE, MEASURE.TIKTOK_CPA],
188
189
  sumPrefix: '',
189
190
  sumSuffix: 'x',
190
191
  avgPrefix: '',
@@ -197,11 +198,13 @@ export const TIKTOK_MEASURES_MAP = {
197
198
  decimalPlaces: 2,
198
199
  useCompactNotation: false,
199
200
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
201
+ relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_PURCHASES_VALUE, MEASURE.TIKTOK_CPA],
200
202
  },
201
203
  [MEASURE.TIKTOK_VIEW_CONTENTS]: {
202
204
  title: 'TikTok View Contents',
203
- description: 'The number of view content events attributed to your TikTok ads.',
204
- relatedMeasures: [MEASURE.TIKTOK_VIEW_CONTENT_VALUE],
205
+ shortTitle: 'View Content',
206
+ description: 'The number of product or content page views attributed to your TikTok ads.',
207
+ tooltip: 'How many times visitors viewed a product detail page after clicking your ad. A top-of-funnel engagement signal.',
205
208
  sumPrefix: '',
206
209
  sumSuffix: '',
207
210
  avgPrefix: '',
@@ -214,28 +217,53 @@ export const TIKTOK_MEASURES_MAP = {
214
217
  decimalPlaces: 0,
215
218
  useCompactNotation: false,
216
219
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
220
+ relatedMeasures: [MEASURE.TIKTOK_VIEW_CONTENTS_COST, MEASURE.TIKTOK_ADD_TO_CARTS, MEASURE.TIKTOK_PURCHASES],
221
+ },
222
+ [MEASURE.TIKTOK_VIEW_CONTENTS_VALUE]: {
223
+ title: 'TikTok View Contents Value',
224
+ shortTitle: 'View Content Value',
225
+ description: 'The total value of products viewed from your TikTok ads.',
226
+ tooltip: 'Combined catalog value of all product pages viewed by visitors from your TikTok ads.',
227
+ sumPrefix: '$',
228
+ sumSuffix: '',
229
+ avgPrefix: '$',
230
+ avgSuffix: '',
231
+ icon: MEASURE_ICON.TIKTOK,
232
+ measure: MEASURE.TIKTOK_VIEW_CONTENTS_VALUE,
233
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
234
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
235
+ valueType: MeasureValueType.CURRENCY,
236
+ decimalPlaces: 2,
237
+ useCompactNotation: true,
238
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
239
+ relatedMeasures: [MEASURE.TIKTOK_VIEW_CONTENTS, MEASURE.TIKTOK_ADD_TO_CARTS_VALUE],
217
240
  },
218
- [MEASURE.TIKTOK_VIEW_CONTENT_VALUE]: {
219
- title: 'TikTok View Content Value',
220
- description: 'The total value of view content events attributed to your TikTok ads.',
221
- relatedMeasures: [MEASURE.TIKTOK_VIEW_CONTENTS],
241
+ [MEASURE.TIKTOK_VIEW_CONTENTS_COST]: {
242
+ title: 'TikTok Cost per View Content',
243
+ shortTitle: 'Cost/View Content',
244
+ description: 'The cost per product or content page view from your TikTok ads.',
245
+ tooltip: 'Average spend per product page view. Useful for optimizing top-of-funnel traffic cost.',
246
+ formulaDisplay: 'Ad Spend ÷ View Contents',
247
+ formula: 'spend / view_contents',
222
248
  sumPrefix: '$',
223
249
  sumSuffix: '',
224
250
  avgPrefix: '$',
225
251
  avgSuffix: '',
226
252
  icon: MEASURE_ICON.TIKTOK,
227
- measure: MEASURE.TIKTOK_VIEW_CONTENT_VALUE,
253
+ measure: MEASURE.TIKTOK_VIEW_CONTENTS_COST,
228
254
  category: MEASURE_CATEGORY.TIKTOK_ADS,
229
255
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
230
256
  valueType: MeasureValueType.CURRENCY,
231
257
  decimalPlaces: 2,
232
258
  useCompactNotation: true,
233
259
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
260
+ relatedMeasures: [MEASURE.TIKTOK_VIEW_CONTENTS, MEASURE.TIKTOK_ADD_TO_CARTS_COST],
234
261
  },
235
262
  [MEASURE.TIKTOK_ADD_TO_CARTS]: {
236
263
  title: 'TikTok Add to Carts',
237
- description: 'The number of add to cart events attributed to your TikTok ads.',
238
- relatedMeasures: [MEASURE.TIKTOK_ADD_TO_CART_VALUE],
264
+ shortTitle: 'Add to Cart',
265
+ description: 'The number of add to cart actions attributed to your TikTok ads.',
266
+ tooltip: 'How many times shoppers added items to their cart after engaging with your ad. A mid-funnel purchase intent signal.',
239
267
  sumPrefix: '',
240
268
  sumSuffix: '',
241
269
  avgPrefix: '',
@@ -248,27 +276,53 @@ export const TIKTOK_MEASURES_MAP = {
248
276
  decimalPlaces: 0,
249
277
  useCompactNotation: false,
250
278
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
279
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_CARTS_COST, MEASURE.TIKTOK_INITIATE_CHECKOUTS, MEASURE.TIKTOK_PURCHASES],
280
+ },
281
+ [MEASURE.TIKTOK_ADD_TO_CARTS_VALUE]: {
282
+ title: 'TikTok Add to Carts Value',
283
+ shortTitle: 'Cart Value',
284
+ description: 'The total value of products added to cart from your TikTok ads.',
285
+ tooltip: 'Combined value of all items added to carts by visitors from your TikTok ads.',
286
+ sumPrefix: '$',
287
+ sumSuffix: '',
288
+ avgPrefix: '$',
289
+ avgSuffix: '',
290
+ icon: MEASURE_ICON.TIKTOK,
291
+ measure: MEASURE.TIKTOK_ADD_TO_CARTS_VALUE,
292
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
293
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
294
+ valueType: MeasureValueType.CURRENCY,
295
+ decimalPlaces: 2,
296
+ useCompactNotation: true,
297
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
298
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_CARTS, MEASURE.TIKTOK_PURCHASES_VALUE],
251
299
  },
252
- [MEASURE.TIKTOK_ADD_TO_CART_VALUE]: {
253
- title: 'TikTok Add to Cart Value',
254
- description: 'The total value of add to cart events attributed to your TikTok ads.',
255
- relatedMeasures: [MEASURE.TIKTOK_ADD_TO_CARTS],
300
+ [MEASURE.TIKTOK_ADD_TO_CARTS_COST]: {
301
+ title: 'TikTok Cost per Add to Cart',
302
+ shortTitle: 'Cost/Add to Cart',
303
+ description: 'The cost per add to cart action from your TikTok ads.',
304
+ tooltip: 'Average spend per add-to-cart event. Helps gauge how efficiently your ads drive purchase intent.',
305
+ formulaDisplay: 'Ad Spend ÷ Add to Carts',
306
+ formula: 'spend / add_to_carts',
256
307
  sumPrefix: '$',
257
308
  sumSuffix: '',
258
309
  avgPrefix: '$',
259
310
  avgSuffix: '',
260
311
  icon: MEASURE_ICON.TIKTOK,
261
- measure: MEASURE.TIKTOK_ADD_TO_CART_VALUE,
312
+ measure: MEASURE.TIKTOK_ADD_TO_CARTS_COST,
262
313
  category: MEASURE_CATEGORY.TIKTOK_ADS,
263
314
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
264
315
  valueType: MeasureValueType.CURRENCY,
265
316
  decimalPlaces: 2,
266
317
  useCompactNotation: true,
267
318
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
319
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_CARTS, MEASURE.TIKTOK_CPA, MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST],
268
320
  },
269
321
  [MEASURE.TIKTOK_INITIATE_CHECKOUTS]: {
270
322
  title: 'TikTok Initiate Checkouts',
271
- description: 'The number of initiate checkout events attributed to your TikTok ads.',
323
+ shortTitle: 'Checkouts',
324
+ description: 'The number of checkout initiations attributed to your TikTok ads.',
325
+ tooltip: 'How many shoppers started the checkout process after engaging with your ad. A strong bottom-of-funnel conversion signal.',
272
326
  sumPrefix: '',
273
327
  sumSuffix: '',
274
328
  avgPrefix: '',
@@ -281,11 +335,33 @@ export const TIKTOK_MEASURES_MAP = {
281
335
  decimalPlaces: 0,
282
336
  useCompactNotation: false,
283
337
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
338
+ relatedMeasures: [MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST, MEASURE.TIKTOK_PURCHASES, MEASURE.TIKTOK_ADD_TO_CARTS],
339
+ },
340
+ [MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST]: {
341
+ title: 'TikTok Cost per Initiate Checkout',
342
+ shortTitle: 'Cost/Checkout',
343
+ description: 'The cost per checkout initiation from your TikTok ads.',
344
+ tooltip: 'Average spend per checkout started. A lower figure indicates efficient bottom-of-funnel performance.',
345
+ formulaDisplay: 'Ad Spend ÷ Initiate Checkouts',
346
+ formula: 'spend / initiate_checkouts',
347
+ sumPrefix: '$',
348
+ sumSuffix: '',
349
+ avgPrefix: '$',
350
+ avgSuffix: '',
351
+ icon: MEASURE_ICON.TIKTOK,
352
+ measure: MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST,
353
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
354
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
355
+ valueType: MeasureValueType.CURRENCY,
356
+ decimalPlaces: 2,
357
+ useCompactNotation: true,
358
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
359
+ relatedMeasures: [MEASURE.TIKTOK_INITIATE_CHECKOUTS, MEASURE.TIKTOK_CPA, MEASURE.TIKTOK_ADD_TO_CARTS_COST],
284
360
  },
285
361
  [MEASURE.TIKTOK_LEADS]: {
286
362
  title: 'TikTok Leads',
287
- description: 'The number of lead events attributed to your TikTok ads.',
288
- relatedMeasures: [MEASURE.TIKTOK_LEAD_VALUE, MEASURE.TIKTOK_CPL],
363
+ description: 'The number of leads generated from your TikTok ads.',
364
+ tooltip: 'How many people submitted a lead form or completed a lead event from your TikTok ads.',
289
365
  sumPrefix: '',
290
366
  sumSuffix: '',
291
367
  avgPrefix: '',
@@ -298,48 +374,172 @@ export const TIKTOK_MEASURES_MAP = {
298
374
  decimalPlaces: 0,
299
375
  useCompactNotation: false,
300
376
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
377
+ relatedMeasures: [MEASURE.TIKTOK_LEADS_COST, MEASURE.TIKTOK_LEADS_VALUE, MEASURE.TIKTOK_PURCHASES],
301
378
  },
302
- [MEASURE.TIKTOK_LEAD_VALUE]: {
303
- title: 'TikTok Lead Value',
304
- description: 'The total value of lead events attributed to your TikTok ads.',
305
- relatedMeasures: [MEASURE.TIKTOK_LEADS],
379
+ [MEASURE.TIKTOK_LEADS_VALUE]: {
380
+ title: 'TikTok Leads Value',
381
+ shortTitle: 'Lead Value',
382
+ description: 'The total value of leads generated from your TikTok ads.',
383
+ tooltip: 'Combined assigned value of all leads generated via TikTok ads.',
306
384
  sumPrefix: '$',
307
385
  sumSuffix: '',
308
386
  avgPrefix: '$',
309
387
  avgSuffix: '',
310
388
  icon: MEASURE_ICON.TIKTOK,
311
- measure: MEASURE.TIKTOK_LEAD_VALUE,
389
+ measure: MEASURE.TIKTOK_LEADS_VALUE,
312
390
  category: MEASURE_CATEGORY.TIKTOK_ADS,
313
391
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
314
392
  valueType: MeasureValueType.CURRENCY,
315
393
  decimalPlaces: 2,
316
394
  useCompactNotation: true,
317
395
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
396
+ relatedMeasures: [MEASURE.TIKTOK_LEADS, MEASURE.TIKTOK_LEADS_COST],
318
397
  },
319
- [MEASURE.TIKTOK_CPL]: {
398
+ [MEASURE.TIKTOK_LEADS_COST]: {
320
399
  title: 'TikTok Cost per Lead',
321
- description: 'The cost per lead from your TikTok ads.',
322
400
  shortTitle: 'CPL',
323
- tooltip: 'How much you spend on average to drive each lead through TikTok. Lower is better.',
401
+ description: 'The cost per lead generated from your TikTok ads.',
402
+ tooltip: 'Average spend per lead from TikTok ads. Key metric for lead generation campaigns.',
324
403
  formulaDisplay: 'Ad Spend ÷ Leads',
325
404
  formula: 'spend / leads',
326
- relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_LEADS],
327
405
  sumPrefix: '$',
328
406
  sumSuffix: '',
329
407
  avgPrefix: '$',
330
408
  avgSuffix: '',
331
409
  icon: MEASURE_ICON.TIKTOK,
332
- measure: MEASURE.TIKTOK_CPL,
410
+ measure: MEASURE.TIKTOK_LEADS_COST,
333
411
  category: MEASURE_CATEGORY.TIKTOK_ADS,
334
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_EFFICIENCY,
412
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
413
+ valueType: MeasureValueType.CURRENCY,
414
+ decimalPlaces: 2,
415
+ useCompactNotation: true,
416
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
417
+ relatedMeasures: [MEASURE.TIKTOK_LEADS, MEASURE.TIKTOK_CPA],
418
+ },
419
+ [MEASURE.TIKTOK_APP_INSTALLS]: {
420
+ title: 'TikTok App Installs',
421
+ description: 'The number of app installs from your TikTok ads.',
422
+ tooltip: 'How many people installed your app after engaging with your TikTok ad.',
423
+ sumPrefix: '',
424
+ sumSuffix: '',
425
+ avgPrefix: '',
426
+ avgSuffix: '',
427
+ icon: MEASURE_ICON.TIKTOK,
428
+ measure: MEASURE.TIKTOK_APP_INSTALLS,
429
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
430
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
431
+ valueType: MeasureValueType.NUMBER,
432
+ decimalPlaces: 0,
433
+ useCompactNotation: false,
434
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
435
+ relatedMeasures: [MEASURE.TIKTOK_APP_INSTALLS_COST, MEASURE.TIKTOK_COMPLETE_REGISTRATIONS],
436
+ },
437
+ [MEASURE.TIKTOK_APP_INSTALLS_COST]: {
438
+ title: 'TikTok Cost per App Install',
439
+ shortTitle: 'CPI',
440
+ description: 'The cost per app install from your TikTok ads.',
441
+ tooltip: 'Average spend per app install from TikTok ads. The primary efficiency metric for app install campaigns.',
442
+ formulaDisplay: 'Ad Spend ÷ App Installs',
443
+ formula: 'spend / app_installs',
444
+ sumPrefix: '$',
445
+ sumSuffix: '',
446
+ avgPrefix: '$',
447
+ avgSuffix: '',
448
+ icon: MEASURE_ICON.TIKTOK,
449
+ measure: MEASURE.TIKTOK_APP_INSTALLS_COST,
450
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
451
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
452
+ valueType: MeasureValueType.CURRENCY,
453
+ decimalPlaces: 2,
454
+ useCompactNotation: true,
455
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
456
+ relatedMeasures: [MEASURE.TIKTOK_APP_INSTALLS, MEASURE.TIKTOK_CPA],
457
+ },
458
+ [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS]: {
459
+ title: 'TikTok Completed Registrations',
460
+ shortTitle: 'Registrations',
461
+ description: 'The number of completed registrations from your TikTok ads.',
462
+ tooltip: 'How many people completed a registration form or sign-up flow after engaging with your TikTok ad.',
463
+ sumPrefix: '',
464
+ sumSuffix: '',
465
+ avgPrefix: '',
466
+ avgSuffix: '',
467
+ icon: MEASURE_ICON.TIKTOK,
468
+ measure: MEASURE.TIKTOK_COMPLETE_REGISTRATIONS,
469
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
470
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
471
+ valueType: MeasureValueType.NUMBER,
472
+ decimalPlaces: 0,
473
+ useCompactNotation: false,
474
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
475
+ relatedMeasures: [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST, MEASURE.TIKTOK_LEADS],
476
+ },
477
+ [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST]: {
478
+ title: 'TikTok Cost per Completed Registration',
479
+ shortTitle: 'Cost/Registration',
480
+ description: 'The cost per completed registration from your TikTok ads.',
481
+ tooltip: 'Average spend per completed registration from TikTok ads.',
482
+ formulaDisplay: 'Ad Spend ÷ Completed Registrations',
483
+ formula: 'spend / complete_registrations',
484
+ sumPrefix: '$',
485
+ sumSuffix: '',
486
+ avgPrefix: '$',
487
+ avgSuffix: '',
488
+ icon: MEASURE_ICON.TIKTOK,
489
+ measure: MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST,
490
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
491
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
492
+ valueType: MeasureValueType.CURRENCY,
493
+ decimalPlaces: 2,
494
+ useCompactNotation: true,
495
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
496
+ relatedMeasures: [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS, MEASURE.TIKTOK_LEADS_COST],
497
+ },
498
+ [MEASURE.TIKTOK_ADD_TO_WISHLISTS]: {
499
+ title: 'TikTok Add to Wishlists',
500
+ shortTitle: 'Wishlists',
501
+ description: 'The number of add to wishlist actions attributed to your TikTok ads.',
502
+ tooltip: 'How many times shoppers saved items to their wishlist after engaging with your ad. Signals future purchase intent.',
503
+ sumPrefix: '',
504
+ sumSuffix: '',
505
+ avgPrefix: '',
506
+ avgSuffix: '',
507
+ icon: MEASURE_ICON.TIKTOK,
508
+ measure: MEASURE.TIKTOK_ADD_TO_WISHLISTS,
509
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
510
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
511
+ valueType: MeasureValueType.NUMBER,
512
+ decimalPlaces: 0,
513
+ useCompactNotation: false,
514
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
515
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST, MEASURE.TIKTOK_ADD_TO_CARTS],
516
+ },
517
+ [MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST]: {
518
+ title: 'TikTok Cost per Add to Wishlist',
519
+ shortTitle: 'Cost/Wishlist',
520
+ description: 'The cost per add to wishlist action from your TikTok ads.',
521
+ tooltip: 'Average spend per wishlist add from your TikTok ads.',
522
+ formulaDisplay: 'Ad Spend ÷ Add to Wishlists',
523
+ formula: 'spend / add_to_wishlists',
524
+ sumPrefix: '$',
525
+ sumSuffix: '',
526
+ avgPrefix: '$',
527
+ avgSuffix: '',
528
+ icon: MEASURE_ICON.TIKTOK,
529
+ measure: MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST,
530
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
531
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
335
532
  valueType: MeasureValueType.CURRENCY,
336
533
  decimalPlaces: 2,
337
534
  useCompactNotation: true,
338
535
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
536
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_WISHLISTS, MEASURE.TIKTOK_ADD_TO_CARTS_COST],
339
537
  },
340
538
  [MEASURE.TIKTOK_LANDING_PAGE_VIEWS]: {
341
539
  title: 'TikTok Landing Page Views',
342
- description: 'The number of landing page views from your TikTok ads.',
540
+ shortTitle: 'LP Views',
541
+ description: 'The number of times your landing page loaded after people clicked your ads.',
542
+ tooltip: 'How many people fully loaded your landing page after clicking. Lower than clicks indicates drop-off before the page loaded.',
343
543
  sumPrefix: '',
344
544
  sumSuffix: '',
345
545
  avgPrefix: '',
@@ -350,15 +550,42 @@ export const TIKTOK_MEASURES_MAP = {
350
550
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_CLICKS,
351
551
  valueType: MeasureValueType.NUMBER,
352
552
  decimalPlaces: 0,
553
+ useCompactNotation: false,
554
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
555
+ relatedMeasures: [
556
+ MEASURE.TIKTOK_LANDING_PAGE_VIEWS_COST,
557
+ MEASURE.TIKTOK_LANDING_PAGE_VIEW_RATE,
558
+ MEASURE.TIKTOK_CLICKS,
559
+ ],
560
+ },
561
+ [MEASURE.TIKTOK_LANDING_PAGE_VIEWS_COST]: {
562
+ title: 'TikTok Cost per Landing Page View',
563
+ shortTitle: 'Cost/LP View',
564
+ description: 'The cost per landing page view from your TikTok ads.',
565
+ tooltip: 'Average spend per landing page load. A more reliable traffic metric than clicks alone.',
566
+ formulaDisplay: 'Ad Spend ÷ Landing Page Views',
567
+ formula: 'spend / landing_page_views',
568
+ sumPrefix: '$',
569
+ sumSuffix: '',
570
+ avgPrefix: '$',
571
+ avgSuffix: '',
572
+ icon: MEASURE_ICON.TIKTOK,
573
+ measure: MEASURE.TIKTOK_LANDING_PAGE_VIEWS_COST,
574
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
575
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CLICKS,
576
+ valueType: MeasureValueType.CURRENCY,
577
+ decimalPlaces: 2,
353
578
  useCompactNotation: true,
354
579
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
580
+ relatedMeasures: [MEASURE.TIKTOK_LANDING_PAGE_VIEWS, MEASURE.TIKTOK_CPC],
355
581
  },
356
582
  [MEASURE.TIKTOK_LANDING_PAGE_VIEW_RATE]: {
357
583
  title: 'TikTok Landing Page View Rate',
358
- description: 'The percentage of impressions that resulted in a landing page view.',
359
- formulaDisplay: 'Landing Page Views ÷ Impressions × 100',
360
- formula: 'landing_page_views / impressions * 100',
361
- relatedMeasures: [MEASURE.TIKTOK_LANDING_PAGE_VIEWS, MEASURE.TIKTOK_IMPRESSIONS],
584
+ shortTitle: 'LP View Rate',
585
+ description: 'The percentage of clicks that resulted in landing page loads.',
586
+ tooltip: 'Share of clicks that actually loaded your landing page. Low rates suggest slow load times or bounce issues.',
587
+ formulaDisplay: 'Landing Page Views ÷ Clicks × 100',
588
+ formula: 'landing_page_views / clicks * 100',
362
589
  sumPrefix: '',
363
590
  sumSuffix: '%',
364
591
  avgPrefix: '',
@@ -371,10 +598,12 @@ export const TIKTOK_MEASURES_MAP = {
371
598
  decimalPlaces: 2,
372
599
  useCompactNotation: false,
373
600
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
601
+ relatedMeasures: [MEASURE.TIKTOK_LANDING_PAGE_VIEWS, MEASURE.TIKTOK_CLICKS],
374
602
  },
375
603
  [MEASURE.TIKTOK_VIDEO_PLAYS]: {
376
604
  title: 'TikTok Video Plays',
377
- description: 'The number of times your TikTok video ads started playing.',
605
+ description: 'The number of video plays on your TikTok ads.',
606
+ tooltip: 'Total times your video started playing, including auto-plays. Higher than views due to very short watches being excluded from "views".',
378
607
  sumPrefix: '',
379
608
  sumSuffix: '',
380
609
  avgPrefix: '',
@@ -385,12 +614,14 @@ export const TIKTOK_MEASURES_MAP = {
385
614
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
386
615
  valueType: MeasureValueType.NUMBER,
387
616
  decimalPlaces: 0,
388
- useCompactNotation: true,
617
+ useCompactNotation: false,
389
618
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
619
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS],
390
620
  },
391
621
  [MEASURE.TIKTOK_VIDEO_VIEWS]: {
392
622
  title: 'TikTok Video Views',
393
- description: 'The number of 6-second video views on your TikTok ads.',
623
+ description: 'The number of video views on your TikTok ads.',
624
+ tooltip: 'How many times your video ad was watched for at least 6 seconds (TikTok\'s default view threshold).',
394
625
  sumPrefix: '',
395
626
  sumSuffix: '',
396
627
  avgPrefix: '',
@@ -401,12 +632,36 @@ export const TIKTOK_MEASURES_MAP = {
401
632
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
402
633
  valueType: MeasureValueType.NUMBER,
403
634
  decimalPlaces: 0,
635
+ useCompactNotation: false,
636
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
637
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS_COST, MEASURE.TIKTOK_VIDEO_PLAYS, MEASURE.TIKTOK_VIDEO_THRUPLAYS],
638
+ },
639
+ [MEASURE.TIKTOK_VIDEO_VIEWS_COST]: {
640
+ title: 'TikTok Cost per Video View',
641
+ shortTitle: 'Cost/Video View',
642
+ description: 'The cost per video view on your TikTok ads.',
643
+ tooltip: 'Average spend per 6-second video view. The standard cost metric for video awareness campaigns.',
644
+ formulaDisplay: 'Ad Spend ÷ Video Views',
645
+ formula: 'spend / video_views',
646
+ sumPrefix: '$',
647
+ sumSuffix: '',
648
+ avgPrefix: '$',
649
+ avgSuffix: '',
650
+ icon: MEASURE_ICON.TIKTOK,
651
+ measure: MEASURE.TIKTOK_VIDEO_VIEWS_COST,
652
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
653
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
654
+ valueType: MeasureValueType.CURRENCY,
655
+ decimalPlaces: 2,
404
656
  useCompactNotation: true,
405
657
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
658
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS, MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST],
406
659
  },
407
660
  [MEASURE.TIKTOK_VIDEO_VIEWS_15S]: {
408
- title: 'TikTok 15-Second Focused Views',
409
- description: 'The number of 15-second focused views on your TikTok video ads.',
661
+ title: 'TikTok 15-Second Video Views',
662
+ shortTitle: '15s Video Views',
663
+ description: 'The number of times your video ads were watched for at least 15 seconds.',
664
+ tooltip: 'Views where the viewer watched at least 15 continuous seconds. Indicates deeper engagement than the 6-second threshold.',
410
665
  sumPrefix: '',
411
666
  sumSuffix: '',
412
667
  avgPrefix: '',
@@ -417,12 +672,15 @@ export const TIKTOK_MEASURES_MAP = {
417
672
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
418
673
  valueType: MeasureValueType.NUMBER,
419
674
  decimalPlaces: 0,
420
- useCompactNotation: true,
675
+ useCompactNotation: false,
421
676
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
677
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS, MEASURE.TIKTOK_VIDEO_THRUPLAYS],
422
678
  },
423
679
  [MEASURE.TIKTOK_VIDEO_THRUPLAYS]: {
424
- title: 'TikTok Thruplays',
425
- description: 'The number of complete video views on your TikTok ads.',
680
+ title: 'TikTok Video Thruplay Views',
681
+ shortTitle: 'Thruplay Views',
682
+ description: 'The number of videos watched to completion.',
683
+ tooltip: 'Views where the viewer watched your video to completion. The recommended metric for video campaign optimization.',
426
684
  sumPrefix: '',
427
685
  sumSuffix: '',
428
686
  avgPrefix: '',
@@ -433,12 +691,40 @@ export const TIKTOK_MEASURES_MAP = {
433
691
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
434
692
  valueType: MeasureValueType.NUMBER,
435
693
  decimalPlaces: 0,
694
+ useCompactNotation: false,
695
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
696
+ relatedMeasures: [
697
+ MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST,
698
+ MEASURE.TIKTOK_VIDEO_P100_WATCHED,
699
+ MEASURE.TIKTOK_VIDEO_VIEWS_15S,
700
+ ],
701
+ },
702
+ [MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST]: {
703
+ title: 'TikTok Cost per Video Thruplay',
704
+ shortTitle: 'Cost/Thruplay',
705
+ description: 'The cost per video watched to completion.',
706
+ tooltip: 'Average spend per Thruplay view. The standard efficiency metric when optimizing for video completion campaigns.',
707
+ formulaDisplay: 'Ad Spend ÷ Thruplay Views',
708
+ formula: 'spend / video_thruplays',
709
+ sumPrefix: '$',
710
+ sumSuffix: '',
711
+ avgPrefix: '$',
712
+ avgSuffix: '',
713
+ icon: MEASURE_ICON.TIKTOK,
714
+ measure: MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST,
715
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
716
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
717
+ valueType: MeasureValueType.CURRENCY,
718
+ decimalPlaces: 2,
436
719
  useCompactNotation: true,
437
720
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
721
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_THRUPLAYS, MEASURE.TIKTOK_VIDEO_VIEWS_COST],
438
722
  },
439
723
  [MEASURE.TIKTOK_VIDEO_P25_WATCHED]: {
440
- title: 'TikTok Video 25% Watched',
441
- description: 'The number of times your TikTok video was watched to 25% of its length.',
724
+ title: 'TikTok Video 25% Completion Views',
725
+ shortTitle: 'Video 25% Views',
726
+ description: 'The number of times your video ads were watched to at least 25% completion.',
727
+ tooltip: 'Views where the audience watched at least a quarter of your video. Part of the completion rate funnel.',
442
728
  sumPrefix: '',
443
729
  sumSuffix: '',
444
730
  avgPrefix: '',
@@ -449,12 +735,15 @@ export const TIKTOK_MEASURES_MAP = {
449
735
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
450
736
  valueType: MeasureValueType.NUMBER,
451
737
  decimalPlaces: 0,
452
- useCompactNotation: true,
738
+ useCompactNotation: false,
453
739
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
740
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_P50_WATCHED, MEASURE.TIKTOK_VIDEO_VIEWS],
454
741
  },
455
742
  [MEASURE.TIKTOK_VIDEO_P50_WATCHED]: {
456
- title: 'TikTok Video 50% Watched',
457
- description: 'The number of times your TikTok video was watched to 50% of its length.',
743
+ title: 'TikTok Video 50% Completion Views',
744
+ shortTitle: 'Video 50% Views',
745
+ description: 'The number of times your video ads were watched to at least 50% completion.',
746
+ tooltip: 'Views where the audience watched at least half of your video. Indicates moderate viewing engagement.',
458
747
  sumPrefix: '',
459
748
  sumSuffix: '',
460
749
  avgPrefix: '',
@@ -465,12 +754,15 @@ export const TIKTOK_MEASURES_MAP = {
465
754
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
466
755
  valueType: MeasureValueType.NUMBER,
467
756
  decimalPlaces: 0,
468
- useCompactNotation: true,
757
+ useCompactNotation: false,
469
758
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
759
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_P25_WATCHED, MEASURE.TIKTOK_VIDEO_P75_WATCHED],
470
760
  },
471
761
  [MEASURE.TIKTOK_VIDEO_P75_WATCHED]: {
472
- title: 'TikTok Video 75% Watched',
473
- description: 'The number of times your TikTok video was watched to 75% of its length.',
762
+ title: 'TikTok Video 75% Completion Views',
763
+ shortTitle: 'Video 75% Views',
764
+ description: 'The number of times your video ads were watched to at least 75% completion.',
765
+ tooltip: 'Views where the audience watched at least three quarters of your video. Signals strong content retention.',
474
766
  sumPrefix: '',
475
767
  sumSuffix: '',
476
768
  avgPrefix: '',
@@ -481,12 +773,15 @@ export const TIKTOK_MEASURES_MAP = {
481
773
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
482
774
  valueType: MeasureValueType.NUMBER,
483
775
  decimalPlaces: 0,
484
- useCompactNotation: true,
776
+ useCompactNotation: false,
485
777
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
778
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_P50_WATCHED, MEASURE.TIKTOK_VIDEO_P100_WATCHED],
486
779
  },
487
780
  [MEASURE.TIKTOK_VIDEO_P100_WATCHED]: {
488
- title: 'TikTok Video 100% Watched',
489
- description: 'The number of times your TikTok video was watched to completion.',
781
+ title: 'TikTok Video Completions',
782
+ shortTitle: 'Video Completions',
783
+ description: 'The number of times your video ads were watched to 100% completion.',
784
+ tooltip: 'Views where the audience watched your entire video from start to finish. The strongest video engagement signal.',
490
785
  sumPrefix: '',
491
786
  sumSuffix: '',
492
787
  avgPrefix: '',
@@ -497,13 +792,14 @@ export const TIKTOK_MEASURES_MAP = {
497
792
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
498
793
  valueType: MeasureValueType.NUMBER,
499
794
  decimalPlaces: 0,
500
- useCompactNotation: true,
795
+ useCompactNotation: false,
501
796
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
797
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_P75_WATCHED, MEASURE.TIKTOK_VIDEO_THRUPLAYS],
502
798
  },
503
799
  [MEASURE.TIKTOK_ENGAGEMENTS]: {
504
800
  title: 'TikTok Engagements',
505
- description: 'The total number of engagements (likes + comments + shares) on your TikTok ads.',
506
- relatedMeasures: [MEASURE.TIKTOK_LIKES, MEASURE.TIKTOK_COMMENTS, MEASURE.TIKTOK_SHARES],
801
+ description: 'The total interactions with your TikTok ads (likes, comments, shares).',
802
+ tooltip: 'All social interactions on your ad including likes, comments, and shares. High engagement signals resonant creative.',
507
803
  sumPrefix: '',
508
804
  sumSuffix: '',
509
805
  avgPrefix: '',
@@ -514,15 +810,43 @@ export const TIKTOK_MEASURES_MAP = {
514
810
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
515
811
  valueType: MeasureValueType.NUMBER,
516
812
  decimalPlaces: 0,
813
+ useCompactNotation: false,
814
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
815
+ relatedMeasures: [
816
+ MEASURE.TIKTOK_ENGAGEMENTS_COST,
817
+ MEASURE.TIKTOK_ENGAGEMENT_RATE,
818
+ MEASURE.TIKTOK_LIKES,
819
+ MEASURE.TIKTOK_SHARES,
820
+ ],
821
+ },
822
+ [MEASURE.TIKTOK_ENGAGEMENTS_COST]: {
823
+ title: 'TikTok Cost per Engagement',
824
+ shortTitle: 'Cost/Engagement',
825
+ description: 'The cost per engagement on your TikTok ads.',
826
+ tooltip: 'Average spend per social interaction. Useful for evaluating brand awareness and community-building campaigns.',
827
+ formulaDisplay: 'Ad Spend ÷ Engagements',
828
+ formula: 'spend / engagements',
829
+ sumPrefix: '$',
830
+ sumSuffix: '',
831
+ avgPrefix: '$',
832
+ avgSuffix: '',
833
+ icon: MEASURE_ICON.TIKTOK,
834
+ measure: MEASURE.TIKTOK_ENGAGEMENTS_COST,
835
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
836
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
837
+ valueType: MeasureValueType.CURRENCY,
838
+ decimalPlaces: 2,
517
839
  useCompactNotation: true,
518
840
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
841
+ relatedMeasures: [MEASURE.TIKTOK_ENGAGEMENTS, MEASURE.TIKTOK_ENGAGEMENT_RATE],
519
842
  },
520
843
  [MEASURE.TIKTOK_ENGAGEMENT_RATE]: {
521
844
  title: 'TikTok Engagement Rate',
522
- description: 'The percentage of impressions that resulted in an engagement.',
845
+ shortTitle: 'Engagement Rate',
846
+ description: 'The percentage of people who engaged with your TikTok ads after seeing them.',
847
+ tooltip: 'Share of people who interacted with your ad after seeing it. Higher rates indicate more compelling content.',
523
848
  formulaDisplay: 'Engagements ÷ Impressions × 100',
524
849
  formula: 'engagements / impressions * 100',
525
- relatedMeasures: [MEASURE.TIKTOK_ENGAGEMENTS, MEASURE.TIKTOK_IMPRESSIONS],
526
850
  sumPrefix: '',
527
851
  sumSuffix: '%',
528
852
  avgPrefix: '',
@@ -535,10 +859,12 @@ export const TIKTOK_MEASURES_MAP = {
535
859
  decimalPlaces: 2,
536
860
  useCompactNotation: false,
537
861
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
862
+ relatedMeasures: [MEASURE.TIKTOK_ENGAGEMENTS, MEASURE.TIKTOK_ENGAGEMENTS_COST],
538
863
  },
539
864
  [MEASURE.TIKTOK_LIKES]: {
540
865
  title: 'TikTok Likes',
541
866
  description: 'The number of likes on your TikTok ads.',
867
+ tooltip: 'Total likes on your ad. Likes are a basic positive engagement signal.',
542
868
  sumPrefix: '',
543
869
  sumSuffix: '',
544
870
  avgPrefix: '',
@@ -549,12 +875,14 @@ export const TIKTOK_MEASURES_MAP = {
549
875
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
550
876
  valueType: MeasureValueType.NUMBER,
551
877
  decimalPlaces: 0,
552
- useCompactNotation: true,
878
+ useCompactNotation: false,
553
879
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
880
+ relatedMeasures: [MEASURE.TIKTOK_ENGAGEMENTS, MEASURE.TIKTOK_COMMENTS, MEASURE.TIKTOK_SHARES],
554
881
  },
555
882
  [MEASURE.TIKTOK_COMMENTS]: {
556
883
  title: 'TikTok Comments',
557
884
  description: 'The number of comments on your TikTok ads.',
885
+ tooltip: 'Total comments left on your ad. Comments often indicate strong opinions or questions about your product.',
558
886
  sumPrefix: '',
559
887
  sumSuffix: '',
560
888
  avgPrefix: '',
@@ -565,12 +893,14 @@ export const TIKTOK_MEASURES_MAP = {
565
893
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
566
894
  valueType: MeasureValueType.NUMBER,
567
895
  decimalPlaces: 0,
568
- useCompactNotation: true,
896
+ useCompactNotation: false,
569
897
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
898
+ relatedMeasures: [MEASURE.TIKTOK_ENGAGEMENTS, MEASURE.TIKTOK_LIKES, MEASURE.TIKTOK_SHARES],
570
899
  },
571
900
  [MEASURE.TIKTOK_SHARES]: {
572
901
  title: 'TikTok Shares',
573
- description: 'The number of shares on your TikTok ads.',
902
+ description: 'The number of times your TikTok ads were shared.',
903
+ tooltip: 'How many times people shared your ad. Shares extend organic reach at no extra cost.',
574
904
  sumPrefix: '',
575
905
  sumSuffix: '',
576
906
  avgPrefix: '',
@@ -581,77 +911,9 @@ export const TIKTOK_MEASURES_MAP = {
581
911
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
582
912
  valueType: MeasureValueType.NUMBER,
583
913
  decimalPlaces: 0,
584
- useCompactNotation: true,
585
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
586
- },
587
- [MEASURE.TIKTOK_CPE]: {
588
- title: 'TikTok Cost per Engagement',
589
- description: 'The cost per engagement on your TikTok ads.',
590
- shortTitle: 'CPE',
591
- tooltip: 'How much you spend on average to drive each engagement through TikTok.',
592
- formulaDisplay: 'Ad Spend ÷ Engagements',
593
- formula: 'spend / engagements',
594
- relatedMeasures: [MEASURE.TIKTOK_SPEND, MEASURE.TIKTOK_ENGAGEMENTS],
595
- sumPrefix: '$',
596
- sumSuffix: '',
597
- avgPrefix: '$',
598
- avgSuffix: '',
599
- icon: MEASURE_ICON.TIKTOK,
600
- measure: MEASURE.TIKTOK_CPE,
601
- category: MEASURE_CATEGORY.TIKTOK_ADS,
602
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_EFFICIENCY,
603
- valueType: MeasureValueType.CURRENCY,
604
- decimalPlaces: 2,
605
- useCompactNotation: true,
606
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
607
- },
608
- [MEASURE.TIKTOK_APP_INSTALLS]: {
609
- title: 'TikTok App Installs',
610
- description: 'The number of app installs attributed to your TikTok ads.',
611
- sumPrefix: '',
612
- sumSuffix: '',
613
- avgPrefix: '',
614
- avgSuffix: '',
615
- icon: MEASURE_ICON.TIKTOK,
616
- measure: MEASURE.TIKTOK_APP_INSTALLS,
617
- category: MEASURE_CATEGORY.TIKTOK_ADS,
618
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
619
- valueType: MeasureValueType.NUMBER,
620
- decimalPlaces: 0,
621
- useCompactNotation: false,
622
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
623
- },
624
- [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS]: {
625
- title: 'TikTok Complete Registrations',
626
- description: 'The number of registration events attributed to your TikTok ads.',
627
- sumPrefix: '',
628
- sumSuffix: '',
629
- avgPrefix: '',
630
- avgSuffix: '',
631
- icon: MEASURE_ICON.TIKTOK,
632
- measure: MEASURE.TIKTOK_COMPLETE_REGISTRATIONS,
633
- category: MEASURE_CATEGORY.TIKTOK_ADS,
634
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
635
- valueType: MeasureValueType.NUMBER,
636
- decimalPlaces: 0,
637
- useCompactNotation: false,
638
- applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
639
- },
640
- [MEASURE.TIKTOK_ADD_TO_WISHLISTS]: {
641
- title: 'TikTok Add to Wishlists',
642
- description: 'The number of add to wishlist events attributed to your TikTok ads.',
643
- sumPrefix: '',
644
- sumSuffix: '',
645
- avgPrefix: '',
646
- avgSuffix: '',
647
- icon: MEASURE_ICON.TIKTOK,
648
- measure: MEASURE.TIKTOK_ADD_TO_WISHLISTS,
649
- category: MEASURE_CATEGORY.TIKTOK_ADS,
650
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
651
- valueType: MeasureValueType.NUMBER,
652
- decimalPlaces: 0,
653
914
  useCompactNotation: false,
654
915
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
916
+ relatedMeasures: [MEASURE.TIKTOK_ENGAGEMENTS, MEASURE.TIKTOK_LIKES, MEASURE.TIKTOK_COMMENTS],
655
917
  },
656
918
  };
657
919
  //# sourceMappingURL=tiktok-measure-definitions.js.map