feat(rum-api-client): campaign performance measurement for meta campaigns

[ekremney]

Summary

This PR introduces the campaign-performance query which is used to evaluate the performance of marketing campaigns by analyzing RUM data. The query first filters RUM bundles where the source of a paid checkpoint is identified as facebook (see explanation below). Then it groups the RUM bundles by the utm_campaign so that each campaign's performance can be calculated. Finally it calculates some business KPIs such as CTR and pageviews for each campaign.

Example Query Response:

[
  {
    "campaignId": "120213168952980692",
    "ctr": "0.0699",
    "lcp": 2342,
    "views": 118800
  },
  {
    "campaignId": "120211829416530209",
    "ctr": "0.0809",
    "lcp": 7079,
    "views": 30900
  },
  {
    "campaignId": "23855478306050731",
    "ctr": "0.2917",
    "lcp": 6129,
    "views": 26400
  }
]

Details

RUM Enhancer collects hints about the sources of acquired traffic. One of the primary indicators is utm parameters, where:

• utm_source and utm_medium provide information about the traffic source.
• utm_campaign identifies the specific marketing or advertising campaign responsible for driving the traffic.

In addition to utm parameters, other hints are collected as well such as email and paid checkpoints. A paid checkpoint is triggered when a specific hint in the URL tells the traffic source. For example, if the URL contains a fbclid query parameter, RUM Enhancer fires a paid checkpoint event with facebook as the source and fbclid as the target.