Versions Compared

Old Version 58

changes.mady.by.user Lopes da Costa, Valentina

Saved on

compared with

New Version 59

changes.mady.by.user Fragalli, Andre

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Event Name

Description

Properties

Property Description

Loyalty User Created

When a Loyalty user is created. In markets where loyalty is enabled, this happens at the same time that a new user signs up.

initialPointsBalance

Points added to the account when creation (could be subject to campaigns that add points when account created)

Loyalty User Updated

Triggered every time that a user’s loyalty points are updated.

newPointsBalance

Number of points in the user’s loyalty account, after a transaction has been made.

Loyalty Transaction Created

Triggered when any type of a loyalty transaction is created, including orders and point expiration. For orders, this event is triggered when an order is initiated and the transaction is in a Pending state. At this stage, the transaction is not completed yet. It will only be marked as completed once the ordering flow completes successfully (see Loyalty Transaction Claimed below).

For example, this event would be fired when a customer logins with their Loyalty OTP code in the Kiosk successfully (even if the customer has not completed the purchase in the Kiosk yet).

bonusPointsEarned

Additional points earned via promotion.

brand

Brand, for example “BK”.

channel

Can have the following values:

  • RESTAURANT: orders made in-restaurant

  • WEB: orders made on the web app

  • APP: orders made on the iOS or Android apps

  • INITIAL_POINT_BALANCE: we have certain markets that want brand new users to have a balance (i.e. sign up and get 100 pts). The INITIAL_POINT_BALANCE channel tracks those

  • POINTS_EXPIRATION: when points expire

  • CAMPAIGN: campaign is for transactions done via Braze campaigns that brands have setup

  • SUPPORT: when loyalty points are awarded to the user via the Support tool

  • REMEDIATION: REMEDIATION is for scripts that we've had to run to fix user balances

createdAt

Date and time when the transaction was created

offers

Offers redeemed on this transaction, if any

offersSanityIds

Sanity ID's for each offer redeemed in this transaction, if any

Partner

The partner that requested the loyalty points assignment

pointsEarned

Base points earned

pointsUsed

Points used to redeem

posType

The type of POS from where this transaction was created. For example, NCR, SYCOM. TABLET corresponds specifically to the RBI tablet in use in some markets.

posSystem

Specific POS vendor name, for example: ncr, Acrelec, Xenial Encounter.

rbiOrderId

The associated RBI Order Id

fulfillmentType

The fulfillment channel for the transaction. Can have one of the following values:

  • POS

  • TAKEOUT

  • DRIVE_THRU

  • EAT_IN

  • DELIVERY

  • CURBSIDE

  • POINT_ASSIGNMENT

restaurantId

Restaurant ID related to a purchase

rewards

The rewards redeemed in this transaction

rewardsSanityIds

The Sanity ids for each reward in this transaction

shortId

Autogenerated code for easy lookup via support tool

Store Has Loyalty

MDM loyalty assignment

  • Feature flag: Differentiating Between Loyalty and Non-Loyalty Stores for In-Store Orders

storeId

MDM assigned store number

subTotal

The total for the order

systemWidePromotions

The promotions redeemed with this transaction

totalPoints

User's total loyalty points post transaction

transactionStatus

The current status of the transaction:

  • PENDING: this will. be the status for all loyalty transactions created during the ordering process

  • CLAIMED: for non-ordering operations e.g. points expiry

  • UNCLAIMED

  • VOID

Loyalty Transaction Claimed

When an order completes successfully, loyalty transactions that were previously in a Pending state change to Claimed and this event is triggered.

Note

Note: Online transaction Claimed scenario is not covered by this event.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

Loyalty Cart Data

Cart data of the order.

  • Required properties: price, productId and quantity.

  • Optional properties: couponId, incentivePlu, lineId, name, parentReferenceId, plu, productType, rootReferenceId and tax.

In-Store Loyalty Transaction Claimed

Shorthand for Loyalty Transaction Claimed when channel is RESTAURANT.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

payAtCounter

Note

Note: Only when the transaction is created and claimed in different POS/Kiosk vendor

The posSystem different vendors from when transaction was created to when it was finalized, e.g. Tillster-Toshiba

Loyalty Cart Data

Cart data of the order.

  • Required properties: price, productId and quantity.

  • Optional properties: couponId, incentivePlu, lineId, name, parentReferenceId, plu, productType, rootReferenceId and tax.

Online Loyalty Transaction Claimed

Shorthand for Loyalty Transaction Claimed when channel is APP or WEB.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

Loyalty Cart Data

Cart data of the order.

  • Required properties: price, productId and quantity.

  • Optional properties: couponId, incentivePlu, lineId, name, parentReferenceId, plu, productType, rootReferenceId and tax.

Loyalty Points Expiring

When the user points are about to expire, an event indicating the amount of points and the future expiration date is fired. Triggered on defined days away: 1, 3, 7, 30, 60.

Note

Note: This event is only for points Expiration By Inactivity, not for Expiration By Issue Date.

daysAway

Days away from expiration of points (e.g. 14)

pointsAtRisk

Amount of points that will expire by the moment the event is triggered (e.g. 250)

