Skip to main content

Measure your perk pages

Read what your perk pages actually did — views, clicks, and the conversions they produced — from your analytics data.

Every perk-page surface reports into the same analytics layer: the embedded page, the hosted page, and perks you render through the API. You query it like any other metric — mint a token, send a query — so read Authenticate and Query your metrics first. This page maps which views carry perk-page activity.

The views that matter​

  • Page views — perk_page_views counts how often your page was seen.
  • Clicks — one view per section of the page: perk_page_clicks_of_collection_perks (your standing list), perk_page_clicks_of_group_perks (themed groups), perk_page_clicks_of_local_perks and perk_page_clicks_of_short_term_perks (the geo and expiring sections). clicks_unified sums click activity across surfaces, and uurl_clicks isolates clicks on your Universal URLs.
  • Conversions — conversions_unified is the one to start with: every conversion across your perk surfaces, with status, amount, and date. Per- section variants (conversions_of_collection_perks, …_of_group_perks, …_of_local_perks, …_of_short_term_perks, conversions_of_uurl) split the same data by where the click happened.

All click and conversion views carry a cmeta dimension — the attributes you forwarded from your pages — so your own ids are first-class group-by keys.

Confirm the exact measures and dimensions available to your account with the /meta call.

A worked query — clicks per day by section​

How many perk clicks did my standing collection get per day over the last 30 days?

curl -G https://cube.paylode.com/cubejs-api/v1/load \
  -H "Authorization: eyJhbGciOiJIUzI1NiJ9.EXAMPLE_PAYLOAD.EXAMPLE_SIGNATURE" \
  --data-urlencode 'query={
    "measures": ["perk_page_clicks_of_collection_perks.count"],
    "timeDimensions": [{
      "dimension": "perk_page_clicks_of_collection_perks.event_date",
      "granularity": "day",
      "dateRange": "last 30 days"
    }]
  }'

Swap the view name to ask the same question of any other section, or of conversions_unified to follow the funnel from click to purchase.

Reading the funnel​

The three layers connect: a view is the page rendering, a click is a customer following a perk's redemption link, and a conversion is the purchase that click produced — reported back with a delay, which is why conversion counts trail click counts (see Data freshness).