Skip to main content
POST
/
advertisers
/
{advertiserId}
/
log-event
Log conversion events
curl --request POST \
  --url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/log-event \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_source_id": "es_abc123",
  "events": [
    {
      "event_id": "txn_abc123",
      "event_type": "purchase",
      "event_time": "2026-03-15T14:30:00-05:00",
      "user_match": {
        "uids": [
          {
            "type": "<string>",
            "value": "<string>"
          }
        ],
        "hashed_email": "<string>",
        "hashed_phone": "<string>",
        "click_id": "<string>",
        "click_id_type": "<string>",
        "client_ip": "<string>",
        "client_user_agent": "<string>"
      },
      "custom_data": {
        "value": 123,
        "currency": "<string>",
        "order_id": "<string>",
        "content_ids": [
          "<string>"
        ],
        "content_type": "<string>",
        "num_items": 4503599627370495,
        "contents": [
          {
            "id": "<string>",
            "quantity": 123,
            "price": 123,
            "brand": "<string>"
          }
        ]
      },
      "action_source": "website",
      "event_source_url": "<string>",
      "custom_event_name": "<string>"
    }
  ]
}
'
{
  "events_received": 4503599627370495,
  "events_processed": 4503599627370495,
  "partial_failures": [
    {
      "event_id": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ],
  "warnings": [
    "<string>"
  ],
  "match_quality": 0.5
}

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Body

application/json

Request body for logging conversion or marketing events (ADCP spec)

event_source_id
string
required

Event source configured on the account via sync_event_sources

Required string length: 1 - 256
Example:

"es_abc123"

events
object[]
required

Events to log (up to 10,000 per call)

Required array length: 1 - 10000 elements
test_event_code
string

Test event code for validation without affecting production data

Maximum string length: 256

Response

Log conversion events

Response from log_event

events_received
integer
required

Number of events received

Required range: 0 <= x <= 9007199254740991
events_processed
integer
required

Number of events successfully queued

Required range: 0 <= x <= 9007199254740991
partial_failures
object[]

Events that failed validation

warnings
string[]

Non-fatal issues (low match quality, missing fields)

match_quality
number

Overall match quality score

Required range: 0 <= x <= 1