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

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.
@@ -88,6 +88,7 @@ export interface AccountOnboarding {
88
88
  dismissed?: boolean;
89
89
  requiredCompletedAt?: string;
90
90
  recommendedDismissed?: boolean;
91
+ timezoneConfirmed?: boolean;
91
92
  }
92
93
  export interface User {
93
94
  id: string;
@@ -28,7 +28,7 @@ exports.TIKTOK_MEASURES_MAP = {
28
28
  [measures_js_1.MEASURE.TIKTOK_IMPRESSIONS]: {
29
29
  title: 'TikTok Impressions',
30
30
  description: 'The number of times your TikTok ads were shown.',
31
- tooltip: 'How many times your ads appeared on screen. One person can generate multiple impressions.',
31
+ tooltip: 'How many times your ads appeared on screen. The same viewer can account for multiple impressions.',
32
32
  sumPrefix: '',
33
33
  sumSuffix: '',
34
34
  avgPrefix: '',
@@ -47,7 +47,7 @@ exports.TIKTOK_MEASURES_MAP = {
47
47
  title: 'TikTok CPM',
48
48
  shortTitle: 'CPM',
49
49
  description: 'The cost per thousand impressions of your TikTok ads.',
50
- tooltip: 'How much you pay for every 1,000 times your ad is shown. Lower CPM means cheaper reach.',
50
+ tooltip: 'How much you pay for every 1,000 times your ad is shown. Lower CPM means cheaper impressions.',
51
51
  formulaDisplay: 'Ad Spend ÷ Impressions × 1,000',
52
52
  formula: 'spend / impressions * 1000',
53
53
  sumPrefix: '$',
@@ -127,7 +127,7 @@ exports.TIKTOK_MEASURES_MAP = {
127
127
  [measures_js_1.MEASURE.TIKTOK_PURCHASES]: {
128
128
  title: 'TikTok Purchases',
129
129
  description: 'The number of purchases attributed to your TikTok ads.',
130
- tooltip: 'How many completed purchases TikTok attributes to your ads, including web and TikTok Shop conversions.',
130
+ tooltip: 'How many purchase events TikTok attributes to your ads.',
131
131
  sumPrefix: '',
132
132
  sumSuffix: '',
133
133
  avgPrefix: '',
@@ -207,7 +207,7 @@ exports.TIKTOK_MEASURES_MAP = {
207
207
  title: 'TikTok View Contents',
208
208
  shortTitle: 'View Content',
209
209
  description: 'The number of product or content page views attributed to your TikTok ads.',
210
- tooltip: 'How many times visitors viewed a product detail page after clicking your ad. A top-of-funnel engagement signal.',
210
+ tooltip: 'How many product detail page views TikTok attributes to your ads. A top-of-funnel engagement signal.',
211
211
  sumPrefix: '',
212
212
  sumSuffix: '',
213
213
  avgPrefix: '',
@@ -266,7 +266,7 @@ exports.TIKTOK_MEASURES_MAP = {
266
266
  title: 'TikTok Add to Carts',
267
267
  shortTitle: 'Add to Cart',
268
268
  description: 'The number of add to cart actions attributed to your TikTok ads.',
269
- tooltip: 'How many times shoppers added items to their cart after engaging with your ad. A mid-funnel purchase intent signal.',
269
+ tooltip: 'How many add-to-cart events TikTok attributes to your ads. A mid-funnel purchase intent signal.',
270
270
  sumPrefix: '',
271
271
  sumSuffix: '',
272
272
  avgPrefix: '',
@@ -325,7 +325,7 @@ exports.TIKTOK_MEASURES_MAP = {
325
325
  title: 'TikTok Initiate Checkouts',
326
326
  shortTitle: 'Checkouts',
327
327
  description: 'The number of checkout initiations attributed to your TikTok ads.',
328
- tooltip: 'How many shoppers started the checkout process after engaging with your ad. A strong bottom-of-funnel conversion signal.',
328
+ tooltip: 'How many checkout-initiation events TikTok attributes to your ads. A strong bottom-of-funnel conversion signal.',
329
329
  sumPrefix: '',
330
330
  sumSuffix: '',
331
331
  avgPrefix: '',
@@ -338,7 +338,26 @@ exports.TIKTOK_MEASURES_MAP = {
338
338
  decimalPlaces: 0,
339
339
  useCompactNotation: false,
340
340
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
341
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST, measures_js_1.MEASURE.TIKTOK_PURCHASES, measures_js_1.MEASURE.TIKTOK_ADD_TO_CARTS],
341
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST, measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS_VALUE, measures_js_1.MEASURE.TIKTOK_PURCHASES],
342
+ },
343
+ [measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS_VALUE]: {
344
+ title: 'TikTok Initiate Checkouts Value',
345
+ shortTitle: 'Checkout Value',
346
+ description: 'The total value of checkout initiations from your TikTok ads.',
347
+ tooltip: 'Combined value of all checkout initiations by visitors from your TikTok ads.',
348
+ sumPrefix: '$',
349
+ sumSuffix: '',
350
+ avgPrefix: '$',
351
+ avgSuffix: '',
352
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
353
+ measure: measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS_VALUE,
354
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
355
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
356
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
357
+ decimalPlaces: 2,
358
+ useCompactNotation: true,
359
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
360
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS, measures_js_1.MEASURE.TIKTOK_PURCHASES_VALUE],
342
361
  },
343
362
  [measures_js_1.MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST]: {
344
363
  title: 'TikTok Cost per Initiate Checkout',
@@ -364,7 +383,7 @@ exports.TIKTOK_MEASURES_MAP = {
364
383
  [measures_js_1.MEASURE.TIKTOK_LEADS]: {
365
384
  title: 'TikTok Leads',
366
385
  description: 'The number of leads generated from your TikTok ads.',
367
- tooltip: 'How many people submitted a lead form or completed a lead event from your TikTok ads.',
386
+ tooltip: 'How many lead events TikTok attributes to your ads (form submissions or equivalent lead actions).',
368
387
  sumPrefix: '',
369
388
  sumSuffix: '',
370
389
  avgPrefix: '',
@@ -419,10 +438,184 @@ exports.TIKTOK_MEASURES_MAP = {
419
438
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
420
439
  relatedMeasures: [measures_js_1.MEASURE.TIKTOK_LEADS, measures_js_1.MEASURE.TIKTOK_CPA],
421
440
  },
441
+ [measures_js_1.MEASURE.TIKTOK_SEARCHES]: {
442
+ title: 'TikTok Searches',
443
+ description: 'The number of search events attributed to your TikTok ads.',
444
+ tooltip: 'How many search events TikTok attributes to your ads.',
445
+ sumPrefix: '',
446
+ sumSuffix: '',
447
+ avgPrefix: '',
448
+ avgSuffix: '',
449
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
450
+ measure: measures_js_1.MEASURE.TIKTOK_SEARCHES,
451
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
452
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
453
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
454
+ decimalPlaces: 0,
455
+ useCompactNotation: false,
456
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
457
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SEARCHES_COST, measures_js_1.MEASURE.TIKTOK_SEARCHES_VALUE],
458
+ },
459
+ [measures_js_1.MEASURE.TIKTOK_SEARCHES_VALUE]: {
460
+ title: 'TikTok Searches Value',
461
+ shortTitle: 'Search Value',
462
+ description: 'The total value of search events from your TikTok ads.',
463
+ tooltip: 'Combined value of all search events by visitors from your TikTok ads.',
464
+ sumPrefix: '$',
465
+ sumSuffix: '',
466
+ avgPrefix: '$',
467
+ avgSuffix: '',
468
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
469
+ measure: measures_js_1.MEASURE.TIKTOK_SEARCHES_VALUE,
470
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
471
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
472
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
473
+ decimalPlaces: 2,
474
+ useCompactNotation: true,
475
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
476
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SEARCHES, measures_js_1.MEASURE.TIKTOK_SEARCHES_COST],
477
+ },
478
+ [measures_js_1.MEASURE.TIKTOK_SEARCHES_COST]: {
479
+ title: 'TikTok Cost per Search',
480
+ shortTitle: 'Cost/Search',
481
+ description: 'The cost per search event from your TikTok ads.',
482
+ tooltip: 'Average spend per search event from TikTok ads.',
483
+ formulaDisplay: 'Ad Spend ÷ Searches',
484
+ formula: 'spend / searches',
485
+ sumPrefix: '$',
486
+ sumSuffix: '',
487
+ avgPrefix: '$',
488
+ avgSuffix: '',
489
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
490
+ measure: measures_js_1.MEASURE.TIKTOK_SEARCHES_COST,
491
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
492
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
493
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
494
+ decimalPlaces: 2,
495
+ useCompactNotation: true,
496
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
497
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SEARCHES, measures_js_1.MEASURE.TIKTOK_CPA],
498
+ },
499
+ [measures_js_1.MEASURE.TIKTOK_SUBSCRIBES]: {
500
+ title: 'TikTok Subscribes',
501
+ description: 'The number of subscribe events attributed to your TikTok ads.',
502
+ tooltip: 'How many subscribe events TikTok attributes to your ads.',
503
+ sumPrefix: '',
504
+ sumSuffix: '',
505
+ avgPrefix: '',
506
+ avgSuffix: '',
507
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
508
+ measure: measures_js_1.MEASURE.TIKTOK_SUBSCRIBES,
509
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
510
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
511
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
512
+ decimalPlaces: 0,
513
+ useCompactNotation: false,
514
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
515
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_COST, measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_VALUE],
516
+ },
517
+ [measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_VALUE]: {
518
+ title: 'TikTok Subscribes Value',
519
+ shortTitle: 'Subscribe Value',
520
+ description: 'The total value of subscribe events from your TikTok ads.',
521
+ tooltip: 'Combined value of all subscribe events by visitors from your TikTok ads.',
522
+ sumPrefix: '$',
523
+ sumSuffix: '',
524
+ avgPrefix: '$',
525
+ avgSuffix: '',
526
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
527
+ measure: measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_VALUE,
528
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
529
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
530
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
531
+ decimalPlaces: 2,
532
+ useCompactNotation: true,
533
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
534
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SUBSCRIBES, measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_COST],
535
+ },
536
+ [measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_COST]: {
537
+ title: 'TikTok Cost per Subscribe',
538
+ shortTitle: 'Cost/Subscribe',
539
+ description: 'The cost per subscribe event from your TikTok ads.',
540
+ tooltip: 'Average spend per subscribe event from TikTok ads.',
541
+ formulaDisplay: 'Ad Spend ÷ Subscribes',
542
+ formula: 'spend / subscribes',
543
+ sumPrefix: '$',
544
+ sumSuffix: '',
545
+ avgPrefix: '$',
546
+ avgSuffix: '',
547
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
548
+ measure: measures_js_1.MEASURE.TIKTOK_SUBSCRIBES_COST,
549
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
550
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
551
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
552
+ decimalPlaces: 2,
553
+ useCompactNotation: true,
554
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
555
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SUBSCRIBES, measures_js_1.MEASURE.TIKTOK_CPA],
556
+ },
557
+ [measures_js_1.MEASURE.TIKTOK_SCHEDULES]: {
558
+ title: 'TikTok Schedules',
559
+ description: 'The number of schedule events attributed to your TikTok ads.',
560
+ tooltip: 'How many schedule events TikTok attributes to your ads.',
561
+ sumPrefix: '',
562
+ sumSuffix: '',
563
+ avgPrefix: '',
564
+ avgSuffix: '',
565
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
566
+ measure: measures_js_1.MEASURE.TIKTOK_SCHEDULES,
567
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
568
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
569
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
570
+ decimalPlaces: 0,
571
+ useCompactNotation: false,
572
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
573
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SCHEDULES_COST, measures_js_1.MEASURE.TIKTOK_SCHEDULES_VALUE],
574
+ },
575
+ [measures_js_1.MEASURE.TIKTOK_SCHEDULES_VALUE]: {
576
+ title: 'TikTok Schedules Value',
577
+ shortTitle: 'Schedule Value',
578
+ description: 'The total value of schedule events from your TikTok ads.',
579
+ tooltip: 'Combined value of all schedule events by visitors from your TikTok ads.',
580
+ sumPrefix: '$',
581
+ sumSuffix: '',
582
+ avgPrefix: '$',
583
+ avgSuffix: '',
584
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
585
+ measure: measures_js_1.MEASURE.TIKTOK_SCHEDULES_VALUE,
586
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
587
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
588
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
589
+ decimalPlaces: 2,
590
+ useCompactNotation: true,
591
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
592
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SCHEDULES, measures_js_1.MEASURE.TIKTOK_SCHEDULES_COST],
593
+ },
594
+ [measures_js_1.MEASURE.TIKTOK_SCHEDULES_COST]: {
595
+ title: 'TikTok Cost per Schedule',
596
+ shortTitle: 'Cost/Schedule',
597
+ description: 'The cost per schedule event from your TikTok ads.',
598
+ tooltip: 'Average spend per schedule event from TikTok ads.',
599
+ formulaDisplay: 'Ad Spend ÷ Schedules',
600
+ formula: 'spend / schedules',
601
+ sumPrefix: '$',
602
+ sumSuffix: '',
603
+ avgPrefix: '$',
604
+ avgSuffix: '',
605
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
606
+ measure: measures_js_1.MEASURE.TIKTOK_SCHEDULES_COST,
607
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
608
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
609
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
610
+ decimalPlaces: 2,
611
+ useCompactNotation: true,
612
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
613
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_SCHEDULES, measures_js_1.MEASURE.TIKTOK_CPA],
614
+ },
422
615
  [measures_js_1.MEASURE.TIKTOK_APP_INSTALLS]: {
423
616
  title: 'TikTok App Installs',
424
617
  description: 'The number of app installs from your TikTok ads.',
425
- tooltip: 'How many people installed your app after engaging with your TikTok ad.',
618
+ tooltip: 'How many app-install events TikTok attributes to your ads.',
426
619
  sumPrefix: '',
427
620
  sumSuffix: '',
428
621
  avgPrefix: '',
@@ -462,7 +655,7 @@ exports.TIKTOK_MEASURES_MAP = {
462
655
  title: 'TikTok Completed Registrations',
463
656
  shortTitle: 'Registrations',
464
657
  description: 'The number of completed registrations from your TikTok ads.',
465
- tooltip: 'How many people completed a registration form or sign-up flow after engaging with your TikTok ad.',
658
+ tooltip: 'How many completed-registration events TikTok attributes to your ads.',
466
659
  sumPrefix: '',
467
660
  sumSuffix: '',
468
661
  avgPrefix: '',
@@ -475,7 +668,26 @@ exports.TIKTOK_MEASURES_MAP = {
475
668
  decimalPlaces: 0,
476
669
  useCompactNotation: false,
477
670
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
478
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST, measures_js_1.MEASURE.TIKTOK_LEADS],
671
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST, measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_VALUE, measures_js_1.MEASURE.TIKTOK_LEADS],
672
+ },
673
+ [measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_VALUE]: {
674
+ title: 'TikTok Completed Registrations Value',
675
+ shortTitle: 'Registration Value',
676
+ description: 'The total value of completed registrations from your TikTok ads.',
677
+ tooltip: 'Combined value of all completed registrations by visitors from your TikTok ads.',
678
+ sumPrefix: '$',
679
+ sumSuffix: '',
680
+ avgPrefix: '$',
681
+ avgSuffix: '',
682
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
683
+ measure: measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_VALUE,
684
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
685
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
686
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
687
+ decimalPlaces: 2,
688
+ useCompactNotation: true,
689
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
690
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS, measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST],
479
691
  },