pointsExpiryDate

Date of the expiration of points (e.g. 10/5/2022)

Loyalty Points Expired

Triggered when user points have expired.

channel

See Loyalty Transaction Created / channel

pointsEarned

Base points earned

pointsUsed

Points used to redeem

shortId

Autogenerated code for easy lookup via support tool

id

Unique Identifier for points expiration event

subTotal

The total for the order

brand

Brand from which the points have expired (e.g. BK)

transactionStatus

See Loyalty Transaction Created / transactionStatus

pointsDeducted

Amounts getting expired for not being used

createdAt

Date and time when the event was triggered

Loyalty Transaction Voided

When an order is voided.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

payAtCounter

Note

Note: Only when the transaction is created and voided in different POS/Kiosk vendor

The posSystem different vendors from when transaction was created to when it was finalized, e.g. Tillster-Toshiba

Loyalty Transaction Deleted

When a transaction is deleted this event is fired indicating the total points the user has after the rollback. Only Transactions that are in Pending which were created through the OTP process can be deleted.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

Max Transaction Limit Reached

Triggered when the maximum transactions limit is reached for a given user. This is an optional configuration setting that sets a "cap" of how many daily transactions a given user can earn points towards.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

...

Event Name

Description

Properties

Property Description

External Offer Selected

User clicked on an offer from the offers list and saw the offer description.

name

Offer name, e.g. “£4.99 CHICKEN or VEGAN ROYAL”

sanityId

Sanity ID of the offer

External Offer Added to Order

When redemptionMode is In-Store, this event is triggered when the user clicks on the “Use my Discount“ button. This event is triggered before the modal appears, letting the user know they will be redirected to the external partner’s website.

name

Offer name, e.g. “£4.99 CHICKEN or VEGAN ROYAL”

sanityId

Sanity ID of the offer

External Offer Redeemed

This event is only triggered after the user in the confirmation modal clicks on the button that redirects the user to the external offer’s partner website.

name

Offer name, e.g. “£4.99 CHICKEN or VEGAN ROYAL”

sanityId

Sanity ID of the offer

createdAt

Date and time when the External Offer was redeemed

...

Reward Redeemed Online

Triggered when a reward is redeemed during a purchase where channel is WEB or APP

Event Name

Description

Properties

Property Description

Reward Selected

User clicked on the reward from reward list and saw the reward description.

name

Reward name, e.g. “Bacon Double XL Cheese Meal“

sanityId

Sanity ID of the offer

Status

Locked , Unlocked

Category

200, 400 , 600…

Reward Added to Order

User added a reward to their order cart.

Same as Reward Selected

Same as Reward Selected

Reward Redeemed

This is an event configured in Amplitude, combining Reward Redeemed In-store and Reward Redeemed Online.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

Reward Redeemed In Store

Triggered when a reward is redeemed during a purchase where channel is RESTAURANT.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

payAtCounter

Note

Note: Only when the transaction is created and claimed in different POS/Kiosk vendor

The posSystem different vendors from when transaction was created to when it was finalized, e.g. Tillster-Toshiba

Offer Assignment

Triggered when the Offer Assignment endpoint receives a request from a partner.

Duration

The duration in ms of the offer assignment process from the time the request is received until it is finished.

engineId

The Loyalty Engine ID of the configurable offer from the sanity page.

Partner

The partner that requested the offer assignment.

Reference

An optional property where the partner can send the reason or event that generated the request for this offer assignment.

Status

Successful or Error.

traceId

The ID of the offer assignment process.

ErrorDescription

The error that happened. (Only for the Error status)

Rewards

Event Name

Description

Properties

Property Description

Quest Activated

When a Quest/Challenge is activated by an user

totalStepsCount

Total # of steps in the Quest

activatedOn

Quest has been activated

incentiveId

refers to the CONFIG Offer or Reward ID if the Quest is type OFFER or REWARD respectively.

configId

UID for the personalized quest that is

Event Name

Description

Properties

Property Description

Reward Selected

User clicked on the reward from reward list and saw the reward description.

name

Reward name, e.g. “Bacon Double XL Cheese Meal“

sanityId

Sanity ID of the offer

Status

Locked , Unlocked

Category

200, 400 , 600…

Reward Added to Order

User added a reward to their order cart.

Same as Reward Selected

Same as Reward Selected

Reward Redeemed

This is an event configured in Amplitude, combining Reward Redeemed In-store and Reward Redeemed Online.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

Quests / Challenges

Quest events are related to the Challenges feature documented here: Loyalty Challenges UI.

Reward Redeemed In Store

Triggered when a reward is redeemed during a purchase where channel is RESTAURANT.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

payAtCounter

Note

Note: Only when the transaction is created and claimed in different POS/Kiosk vendor

The posSystem different vendors from when transaction was created to when it was finalized, e.g. Tillster-Toshiba

Reward Redeemed Online

Triggered when a reward is redeemed during a purchase where channel is WEB or APP.

Same as Loyalty Transaction Created

Same as Loyalty Transaction Created

Quests / Challenges

Quest events are related to the Challenges feature documented here: Loyalty Challenges UI.

