Record Activity Log

POST

app

log

activity

Record Activity Log

curl --request POST \
  --url https://your_a2_service/app/v0/log/activity \
  --header 'Content-Type: application/json' \
  --data '
{
  "catalogs": [
    {
      "id": "<string>"
    }
  ],
  "channel": "<string>",
  "device_id": "<string>",
  "schema": "activity.item_view",
  "timestamp": 123,
  "user_id": "<string>",
  "device": {
    "ext": "<unknown>",
    "geo": {
      "accuracy": 123,
      "city": "<string>",
      "country": "<string>",
      "ext": "<unknown>",
      "ipservice": 1,
      "lastfix": 1,
      "lat": 123,
      "lon": 123,
      "metro": "<string>",
      "region": "<string>",
      "regionfips104": "<string>",
      "type": 1,
      "utcoffset": 123,
      "zip": "<string>"
    },
    "ip": "<string>",
    "ua": "<string>"
  },
  "id": "<string>",
  "page_id": "<string>"
}
'

Body

application/json

Option 1
Option 2
Option 3
Option 4
Option 5

catalogs

object[]

required

Show child attributes

catalogs.id

string

required

Unique identifier for the catalog item

channel

string

required

Channel through which the activity occurred (e.g., 'web', 'mobile', 'app')

device_id

string

required

Unique identifier for the device used

schema

enum<string>

required

Available options:

activity.item_view

timestamp

integer<int64>

required

Unix timestamp when the activity occurred

user_id

string

required

Unique identifier for the user performing the activity

device

object

Optional AdCom v1.0 Device information

Show child attributes

device.ext

any

Placeholder for advertising-system specific extensions to this object

device.geo

object

Location of the device assumed to be the user’s current location defined by a Geo object

Show child attributes

device.geo.accuracy

integer<int32> | null

device.geo.city

string | null

device.geo.country

string | null

device.geo.ext

any

device.geo.ipservice

enum<integer> | null

Available options:

1,

2,

3,

4

device.geo.lastfix

integer<uint32> | null

Required range: x >= 0

device.geo.lat

number<float> | null

device.geo.lon

number<float> | null

device.geo.metro

string | null

device.geo.region

string | null

device.geo.regionfips104

string | null

device.geo.type

enum<integer> | null

Available options:

1,

2,

3

device.geo.utcoffset

integer<int32> | null

device.geo.zip

string | null

device.ip

string | null

IPv4 address closest to device.

device.ua

string | null

Browser user agent string. This field represents a raw user agent string from the browser. For backwards compatibility, exchanges are recommended to always populate ‘ua’ with the User-Agent string, when available from the end user’s device, even if an alternative representation, such as the User-Agent Client-Hints, is available and is used to populate ‘sua’. No inferred or approximated user agents are expected in this field. If a client supports User-Agent Client Hints, and ‘sua’ field is present, bidders are recommended to rely on ‘sua’ for detecting device type, browser type and version and other purposes that rely on the user agent information, and ignore ‘ua’ field. This is because the ‘ua’ may contain a frozen or reduced user agent string.

string | null

Optional unique identifier for the activity event

page_id

string | null

Optional identifier for the specific page where the activity occurred

Response

200

/app/v0/logRecords ad interaction events for advertising optimization and analytics. Supported event types: - Impressions (imp): Records ad view events - Clicks (clk): Records ad click events - Conversions (conv): Records post-view conversion events including purchases, installations, and subscriptions Note: Returns 200 OK for all requests. Invalid schemas are silently ignored.

⌘I

Record Activity Log

curl --request POST \
  --url https://your_a2_service/app/v0/log/activity \
  --header 'Content-Type: application/json' \
  --data '
{
  "catalogs": [
    {
      "id": "<string>"
    }
  ],
  "channel": "<string>",
  "device_id": "<string>",
  "schema": "activity.item_view",
  "timestamp": 123,
  "user_id": "<string>",
  "device": {
    "ext": "<unknown>",
    "geo": {
      "accuracy": 123,
      "city": "<string>",
      "country": "<string>",
      "ext": "<unknown>",
      "ipservice": 1,
      "lastfix": 1,
      "lat": 123,
      "lon": 123,
      "metro": "<string>",
      "region": "<string>",
      "regionfips104": "<string>",
      "type": 1,
      "utcoffset": 123,
      "zip": "<string>"
    },
    "ip": "<string>",
    "ua": "<string>"
  },
  "id": "<string>",
  "page_id": "<string>"
}
'

Data Management APIs

Decision APIs

Body

Response