administrators group

JasonL

Thanks for the follow-ups. Here are answers to your three new questions:

A1: Right now, pagination for GetSocialLeaderboard (or other social leaderboard APIs) is not supported, and adding it would be a non-trivial server-side change, not a quick configuration tweak. It’s something we’d like to improve, but it’s not on the short-term roadmap at the moment.

A2: Raising maxMultipleLeaderboardScoreLimit to 100
The maxMultipleLeaderboardScoreLimit value is configurable on a per-app basis, with a default of 10. We do try to keep this value low because GetMultiSocialLeaderboard is quite expensive on the server, but for your use case we should be able to bump it to 20 for your app so you can safely call GetMultiSocialLeaderboard([leaderboardId], 20, replaceName). We’re not normally bumping this limit to 100, but 20 is reasonable. If you’d like us to do that, just let us know your appId and we can review and apply the change.

A3: Getting only the current player’s rank/score in their friends leaderboard**
There’s no dedicated API currently that returns just “my rank among my friends” in a single call. However, you can get both the top list and your “my rank” context in one call using GetMultiSocialLeaderboard with a single leaderboardId and a leaderboardResultCount set to your truncated top‑N (e.g., 50 or 20). The response includes a selfIndex field computed server-side:

If the current player is inside the top‑N, selfIndex is their rank (0-based).
If the current player is outside the top‑N, selfIndex is -1, and you can show something like “Your rank: > N” in the UI.

JasonL

All fields are editable during the cloning step, and the Code field is also editable there. I’m not sure why it’s looking like the Code field isn’t editable for you, it should work the same whether it’s under or over the 12‑character limit.

Paul Winterhalder

Hi @gyutaelee - this has been done!

JasonL

Hi @gyutaelee,

Thanks for the follow-up. Based on the current behavior, the “first 2 API calls are free” allowance is applied across the whole request chain, not separately for the Pre-hook and the original CloudCode script. In other words, internal bridge.callAPI() usage from both executions shares the same allowance for that request/session.

So if the Pre-hook makes 1 internal API call and the original script makes 3 more, the first 2 total internal calls are free, and the remaining 2 are billed according to the normal post-free rate.

For your current version-gate use case, this does not change anything because bridge.getGlobalProperty() is not counted as an API call. But if either the Pre-hook or the original script starts using bridge.callAPI() later, the calls will pool under the same request-level allowance.

Paul Winterhalder

Ah - gotcha - that makes more sense!

We'll look into it.

Paul Winterhalder

Hi @gyutaelee ,

Are you by any chance taking an automated promotion that you had used before and just changing the dates? Or maybe changing the criteria in some other way (the xp level?)

Because that won't work. Our system keeps track of the fact that the user has participated in that promotion before - no matter what the criteria is.

I mention this because the promotion id is 6 - which of course means it was the 6th promotion ever created. I figure such a low number means you are likely re-using an existing promotion.

Just a guess though -- try creating a brand-new promotion to see if you get the same behaviour.

Paul Winterhalder

So you are saying that you want to be able to bulk import custom entities for a single user?

Paul Winterhalder

Hi @gyutaelee ,

Your approach looks good. Answers to your questions:

Is GetGlobalLeaderboardPage on the per-influencer shadow leaderboard the intended way to support paging for these large friend lists?

Well - GetGlobalLeaderboardPage() and GetGlobalLeaderboardView() return all players - not just friends. It becomes a friend leaderboard if you only put friends of the influencers on there.

For rotated leaderboards, should each shadow leaderboard use the same rotation settings as the main leaderboard?
Yes - that would make sense.
Is there a practical recommended maximum number of shadow leaderboards or mirrored score writes we should design around?
There are games in brainCloud with tens of thousands of leaderboards. Not necessarily something I think everybody should do - but definitely supported.
Would increasing maxMultipleLeaderboardScoreLimit still only be needed for the regular top-N social leaderboard path, and should that be requested through brainCloud Support?

That is intended for "candy crush map" style usage where your show an overview map of different levels - and generally just one or two of your friends at each location on the map. It's a very expensive call for us to run server-side. We don't normally bump up that limit.

Paul.

Paul Winterhalder

I should clarify - the first 2 api calls are free in a script - not the first 3.

Where did you see the document with 3? [That is old - from several years ago]

JasonL

Hi @gyutaelee ,

Based on the current brainCloud's implementation, here are the answers to your questions:

Q1: Does the Pre-hook count as a separate CloudCode execution / API count?**

Yes. The Pre-hook counts as both a separate API call and a separate CloudCode script invocation. After running, the server publishes its own analytics event with operation "RUN_HOOK-Pre_VersionGate" that increments both counts.

Q2: Does bridge.getGlobalProperty() count as an API call?**

No. bridge.getGlobalProperty() is completely free. It reads directly from the cached Game object in memory and bypasses the API call tracking pipeline entirely.

Q3: Does the "first 3 free, then 0.5 each" rule apply to hook CloudCode scripts?**

Yes, the discount applies to internal calls from any script or hook within the session.

Q4: Pass-through case: usage count breakdown

Client calls script.RUN: +1 API call
Pre-hook executes: +1 API call
bridge.getGlobalProperty() inside hook: free
Original CloudCode script: +0 (covered by the original script.RUN request)

Total external API count: 2

Q5: Blocked case: usage count breakdown

Client calls script.RUN: +1 API call
Pre-hook executes: +1 API call
bridge.getGlobalProperty() inside hook: 0 (free)
Original script: +0 (does not run, server throws before invoking it when hook returns non-200)

Total external API count: 2

The blocked case costs the same as pass-through from an API-count perspective. The only savings is that the original script's internal bridge.callAPI() calls are avoided.

Q6: Could reading a Global Property on every script.RUN become a performance or cost concern?

Performance: No. getGlobalProperty() reads from an in-memory cached Game object (ConcurrentHashMap per node) with no DB query or network call.

Cost: The hook itself adds +1 API count to every script.RUN call that has the hook attached.

Q7: Recommended caching approach for frequently-read, rarely-changed property?

The cache is already in place, no additional caching needed. brainCloud stores the Game object (including all global properties) in an in-memory cache for each server node. Cross-node invalidation is handled automatically when a global property is updated in the portal. Using bridge.getGlobalProperty() is already the optimal pattern.

Q8: Portal metrics: what can be broken down separately?

API Hook execution count: Partially available. Hooks appear within the CC script invocation counter; no hook-only counter exists.
CloudCode script execution count: Available as CC Script Invocations, but includes hooks in the same counter.
CloudCode internal API call count: Available as CC API Calls in the Monitoring dashboard.
Global Property read count: Not tracked. No metric exists for this.

administrators

Posts

Member List