480
692
  [measures_js_1.MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST]: {
481
693
  title: 'TikTok Cost per Completed Registration',
@@ -502,7 +714,7 @@ exports.TIKTOK_MEASURES_MAP = {
502
714
  title: 'TikTok Add to Wishlists',
503
715
  shortTitle: 'Wishlists',
504
716
  description: 'The number of add to wishlist actions attributed to your TikTok ads.',
505
- tooltip: 'How many times shoppers saved items to their wishlist after engaging with your ad. Signals future purchase intent.',
717
+ tooltip: 'How many wishlist-add events TikTok attributes to your ads. Signals future purchase intent.',
506
718
  sumPrefix: '',
507
719
  sumSuffix: '',
508
720
  avgPrefix: '',
@@ -515,7 +727,26 @@ exports.TIKTOK_MEASURES_MAP = {
515
727
  decimalPlaces: 0,
516
728
  useCompactNotation: false,
517
729
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
518
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST, measures_js_1.MEASURE.TIKTOK_ADD_TO_CARTS],
730
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST, measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_VALUE, measures_js_1.MEASURE.TIKTOK_ADD_TO_CARTS],
731
+ },
732
+ [measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_VALUE]: {
733
+ title: 'TikTok Add to Wishlists Value',
734
+ shortTitle: 'Wishlist Value',
735
+ description: 'The total value of add to wishlist actions from your TikTok ads.',
736
+ tooltip: 'Combined value of all wishlist adds by visitors from your TikTok ads.',
737
+ sumPrefix: '$',
738
+ sumSuffix: '',
739
+ avgPrefix: '$',
740
+ avgSuffix: '',
741
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
742
+ measure: measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_VALUE,
743
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
744
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
745
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
746
+ decimalPlaces: 2,
747
+ useCompactNotation: true,
748
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
749
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS, measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST],
519
750
  },
