Skip to main content

​
User Context

Provide user information for better ad targeting: 
{
  "userContext": {
    "userId": "user-123",
    "sessionId": "session-abc",
    "demographics": {
      "country": "US",
      "language": "en"
    },
    "profile": {
      "interests": ["technology", "gaming"],
      "behavior": {
        "preferredTopics": ["AI", "software"],
        "interactionStyle": "technical"
      }
    }
  }
}

​
Demographics

FieldTypeDescription
countrystringISO country code
languagestringISO language code

​
User Profile

FieldTypeDescription
interestsstring[]User interests
behavior.preferredTopicsstring[]Preferred topics
behavior.interactionStylestringInteraction style preference
purchaseIntent.categoriesstring[]Product categories of interest
purchaseIntent.timelinestringPurchase timeline

​
Ad Slots

Define ad placements in your interface: 
{
  "slots": [
    {
      "slotId": "main-chat",
      "format": "action_card",
      "count": 3,
      "placement": "post_response"
    }
  ]
}

​
Slot Configuration

FieldTypeRequiredDescription
slotIdstringYesUnique slot identifier
formatstringYesAd format type
countnumberYesNumber of ads (1-10)
placementstringNoPlacement timing