@adtrackify/at-tracking-event-types 4.66.30 → 4.66.32

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.
@@ -25,7 +25,7 @@ export const TIKTOK_MEASURES_MAP = {
25
25
  [MEASURE.TIKTOK_IMPRESSIONS]: {
26
26
  title: 'TikTok Impressions',
27
27
  description: 'The number of times your TikTok ads were shown.',
28
- tooltip: 'How many times your ads appeared on screen. One person can generate multiple impressions.',
28
+ tooltip: 'How many times your ads appeared on screen. The same viewer can account for multiple impressions.',
29
29
  sumPrefix: '',
30
30
  sumSuffix: '',
31
31
  avgPrefix: '',
@@ -44,7 +44,7 @@ export const TIKTOK_MEASURES_MAP = {
44
44
  title: 'TikTok CPM',
45
45
  shortTitle: 'CPM',
46
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.',
47
+ tooltip: 'How much you pay for every 1,000 times your ad is shown. Lower CPM means cheaper impressions.',
48
48
  formulaDisplay: 'Ad Spend ÷ Impressions × 1,000',
49
49
  formula: 'spend / impressions * 1000',
50
50
  sumPrefix: '$',
@@ -124,7 +124,7 @@ export const TIKTOK_MEASURES_MAP = {
124
124
  [MEASURE.TIKTOK_PURCHASES]: {
125
125
  title: 'TikTok Purchases',
126
126
  description: 'The number of purchases attributed to your TikTok ads.',
127
- tooltip: 'How many completed purchases TikTok attributes to your ads, including web and TikTok Shop conversions.',
127
+ tooltip: 'How many purchase events TikTok attributes to your ads.',
128
128
  sumPrefix: '',
129
129
  sumSuffix: '',
130
130
  avgPrefix: '',
@@ -204,7 +204,7 @@ export const TIKTOK_MEASURES_MAP = {
204
204
  title: 'TikTok View Contents',
205
205
  shortTitle: 'View Content',
206
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.',
207
+ tooltip: 'How many product detail page views TikTok attributes to your ads. A top-of-funnel engagement signal.',
208
208
  sumPrefix: '',
209
209
  sumSuffix: '',
210
210
  avgPrefix: '',
@@ -263,7 +263,7 @@ export const TIKTOK_MEASURES_MAP = {
263
263
  title: 'TikTok Add to Carts',
264
264
  shortTitle: 'Add to Cart',
265
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.',
266
+ tooltip: 'How many add-to-cart events TikTok attributes to your ads. A mid-funnel purchase intent signal.',
267
267
  sumPrefix: '',
268
268
  sumSuffix: '',
269
269
  avgPrefix: '',
@@ -322,7 +322,7 @@ export const TIKTOK_MEASURES_MAP = {
322
322
  title: 'TikTok Initiate Checkouts',
323
323
  shortTitle: 'Checkouts',
324
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.',
325
+ tooltip: 'How many checkout-initiation events TikTok attributes to your ads. A strong bottom-of-funnel conversion signal.',
326
326
  sumPrefix: '',
327
327
  sumSuffix: '',
328
328
  avgPrefix: '',
@@ -335,7 +335,26 @@ export const TIKTOK_MEASURES_MAP = {
335
335
  decimalPlaces: 0,
336
336
  useCompactNotation: false,
337
337
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
338
- relatedMeasures: [MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST, MEASURE.TIKTOK_PURCHASES, MEASURE.TIKTOK_ADD_TO_CARTS],
338
+ relatedMeasures: [MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST, MEASURE.TIKTOK_INITIATE_CHECKOUTS_VALUE, MEASURE.TIKTOK_PURCHASES],
339
+ },
340
+ [MEASURE.TIKTOK_INITIATE_CHECKOUTS_VALUE]: {
341
+ title: 'TikTok Initiate Checkouts Value',
342
+ shortTitle: 'Checkout Value',
343
+ description: 'The total value of checkout initiations from your TikTok ads.',
344
+ tooltip: 'Combined value of all checkout initiations by visitors from your TikTok ads.',
345
+ sumPrefix: '$',
346
+ sumSuffix: '',
347
+ avgPrefix: '$',
348
+ avgSuffix: '',
349
+ icon: MEASURE_ICON.TIKTOK,
350
+ measure: MEASURE.TIKTOK_INITIATE_CHECKOUTS_VALUE,
351
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
352
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
353
+ valueType: MeasureValueType.CURRENCY,
354
+ decimalPlaces: 2,
355
+ useCompactNotation: true,
356
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
357
+ relatedMeasures: [MEASURE.TIKTOK_INITIATE_CHECKOUTS, MEASURE.TIKTOK_PURCHASES_VALUE],
339
358
  },
340
359
  [MEASURE.TIKTOK_INITIATE_CHECKOUTS_COST]: {
341
360
  title: 'TikTok Cost per Initiate Checkout',
@@ -361,7 +380,7 @@ export const TIKTOK_MEASURES_MAP = {
361
380
  [MEASURE.TIKTOK_LEADS]: {
362
381
  title: 'TikTok Leads',
363
382
  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.',
383
+ tooltip: 'How many lead events TikTok attributes to your ads (form submissions or equivalent lead actions).',
365
384
  sumPrefix: '',
366
385
  sumSuffix: '',
367
386
  avgPrefix: '',
@@ -416,10 +435,184 @@ export const TIKTOK_MEASURES_MAP = {
416
435
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
417
436
  relatedMeasures: [MEASURE.TIKTOK_LEADS, MEASURE.TIKTOK_CPA],
418
437
  },
438
+ [MEASURE.TIKTOK_SEARCHES]: {
439
+ title: 'TikTok Searches',
440
+ description: 'The number of search events attributed to your TikTok ads.',
441
+ tooltip: 'How many search events TikTok attributes to your ads.',
442
+ sumPrefix: '',
443
+ sumSuffix: '',
444
+ avgPrefix: '',
445
+ avgSuffix: '',
446
+ icon: MEASURE_ICON.TIKTOK,
447
+ measure: MEASURE.TIKTOK_SEARCHES,
448
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
449
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
450
+ valueType: MeasureValueType.NUMBER,
451
+ decimalPlaces: 0,
452
+ useCompactNotation: false,
453
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
454
+ relatedMeasures: [MEASURE.TIKTOK_SEARCHES_COST, MEASURE.TIKTOK_SEARCHES_VALUE],
455
+ },
456
+ [MEASURE.TIKTOK_SEARCHES_VALUE]: {
457
+ title: 'TikTok Searches Value',
458
+ shortTitle: 'Search Value',
459
+ description: 'The total value of search events from your TikTok ads.',
460
+ tooltip: 'Combined value of all search events by visitors from your TikTok ads.',
461
+ sumPrefix: '$',
462
+ sumSuffix: '',
463
+ avgPrefix: '$',
464
+ avgSuffix: '',
465
+ icon: MEASURE_ICON.TIKTOK,
466
+ measure: MEASURE.TIKTOK_SEARCHES_VALUE,
467
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
468
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
469
+ valueType: MeasureValueType.CURRENCY,
470
+ decimalPlaces: 2,
471
+ useCompactNotation: true,
472
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
473
+ relatedMeasures: [MEASURE.TIKTOK_SEARCHES, MEASURE.TIKTOK_SEARCHES_COST],
474
+ },
475
+ [MEASURE.TIKTOK_SEARCHES_COST]: {
476
+ title: 'TikTok Cost per Search',
477
+ shortTitle: 'Cost/Search',
478
+ description: 'The cost per search event from your TikTok ads.',
479
+ tooltip: 'Average spend per search event from TikTok ads.',
480
+ formulaDisplay: 'Ad Spend ÷ Searches',
481
+ formula: 'spend / searches',
482
+ sumPrefix: '$',
483
+ sumSuffix: '',
484
+ avgPrefix: '$',
485
+ avgSuffix: '',
486
+ icon: MEASURE_ICON.TIKTOK,
487
+ measure: MEASURE.TIKTOK_SEARCHES_COST,
488
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
489
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
490
+ valueType: MeasureValueType.CURRENCY,
491
+ decimalPlaces: 2,
492
+ useCompactNotation: true,
493
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
494
+ relatedMeasures: [MEASURE.TIKTOK_SEARCHES, MEASURE.TIKTOK_CPA],
495
+ },
496
+ [MEASURE.TIKTOK_SUBSCRIBES]: {
497
+ title: 'TikTok Subscribes',
498
+ description: 'The number of subscribe events attributed to your TikTok ads.',
499
+ tooltip: 'How many subscribe events TikTok attributes to your ads.',
500
+ sumPrefix: '',
501
+ sumSuffix: '',
502
+ avgPrefix: '',
503
+ avgSuffix: '',
504
+ icon: MEASURE_ICON.TIKTOK,
505
+ measure: MEASURE.TIKTOK_SUBSCRIBES,
506
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
507
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
508
+ valueType: MeasureValueType.NUMBER,
509
+ decimalPlaces: 0,
510
+ useCompactNotation: false,
511
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
512
+ relatedMeasures: [MEASURE.TIKTOK_SUBSCRIBES_COST, MEASURE.TIKTOK_SUBSCRIBES_VALUE],
513
+ },
514
+ [MEASURE.TIKTOK_SUBSCRIBES_VALUE]: {
515
+ title: 'TikTok Subscribes Value',
516
+ shortTitle: 'Subscribe Value',
517
+ description: 'The total value of subscribe events from your TikTok ads.',
518
+ tooltip: 'Combined value of all subscribe events by visitors from your TikTok ads.',
519
+ sumPrefix: '$',
520
+ sumSuffix: '',
521
+ avgPrefix: '$',
522
+ avgSuffix: '',
523
+ icon: MEASURE_ICON.TIKTOK,
524
+ measure: MEASURE.TIKTOK_SUBSCRIBES_VALUE,
525
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
526
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
527
+ valueType: MeasureValueType.CURRENCY,
528
+ decimalPlaces: 2,
529
+ useCompactNotation: true,
530
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
531
+ relatedMeasures: [MEASURE.TIKTOK_SUBSCRIBES, MEASURE.TIKTOK_SUBSCRIBES_COST],
532
+ },
533
+ [MEASURE.TIKTOK_SUBSCRIBES_COST]: {
534
+ title: 'TikTok Cost per Subscribe',
535
+ shortTitle: 'Cost/Subscribe',
536
+ description: 'The cost per subscribe event from your TikTok ads.',
537
+ tooltip: 'Average spend per subscribe event from TikTok ads.',
538
+ formulaDisplay: 'Ad Spend ÷ Subscribes',
539
+ formula: 'spend / subscribes',
540
+ sumPrefix: '$',
541
+ sumSuffix: '',
542
+ avgPrefix: '$',
543
+ avgSuffix: '',
544
+ icon: MEASURE_ICON.TIKTOK,
545
+ measure: MEASURE.TIKTOK_SUBSCRIBES_COST,
546
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
547
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
548
+ valueType: MeasureValueType.CURRENCY,
549
+ decimalPlaces: 2,
550
+ useCompactNotation: true,
551
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
552
+ relatedMeasures: [MEASURE.TIKTOK_SUBSCRIBES, MEASURE.TIKTOK_CPA],
553
+ },
554
+ [MEASURE.TIKTOK_SCHEDULES]: {
555
+ title: 'TikTok Schedules',
556
+ description: 'The number of schedule events attributed to your TikTok ads.',
557
+ tooltip: 'How many schedule events TikTok attributes to your ads.',
558
+ sumPrefix: '',
559
+ sumSuffix: '',
560
+ avgPrefix: '',
561
+ avgSuffix: '',
562
+ icon: MEASURE_ICON.TIKTOK,
563
+ measure: MEASURE.TIKTOK_SCHEDULES,
564
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
565
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
566
+ valueType: MeasureValueType.NUMBER,
567
+ decimalPlaces: 0,
568
+ useCompactNotation: false,
569
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
570
+ relatedMeasures: [MEASURE.TIKTOK_SCHEDULES_COST, MEASURE.TIKTOK_SCHEDULES_VALUE],
571
+ },
572
+ [MEASURE.TIKTOK_SCHEDULES_VALUE]: {
573
+ title: 'TikTok Schedules Value',
574
+ shortTitle: 'Schedule Value',
575
+ description: 'The total value of schedule events from your TikTok ads.',
576
+ tooltip: 'Combined value of all schedule events by visitors from your TikTok ads.',
577
+ sumPrefix: '$',
578
+ sumSuffix: '',
579
+ avgPrefix: '$',
580
+ avgSuffix: '',
581
+ icon: MEASURE_ICON.TIKTOK,
582
+ measure: MEASURE.TIKTOK_SCHEDULES_VALUE,
583
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
584
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
585
+ valueType: MeasureValueType.CURRENCY,
586
+ decimalPlaces: 2,
587
+ useCompactNotation: true,
588
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
589
+ relatedMeasures: [MEASURE.TIKTOK_SCHEDULES, MEASURE.TIKTOK_SCHEDULES_COST],
590
+ },
591
+ [MEASURE.TIKTOK_SCHEDULES_COST]: {
592
+ title: 'TikTok Cost per Schedule',
593
+ shortTitle: 'Cost/Schedule',
594
+ description: 'The cost per schedule event from your TikTok ads.',
595
+ tooltip: 'Average spend per schedule event from TikTok ads.',
596
+ formulaDisplay: 'Ad Spend ÷ Schedules',
597
+ formula: 'spend / schedules',
598
+ sumPrefix: '$',
599
+ sumSuffix: '',
600
+ avgPrefix: '$',
601
+ avgSuffix: '',
602
+ icon: MEASURE_ICON.TIKTOK,
603
+ measure: MEASURE.TIKTOK_SCHEDULES_COST,
604
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
605
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
606
+ valueType: MeasureValueType.CURRENCY,
607
+ decimalPlaces: 2,
608
+ useCompactNotation: true,
609
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
610
+ relatedMeasures: [MEASURE.TIKTOK_SCHEDULES, MEASURE.TIKTOK_CPA],
611
+ },
419
612
  [MEASURE.TIKTOK_APP_INSTALLS]: {
420
613
  title: 'TikTok App Installs',
421
614
  description: 'The number of app installs from your TikTok ads.',
422
- tooltip: 'How many people installed your app after engaging with your TikTok ad.',
615
+ tooltip: 'How many app-install events TikTok attributes to your ads.',
423
616
  sumPrefix: '',
424
617
  sumSuffix: '',
425
618
  avgPrefix: '',
@@ -459,7 +652,7 @@ export const TIKTOK_MEASURES_MAP = {
459
652
  title: 'TikTok Completed Registrations',
460
653
  shortTitle: 'Registrations',
461
654
  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.',
655
+ tooltip: 'How many completed-registration events TikTok attributes to your ads.',
463
656
  sumPrefix: '',
464
657
  sumSuffix: '',
465
658
  avgPrefix: '',
@@ -472,7 +665,26 @@ export const TIKTOK_MEASURES_MAP = {
472
665
  decimalPlaces: 0,
473
666
  useCompactNotation: false,
474
667
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
475
- relatedMeasures: [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST, MEASURE.TIKTOK_LEADS],
668
+ relatedMeasures: [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST, MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_VALUE, MEASURE.TIKTOK_LEADS],
669
+ },
670
+ [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_VALUE]: {
671
+ title: 'TikTok Completed Registrations Value',
672
+ shortTitle: 'Registration Value',
673
+ description: 'The total value of completed registrations from your TikTok ads.',
674
+ tooltip: 'Combined value of all completed registrations by visitors from your TikTok ads.',
675
+ sumPrefix: '$',
676
+ sumSuffix: '',
677
+ avgPrefix: '$',
678
+ avgSuffix: '',
679
+ icon: MEASURE_ICON.TIKTOK,
680
+ measure: MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_VALUE,
681
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
682
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
683
+ valueType: MeasureValueType.CURRENCY,
684
+ decimalPlaces: 2,
685
+ useCompactNotation: true,
686
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
687
+ relatedMeasures: [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS, MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST],
476
688
  },
477
689
  [MEASURE.TIKTOK_COMPLETE_REGISTRATIONS_COST]: {
478
690
  title: 'TikTok Cost per Completed Registration',
@@ -499,7 +711,7 @@ export const TIKTOK_MEASURES_MAP = {
499
711
  title: 'TikTok Add to Wishlists',
500
712
  shortTitle: 'Wishlists',
501
713
  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.',
714
+ tooltip: 'How many wishlist-add events TikTok attributes to your ads. Signals future purchase intent.',
503
715
  sumPrefix: '',
504
716
  sumSuffix: '',
505
717
  avgPrefix: '',
@@ -512,7 +724,26 @@ export const TIKTOK_MEASURES_MAP = {
512
724
  decimalPlaces: 0,
513
725
  useCompactNotation: false,
514
726
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
515
- relatedMeasures: [MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST, MEASURE.TIKTOK_ADD_TO_CARTS],
727
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST, MEASURE.TIKTOK_ADD_TO_WISHLISTS_VALUE, MEASURE.TIKTOK_ADD_TO_CARTS],
728
+ },
729
+ [MEASURE.TIKTOK_ADD_TO_WISHLISTS_VALUE]: {
730
+ title: 'TikTok Add to Wishlists Value',
731
+ shortTitle: 'Wishlist Value',
732
+ description: 'The total value of add to wishlist actions from your TikTok ads.',
733
+ tooltip: 'Combined value of all wishlist adds by visitors from your TikTok ads.',
734
+ sumPrefix: '$',
735
+ sumSuffix: '',
736
+ avgPrefix: '$',
737
+ avgSuffix: '',
738
+ icon: MEASURE_ICON.TIKTOK,
739
+ measure: MEASURE.TIKTOK_ADD_TO_WISHLISTS_VALUE,
740
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
741
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_CONVERSIONS,
742
+ valueType: MeasureValueType.CURRENCY,
743
+ decimalPlaces: 2,
744
+ useCompactNotation: true,
745
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
746
+ relatedMeasures: [MEASURE.TIKTOK_ADD_TO_WISHLISTS, MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST],
516
747
  },
517
748
  [MEASURE.TIKTOK_ADD_TO_WISHLISTS_COST]: {
518
749
  title: 'TikTok Cost per Add to Wishlist',
@@ -535,11 +766,89 @@ export const TIKTOK_MEASURES_MAP = {
535
766
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
536
767
  relatedMeasures: [MEASURE.TIKTOK_ADD_TO_WISHLISTS, MEASURE.TIKTOK_ADD_TO_CARTS_COST],
537
768
  },
769
+ [MEASURE.TIKTOK_FOLLOWS]: {
770
+ title: 'TikTok Follows',
771
+ description: 'The number of new followers from your TikTok ads.',
772
+ tooltip: 'How many users followed your TikTok account after seeing your ad.',
773
+ sumPrefix: '',
774
+ sumSuffix: '',
775
+ avgPrefix: '',
776
+ avgSuffix: '',
777
+ icon: MEASURE_ICON.TIKTOK,
778
+ measure: MEASURE.TIKTOK_FOLLOWS,
779
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
780
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
781
+ valueType: MeasureValueType.NUMBER,
782
+ decimalPlaces: 0,
783
+ useCompactNotation: false,
784
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
785
+ relatedMeasures: [MEASURE.TIKTOK_FOLLOWS_COST, MEASURE.TIKTOK_ENGAGEMENTS],
786
+ },
787
+ [MEASURE.TIKTOK_FOLLOWS_COST]: {
788
+ title: 'TikTok Cost per Follow',
789
+ shortTitle: 'Cost/Follow',
790
+ description: 'The cost per new follower from your TikTok ads.',
791
+ tooltip: 'Average spend per new follower from TikTok ads.',
792
+ formulaDisplay: 'Ad Spend ÷ Follows',
793
+ formula: 'spend / follows',
794
+ sumPrefix: '$',
795
+ sumSuffix: '',
796
+ avgPrefix: '$',
797
+ avgSuffix: '',
798
+ icon: MEASURE_ICON.TIKTOK,
799
+ measure: MEASURE.TIKTOK_FOLLOWS_COST,
800
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
801
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
802
+ valueType: MeasureValueType.CURRENCY,
803
+ decimalPlaces: 2,
804
+ useCompactNotation: true,
805
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
806
+ relatedMeasures: [MEASURE.TIKTOK_FOLLOWS, MEASURE.TIKTOK_ENGAGEMENTS_COST],
807
+ },
808
+ [MEASURE.TIKTOK_PROFILE_VISITS]: {
809
+ title: 'TikTok Profile Visits',
810
+ description: 'The number of profile visits from your TikTok ads.',
811
+ tooltip: 'How many users visited your TikTok profile after seeing your ad.',
812
+ sumPrefix: '',
813
+ sumSuffix: '',
814
+ avgPrefix: '',
815
+ avgSuffix: '',
816
+ icon: MEASURE_ICON.TIKTOK,
817
+ measure: MEASURE.TIKTOK_PROFILE_VISITS,
818
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
819
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
820
+ valueType: MeasureValueType.NUMBER,
821
+ decimalPlaces: 0,
822
+ useCompactNotation: false,
823
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
824
+ relatedMeasures: [MEASURE.TIKTOK_PROFILE_VISITS_COST, MEASURE.TIKTOK_FOLLOWS],
825
+ },
826
+ [MEASURE.TIKTOK_PROFILE_VISITS_COST]: {
827
+ title: 'TikTok Cost per Profile Visit',
828
+ shortTitle: 'Cost/Profile Visit',
829
+ description: 'The cost per profile visit from your TikTok ads.',
830
+ tooltip: 'Average spend per profile visit from TikTok ads.',
831
+ formulaDisplay: 'Ad Spend ÷ Profile Visits',
832
+ formula: 'spend / profile_visits',
833
+ sumPrefix: '$',
834
+ sumSuffix: '',
835
+ avgPrefix: '$',
836
+ avgSuffix: '',
837
+ icon: MEASURE_ICON.TIKTOK,
838
+ measure: MEASURE.TIKTOK_PROFILE_VISITS_COST,
839
+ category: MEASURE_CATEGORY.TIKTOK_ADS,
840
+ subcategory: MEASURE_SUBCATEGORY.TIKTOK_ENGAGEMENT,
841
+ valueType: MeasureValueType.CURRENCY,
842
+ decimalPlaces: 2,
843
+ useCompactNotation: true,
844
+ applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
845
+ relatedMeasures: [MEASURE.TIKTOK_PROFILE_VISITS, MEASURE.TIKTOK_FOLLOWS_COST],
846
+ },
538
847
  [MEASURE.TIKTOK_LANDING_PAGE_VIEWS]: {
539
848
  title: 'TikTok Landing Page Views',
540
849
  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.',
850
+ description: 'The number of landing page loads attributed to clicks on your TikTok ads.',
851
+ tooltip: 'How many times your landing page fully loaded after a click. Lower than clicks indicates drop-off before the page loaded.',
543
852
  sumPrefix: '',
544
853
  sumSuffix: '',
545
854
  avgPrefix: '',
@@ -582,10 +891,10 @@ export const TIKTOK_MEASURES_MAP = {
582
891
  [MEASURE.TIKTOK_LANDING_PAGE_VIEW_RATE]: {
583
892
  title: 'TikTok Landing Page View Rate',
584
893
  shortTitle: 'LP View Rate',
585
- description: 'The percentage of impressions that resulted in landing page loads.',
586
- tooltip: 'Share of impressions that actually loaded your landing page. Low rates suggest slow load times or bounce issues.',
587
- formulaDisplay: 'Landing Page Views ÷ Impressions × 100',
588
- formula: 'landing_page_views / impressions * 100',
894
+ description: 'The percentage of clicks that resulted in landing page loads.',
895
+ tooltip: 'Share of clicks that actually loaded your landing page. Low rates suggest slow load times or bounce issues.',
896
+ formulaDisplay: 'Landing Page Views ÷ Clicks × 100',
897
+ formula: 'landing_page_views / clicks * 100',
589
898
  sumPrefix: '',
590
899
  sumSuffix: '%',
591
900
  avgPrefix: '',
@@ -598,7 +907,7 @@ export const TIKTOK_MEASURES_MAP = {
598
907
  decimalPlaces: 2,
599
908
  useCompactNotation: false,
600
909
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
601
- relatedMeasures: [MEASURE.TIKTOK_LANDING_PAGE_VIEWS, MEASURE.TIKTOK_IMPRESSIONS],
910
+ relatedMeasures: [MEASURE.TIKTOK_LANDING_PAGE_VIEWS, MEASURE.TIKTOK_CLICKS],
602
911
  },
603
912
  [MEASURE.TIKTOK_VIDEO_PLAYS]: {
604
913
  title: 'TikTok Video Plays',
@@ -634,7 +943,7 @@ export const TIKTOK_MEASURES_MAP = {
634
943
  decimalPlaces: 0,
635
944
  useCompactNotation: false,
636
945
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
637
- relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS_COST, MEASURE.TIKTOK_VIDEO_PLAYS, MEASURE.TIKTOK_VIDEO_THRUPLAYS],
946
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS_COST, MEASURE.TIKTOK_VIDEO_PLAYS, MEASURE.TIKTOK_VIDEO_VIEWS_15S],
638
947
  },
639
948
  [MEASURE.TIKTOK_VIDEO_VIEWS_COST]: {
640
949
  title: 'TikTok Cost per Video View',
@@ -655,7 +964,7 @@ export const TIKTOK_MEASURES_MAP = {
655
964
  decimalPlaces: 2,
656
965
  useCompactNotation: true,
657
966
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
658
- relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS, MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST],
967
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS, MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST],
659
968
  },
660
969
  [MEASURE.TIKTOK_VIDEO_VIEWS_15S]: {
661
970
  title: 'TikTok 15-Second Video Views',
@@ -674,57 +983,34 @@ export const TIKTOK_MEASURES_MAP = {
674
983
  decimalPlaces: 0,
675
984
  useCompactNotation: false,
676
985
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
677
- relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS, MEASURE.TIKTOK_VIDEO_THRUPLAYS],
678
- },
679
- [MEASURE.TIKTOK_VIDEO_THRUPLAYS]: {
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.',
684
- sumPrefix: '',
685
- sumSuffix: '',
686
- avgPrefix: '',
687
- avgSuffix: '',
688
- icon: MEASURE_ICON.TIKTOK,
689
- measure: MEASURE.TIKTOK_VIDEO_THRUPLAYS,
690
- category: MEASURE_CATEGORY.TIKTOK_ADS,
691
- subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
692
- valueType: MeasureValueType.NUMBER,
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
- ],
986
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS, MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST],
701
987
  },
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',
988
+ [MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST]: {
989
+ title: 'TikTok Cost per 15-Second Video View',
990
+ shortTitle: 'Cost/15s View',
991
+ description: 'The cost per 15-second video view on your TikTok ads.',
992
+ tooltip: 'Average spend per 15-second video view. Useful when optimizing for engaged video view campaigns.',
993
+ formulaDisplay: 'Ad Spend ÷ 15s Video Views',
994
+ formula: 'spend / video_views_15s',
709
995
  sumPrefix: '$',
710
996
  sumSuffix: '',
711
997
  avgPrefix: '$',
712
998
  avgSuffix: '',
713
999
  icon: MEASURE_ICON.TIKTOK,
714
- measure: MEASURE.TIKTOK_VIDEO_VIEWS_THRUPLAY_COST,
1000
+ measure: MEASURE.TIKTOK_VIDEO_VIEWS_15S_COST,
715
1001
  category: MEASURE_CATEGORY.TIKTOK_ADS,
716
1002
  subcategory: MEASURE_SUBCATEGORY.TIKTOK_VIDEO,
717
1003
  valueType: MeasureValueType.CURRENCY,
718
1004
  decimalPlaces: 2,
719
1005
  useCompactNotation: true,
720
1006
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
721
- relatedMeasures: [MEASURE.TIKTOK_VIDEO_THRUPLAYS, MEASURE.TIKTOK_VIDEO_VIEWS_COST],
1007
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_VIEWS_15S, MEASURE.TIKTOK_VIDEO_VIEWS_COST],
722
1008
  },
723
1009
  [MEASURE.TIKTOK_VIDEO_P25_WATCHED]: {
724
1010
  title: 'TikTok Video 25% Completion Views',
725
1011
  shortTitle: 'Video 25% Views',
726
1012
  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.',
1013
+ tooltip: 'Views where viewers watched at least a quarter of your video. Part of the completion rate funnel.',
728
1014
  sumPrefix: '',
729
1015
  sumSuffix: '',
730
1016
  avgPrefix: '',
@@ -743,7 +1029,7 @@ export const TIKTOK_MEASURES_MAP = {
743
1029
  title: 'TikTok Video 50% Completion Views',
744
1030
  shortTitle: 'Video 50% Views',
745
1031
  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.',
1032
+ tooltip: 'Views where viewers watched at least half of your video. Indicates moderate viewing engagement.',
747
1033
  sumPrefix: '',
748
1034
  sumSuffix: '',
749
1035
  avgPrefix: '',
@@ -762,7 +1048,7 @@ export const TIKTOK_MEASURES_MAP = {
762
1048
  title: 'TikTok Video 75% Completion Views',
763
1049
  shortTitle: 'Video 75% Views',
764
1050
  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.',
1051
+ tooltip: 'Views where viewers watched at least three quarters of your video. Signals strong content retention.',
766
1052
  sumPrefix: '',
767
1053
  sumSuffix: '',
768
1054
  avgPrefix: '',
@@ -781,7 +1067,7 @@ export const TIKTOK_MEASURES_MAP = {
781
1067
  title: 'TikTok Video Completions',
782
1068
  shortTitle: 'Video Completions',
783
1069
  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.',
1070
+ tooltip: 'Views where viewers watched your entire video from start to finish. The strongest video engagement signal.',
785
1071
  sumPrefix: '',
786
1072
  sumSuffix: '',
787
1073
  avgPrefix: '',
@@ -794,12 +1080,12 @@ export const TIKTOK_MEASURES_MAP = {
794
1080
  decimalPlaces: 0,
795
1081
  useCompactNotation: false,
796
1082
  applicableContexts: CUSTOM_DASHBOARD_APPLICABLE_CONTEXTS,
797
- relatedMeasures: [MEASURE.TIKTOK_VIDEO_P75_WATCHED, MEASURE.TIKTOK_VIDEO_THRUPLAYS],
1083
+ relatedMeasures: [MEASURE.TIKTOK_VIDEO_P75_WATCHED, MEASURE.TIKTOK_VIDEO_VIEWS_15S],
798
1084
  },
799
1085
  [MEASURE.TIKTOK_ENGAGEMENTS]: {
800
1086
  title: 'TikTok Engagements',
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.',
1087
+ description: 'The total interactions with your TikTok ads as reported by TikTok (e.g., likes, comments, shares).',
1088
+ tooltip: 'All social interactions on your ad reported by TikTok, such as likes, comments, and shares. High engagement signals resonant creative.',
803
1089
  sumPrefix: '',
804
1090
  sumSuffix: '',
805
1091
  avgPrefix: '',
@@ -843,8 +1129,8 @@ export const TIKTOK_MEASURES_MAP = {
843
1129
  [MEASURE.TIKTOK_ENGAGEMENT_RATE]: {
844
1130
  title: 'TikTok Engagement Rate',
845
1131
  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.',
1132
+ description: 'The percentage of impressions that resulted in an engagement.',
1133
+ tooltip: 'Engagements divided by impressions. Higher rates indicate more compelling content.',
848
1134
  formulaDisplay: 'Engagements ÷ Impressions × 100',
849
1135
  formula: 'engagements / impressions * 100',
850
1136
  sumPrefix: '',
@@ -900,7 +1186,7 @@ export const TIKTOK_MEASURES_MAP = {
900
1186
  [MEASURE.TIKTOK_SHARES]: {
901
1187
  title: 'TikTok Shares',
902
1188
  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.',
1189
+ tooltip: 'How many times your ad was shared. Shares extend your audience organically at no extra cost.',
904
1190
  sumPrefix: '',
905
1191
  sumSuffix: '',
906
1192
  avgPrefix: '',