520
751
  [measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST]: {
521
752
  title: 'TikTok Cost per Add to Wishlist',
@@ -538,11 +769,89 @@ exports.TIKTOK_MEASURES_MAP = {
538
769
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
539
770
  relatedMeasures: [measures_js_1.MEASURE.TIKTOK_ADD_TO_WISHLISTS, measures_js_1.MEASURE.TIKTOK_ADD_TO_CARTS_COST],
540
771
  },
772
+ [measures_js_1.MEASURE.TIKTOK_FOLLOWS]: {
773
+ title: 'TikTok Follows',
774
+ description: 'The number of new followers from your TikTok ads.',
775
+ tooltip: 'How many users followed your TikTok account after seeing your ad.',
776
+ sumPrefix: '',
777
+ sumSuffix: '',
778
+ avgPrefix: '',
779
+ avgSuffix: '',
780
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
781
+ measure: measures_js_1.MEASURE.TIKTOK_FOLLOWS,
782
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
783
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
784
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
785
+ decimalPlaces: 0,
786
+ useCompactNotation: false,
787
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
788
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_FOLLOWS_COST, measures_js_1.MEASURE.TIKTOK_ENGAGEMENTS],
789
+ },
790
+ [measures_js_1.MEASURE.TIKTOK_FOLLOWS_COST]: {
791
+ title: 'TikTok Cost per Follow',
792
+ shortTitle: 'Cost/Follow',
793
+ description: 'The cost per new follower from your TikTok ads.',
794
+ tooltip: 'Average spend per new follower from TikTok ads.',
795
+ formulaDisplay: 'Ad Spend ÷ Follows',
796
+ formula: 'spend / follows',
797
+ sumPrefix: '$',
798
+ sumSuffix: '',
799
+ avgPrefix: '$',
800
+ avgSuffix: '',
801
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
802
+ measure: measures_js_1.MEASURE.TIKTOK_FOLLOWS_COST,
803
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
804
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
805
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
806
+ decimalPlaces: 2,
807
+ useCompactNotation: true,
808
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
809
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_FOLLOWS, measures_js_1.MEASURE.TIKTOK_ENGAGEMENTS_COST],
810
+ },
811
+ [measures_js_1.MEASURE.TIKTOK_PROFILE_VISITS]: {
812
+ title: 'TikTok Profile Visits',
813
+ description: 'The number of profile visits from your TikTok ads.',
814
+ tooltip: 'How many users visited your TikTok profile after seeing your ad.',
815
+ sumPrefix: '',
816
+ sumSuffix: '',
817
+ avgPrefix: '',
818
+ avgSuffix: '',
819
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
820
+ measure: measures_js_1.MEASURE.TIKTOK_PROFILE_VISITS,
821
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
822
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
823
+ valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
824
+ decimalPlaces: 0,
825
+ useCompactNotation: false,
826
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
827
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_PROFILE_VISITS_COST, measures_js_1.MEASURE.TIKTOK_FOLLOWS],
828
+ },
829
+ [measures_js_1.MEASURE.TIKTOK_PROFILE_VISITS_COST]: {
830
+ title: 'TikTok Cost per Profile Visit',
831
+ shortTitle: 'Cost/Profile Visit',
832
+ description: 'The cost per profile visit from your TikTok ads.',
833
+ tooltip: 'Average spend per profile visit from TikTok ads.',
834
+ formulaDisplay: 'Ad Spend ÷ Profile Visits',
835
+ formula: 'spend / profile_visits',
836
+ sumPrefix: '$',
837
+ sumSuffix: '',
838
+ avgPrefix: '$',
839
+ avgSuffix: '',
840
+ icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
841
+ measure: measures_js_1.MEASURE.TIKTOK_PROFILE_VISITS_COST,
842
+ category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
843
+ subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
844
+ valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
845
+ decimalPlaces: 2,
846
+ useCompactNotation: true,
847
+ applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
848
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_PROFILE_VISITS, measures_js_1.MEASURE.TIKTOK_FOLLOWS_COST],
849
+ },
541
850
  [measures_js_1.MEASURE.TIKTOK_LANDING_PAGE_VIEWS]: {
542
851
  title: 'TikTok Landing Page Views',
543
852
  shortTitle: 'LP Views',
544
- description: 'The number of times your landing page loaded after people clicked your ads.',
545
- tooltip: 'How many people fully loaded your landing page after clicking. Lower than clicks indicates drop-off before the page loaded.',
853
+ description: 'The number of landing page loads attributed to clicks on your TikTok ads.',
854
+ tooltip: 'How many times your landing page fully loaded after a click. Lower than clicks indicates drop-off before the page loaded.',
546
855
  sumPrefix: '',
547
856
  sumSuffix: '',
548
857
  avgPrefix: '',
@@ -637,7 +946,7 @@ exports.TIKTOK_MEASURES_MAP = {
637
946
  decimalPlaces: 0,
638
947
  useCompactNotation: false,
639
948
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
640
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_COST, measures_js_1.MEASURE.TIKTOK_VIDEO_PLAYS, measures_js_1.MEASURE.TIKTOK_VIDEO_THRUPLAYS],
949
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_COST, measures_js_1.MEASURE.TIKTOK_VIDEO_PLAYS, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S],
641
950
  },
