User & Chat Identification

• user.id — optional. A stable ID enables user-based ad controls. See user.
• context.id — optional. A chat ID enables controls for that conversation. See context.

• Frequency capping — limits how often the same user sees the same campaign: by default at most 20 times a day, and not for 24 hours after they click it. Needs a persistent user.id; a fresh id each session resets these limits. With context.id too, a campaign is not shown twice in the same chat within 2 minutes.
• Ad pacing — controls how often ads appear within a conversation. Uses context.id.
• Better targeting — DSPs can optimize bids on user-level signals. Needs a persistent user.id.
• Accurate analytics — your dashboard reflects real unique users and conversations.

{
  "context": {
    "id": "chat_8f2c1a",
    "chat": {
      "messages": [
        {
          "role": "user",
          "content": "What shoes are good for trail running?"
        }
      ]
    }
  },
  "user": {
    "id": "user_5d1e9b"
  }
}

​

context.id

• One context.id per conversation, not per user
• Store it in sessionStorage (browser) or generate it per conversation (server-side)
• Reset it when the user starts a new chat

​

Browser Example

function getContextId() {
  const STORAGE_KEY = 'thrad_context_id';
  let contextId = sessionStorage.getItem(STORAGE_KEY);

  if (!contextId) {
    contextId = 'chat_' + crypto.randomUUID();
    sessionStorage.setItem(STORAGE_KEY, contextId);
  }

  return contextId;
}

​

Server-Side Example

import uuid

def get_context_id():
    return f"chat_{uuid.uuid4()}"

​

user.id

• Store it in localStorage, a cookie, or your own user store
• Reuse it across sessions so DSPs can build better bidding signals
• Use anonymous UUIDs — never PII (email, name, phone, etc.)

• Generate one UUID when the session starts and reuse it for every request in that session
• Frequency capping and pacing still work within the session; cross-session targeting won’t apply
• Never mint a new id per request: that defeats capping entirely and looks like invalid traffic

​

Browser Example — Persistent

function getUserId() {
  const STORAGE_KEY = 'thrad_user_id';
  let userId = localStorage.getItem(STORAGE_KEY);

  if (!userId) {
    userId = 'user_' + crypto.randomUUID();
    localStorage.setItem(STORAGE_KEY, userId);
  }

  return userId;
}

​

Browser Example — Per session

function getUserId() {
  const STORAGE_KEY = 'thrad_user_id';
  let userId = sessionStorage.getItem(STORAGE_KEY);

  if (!userId) {
    userId = 'user_' + crypto.randomUUID();
    sessionStorage.setItem(STORAGE_KEY, userId);
  }

  return userId;
}

​

user.extended_ids

{
  "user": {
    "id": "user_5d1e9b",
    "extended_ids": {
      "emails_sha256": [
        "6db61e6dcbcf2390e4a46af426f26a133a3bee45021422fc7ae86e9136f14110"
      ],
      "phone_numbers_sha256": [
        "758fbf68945f21c416814c539ab578876c8d98fb69e6da692def92cd52417fe0"
      ]
    }
  }
}

​

Device and location

​

Next steps