Understand the parameter handoff
The source expands its macros before sending a visitor. Metricanic reads the resulting query parameters and stores the values for attribution and reporting. For example:
Click ID and Cost are fixed system rows. The 15 token slots store additional parameters. Naming Token 1
Creative does not change its stable outgoing macro, {token1}.
Create a source
- Open Traffic sources and click Create.
- Choose a template if one matches your provider, or Custom to configure the mapping yourself.
- Enter Name.
- In Parameters, fill the rows the source will actually send. For Click ID, choose a distinct Param such as
extidand the source’s click ID macro. - Configure Cost if the source supplies a price per visit. The campaign must use Visit cost → auto to record it.
- Add useful tokens such as creative, placement, or source campaign ID. Save the source and select it in your campaign.
Preserve the source click ID
The Click ID row stores the source’s identifier as External ID. Its Metricanic macro is{external_id}.
Metricanic’s own {click_id} is generated separately and passed to the offer for conversion attribution. Returning the source’s click ID in an incoming Metricanic event URL will not establish that attribution. Read URL macros for both directions of the exchange.
Use distinct, consistently spelled Param names. Avoid reserved tracking names such as clickid, cmpid, vid, vclk, landing, page, and ts. Custom token parameters allow letters, digits, underscores, and hyphens. Duplicate token parameters or aliases are rejected.
Send conversions back to the source
Postback URL is the source’s receiving URL for an outgoing conversion notification. It is different from the incoming callback that an affiliate network sends to Metricanic. The campaign editor can seed an event’s outgoing postback from the selected traffic source. Review 2. Events → Outgoing postback in each campaign to confirm the destination and whether sending is enabled. Include{external_id} when the source needs its original click identifier.
Follow outgoing postbacks to configure and test this step.
Verify with a real arrival
Copy the saved campaign’s tracking instructions. For a manual test, replace source placeholders with known values such asextid=test-ad-001, cost=0.20, and creative=banner-a.
Open the URL and inspect the campaign report using External ID and the relevant token. If a token contains literal braces, the source did not expand the macro. If it is blank, compare the actual query parameter with its configured Param, including case.
Editing a shared traffic source updates the parsing configuration used by its campaigns. It does not rewrite URLs already entered in an ad platform. After changing parameter names or source macros, recopy the affected campaign links and test again.