642
951
  [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_COST]: {
643
952
  title: 'TikTok Cost per Video View',
@@ -658,7 +967,7 @@ exports.TIKTOK_MEASURES_MAP = {
658
967
  decimalPlaces: 2,
659
968
  useCompactNotation: true,
660
969
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
661
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST],
970
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST],
662
971
  },
663
972
  [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S]: {
664
973
  title: 'TikTok 15-Second Video Views',
@@ -677,57 +986,34 @@ exports.TIKTOK_MEASURES_MAP = {
677
986
  decimalPlaces: 0,
678
987
  useCompactNotation: false,
679
988
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
680
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS, measures_js_1.MEASURE.TIKTOK_VIDEO_THRUPLAYS],
681
- },
682
- [measures_js_1.MEASURE.TIKTOK_VIDEO_THRUPLAYS]: {
683
- title: 'TikTok Video Thruplay Views',
684
- shortTitle: 'Thruplay Views',
685
- description: 'The number of videos watched to completion.',
686
- tooltip: 'Views where the viewer watched your video to completion. The recommended metric for video campaign optimization.',
687
- sumPrefix: '',
688
- sumSuffix: '',
689
- avgPrefix: '',
690
- avgSuffix: '',
691
- icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
692
- measure: measures_js_1.MEASURE.TIKTOK_VIDEO_THRUPLAYS,
693
- category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
694
- subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
695
- valueType: measure_value_type_js_1.MeasureValueType.NUMBER,
696
- decimalPlaces: 0,
697
- useCompactNotation: false,
698
- applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
699
- relatedMeasures: [
700
- measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST,
701
- measures_js_1.MEASURE.TIKTOK_VIDEO_P100_WATCHED,
702
- measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S,
703
- ],
989
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST],
704
990
  },
