Custom / Affiliate Connector

Send Webhooks from Tracklution

The Custom Connector lets you send Tracklution event data to an external system using a webhook. This guide shows how to configure it for:

• Sending events (like purchases) to third-party tools

• Setting up affiliate tracking with custom click ID logic

Choose the Custom Connector from the "Connectors" section on your tracking container dashboard.

Click "Add" or "Edit" on the Custom Connector:

Define When to Trigger the Webhook

Give your Custom Connector a name. Then, click the Trigger Events field to choose which event should trigger your webhook.

• Use any Standard or Custom event in the list of events already tracked by your container.

• If the event you want to use isn't listed, ensure it has been tracked by your container at least once.

Add Webhook URL and Parameters

Input the destination URL you want to send data to.

• Example: https://example.com/webhook

Give your parameters a name and a corresponding value. You can send both static values and dynamic data using Tracklution variables.

Supported variables:

{{EVENT_NAME}}
{{VALUE}}
{{CURRENCY}}
{{GCLID}}
{{GBRAID}}
{{WBRAID}}
{{FBC}}
{{TTCLID}}
{{SCCLID}}
{{EPIK}}
{{MSCLKID}}
{{LI_FAT_ID}}
{{CLICK_ID}}
{{CLICK_SOURCE}}
{{EMAIL}}
{{PHONE}}
{{BIRTHDAY}}
{{FIRST_NAME}}
{{LAST_NAME}}
{{GENDER}}
{{ZIP}}
{{CITY}}
{{COUNTRY}}

Example mapping:

value = {{VALUE}}
track = {{EVENT_NAME}}
gclid = {{GCLID}}
email = {{EMAIL}}

The resulting webhook (shown in URL preview) will look like:

https://example.com/webhook?value=15&track=Purchase&gclid=12a34bC&email=example@email.com

You can also set custom HTTP headers like:

Authorization: Bearer abc123

[Optional] Enable Click ID Matching (For Affiliate Tracking)

Enable this if you're working with affiliate platforms using their own click ID format (e.g. clickid, awc, etc.).

Settings:

• Click ID query parameter: e.g. my_click_id

• Click source parameter (optional): e.g. utm_source

• Attribution window: e.g. 14 days

• Attribution model:

  • Last click – Fires only if this was the latest click source

  • Any click – Fires if this was any touchpoint within the attribution window

Test Your Webhook

• Use Test Webhook to simulate the request without actually firing it.

• Use Test Mode to log the webhook structure instead of sending it.

• To force a real request while in Test Mode, add parameter name trl_test with corresponding value 1 to the URL.

Activate and Monitor

• Mode options: Enabled / Test Mode / Disabled

• After saving, use the Webhook Log to review all triggered or simulated webhooks.

Log includes:

• Timestamp

• Full request URL

• HTTP response code (200/500/etc.)

Quick Recap

• Trigger on any Standard or Custom event
• Send event and parameters to any webhook URL
• Use dynamic variables for event, value, ID, etc.
• (Optional) Match affiliate click IDs with attribution logic
• Test safely before going live
• Monitor webhook requests in the log