Published at: 2025-10-30

How to Set Up Scoring Rules


1. Configuration Steps

1.1 Step 1: Enter Basic Information

image

Enter basic information: includes Rule Name, API Name (auto-generated; editable but not recommended to change), Applicable Object, Description, Applicable Data Scope, and Data Update Method.

Applicable Object: only supports a subset of preset objects: Account, Opportunity, Leads, Contact, competitor line items, Opportunity 2.0, Opportunity 2.0 line items, Opportunity Contacts, User, Work Order, plus all custom objects.

Applicable Data Scope: supports tag application to a custom-defined scope — either all records or records that meet specified conditions.

Data Update Method: supports Real-time Update and Scheduled Update.

  • Real-time Update: calculates scores and updates them in real time. When this is enabled, any create or edit operation on the data triggers a recalculation of that record’s score.
  • Scheduled Update:
    • Daily: no specific execution day (runs every day)
    • Weekly: execution day can be set to any day Monday through Sunday
    • Monthly: execution day can be set to 1–31 or Last Day
    • Quarterly: execution day can be set to Day 1–15 or Last Day -1 to Last Day -15

1.2 Step 2: Configure Metric Rules

Tag rule configuration supports four major rule types: Basic Rules, Calculated Rules, Aggregation Rules, and Scoring Rules. You can add multiple rules of different types; rules operate independently of each other.

image

1.2.1 Basic Rules

Basic Rules: apply tags, modify field values, or perform similar actions on records within a custom-defined data scope. Business scenario: tag Accounts as “Key Account” when headcount > 10,000 and annual revenue > ¥100,000,000 RMB. Rule settings: - Rule Name: customizable - Metric: supports fields on the current object as metrics

image

1.2.2 Calculated Rules

Calculated Rules: suitable for complex calculations. You can use calculation results as tags/field values or to segment data into tiers. Business scenario: when order count >= 5 and the proportion of Work Orders to orders > 35%, tag the Account as “High Inquiry Account”. Rule settings: - Rule Name: customizable - Metrics: - Support inserting fields from the current object, fields from objects related to the current object, and global variables - Operators and functions follow the same rules as Calculation Fields; refer to Calculation Fields documentation - Return Type: supports Number, Currency, Percentage, DateTime, Date, Time, Text, Boolean - When a field in the formula is null, you can set the default to Null or Zero Note: after configuring the formula, click Syntax Check to validate and correct any syntax errors.

image

1.2.3 Aggregation Rules

Aggregation Rules: compute aggregated values and use the result as a tag/field value or to partition data into tiers. Business scenario: assign different tags to Accounts based on aggregated Sales Order amounts from the Account’s related Sales Orders. Rule settings: - Rule Name: customizable - Metrics: - Related Object: choose a related object of the current object - Aggregation Type: Count, Sum, Max, Min, Average - Field to Aggregate: only numeric and currency fields are supported - Null handling: for Max, Min, and Average, choose whether nulls default to zero or are excluded from the calculation (same logic as Calculation Fields) - Return Type: supports Number, Currency, Date, DateTime - Aggregation Data Scope: supports a custom data scope - All - Meet the following conditions: selectable fields are fields from the chosen related object

image

1.2.4 Scoring Rules

Scoring Rules: score records based on field attributes or behaviors and use the final score to assign tags or update field values. Business scenario: score Accounts by Industry, Headcount, Credit Rating, and Customer Attitude, then assign Account tiers based on the total score. Rule settings: - Rule Name: customizable - Metrics: supports selecting fields on the current object and lookup-related fields - Scoring assignments: - Dynamic Scoring: each score item can be configured to add or subtract points when conditions are met within that scoring item - Static Scoring: each score item can assign a fixed score when conditions are met within that scoring item

image

1.3 Step 3: Configure Rule Results

Use the metric rules defined in Step 2 to automatically tag records or modify field values.

image

  • Auto-tagging: configure which tags to apply when records meet the metric rules.
    • Supports selecting any tags in Tag Management that apply to the chosen object
  • Modify Field Values:
    • Support updating fields on the current object
    • Range Assignment: set different result values for the result field based on score ranges
    • Direct Assignment: assign the total score directly to the result field, recording the score in the object’s field

image

2. Other Operations for Tag Rules

After configuring a tag rule, you can Enable/Disable, Edit, Delete, or Recalculate it.

  • Recalculate: the Recalculate button appears only when the tag rule is enabled. Even if Real-time scoring is not enabled, you can trigger bulk recalculation of historical data by using the rule’s Recalculate action.

image

Submit Feedback