705
- [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST]: {
706
- title: 'TikTok Cost per Video Thruplay',
707
- shortTitle: 'Cost/Thruplay',
708
- description: 'The cost per video watched to completion.',
709
- tooltip: 'Average spend per Thruplay view. The standard efficiency metric when optimizing for video completion campaigns.',
710
- formulaDisplay: 'Ad Spend ÷ Thruplay Views',
711
- formula: 'spend / video_thruplays',
991
+ [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST]: {
992
+ title: 'TikTok Cost per 15-Second Video View',
993
+ shortTitle: 'Cost/15s View',
994
+ description: 'The cost per 15-second video view on your TikTok ads.',
995
+ tooltip: 'Average spend per 15-second video view. Useful when optimizing for engaged video view campaigns.',
996
+ formulaDisplay: 'Ad Spend ÷ 15s Video Views',
997
+ formula: 'spend / video_views_15s',
712
998
  sumPrefix: '$',
713
999
  sumSuffix: '',
714
1000
  avgPrefix: '$',
715
1001
  avgSuffix: '',
716
1002
  icon: measure_icon_js_1.MEASURE_ICON.TIKTOK,
717
- measure: measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST,
1003
+ measure: measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST,
718
1004
  category: measure_categories_js_1.MEASURE_CATEGORY.TIKTOK_ADS,
719
1005
  subcategory: measure_categories_js_1.MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
720
1006
  valueType: measure_value_type_js_1.MeasureValueType.CURRENCY,
721
1007
  decimalPlaces: 2,
722
1008
  useCompactNotation: true,
723
1009
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
724
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_THRUPLAYS, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_COST],
1010
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_COST],
725
1011
  },
