Skip to main content

Checking the tier uids

Each easyPoints tier is assigned a unique identifier called a “uid”.

This identifier is mainly required when converting tiers into metafields or when using them for segmentation. Each tier is assigned one uid that does not change, regardless of any modifications to the tier settings.

Please refer to the instructions below to check the uid for each tier.

 

How to Check the uids

Access the metafield information of a test account

Create a test account in Shopify and go to the customer detail page from the customer management section.

Make sure that the test account belongs to the default tier.

Add /metafields.json to the end of the customer detail page URL and press Enter. You will then be able to view all metafield information for the customer in JSON format.

(If your browser supports a JSON formatter or you use an online formatter, you can display the information in a more readable format.)

 

Extract the uid from the easyPoints metafield information

In the JSON file, locate the metafield with:

"namespace": "loyalty",
"key": "easy_points_attributes"

From the value of this metafield, you can extract the uid for each tier.

The uids for each tier can be found in: loyalty.easy_points_attributes.value.tier_maintenance_data.advancement_data.tiers

loyalty.easy_points_attributes.value
 └── tier_maintenance_data
       └── advancement_data
             └── tiers  ← here's where the uids are found

 

e.g.（blue: tier name, red: uid）: 

"value": "{\"tier\":\"Silver\",\"balance\":133030,\"point_value\":1,\"tier_uid\":\"f80c71c0-5363-4c78-903f-a6ee8cae6081\",\"expiration_date\":\"2026-07-24T23:59:59+09:00\",\"tier_maintenance_data\":{\"advancement_data\":{\"currency\":\"JPY\",\"tiers\":

[{\"name\":\"Silver\",\"currency\":\"JPY\",\"uid\":\"f80c71c0-5363-4c78-903f-a6ee8cae6081\",\"amount\":\"0\",\"ratio\":0.01,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"0\",\"raw_amount\":0},\"raw_amount\":0},

{\"name\":\"Gold\",\"currency\":\"JPY\",\"uid\":\"7b3e4ebe-fac1-4b22-97b5-c8a013c0a12b\",\"amount\":\"0\",\"ratio\":0.02,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"100000\",\"raw_amount\":100000},\"raw_amount\":0},

{\"name\":\"Platinum\",\"currency\":\"JPY\",\"uid\":\"7f1f6c5d-362b-4e1b-a985-ebe6fc132ffb\",\"amount\":\"28768\",\"ratio\":0.03,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"200000\",\"raw_amount\":200000},\"raw_amount\":28768},

{\"name\":\"Diamond\",\"currency\":\"JPY\",\"uid\":\"4b196120-0d3b-48ae-90f6-bb87cf9a8d42\",\"amount\":\"128768\",\"ratio\":0.04,\"spent_requirement\":{\"currency\":\"JPY\",\"amount\":\"300000\",\"raw_amount\":300000},\"raw_amount\":128768}]

 

Related articles