Skip to main content

​
CPC Click Event Schema

​
Overview

Event emitted when a user clicks or engages with an ad. Triggers CPC billing unless a later CPA event supersedes it.

​
Required Fields

FieldTypeDescription
event_typestringAlways cpc_click.
serve_tokenstringServe token from the AuctionResult.
session_idstringSession identifier from the PlatformRequest.
platform_idstringPlatform emitting the click (e.g., pf_openai_chat).
brand_agent_idstringWinning Brand Agent ID.
wallet_idstringWallet to debit for this event.
pricingobjectMust include unit: "CPC" and amount_cents.
timestampstringISO 8601 timestamp when the click occurred.

​
Pricing Object

FieldTypeRequiredDescription
unitstringYesMust equal CPC.
amount_centsintegerYesCharge amount in cents (non-negative).

​
Optional Fields

FieldTypeDescription
click_metadata.sourcestringdeep_link, button, voice_confirmation, or agent_action.
click_metadata.positionintegerPosition in the results list (minimum 1).
extobjectVendor-namespaced extensions.

​
Example

{
  "event_type": "cpc_click",
  "serve_token": "stk_abcxyz123",
  "session_id": "sess_001",
  "platform_id": "pf_openai_chat",
  "brand_agent_id": "ba_451",
  "wallet_id": "w_0021",
  "pricing": {
    "unit": "CPC",
    "amount_cents": 45
  },
  "click_metadata": {
    "source": "deep_link",
    "position": 1
  },
  "timestamp": "2025-11-14T18:00:02Z"
}

​
Validation Rules

  • pricing.amount_cents must be an integer ≥ 0
  • click_metadata.position, when provided, must be ≥ 1
  • timestamp must be ISO 8601 formatted