For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/integrations/vk-metrics.md.
  • English

      • Send leads and sales to VK Metrics

      Create an outbound integration in Clickmax, choose the events you want to send, paste the URL VK Metrics generated — and every event is sent automatically to your VK account.

      Before you start

      • Workspace role: Owner, Admin, Editor or Collaborator. The Finance, Guest and Agent roles cannot access Integrations.
      • Plan:
      • You need a webhook URL generated in your VK Metrics account. VK shows one URL for leads and another for sales — either one works.

      One integration sends both leads and sales

      VK Metrics receives leads and sales at different addresses, in different formats. Clickmax handles that for you: select every event you want in a single integration, and each one is sent to the right address.

      That is why the URL you paste does not have to match the event: we only use your project identifier (the oid at the end of the URL) and build the rest.

      Step by step

      1. In Clickmax, open Integrations and select the VK Metrics card.
      2. Under Initial actions, select every event you want to send. You can pick leads and sales together:
        • leads: Lead created, Lead captured;
        • sales: Sale made, Sale cancelled, Refund made, Chargeback requested.
      3. In another tab, go to VK Metrics and sign in.
      4. Copy either webhook URL — it does not matter which:
        • leads: side menu > Data sources > Leads > Integrate > webhook integration option;
        • sales: side menu > Data sources > Sales > Add integration > send sales manually via webhook.
      5. Back in Clickmax, paste the whole URL into the Webhook URL or project ID (oid) field. You do not need to trim anything.
      6. (Optional, shows up when a lead event is selected) Fill in the Launch ID to group these leads under a launch in VK Metrics.
      7. (Optional) Under Funnels, pick a funnel to send only what comes from it. Leave it empty to send from every funnel.
      8. Give the integration a Name, turn it on and save.

      Once created, you can add or remove events at any time on the integration's Settings tab, without recreating it.

      Track the source with vk_source and vk_ad_id

      Beyond UTMs, VK Metrics uses two of its own parameters to attribute each lead and each sale correctly:

      ParameterWhat it does
      vk_sourceIdentifies the traffic source in VK's own format (for example, paid_googleads)
      vk_ad_idIdentifies the specific ad

      Add both to your ad links, alongside the UTMs you already use:

      https://yoursite.com/page?utm_source=google&vk_source=paid_googleads&vk_ad_id=21101324513

      Clickmax stores these values when the contact is captured and when the purchase is made, and sends them along in the webhook. They keep working across the funnel: the parameters are carried from one page to the next and into the checkout.

      Without these parameters the integration still works, but VK Metrics falls back to UTMs alone to attribute the source.

      What gets sent

      For lead events: name, email, phone, page address, the five UTMs, vk_source, vk_ad_id and the launch ID when filled in. Email is required — contacts without an email are not sent.

      For sales events: transaction identifier, date, sale status, product, offer, buyer, amounts, currency, payment method, instalments, the five UTMs, vk_source and vk_adid.

      If it did not work

      • Nothing arrives in VK Metrics: check that the integration is active and that the URL you pasted really belongs to your VK project (it ends with ?oid= followed by the identifier). It does not matter whether you copied the leads URL or the sales one. See the error codes.
      • Leads arrive but sales do not (or the other way around): check under Initial actions whether the missing group's events are selected. An integration only sends the events marked there.
      • Fewer sales than expected: if you picked a funnel under Funnels, sales made through a direct checkout link — outside a funnel page — are not sent, because there is no way to tell which funnel they came from. Leave the field empty to send them all.
      • Fewer leads than expected: contacts without an email are not sent. If you picked a funnel, only contacts captured in it are sent.
      • vk_source and vk_ad_id arrive empty: check that the parameters are in your ad links, spelled exactly like this, and test by opening the full link. Values captured before you started using the parameters stay empty.
      • The integration stopped on its own: after many consecutive delivery failures, Clickmax turns the integration off. Fix the URL and turn it back on. See the FAQ.