Event Name

Description

Properties

Property Description

Quest Activated

When a Quest/Challenge is activated by an user

totalStepsCount

Total # of steps in the Quest

activatedOn

Quest has been activated

incentiveId

refers to the CONFIG Offer or Reward ID if the Quest is type OFFER or REWARD respectively.

configId

UID for the personalized quest that is created for each specific user that activates a quest

stepsCompletedCount

Total # of steps completed

incentiveType

Type of Incentive (Reward or Offer)

loyaltyId

Loyalty ID associated with the User

name

Name associated with the Quest

createdAt

When was the transaction created

questId

ID associated with the Quest

Quest Step Completed

When a step as part of a Quest/Challenge is completed by an user

activatedOn

Quest has been activated

loyaltyId

Loyalty ID associated with the User

totalStepsCount

Total # of steps in the Quest

incentiveType

Type of Incentive (Reward or Offer)

stepsCompletedCount

Total # of steps completed

name

Name associated with the Quest

questId

ID associated with the Quest

createdAt

When was the transaction created

Quest Completed

When a Quest/Challenge is completed by an user

*For Invitation Code on Signup, this event is triggered by New user (user that signed up with Invitation Code that was shared from existing app user)

benefitId

refers to the the ID generated when the quest is completed. This can be the ID of: a personalized Offer or Reward if the quest is of type  OFFER or REWARD a transaction generated to grant points, if the quest is of type BONUS_POINTS

loyaltyId

Loyalty ID associated with the User

incentiveType

Type of Incentive (Reward or Offer)

stepsCompletedCount

Total # of steps completed

completedAt

When was the quest completed

name

Name associated with the Quest

totalStepsCount

Total # of steps in the Quest

questId

ID associated with the Quest

createdAt

When was the transaction created

Buddy Benefited from Quest Completion

When a Quest/Challenge is completed by an user and the benefit is also unlocked for Buddy users

*For Invitation Code on Signup, this event is triggered by Existing user (user from the app that shared his/her Invitation Code with a friend)

existingUserLoyaltyId

Loyalty ID associated with the Quest Buddy User (did not complete Quest steps)

name

Object with information on existing user data

newUserLoyaltyId

Loyalty ID associated with main user that completed Quest Steps

questId

ID associated with the Quest

email

email of Quest Buddy user

rbiCognitoId

User ID of Quest Buddy user

...

My Code page

Event Name

Description

Properties

Property Description

Loyalty Load

Triggered after the page loads.

loads.

My Code page load time

This property describes the amount of time in milliseconds that the My Code page took to load.

My Code page QR code load time

This property describes the amount of time in milliseconds that the QR Code on the My Code page took to load and be visible.

Rewards page load time

This property describes the amount of time in milliseconds that the Rewards page took to load.

Offers page load time

This property describes the amount of time in milliseconds that the Offers page took to load.

Offer Redemption page load time

This property describes the amount of time in milliseconds that the Offer Redemption modal page for static code took to load.

Offer Redemption page QR Code load time

This property describes the amount of time in milliseconds that the Offer Redemption modal QR Code took to load. This will only be sent if QR Code is enabled.

Offer Redemption page Short Code load time

This property describes the amount of time in milliseconds that the My Code page Offer Redemption modal offer short code took to load.

My Code page QR code load time

This property describes the amount of time in milliseconds that the QR Code on the My Code page took to load and be visible.

Rewards page load time

This property describes the amount of time in milliseconds that the Rewards page took to load.

Offers page load time

This property describes the amount of time in milliseconds that the Offers page took to load.

Offer Redemption page load time

This property describes the amount of time in milliseconds that the Offer Redemption modal page for static code took to load.

Offer Redemption page QR Code load time

This property describes the amount of time in milliseconds that the Offer Redemption modal QR Code took to load. This will only be sent if QR Code is enabled.

Offer Redemption page Short Code load time

This property describes the amount of time in milliseconds that the Offer Redemption modal offer short code took to load.

QR and Short code Error

Triggered when the QR and Short code cannot be generated.

Message

This property refers to a string in Lokalise (qrCodeLoyaltyCreationError), informing that there is an error when creating the QR and Short code.

rootCause

This property refers to the root cause why the QR Code cannot be generated

QR and Short code Error

Triggered when the QR and Short code cannot be generated.

Message

This property refers to a string in Lokalise (qrCodeLoyaltyCreationError), informing that there is an error when creating the QR and Short code.

rootCause

This property refers to the root cause why the QR Code cannot be generated

Points

Event Name

Description

Properties

Property Description

Loyalty Points Assignment

Triggered when the Loyalty Points Assignment endpoint receives a request from a partner.

Duration

The duration in ms of the loyalty points assignment process from the time the request is received until it is finished.

Partner

The partner that requested the loyalty points assignment.

pointsDeducted

How many points were deducted from the user.

pointsEarned

How many points the user earned.

Reference

An optional property where the partner can send the reason or event that generated the request for this loyalty points assignment.

Status

Successful or Error.

TransactionId

The id of the transaction created for the points assignment. (Only for the Successful status)

ErrorDescription

The error that happened. (Only for the Error status)