SysUpdateCampaignScenarioWeights

Sets the traffic split between a campaign's scenarios. The list you pass replaces the current weight distribution. The campaign must not have ended.

The list must include the control scenario (_), every scenario in it must already exist, and the weights must be integers that add up to exactly 100. A scenario you leave out gets no traffic.

Service	Operation
campaign	SYS_UPDATE_CAMPAIGN_SCENARIO_WEIGHTS

Method Parameters

Parameter	Description
campaignCode	The campaign code whose scenario weights are being updated.
version	Version of the campaign being updated. Pass -1 to update regardless of the current version.
scenarios	Array of objects, each with a scenarioCode (string) and a weight (integer, 0–100).

Usage

http://localhost:3000

C#

// Cloud Code only. To view example, switch to the Cloud Code tab

C++

// Cloud Code only. To view example, switch to the Cloud Code tab

Obj-C

// Cloud Code only. To view example, switch to the Cloud Code tab

Java

// Cloud Code only. To view example, switch to the Cloud Code tab

JavaScript

// Cloud Code only. To view example, switch to the Cloud Code tab

Dart

// Cloud Code only. To view example, switch to the Cloud Code tab

Roblox

-- N/A

GDScript

N/A

Lua

-- Cloud Code only. To view example, switch to the Cloud Code tab

Cloud Code

var campaignCode = "SUMMER2026";
var version = -1;
var scenarios = [
    {
        "scenarioCode": "_",
        "weight": 30
    },
    {
        "scenarioCode": "A",
        "weight": 35
    },
    {
        "scenarioCode": "B",
        "weight": 35
    }
];
var campaignProxy = bridge.getCampaignServiceProxy();

var postResult = campaignProxy.sysUpdateCampaignScenarioWeights(campaignCode, version, scenarios);

Raw

{
    "service": "campaign",
    "operation": "SYS_UPDATE_CAMPAIGN_SCENARIO_WEIGHTS",
    "data": {
        "campaignCode": "SUMMER2026",
        "version": -1,
        "scenarios": [
            {
                "scenarioCode": "_",
                "weight": 30
            },
            {
                "scenarioCode": "A",
                "weight": 35
            },
            {
                "scenarioCode": "B",
                "weight": 35
            }
        ]
    }
}

JSON Response

{
    "data": {
        "campaignCode": "SUMMER2026",
        "scenarios": [
            {
                "scenarioCode": "_",
                "weight": 30
            },
            {
                "scenarioCode": "A",
                "weight": 35
            },
            {
                "scenarioCode": "B",
                "weight": 35
            }
        ],
        "version": 3,
        "updatedAt": 1811732400000
    },
    "status": 200
}

The returned version is the campaign's new version after the update.

Common Error Codes

Status Codes

Code	Name	Description
40345	MISSING_RECORD	No campaign exists for the specified campaignCode.
40345	MISSING_RECORD	No scenario exists for the specified campaignCode and scenarioCode.
40001	INVALID_REQUEST	The campaign has ended, the control scenario (_) is missing from scenarios, or the weights do not add up to 100.
40332	UPDATE_FAILED	The weights could not be saved. This includes the case where version no longer matches the campaign — re-read and retry.
40616	CLOUD_CODE_ONLY_METHOD	The method was called from a client. It can only be called from Cloud Code or S2S.
40731	FEATURE_NOT_SUPPORTED_BY_BILLING_PLAN	Billing plan does not include the Campaign feature. Requires a plan that includes Enterprise features.