726
1012
  [measures_js_1.MEASURE.TIKTOK_VIDEO_P25_WATCHED]: {
727
1013
  title: 'TikTok Video 25% Completion Views',
728
1014
  shortTitle: 'Video 25% Views',
729
1015
  description: 'The number of times your video ads were watched to at least 25% completion.',
730
- tooltip: 'Views where the audience watched at least a quarter of your video. Part of the completion rate funnel.',
1016
+ tooltip: 'Views where viewers watched at least a quarter of your video. Part of the completion rate funnel.',
731
1017
  sumPrefix: '',
732
1018
  sumSuffix: '',
733
1019
  avgPrefix: '',
@@ -746,7 +1032,7 @@ exports.TIKTOK_MEASURES_MAP = {
746
1032
  title: 'TikTok Video 50% Completion Views',
747
1033
  shortTitle: 'Video 50% Views',
748
1034
  description: 'The number of times your video ads were watched to at least 50% completion.',
749
- tooltip: 'Views where the audience watched at least half of your video. Indicates moderate viewing engagement.',
1035
+ tooltip: 'Views where viewers watched at least half of your video. Indicates moderate viewing engagement.',
750
1036
  sumPrefix: '',
751
1037
  sumSuffix: '',
752
1038
  avgPrefix: '',
@@ -765,7 +1051,7 @@ exports.TIKTOK_MEASURES_MAP = {
765
1051
  title: 'TikTok Video 75% Completion Views',
766
1052
  shortTitle: 'Video 75% Views',
767
1053
  description: 'The number of times your video ads were watched to at least 75% completion.',
768
- tooltip: 'Views where the audience watched at least three quarters of your video. Signals strong content retention.',
1054
+ tooltip: 'Views where viewers watched at least three quarters of your video. Signals strong content retention.',
769
1055
  sumPrefix: '',
770
1056
  sumSuffix: '',
771
1057
  avgPrefix: '',
@@ -784,7 +1070,7 @@ exports.TIKTOK_MEASURES_MAP = {
784
1070
  title: 'TikTok Video Completions',
785
1071
  shortTitle: 'Video Completions',
786
1072
  description: 'The number of times your video ads were watched to 100% completion.',
787
- tooltip: 'Views where the audience watched your entire video from start to finish. The strongest video engagement signal.',
1073
+ tooltip: 'Views where viewers watched your entire video from start to finish. The strongest video engagement signal.',
788
1074
  sumPrefix: '',
789
1075
  sumSuffix: '',
790
1076
  avgPrefix: '',
@@ -797,12 +1083,12 @@ exports.TIKTOK_MEASURES_MAP = {
797
1083
  decimalPlaces: 0,
798
1084
  useCompactNotation: false,
799
1085
  applicableContexts: measure_applicable_contexts_js_1.CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
800
- relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_P75_WATCHED, measures_js_1.MEASURE.TIKTOK_VIDEO_THRUPLAYS],
1086
+ relatedMeasures: [measures_js_1.MEASURE.TIKTOK_VIDEO_P75_WATCHED, measures_js_1.MEASURE.TIKTOK_VIDEO_VIEWS_15S],
801
1087
  },
802
1088
  [measures_js_1.MEASURE.TIKTOK_ENGAGEMENTS]: {
803
1089
  title: 'TikTok Engagements',
804
- description: 'The total interactions with your TikTok ads (likes, comments, shares).',
805
- tooltip: 'All social interactions on your ad including likes, comments, and shares. High engagement signals resonant creative.',
1090
+ description: 'The total interactions with your TikTok ads as reported by TikTok (e.g., likes, comments, shares).',
1091
+ tooltip: 'All social interactions on your ad reported by TikTok, such as likes, comments, and shares. High engagement signals resonant creative.',
806
1092
  sumPrefix: '',
807
1093
  sumSuffix: '',
808
1094
  avgPrefix: '',
@@ -846,8 +1132,8 @@ exports.TIKTOK_MEASURES_MAP = {
846
1132
  [measures_js_1.MEASURE.TIKTOK_ENGAGEMENT_RATE]: {
847
1133
  title: 'TikTok Engagement Rate',
848
1134
  shortTitle: 'Engagement Rate',
849
- description: 'The percentage of people who engaged with your TikTok ads after seeing them.',
850
- tooltip: 'Share of people who interacted with your ad after seeing it. Higher rates indicate more compelling content.',
1135
+ description: 'The percentage of impressions that resulted in an engagement.',
1136
+ tooltip: 'Engagements divided by impressions. Higher rates indicate more compelling content.',
851
1137
  formulaDisplay: 'Engagements ÷ Impressions × 100',
852
1138
  formula: 'engagements / impressions * 100',
853
1139
  sumPrefix: '',
@@ -903,7 +1189,7 @@ exports.TIKTOK_MEASURES_MAP = {
903
1189
  [measures_js_1.MEASURE.TIKTOK_SHARES]: {
904
1190
  title: 'TikTok Shares',
905
1191
  description: 'The number of times your TikTok ads were shared.',
906
- tooltip: 'How many times people shared your ad. Shares extend organic reach at no extra cost.',
1192
+ tooltip: 'How many times your ad was shared. Shares extend your audience organically at no extra cost.',
907
1193
  sumPrefix: '',
908
1194
  sumSuffix: '',
909
1195
  avgPrefix: '',