Skip to content
adscapi

VK CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and VK is configured. Secrets and hashed values show as placeholders.

Request

POST
Endpoint
https://ad.mail.ru/fsa/
Headers
Authorization: Token {VK_FSA_TOKEN}
Content-Type: application/json
Body (purchase example)
{
  "phone_sha256": "<sha256(79XXXXXXXXXX-phone)>",
  "platform": "web",
  "event": {
    "customEventName": "purchase",
    "customEventParams": {
      "value": "49.99"
    },
    "eventTimestamp": "1739452800"
  }
}

Verified against the library dispatcher (src/dispatchers/vk.ts). See the VK setup guide for where to get each secret.

Required secrets

VK_FSA_TOKEN

VK activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventVK receives
page_viewviewOffer
leadlead (custom event passthrough)
signup_startsignup_start (custom event passthrough)
signupsignup (custom event passthrough)
checkout_createdaddToCart
purchasepurchase
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • The auth scheme word is Token, not Bearer: `Authorization: Token <VK_FSA_TOKEN>`.
  • A SHA-256 phone is the only identifier FSA accepts and it is required; the phone is normalized to the Russian MSISDN form 79XXXXXXXXXX first. No usable phone means a silent no-op.
  • customEventParams.value is a string amount; eventTimestamp is a Unix-seconds string; customEventParams.productId comes from properties.productId when set.
  • One JSON object per request; FSA does not accept arrays.

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track VK conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.

Get startednpm install adscapi