Skip to main content
This page helps you read the response in two layers: first the slot, then the concrete content returned inside each slot.

Basic structure

{
  "requestId": "req_abc123",
  "slots": [
    {
      "slotId": "main-chat",
      "ads": [
        {
          "id": "ad_xyz789",
          "type": "action_card"
        }
      ]
    }
  ]
}

How to read it

  • requestId: The trace identifier for this request
  • slots: One result container for each position you requested
  • ads: The actual monetization results you need to render or consume

Common output formats

Action Card

  • Typical elements: title, description, image, brand, CTA, and tracked click link
  • Common scenarios: chat recommendation areas, result blocks, and product cards

Suffix

  • Typical elements: lightweight supporting copy and a jump link
  • Common scenarios: answer tails and low-friction enhancement placements
  • Typical elements: an enhanced entity link inside the main body text
  • Common scenarios: natural in-text enhancement

Recommendation

Before you start building frontend rendering, make sure requestId, slotId, and the returned format all work correctly in logs or a debug panel. It will make troubleshooting much faster.