Does GetEligiblePromotions trigger Automated Promotions in real-time after XP level update?

gyutaelee

We have an Automated Promotion tied to a segment condition: experienceLevel >= 4.

Our flow is:

Server calls incrementExperiencePoints() via CloudCode → player reaches level 4
Client immediately calls GetEligiblePromotions (client-side CAPI)
The promotion is not returned

However, if the player restarts the app and logs in again, GetEligiblePromotions does return the promotion correctly.

Questions:

Does GetEligiblePromotions evaluate segment conditions in real-time against current player state, or does it rely on a cached/pre-calculated segment membership?
If there is a delay between incrementExperiencePoints and when the promotion becomes available via GetEligiblePromotions, how long is that delay typically?
Is there a way to force immediate promotion triggering when a player's level changes mid-session?

JasonL

Hi, GetEligiblePromotions is snapshot-driven, not fully real-time. It relies on a cached promotion-eligibility snapshot stored on the UserProfile, which is only refreshed at specific points.

GetEligiblePromotions does not reevaluate Automated Promotion segment conditions (like experienceLevel >= 4) against the latest player state on every call. Instead, it uses the last calculated promotion snapshot that was written to the UserProfile. That snapshot is normally refreshed at login, or when you explicitly call the RefreshPromotions CAPI.
Because of that, the “delay” you are seeing is essentially “until the next snapshot refresh.” In your current flow, that refresh happens on the next login, which is why restarting the app makes the promotion suddenly appear. There is no fixed time-based delay; it is purely tied to when the snapshot is updated.
To make the promotion available immediately mid-session, add an explicit refresh step to your flow. After your CloudCode call to incrementExperiencePoints (once the player has reached level 4), call RefreshPromotions on the client, and then call GetEligiblePromotions. That will force an immediate refresh of the promotion snapshot so the level-4 promotion is returned without requiring a new session.

API details for RefreshPromotions:
https://docs.braincloudservers.com/api/capi/appstore/refreshpromotions.

gyutaelee

It's been resolved. Thank you for your response!