Number Attribute

This article describes how to use the number attribute.

The number attribute stores a numeric value for browsing metrics such as visits, page views, and events. Common examples include Lifetime Value, Order Total Transaction, or Days Since Last Purchase.

How it works

Numeric values are stored as decimals or integers. Choose the type that matches your needs:

  • Decimal (default)

    • Decimal values can have zero (0) or more decimal digits.
    • Example: 12, 12.0, 12.345
    • Recommended for attributes that represent monetary values.
  • Integer

    • Only whole number values are stored.
    • Example: 12, -4, 3214
    • Useful for number attributes that represent quantities, counters, or scores.

The number attribute is available in the following scopes: Event, Visit, Visitor.

There are no storage capacity limits for number attributes, but these attributes are still limited by the maximum size of the profile after encryption and compression.

Number enrichments

Increment or decrement number enrichment

This enrichment modifies a number with a positive value (increment) or a negative value (decrement). The modifying value can be a separate number attribute or a constant value.

For example, to calculate the Lifetime Total Value (LTV) of a visitor’s orders use this enrichment to increment the attribute with the value of the order_total attribute each time the purchase event occurs.

Attribute Name: Lifetime Total Value

  • Initial: 121.78
  • Enriched With: order_total 220.00
  • Result: 341.78

Set ratio

Set the quotient of two numbers as a new ratio number.

For example, to calculate the Average Cart Items Per Order use this enrichment to set the ratio of the Total Cart Items Purchased attribute to the Total Orders Completed attribute.

Attribute Name: Average Cart Items Per Order

  • Initial: —
  • Enriched With:
    Total Cart Items Purchased: 48.00
    Total Orders Completed: 3.00
  • Result: 16.00

Set product

Set the product of two numbers as a new number.

For example, to calculate the coupon_discount_amount, use this enrichment to multiply the order_subtotal by the coupon_discount_percent.

Attribute Name: coupon_discount_amount

  • Initial:—
  • Enriched With:
    order_subtotal: 42.00
    coupon_discount_percent: 0.05
  • Result: 2.10

Set difference

Set the difference of two numbers as a new number.

Attribute Name: order_subtotal

  • Initial: 42.00
  • Enriched With:
    order_subtotal: 42.00
    coupon_discount_amount: 2.10
  • Result: 39.90

Set sum

Set to the sum of two numbers.

For example, set order_total to the sum of order_subtotal and order_tax_amount.

Attribute Name: order_total

  • Initial: —
  • Enriched With:
    order_subtotal: 39.90
    order_tax_amount: 3.29
  • Result: 43.19

Set number

Set the number to a specific number.

For example, set Last Purchase Amount to the value of order_total whenever the purchase event occurs.

Attribute Name: Last Purchase Amount

  • Initial: —
  • Enriched With: order_total:43.19
  • Result: 43.19

Set difference between two dates

Calculates the elapsed time between two events. Elapsed time can be expressed as one of the following:

  • Minutes
  • Hours
  • Days
  • Weeks
  • Months

The difference is always stored as a positive value, so the dates can be set in any order.

For example, to calculate Days Since Last Purchase as the difference in days between Last Purchase Date and Current Visit Date.

While date attributes are stored as Unix timestamps, these examples use formatted dates for readability.

Attribute Name: Days Since Last Purchase

  • Initial: —
  • Enriched With:
    Last Purchase Date: "2018/10/30"
    Current Visit Date: "2019/11/01"
  • Result: 367

Set rolling average based on timeline

The rolling average is the arithmetic mean of numerical values captured over time. These values come from number and tally](/server-side/attributes/data-types/tally/) attributes that are collected as entries in a timeline. The timeline’s expiration determines which entries can be factored into the final average. If there is not an expiration date, it is a simple average solution.

Attribute Name: Average Order Value

  • Initial: —
  • Enriched With: [20.00, 30.00, 40.00, 50.00]
  • Result: 35.00

Set rolling sum based on timeline

A rolling sum is the aggregate of numerical values in a number or tally attribute that are captured as entries in a timeline. The timeline’s expiration determines which entries can be factored in during the aggregation.

Attribute Name: Total Order Value

  • Initial: —
  • Enriched With: [10.00, 20.00, 30.00, 40.00, 50.00]
  • Result: 150.00

Set number to the number of entries in timeline

Set the number to the number of entries in a timeline.

Attribute Name: Total Order Count

  • Initial: —
  • Enriched With: [10.00, 20.00, 30.00, 40.00, 50.00]
  • Result: 5.00

Set number to tally value

Set the number to a specific value within the tally. Specify the tally attribute and the name of the entry in the tally. For example, a tally for Site Category Views might have an entry for “Shoes”.

Attribute Name: Shoe Category View Count

  • Initial: —
  • Enriched With: Site Category Views: {"Shoes": 42}
  • Result: 42

Set number to the count of items in tally

Set the attribute to the number of entries in a tally. For example, a tally for Site Category Views might have three entries in it.

Attribute Name: Number of Categories Viewed

  • Initial: —
  • Enriched With:
{  
  "Shoes": 42,  
  "Shirts": 11,  
  "Pants": 8
} 
  • Result: 3.00

Set number to the count of items in set of strings

Set the number to the count of items in a set of strings. For example, a set of strings Active Browser Types might have 3 entries.

Attribute Name: Number of Active Browser Types

  • Initial: —
  • Enriched With: ["Firefox", "Safari", "Chrome"]
  • Result: 3.00

Set number to tally’s rolling max based on a timeline

Set the number to the rolling maximum of another number in a tally captured within a timeline.

Attribute Name: Highest Order Value

  • Initial: —
  • Enriched With: [10.00, 20.00, 30.00, 40.00, 50.00]
  • Result: 50.00

Set number to change in number

Set this attribute to the difference between it and another attribute since the last event. For example, use this enrichment to capture the difference between a previous order amount and the current order amount. To set an attribute named Change in Order Value, set it to the change in order_subtotal since the previous order.

Attribute Name: Change in Order Value

  • Initial: 30.00
  • Enriched With: order_subtotal: 42.00
  • Result: 12.00

Set number to change in date

Set this attribute to the change in value of the selected value between this event and the last event. For example, use this enrichment to capture the change in months of the Last Purchase Date date attribute each time a purchase occurs.

The change in date can be expressed as one of the following:

  • Minutes
  • Hours
  • Days
  • Weeks
  • Months

Attribute Name: Months Since Last Purchase

  • Initial:
  • Enriched With:
    Last Purchase Date (last event): "10/31/2019"
    Last Purchase Date (this event): "12/31/2019"
  • Result: 2 (months)

Set to the number of items in an array

Set to the number of items in an array. For example, to store the number of products in the cart, use this enrichment to capture the number of items in the cart_product_id array.

Attribute Name: num_cart_items

  • Initial: —
  • Enriched With: product_id: ["prod123", "prod456"]
  • Result: 2.00

Was this page helpful?

This page was last updated: January 7, 2023