ClickFlare
Connect ClickFlare to see its conversions and revenue next to your campaigns and in Agent Tasks, and push your live ad spend into ClickFlare every hour.
Connect ClickFlare and Koast brings in its visits, conversions and revenue every hour, so you see what each campaign earned next to what it spent. Turn on the spend push and Koast also writes your live ad spend into ClickFlare, so its cost and ROI reports stop depending on cost you upload by hand.
Before you start
- You need a ClickFlare API key.
- Only the organization owner and admins can connect ClickFlare and change its settings. Everyone on the team sees the numbers.
- Integrations are set per brand, so connect ClickFlare while the right brand is selected.
- Your ClickFlare tracking links must pass the ad platform's campaign ID in one of ClickFlare's tracking fields, and ideally the ad set and ad IDs in two more. Your traffic source template in ClickFlare decides which field holds which ID.
Connect ClickFlare
Open Settings and select Your integrations.
Under All integrations, select ClickFlare in Attribution. Connect ClickFlare opens. Paste your ClickFlare API key and select Connect. If ClickFlare refuses the key, you'll see "ClickFlare rejected this API key."
Pick the ClickFlare workspaces to read. Leave it empty to read all of them. If Koast can't read your workspaces, you'll see "Could not read workspaces from ClickFlare." Select Try again. You can't continue until the list loads.
Check the tracking fields. Koast suggests which field carries the campaign, ad set and ad ID. Change any that are wrong.
Right after you connect, Koast brings in the last 30 days in the background. ClickFlare now shows under Connected, and gets its own entry under Your integrations that opens its page.
How Koast picks the tracking fields
Koast looks at the last 14 days of each of ClickFlare's 20 tracking fields and matches the values against the campaign, ad set and ad IDs of your own launches. The field with the most matching visits wins each role. If no field matches, Koast falls back to how your ClickFlare traffic source labels its fields. Anything it still can't place is left empty for you to pick.
A field you pick by hand is never changed by Koast, even when you reconnect.
See ClickFlare numbers next to your campaigns
ClickFlare's visits, conversions, revenue, cost, CPA, ROAS and ROI are Ads Manager columns, next to the Cometly and Hyros ones. Open Ads Manager, select Columns above the grid, and turn them on under ClickFlare. Koast matches them to your campaigns, ad sets and ads by the IDs in your tracking fields.
- Updated every hour. Each hourly run re-reads the last 3 days, so late conversions are picked up.
- Visits count as clicks. ClickFlare's visits, the landings on your tracking links, are the clicks behind CVR and CPC.
- Blank means unknown, not zero. When a number can't be worked out, for example cost per conversion on a day with no conversions, Koast leaves it blank instead of showing 0.
- Days follow your ClickFlare timezone, the one set in your ClickFlare account.
Use ClickFlare in Agent Tasks
In a Monitor rule, pick a ClickFlare metric to watch: Visits, Cost, Conversions, Revenue, CPA, ROI, ROAS, CVR, RPC, CPC, AOV, Profit or Profit Margin. The ClickFlare group is marked Beta in the metric picker. See Monitor rules reference.
Push spend to ClickFlare
Koast reads each campaign's spend live from the ad platform and uploads it to the ClickFlare campaign it's mapped to. It's off until you turn it on, and it's set per brand.
Turn off ClickFlare's own Facebook cost sync
ClickFlare's Facebook integration can also update campaign cost. If it runs on a campaign Koast pushes to, each one overwrites the other's cost. In ClickFlare, turn off cost sync for every campaign Koast pushes spend to. Koast can't see that setting, so it can't do it for you.
In Settings, select ClickFlare under Your integrations, and make sure the campaign tracking field is set. The push can't start without it.
Turn on Push spend to ClickFlare.
Check the mapping table, and pick a ClickFlare campaign for any row that has none.
The mapping table
Each row pairs a Koast campaign with the ClickFlare campaign its spend goes to.
- Matched automatically. Koast finds the pair from the last 14 days of ClickFlare data, using the campaign tracking field. These rows refresh every hour.
- Not matched. Campaigns with spend today or yesterday that Koast couldn't pair. Pick the ClickFlare campaign by hand. A campaign seen under two ClickFlare campaigns is listed here too, with both as options, because Koast won't guess.
- Your pick wins. A campaign you mapped by hand is never changed by the automatic match. Clear your pick to hand it back.
Several Koast campaigns can share one ClickFlare campaign. Koast adds up their spend and uploads one total.
Some ClickFlare campaigns are kept out of the push on purpose, because uploading would write a wrong number:
| Reason | What it means |
|---|---|
| The ClickFlare campaign is missing | It was deleted, or it's in a workspace Koast doesn't read. Pick another one. |
| Mixed timezones | The Koast campaigns mapped to it spend in ad accounts with different timezones. Map them to separate ClickFlare campaigns. |
| Not in USD | ClickFlare takes manual cost in US dollars only, and one of the ad accounts spends in another currency. |
| Spend unavailable | Koast couldn't read the spend of one of its campaigns. Uploading the rest would undercount it, so Koast waits for the next pass. |
| No visits | ClickFlare only accepts cost for a campaign that had at least one visit that day. |
When it runs
- Today, every hour. Each upload sends the spend from midnight to now, in the ad account's timezone. ClickFlare replaces the earlier figure with the new one, so cost is never counted twice.
- Yesterday, once more after the day closes. After 2:00 in the ad account's timezone, Koast uploads yesterday's final spend.
- Koast waits a few seconds between uploads for the same ClickFlare key, and brands sharing a key share that queue.
When something goes wrong
- ClickFlare rejects your key. Koast turns the push off for that brand and shows the error. Fix the key in ClickFlare, then turn the push back on.
- Any other failure. Koast shows the last error and tries again on the next hourly pass.
Disconnect ClickFlare
In Settings, select ClickFlare under Your integrations. Select Disconnect under "Disconnect integration" and confirm. Koast deletes the key, the mappings and the push setting, and stops reading and pushing. The ClickFlare numbers already brought in stay.