Skip to content
AACSearch

Record source behavioral events

Records clicks, cart and purchase signals through the existing analytics pipeline. The server overrides every event collection with the bound source collection. The installation key never grants tenant-wide API access. Batches are limited to 64 KiB.

Full-key operation

Requires a full key; a search key or a browser key gets a 403. See Keys and credits.
POST
/cms/runtime/stores/{storeId}/sources/{sourceId}/behavior

Records clicks, cart and purchase signals through the existing analytics pipeline. The server overrides every event collection with the bound source collection. The installation key never grants tenant-wide API access. Batches are limited to 64 KiB.

Path Parameters

storeId*string
sourceId*string

Header Parameters

X-AACSEARCH-INSTALLATION-KEY*string

Dedicated installation credential, issued once in Console.

Match^aac_install_[a-f0-9]{64}$
X-AACSEARCH-INSTALLATION-ORIGIN*string

HTTPS origin pinned to this installation; clones require another installation.

Formaturi

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/cms/runtime/stores/string/sources/string/behavior" \  -H "X-AACSEARCH-INSTALLATION-KEY: string" \  -H "X-AACSEARCH-INSTALLATION-ORIGIN: http://example.com" \  -H "Content-Type: application/json" \  -d '{    "events": [      {        "type": "search",        "collection": "string"      }    ]  }'
{  "accepted": 0,  "deduplicated": 0,  "rejected": [    {      "index": 0,      "reason": "string"    }  ]}