Developer Payload Example

The Developer Payload parameter lets you attach custom metadata to every gameplay session. By tagging sessions with contextual information, you unlock richer AI-powered analysis in the 6Labs dashboard. The use cases below apply to both Unity and Unreal Engine integrations. The field names in the examples are illustrative. The Developer Payload is free-form, so structure it with whatever fields suit the analysis you need.

1. A/B Test Analysis

Pass your experiment variant in the Developer Payload to segment sessions by test group and compare gameplay metrics across cohorts directly in the 6Labs dashboard.

Example payload

{ "experiment": "onboarding_flow_v2",
"variant": "variant_a or variant_b"
}

What you can do

  • Compare sessions side-by-side across variant_a and variant_b.
  • Identify which variant leads to fewer friction points or longer engagement.
  • Use AI-powered agents to surface behaviour differences between cohorts without manual review.

2. User Segment Behaviour

Tag sessions with your user classification to understand how different player types interact with your game.

Example payload

{ "segment": "whale",
"days_since_install": 45
}

What you can do

  • Filter the dashboard by segment (new, returning, whale) to review segment-specific sessions.
  • Detect onboarding friction that only affects new players.
  • Understand what high-value players do differently compared to churned users.

3. Campaign Attribution

Include acquisition channel and campaign ID so gameplay behaviour can be traced back to specific marketing campaigns.

Example payload

{ "acquisition_channel": "meta_ads",
"campaign_id": "camp_summer_2026"
}

What you can do

  • Correlate campaign spend with actual in-game behaviour, not just install counts.
  • Identify which acquisition channels bring players who engage deeply versus those who churn quickly.
  • Surface sessions from a specific campaign to validate creative messaging alignment with gameplay expectations.

4. Friction Point Detection

Combine user segment and progression data in the Developer Payload to pinpoint exactly where specific player groups drop off.

Example payload

{ "segment": "new",
"level": 3,
"tutorial_completed": false
}

What you can do

  • Filter sessions by players who did not complete the tutorial to observe their experience.
  • Use SixthSense agents to detect common patterns in sessions where players stopped playing.
  • Validate fixes by comparing post-patch sessions with the same segment tag.

5. Feature Validation

Tag sessions with a feature flag or build version to validate whether a newly shipped feature is working as intended for real players.

Example payload

{ "build_version": "2.4.1",
"feature_flag": "new_inventory_ui"
}

What you can do

  • Review sessions from build 2.4.1 to see how players interact with the new inventory UI.
  • Compare behaviour before and after the feature release using sessions.
  • Quickly identify regressions by reviewing sessions tagged with the feature flag during rollout.

Passing the Developer Payload

The Developer Payload is a single string parameter. The example payloads above are illustrative JSON — serialize your metadata to a JSON string before passing it to Init() or StartSession(). For example, in Unity (C#):

// Serialize your metadata to a JSON string
string payload = JsonUtility.ToJson(myData);
// or, with Newtonsoft.Json: JsonConvert.SerializeObject(myData)
SixLabsSDK.Instance.StartSession(inGameId, payload);

See the Unity SDK or Unreal SDK documentation for the exact method signatures.

Table of Contents

Developer Payload Example

Table of Contents

Document Rev. 1.0

Text copied to clipboard
Link copied to clipboard
Questions? Please reach out to us at dev-support@6labs.ai