Tier

A tier is a level or slab within a loyalty program that customers can move up, renew, or be downgraded from based on their engagement with the brand.

Tier Upgraded (tierUpgraded)

Notifies when a user's tier is upgraded.

{
    "eventName": "tierUpgraded",
    "eventId": "fac88937-7740-48a3-b34e-fcfedb1f57a0",
    "orgId": 50261,
    "refId": "50261_vdFdiTjSeg",
    "apiRequestId": "ac70134fac73752691f861aa94dd4678",
    "createdAt": 1724058034369,
    "data": {
      "customerIdentifiers": {
        "customerId": 347266498,
        "instore": {
          "mobile": "919817074381",
          "cardNumbers": []
        }
      },
      "entityInformation": {
        "entityType": "USER",
        "entityId": 347266498
      },
      "loyaltyProgramDetails": {
        "id": 978,
        "name": "Prateek_test23DefaultProgram",
        "isDefault": true,
        "pointsToCurrencyRatio": 1,
        "tiers": [
          {
            "tierNumber": 1,
            "tierName": "silver"
          },
          {
            "tierNumber": 2,
            "tierName": "GOLD"
          },
          {
            "tierNumber": 3,
            "tierName": "diamond"
          }
        ]
      },
      "loyaltyProgramId": 978,
      "previousTierNumber": 1,
      "upgradedTierNumber": 2,
      "tierExpiryDate": "2124-08-19",
      "tierExpiryDateInMillis": 4879765799000, ////Post timezone standardisation
      "notes": "Upgrading to Slab : Slab[2]: Name [GOLD] Description [gold] , Criteria: Primary",
      "upgradeType": "STRATEGY"
    },
    "loyaltyEventId": "vdFdiTjSeg"
  }
{
  "eventName": "tierUpgraded",
  "eventSearchKey": "data.customerIdentifiers.customerId",
  "eventLogId": 5232,
  "data": {
    "currentDateStoreTz": "2024-07-08",
    "notes": "ZNYFZ",
    "previousTierNumber": 4260,
    "tierExpiryDate": "OWODMWNRM",
    "tierExpiryDateInMillis": 4917801599999,
    "loyaltyProgramDetails": {
      "id": 2725,
      "name": "XTOKVNSB",
      "isDefault": false,
      "pointsToCurrencyRatio": 8542.699354459714,
      "tiers": [
        {
          "tierNumber": 4693,
          "tierName": "SJUPWOJ"
        }
      ]
    },
    "entityInformation": {
      "entityType": "ZEI",
      "entityId": 1199
    },
    "customerIdentifiers": {
      "loyaltyType": "QJNJKTUU",
      "ecommerce": {
        "accounts": [
          {
            "accountId": "DKD",
            "identifiers": [
              {
                "identifierType": "MWHULAV",
                "identifierValue": "URNLSNQYO"
              }
            ]
          }
        ]
      },
      "lastName": "FJGTJ",
      "facebook": {
        "accounts": [
          {
            "accountId": "DPK",
            "identifiers": [
              {
                "identifierType": "XBBWG",
                "identifierValue": "XWDRJH"
              }
            ]
          }
        ]
      },
      "wechat": {
        "accounts": [
          {
            "accountId": "QHPETVS",
            "identifiers": [
              {
                "identifierType": "ODXVTK",
                "identifierValue": "YUH"
              }
            ]
          }
        ]
      },
      "tmall": {
        "accounts": [
          {
            "accountId": "NHDRI",
            "identifiers": [
              {
                "identifierType": "HNIC",
                "identifierValue": "AUDEVXO"
              }
            ]
          }
        ]
      },
      "toabao": {
        "accounts": [
          {
            "accountId": "SVU",
            "identifiers": [
              {
                "identifierType": "QIVA",
                "identifierValue": "KZKOAPMQJO"
              }
            ]
          }
        ]
      },
      "web_engage": {
        "accounts": [
          {
            "accountId": "TSTCLPVKC",
            "identifiers": [
              {
                "identifierType": "DEDYPN",
                "identifierValue": "YOF"
              }
            ]
          }
        ]
      },
      "line": {
        "accounts": [
          {
            "accountId": "VYAPLA",
            "identifiers": [
              {
                "identifierType": "SECCOKBTWQ",
                "identifierValue": "RILCU"
              }
            ]
          }
        ]
      },
      "martjack": {
        "accounts": [
          {
            "accountId": "JPP",
            "identifiers": [
              {
                "identifierType": "TJKZOVGGKB",
                "identifierValue": "HMPCQPB"
              }
            ]
          }
        ]
      },
      "customerId": 3081,
      "jd": {
        "accounts": [
          {
            "accountId": "WHYYPC",
            "identifiers": [
              {
                "identifierType": "VORANAOX",
                "identifierValue": "DUI"
              }
            ]
          }
        ]
      },
      "website": {
        "accounts": [
          {
            "accountId": "KQNHPJ",
            "identifiers": [
              {
                "identifierType": "MGQ",
                "identifierValue": "GUY"
              }
            ]
          }
        ]
      },
      "firstName": "DTCBBHGFKX",
      "instore": {
        "id": 5544,
        "mobile": "PQHMRG",
        "email": "OSYGOGDXDG",
        "externalId": "KKA",
        "cardnumber": "LCT",
        "cardexternalid": "YDVAEIYCFL",
        "cardNumbers": [
          "TSORJHMU"
        ]
      }
    },
    "upgradedTierNumber": 9270,
    "upgradeType": "GKP",
    "triggeringActivity": {
      "name": "ZHJNOK",
      "identifiers": [
        {
          "key": "MDFAPG",
          "value": "UYTSCNPS"
        }
      ],
      "enteredBy": {
        "id": 8289,
        "till": {
          "code": "UMX",
          "name": "ONYZAOOVR"
        },
        "store": {
          "code": "LHZEHJSX",
          "name": "ARHU",
          "externalId": "TJOLGKUFTB",
          "externalId1": "ZLYTOQZY",
          "externalId2": "VIEYCFLBQQ"
        }
      },
      "entityInformation": {
        "entityType": "HFAIGFCXRX",
        "entityId": 2749
      },
      "additionalAttributes": [
        {
          "key": "RKTCN",
          "value": "BETUNX"
        }
      ]
    },
    "loyaltyProgramId": 6624
  },
  "refId": "OWMFQV",
  "loyaltyEventId": "LKSPPKRWDG",
  "apiRequestId": "CMBN",
  "eventId": "HHVK",
  "createdAt": 7928,
  "traceAttributes": {
    "x-cap-lineage-id": "660658b1-e59b-489e-a5b8-35a630b172a5",
    "x-cap-lineage-start": "1762178042548"
  },
  "orgId": 6564
}

