Set up the Koast pixel
Add the Koast pixel to your site, check it on a live page and send conversion events, so your Koast ad accounts can optimise and attribute.
The Koast pixel tells your Koast ad account when someone converts on your site. Without it, your ads can't be optimised or attributed. Setup is three steps and takes about ten minutes.
Before you start
- This page is for Koast ad accounts, which are provided through our partner Whop. The Pixel tab in Settings only appears while a Koast ad account is the active ad account.
- Running a Meta ad account? You use your Meta pixel instead, picked in the campaign's settings. See Connect a Meta pixel to an ad account.
- You need to be able to edit your site, or hand a prompt to whoever (or whatever AI agent) does.
Open the Pixel tab
Open Settings, then Pixel. You can also select Set up tracking on the Tracking card on Home.
The top of the tab shows the pixel's status and your progress, for example 1 of 3 done. Re-check reads the status again. The tab also refreshes itself every 15 seconds and when you come back to it. It opens on the first step you haven't finished.
Below the three steps are Server-side tracking, marked Optional, and the Events card.
Set up the pixel
Add the snippet to your site
Select Copy and paste the snippet into the
<head>of every page in your funnel, before any other script. The snippet is already scoped to this ad account.If an AI coding agent builds your site, select Copy prompt for your AI agent instead and paste the prompt into it. The prompt carries the snippet, the list of supported events and the rules for firing them.
Verify a live page
Type the address of a page that has the snippet, such as
https://nimbus.example/blanket, and select Check page. Koast loads the page and looks for the snippet. The step shows Verified once it's found.Send conversion events
Fire the matching event at each step of your funnel, for example
whop.track("lead")when a lead form is submitted. The step counts how many of the eight supported events it has seen, like 7 of 8 detected. An event's dot turns green once it fires, and amber when it hasn't fired for more than 7 days.To see the checklist turn green without walking your whole funnel, select Copy a snippet that fires 7 of them and paste it into your browser's console on a page that has the snippet. It fires every event except
purchase. These are real events: they count as conversions on this ad account.
It can take a few minutes for an event to be counted. The tab updates on its own.
Supported events
| Event | Typical use |
|---|---|
lead | A form submission |
complete_registration | An account or profile created |
submit_application | An application completed |
schedule | A call or appointment booked |
contact | An inbound contact |
view_content | A key page viewed |
add_to_cart | An item added to the cart |
purchase | A sale on your own checkout, with the sale amount as a positive value |
Don't fire purchase for Whop checkout sales
Purchases made through Whop checkout are already counted automatically. Fire purchase only for sales on your own checkout, or each Whop sale counts twice.
What the status means
| Status | What it means |
|---|---|
| Your pixel isn't sending events yet | Setup isn't finished. Work through the three steps. |
| Only page views are tracked | The snippet is live, but no conversion event has fired yet. |
| No activity for 19 days | No event for more than 7 days. The pixel is installed but has gone quiet, so check the snippet is still on your live pages. |
| Pixel is live | Events are arriving, for example "Events arrived today." or "Last event 2 days ago." |
| Tracked automatically | Your page is hosted on Whop, so purchases and subscriptions are measured without a pixel. |
| Pixel status unavailable | Koast couldn't read the status just now. Nothing is wrong with your ads. Select Re-check in a moment. |
On Home, the Tracking card shows the same warning while the pixel isn't detected, only sends page views or has gone quiet.
Go further
- To see how often each event fires, fire a single test event or add your own custom events, use the Events card. See Track and test your pixel events.
- A new pixel starts with no history. To give it one, send the conversions you already have from the last 28 days. See Seed your pixel with past conversions.
- Ad blockers and cookie rules hide some conversions from any browser pixel. To count them, send conversions from your server or your tracker as well. See Server-side conversions.