Multi-Region Tier Definitions

What are Multi-Region Tier Definitions

Tiers can be assigned to specific regions, meaning a user can progress to a new tier within their own profile’s region. This setup allows different thresholds to be configured for different regions.

How to Configure Multi-Region Tier Definitions

Assign a region_id in each tier definition to link it to a specific region. Make sure this is configured for all tier definitions. Once completed, when a new user signs up, they will be assigned the base (floor) tier of their profile’s region and will progress through the tiers within that region as they accumulate spending.

How to Handle Multi-Currency Across Regions

If a user shops in a region other than their home region, and their spend needs to be converted into a different currency, this can be managed using the tier-point.create.with.region action in a reaction. This action enables the system to convert spending from the purchase region into the currency of the user’s profile region by retrieving the exchange rate from the Omneo Currencies Extension.

Below is an example of how to configure this action:

[
    {
        "name": "profile_id",
        "value":
        {
            "var": "profile_id"
        },
        "is_dynamic": true
    },
    {
        "name": "source_id",
        "value":
        {
            "var": "id"
        },
        "is_dynamic": true
    },
    {
        "name": "source_type",
        "value": "transaction",
        "is_dynamic": null
    },
    {
        "name": "amount",
        "value":
        {
            "var": "total"
        },
        "is_dynamic": true
    },
    {
        "name": "currency",
        "value":
        {
            "var": "currency"
        },
        "is_dynamic": true
    },
    {
        "name": "transaction_region",
        "value":
        {
            "var": "location.region.handle"
        },
        "is_dynamic": true
    },
    {
        "name": "profile_region",
        "value":
        {
            "var": "profile.region.handle"
        },
        "is_dynamic": true
    },
    {
        "name": "convert_currency",
        "value": true,
        "is_dynamic": null
    },
    {
        "name": "issued_at",
        "value":
        {
            "var": "transacted_at"
        },
        "is_dynamic": true
    },
    {
        "name": "definition",
        "value": "tier-spend",
        "is_dynamic": null
    }
]

How to Configure Currency

• Configure the default currency for each region. If a region includes multiple countries (e.g., the AU region contains both Australia and New Zealand), the default currency (AUD) will always be used when converting spend from other regions into the AU region.
• Ensure that each location has an associated country, so that when a transaction occurs, the system can correctly determine the region of that transaction.