Tier Renewed Event (tierRenewed)

Notifies when a user's tier has been renewed.

{
    "eventName": "tierRenewed",
    "eventId": "b83dd0af-6035-48c0-9c69-87a31dd7c285",
    "orgId": 50261,
    "refId": "50261_STRING9_50261_978_s2_b1",
    "apiRequestId": "3924604f-f914-473f-b94a-6e95f2e2c0c6",
    "createdAt": 1724062364202,
    "data": {
      "customerIdentifiers": {
        "customerId": 347266801
      },
      "entityInformation": {
        "entityType": "USER",
        "entityId": 347266801
      },
      "loyaltyProgramDetails": {
        "id": 978,
        "name": "Prateek_test23DefaultProgram",
        "isDefault": true,
        "pointsToCurrencyRatio": 1,
        "tiers": [
          {
            "tierNumber": 1,
            "tierName": "silver"
          },
          {
            "tierNumber": 2,
            "tierName": "GOLD"
          },
          {
            "tierNumber": 3,
            "tierName": "diamond"
          }
        ]
      },
      "loyaltyProgramId": 978,
      "currentTierNumber": 2,
      "tierExpiryDate": "2024-10-19",
      "tierExpiryDateInMillis": 1729362599000 //Post timezone standardisation
    }
{
  "eventName": "tierRenewed",
  "eventSearchKey": "data.customerIdentifiers.customerId",
  "eventLogId": 3056,
  "data": {
    "currentDateStoreTz": "2024-07-08",
    "notes": "EAZS",
    "tierExpiryDate": "KSBBVAHJD",
    "tierExpiryDateInMillis": 1764547199000,
    "loyaltyProgramDetails": {
      "id": 7746,
      "name": "EUBQTC",
      "isDefault": false,
      "pointsToCurrencyRatio": 4919.754038258829,
      "tiers": [
        {
          "tierNumber": 6318,
          "tierName": "XSPH"
        }
      ]
    },
    "currentTierNumber": 2762,
    "renewType": "KKZ",
    "entityInformation": {
      "entityType": "BIZQU",
      "entityId": 4853
    },
    "customerIdentifiers": {
      "loyaltyType": "HODK",
      "ecommerce": {
        "accounts": [
          {
            "accountId": "JRWWJKSBUX",
            "identifiers": [
              {
                "identifierType": "PIQCCFDMM",
                "identifierValue": "ALVA"
              }
            ]
          }
        ]
      },
      "lastName": "EMEQSVCOAD",
      "facebook": {
        "accounts": [
          {
            "accountId": "LXKBZFOYHM",
            "identifiers": [
              {
                "identifierType": "UHW",
                "identifierValue": "YOEZTFVD"
              }
            ]
          }
        ]
      },
      "wechat": {
        "accounts": [
          {
            "accountId": "EMHIRBSO",
            "identifiers": [
              {
                "identifierType": "OMOGJZR",
                "identifierValue": "JGVDTQZEE"
              }
            ]
          }
        ]
      },
      "tmall": {
        "accounts": [
          {
            "accountId": "KCIO",
            "identifiers": [
              {
                "identifierType": "XTX",
                "identifierValue": "DFT"
              }
            ]
          }
        ]
      },
      "toabao": {
        "accounts": [
          {
            "accountId": "JSR",
            "identifiers": [
              {
                "identifierType": "PRGPEA",
                "identifierValue": "KAJXP"
              }
            ]
          }
        ]
      },
      "web_engage": {
        "accounts": [
          {
            "accountId": "NYMAVAM",
            "identifiers": [
              {
                "identifierType": "KXSRCSCWAG",
                "identifierValue": "QZSZDAQWRN"
              }
            ]
          }
        ]
      },
      "line": {
        "accounts": [
          {
            "accountId": "AUWR",
            "identifiers": [
              {
                "identifierType": "IOLDJFIMRU",
                "identifierValue": "OUDCO"
              }
            ]
          }
        ]
      },
      "martjack": {
        "accounts": [
          {
            "accountId": "VPJBOJA",
            "identifiers": [
              {
                "identifierType": "ETUS",
                "identifierValue": "BCQDUFRAVJ"
              }
            ]
          }
        ]
      },
      "customerId": 5959,
      "jd": {
        "accounts": [
          {
            "accountId": "UMNXDZW",
            "identifiers": [
              {
                "identifierType": "STHCQ",
                "identifierValue": "ZIRTUUBF"
              }
            ]
          }
        ]
      },
      "website": {
        "accounts": [
          {
            "accountId": "PDFYZ",
            "identifiers": [
              {
                "identifierType": "MUQMGBPZV",
                "identifierValue": "VXGLGUC"
              }
            ]
          }
        ]
      },
      "firstName": "ZDIRFJ",
      "instore": {
        "id": 138,
        "mobile": "XRJSE",
        "email": "NSRHEA",
        "externalId": "HIUDPY",
        "cardnumber": "SSPD",
        "cardexternalid": "OXSG",
        "cardNumbers": [
          "XYEAJ"
        ]
      }
    },
    "triggeringActivity": {
      "name": "NGDZMWZO",
      "identifiers": [
        {
          "key": "NPUCCZAEX",
          "value": "NBPWDBX"
        }
      ],
      "enteredBy": {
        "id": 2742,
        "till": {
          "code": "ETQMUQRR",
          "name": "SFGIANG"
        },
        "store": {
          "code": "JJBDHBP",
          "name": "IVUPMZ",
          "externalId": "JCIOOTOTS",
          "externalId1": "PPJ",
          "externalId2": "BTWCKSBHCB"
        }
      },
      "entityInformation": {
        "entityType": "URYLCYG",
        "entityId": 369
      },
      "additionalAttributes": [
        {
          "key": "ENZGM",
          "value": "ROG"
        }
      ]
    },
    "loyaltyProgramId": 7413
  },
  "refId": "DJELPVDBB",
  "loyaltyEventId": "XFB",
  "apiRequestId": "WWC",
  "eventId": "DVSZKK",
  "createdAt": 4875,
  "traceAttributes": {
    "UFQ": "PNAXV",
    "MBNVYGO": "LXXPLPAG",
    "LAM": "YLKJCHZXXS",
    "FPITNPJCI": "QCSLQNZLI",
    "LRGCTET": "CMM"
  },
  "orgId": 933
}

Tier Downgraded Event (tierDowngraded)

Notifies when a user's tier is downgraded. Includes the downgraded tier information.

{
    "eventName": "tierDowngraded",
    "eventId": "647072c7-1ad5-4efe-9d03-a7c2ed41e07b",
    "orgId": 50261,
    "refId": "50261_STRING8_50261_978_s2_b1",
    "apiRequestId": "dba32835-a551-470f-b4e1-860d597879e5",
    "createdAt": 1724062196121,
    "data": {
      "customerIdentifiers": {
        "customerId": 347266672
      },
      "entityInformation": {
        "entityType": "USER",
        "entityId": 347266672
      },
      "loyaltyProgramDetails": {
        "id": 978,
        "name": "Prateek_test23DefaultProgram",
        "isDefault": true,
        "pointsToCurrencyRatio": 1,
        "tiers": [
          {
            "tierNumber": 1,
            "tierName": "silver"
          },
          {
            "tierNumber": 2,
            "tierName": "GOLD"
          },
          {
            "tierNumber": 3,
            "tierName": "diamond"
          }
        ]
      },
      "loyaltyProgramId": 978,
      "downgradedTierNumber": 1,
      "previousTierNumber": 2,
      "tierExpiryDate": "2124-09-19",
      "tierExpiryDateInMillis": 4882444199000 ////Post timezone standardisation
    },
    "loyaltyEventId": null
  }
{
  "eventName": "tierDowngraded",
  "eventSearchKey": "data.customerIdentifiers.customerId",
  "eventLogId": 1825,
  "data": {
    "currentDateStoreTz": "2024-07-08",
    "customerIdentifiers": {
      "loyaltyType": "YOODUYCJUP",
      "ecommerce": {
        "accounts": [
          {
            "accountId": "YGJNCHBQI",
            "identifiers": [
              {
                "identifierType": "JSM",
                "identifierValue": "OFJHYK"
              }
            ]
          }
        ]
      },
      "lastName": "QOR",
      "facebook": {
        "accounts": [
          {
            "accountId": "WAK",
            "identifiers": [
              {
                "identifierType": "XEXQUHH",
                "identifierValue": "AWXSRHOWJZ"
              }
            ]
          }
        ]
      },
      "wechat": {
        "accounts": [
          {
            "accountId": "DTJF",
            "identifiers": [
              {
                "identifierType": "HHMEZF",
                "identifierValue": "KQGUTL"
              }
            ]
          }
        ]
      },
      "tmall": {
        "accounts": [
          {
            "accountId": "EAMMAM",
            "identifiers": [
              {
                "identifierType": "DVNEB",
                "identifierValue": "OOMOLWEXT"
              }
            ]
          }
        ]
      },
      "toabao": {
        "accounts": [
          {
            "accountId": "XBRMYXQKKP",
            "identifiers": [
              {
                "identifierType": "GKLJ",
                "identifierValue": "WOUSPZDB"
              }
            ]
          }
        ]
      },
      "web_engage": {
        "accounts": [
          {
            "accountId": "LVWSZXOES",
            "identifiers": [
              {
                "identifierType": "MKAL",
                "identifierValue": "TSVKWZEPV"
              }
            ]
          }
        ]
      },
      "line": {
        "accounts": [
          {
            "accountId": "VZJSW",
            "identifiers": [
              {
                "identifierType": "XVO",
                "identifierValue": "IVELUOCX"
              }
            ]
          }
        ]
      },
      "martjack": {
        "accounts": [
          {
            "accountId": "SPPUE",
            "identifiers": [
              {
                "identifierType": "PESE",
                "identifierValue": "DSOAANNIRC"
              }
            ]
          }
        ]
      },
      "customerId": 4685,
      "jd": {
        "accounts": [
          {
            "accountId": "UKFCIZ",
            "identifiers": [
              {
                "identifierType": "YYVR",
                "identifierValue": "EBLKH"
              }
            ]
          }
        ]
      },
      "website": {
        "accounts": [
          {
            "accountId": "MEHBFJSEYK",
            "identifiers": [
              {
                "identifierType": "YNBYEID",
                "identifierValue": "LZZ"
              }
            ]
          }
        ]
      },
      "firstName": "KCVITYKIZV",
      "instore": {
        "id": 4929,
        "mobile": "FXEC",
        "email": "FFA",
        "externalId": "BIAQNIFOYC",
        "cardnumber": "JXCSCWKY",
        "cardexternalid": "MPIIZ",
        "cardNumbers": [
          "FPNIDMM"
        ]
      }
    },
    "entityInformation": {
      "entityType": "PIZITBQFLE",
      "entityId": 3278
    },
    "triggeringActivity": {
      "name": "YEHKLD",
      "identifiers": [
        {
          "key": "LKKZOCUUVO",
          "value": "OQTN"
        }
      ],
      "enteredBy": {
        "id": 4446,
        "till": {
          "code": "NBQEIH",
          "name": "YRDJKCNRGX"
        },
        "store": {
          "code": "PGGQCP",
          "name": "LVSCRHQUAG",
          "externalId": "BMHIY",
          "externalId1": "QZJUHTRPU",
          "externalId2": "PYGG"
        }
      },
      "entityInformation": {
        "entityType": "TSLXLZHO",
        "entityId": 5950
      },
      "additionalAttributes": [
        {
          "key": "NXLL",
          "value": "DSKE"
        }
      ]
    },
    "loyaltyProgramDetails": {
      "id": 5892,
      "name": "GGUZZIBU",
      "isDefault": true,
      "pointsToCurrencyRatio": 3792.889196213459,
      "tiers": [
        {
          "tierNumber": 2117,
          "tierName": "BZEGROSGU"
        }
      ]
    },
    "loyaltyProgramId": 3332,
    "downgradedTierNumber": 8115,
    "previousTierNumber": 3282,
    "tierExpiryDate": "OMFA",
    "tierExpiryDateInMillis": 4917628799000
  },
  "refId": "QCUDRP",
  "loyaltyEventId": "LHWARCTUC",
  "apiRequestId": "GFK",
  "eventId": "QCR",
  "createdAt": 333,
  "traceAttributes": {
    "ZXGSBNT": "GUFV",
    "TUOQJZYJS": "RKETYRJTPS",
    "TBGGV": "MEVZTFTRP"
  },
  "orgId": 3346
}

Tier Downgrade Reminder Event (tierDowngradeReminder)

Notifies when a user is approaching a tier downgrade.

{
    "eventName": "tierDowngradeReminder",
    "eventId": "692e01a7-09ba-43fc-973e-1b7e3207273a",
    "orgId": 50261,
    "refId": "50261_STRING2_50261_978_s2_b1",
    "apiRequestId": "b253cf0f-9062-413b-98fc-ebc69d468552",
    "createdAt": 1724058502434,
    "data": {
      "customerIdentifiers": {
        "customerId": 347266603
      },
      "entityInformation": {
        "entityType": "USER",
        "entityId": 347266603
      },
      "loyaltyProgramDetails": {
        "id": 978,
        "name": "Prateek_test23DefaultProgram",
        "isDefault": true,
        "pointsToCurrencyRatio": 1,
        "tiers": [
          {
            "tierNumber": 1,
            "tierName": "silver"
          },
          {
            "tierNumber": 2,
            "tierName": "GOLD"
          },
          {
            "tierNumber": 3,
            "tierName": "diamond"
          }
        ]
      },
      "loyaltyProgramId": 978,
      "currentTierNumber": 2,
      "scheduledDowngradeDate": "2024-09-19"
    },
    "loyaltyEventId": null
  }
{
  "eventName": "tierDowngradeReminder",
  "eventLogId": 8730,
  "data": {
    "customerIdentifiers": {
      "loyaltyType": "REUS",
      "ecommerce": {
        "accounts": [
          {
            "accountId": "DUSRC",
            "identifiers": [
              {
                "identifierType": "VEL",
                "identifierValue": "ECTYGAMPSD"
              }
            ]
          }
        ]
      },
      "lastName": "IZVDRA",
      "facebook": {
        "accounts": [
          {
            "accountId": "EBXQG",
            "identifiers": [
              {
                "identifierType": "VNPFKSE",
                "identifierValue": "YEYVMAEO"
              }
            ]
          }
        ]
      },
      "wechat": {
        "accounts": [
          {
            "accountId": "ZMJUFNZKAV",
            "identifiers": [
              {
                "identifierType": "DZFMK",
                "identifierValue": "JOUQE"
              }
            ]
          }
        ]
      },
      "tmall": {
        "accounts": [
          {
            "accountId": "ZOT",
            "identifiers": [
              {
                "identifierType": "AAQTB",
                "identifierValue": "DVZJDIW"
              }
            ]
          }
        ]
      },
      "toabao": {
        "accounts": [
          {
            "accountId": "YDW",
            "identifiers": [
              {
                "identifierType": "IEWD",
                "identifierValue": "KFATRURK"
              }
            ]
          }
        ]
      },
      "web_engage": {
        "accounts": [
          {
            "accountId": "BBNYQKBY",
            "identifiers": [
              {
                "identifierType": "ZZKTUPERR",
                "identifierValue": "EKDMU"
              }
            ]
          }
        ]
      },
      "line": {
        "accounts": [
          {
            "accountId": "QGGPVL",
            "identifiers": [
              {
                "identifierType": "ZSTLWVP",
                "identifierValue": "CEUGDD"
              }
            ]
          }
        ]
      },
      "martjack": {
        "accounts": [
          {
            "accountId": "XPCIYUEEV",
            "identifiers": [
              {
                "identifierType": "WBI",
                "identifierValue": "QMBBCF"
              }
            ]
          }
        ]
      },
      "customerId": 8045,
      "jd": {
        "accounts": [
          {
            "accountId": "JGWXVUKWEX",
            "identifiers": [
              {
                "identifierType": "TSWSTWQP",
                "identifierValue": "VFQL"
              }
            ]
          }
        ]
      },
      "website": {
        "accounts": [
          {
            "accountId": "YCDTWEJ",
            "identifiers": [
              {
                "identifierType": "JMDF",
                "identifierValue": "NIM"
              }
            ]
          }
        ]
      },
      "firstName": "YLW",
      "instore": {
        "id": 8910,
        "mobile": "XMR",
        "email": "CFKCMKQ",
        "externalId": "IFUMGBVH",
        "cardnumber": "ABHHROZY",
        "cardexternalid": "YUEXW",
        "cardNumbers": [
          "MSSOZFKSSA"
        ]
      }
    },
    "entityInformation": {
      "entityType": "LWLFOFJP",
      "entityId": 5176
    },
    "triggeringActivity": {
      "name": "VDVH",
      "identifiers": [
        {
          "key": "DCOLQQ",
          "value": "LYYMPQFY"
        }
      ],
      "enteredBy": {
        "id": 5836,
        "till": {
          "code": "AUPABQIO",
          "name": "GTRXUNDK"
        },
        "store": {
          "code": "MHQMM",
          "name": "ETABDTYSDD",
          "externalId": "AHQOVMDRDJ",
          "externalId1": "NOYC",
          "externalId2": "UUMUWB"
        }
      },
      "entityInformation": {
        "entityType": "CDYDMBF",
        "entityId": 2237
      },
      "additionalAttributes": [
        {
          "key": "HRGCDKFGJ",
          "value": "CCVYLVUIJO"
        }
      ]
    },
    "loyaltyProgramDetails": {
      "id": 4230,
      "name": "UXN",
      "isDefault": false,
      "pointsToCurrencyRatio": 1546.2598140488274,
      "tiers": [
        {
          "tierNumber": 4219,
          "tierName": "TTD"
        }
      ]
    },
    "loyaltyProgramId": 7629,
    "currentTierNumber": 6832,
    "scheduledDowngradeDate": "HQPASI"
  },
  "refId": "HAZ",
  "loyaltyEventId": "UOJBZ",
  "apiRequestId": "CJAQXWXC",
  "eventId": "LROHUYSYGR",
  "createdAt": 9601,
  "traceAttributes": {
    "SRT": "SMAO",
    "DRXA": "AMNCQKZK",
    "GMEECZH": "NZUQ",
    "BKRCRT": "EJZJFQXVLG",
    "HBQV": "JYS"
  },
  "orgId": 3405
}