Tracking script functions

Use these functions in your own JavaScript to connect buttons, read visit data or send events. For an ordinary offer link, follow Connect an offer button. Install the tracking snippet before using these functions. See Install the tracking script. On Hosted landings, publish with Add Direct Tracking enabled.

Call a function

Put your code inside metricanicCallback:

metricanicCallback((api) => {
	console.log(api.getClickId());
});

Place your code after the tracking snippet. Your code runs when tracking is ready.

Functions

Function	Returns	Use it to
`getClickId()`	Click ID of the visit	Pass the visit to a form, CRM or order system
`getTokens()`	Traffic source tokens, such as `{ t1: 'banner-a' }`	Read source values. Token 1 is `t1`
`getOfferLink()`	Offer URL selected for the visit	Open the offer from your own button
`getClickLink()`	Tracker link that records a click and redirects to the offer	Link a widget or element where you cannot add code
`generateLinks(options)`	Connected elements	Connect buttons added after the page loaded
`registerClick()`	Promise	Record a click from your own button
`logEvent(options)`	Promise	Send an event, such as a quiz step or form submit

Connect buttons added later

When the page loads, the script connects links to https://<tracking domain>/click and elements with data-dtp-link, including buttons. After a popup, quiz or page builder adds buttons, call:

metricanicCallback((api) => {
	api.generateLinks();
});

Call it again after each change.

Option	Default	Description
`selector`	`[data-dtp-link]`	CSS selector of the elements to connect
`target`	The element’s own `target`	`_blank` opens the offer in a new tab. `replace` opens it in place of the landing, so Back skips the landing
`register`	`true`	`false` connects the element without recording clicks

Build your own offer button

Add custom button logic

Use this when a button needs its own logic before opening the offer:

metricanicCallback((api) => {
	document.querySelector('#continue').addEventListener('click', () => {
		api.registerClick().catch(console.error);
		window.location.href = api.getOfferLink();
	});
});

Call registerClick() once per click. Do not use it on links the script already connects. They record clicks automatically.

Pass the click ID to a form

Save the click ID with the lead so your CRM can send events for this visit later:

<input type="hidden" name="clickid" id="clickid" />
<script>
	metricanicCallback((api) => {
		document.querySelector('#clickid').value = api.getClickId();
	});
</script>

Your CRM sends the event to the incoming event URL with this click ID.

Send an event

metricanicCallback((api) => {
	api.logEvent({ idx: 3, txuid: 'quiz-done' });
});

Field	Description
`idx`	Event ID from `1` to `10`. Default `1`
`txuid`	Action identifier. Repeated calls with the same value count once per visit and Event ID
`payout`	Revenue, such as `24.50`, for an event with Revenue set to From incoming event
`value`	Number added to Value N of the event

Configure the Event ID in the campaign’s 2. Events tab. See Decide what counts as a conversion.
Without txuid, every call adds a new event. Use a fixed txuid for steps that must count once, such as 'form-open'.
Visitors can see and change browser requests. Send revenue from your server or affiliate network instead.
Check the result in Events.

Handle a failed start

Add an error handler

Use onError if your page needs to respond when tracking cannot start:

metricanicCallback.onError((error) => {
	console.error(error.code, error.message);
});

Start here

Campaigns and tracking

Landing pages and scripts

Conversions

Reports and optimization

Integrations

Account

Troubleshooting

Tracking script functions

Call a function

Functions

Connect buttons added later

Build your own offer button

Pass the click ID to a form

Send an event

Handle a failed start

​Call a function

​Functions

​Connect buttons added later

​Build your own offer button

​Pass the click ID to a form

​Send an event

​Handle a failed start

Call a function

Functions

Connect buttons added later

Build your own offer button

Pass the click ID to a form

Send an event

Handle a failed start