Read this first: you need a page you own
Cometly attributes a GrowRamp sale to an ad by matching the buyer to the visitor who clicked your ad. To do that, Cometly gives each visitor an ID the moment they land on a page that has the Cometly pixel. That ID rides along to GrowRamp when the visitor clicks your offer link, and GrowRamp sends it back to Cometly when the sale is reported. No URL parameter, sub ID, or ad-platform macro changes this. Typing an ad name,{{ad.id}}, or {click.id} into a GrowRamp sub field does not create a Cometly ID. It only sends that text back to you.
What counts as a page you own: any page where you can paste code into the head and footer. A simple page with a headline, a few lines and one button to your GrowRamp link is enough. This is what most successful media buyers run anyway.
If you work directly with the vendor, they can host a page dedicated to your traffic and add the three scripts from this guide to it. This only works if the button on that page goes out through your GrowRamp tracking link. If your ads hit the GrowRamp link first and it redirects to the vendor, the click is already recorded before any page loads, and this option does not apply.
Running without a page anyway? Do Steps 5, 6, 7 and 9 only. Skip Steps 1, 3 and 4, since there is no page of yours to put those scripts on. Your GrowRamp sales will still show up in Cometly as revenue, but they will stay “Unattributed.”
What goes on your landing page
Three scripts. Everything else in this guide is configuration in Cometly and GrowRamp.
Nothing else goes on the page. Do not add the affiliate script to any page that is not yours.
There are 9 steps. Do them in order. Don’t skip any.
Step 1: Put the Cometly pixel on your landing page
Why: The pixel is what lets Cometly see visitors on your page. Every other step in this guide depends on it. No pixel, no tracking.- Log in to Cometly.
- In the left menu, click Setup.
- Open step 2, Install the Cometly pixel.
-
Under Add domains, type your landing page’s domain into the domain box, exactly the way it looks in your browser. If your browser shows
www., type thewww.too. Click Add Domain. -
Under Install the pixel, click Copy Code. This copies your pixel. It is unique to your account, so always copy it from your own Cometly screen. It looks like this, with your own ID in place of
YOUR_ID: - Open your landing page in your page builder. Find the box for head code. Depending on your builder it may be called “Header code”, “Custom head code”, or “Tracking codes > Head”.
- Paste the pixel into that box. Save and publish your page.
- Go back to the same Cometly screen. Under Verify your pixel, click Verify next to your domain, then Verify again in the dialog. Cometly opens your page in a pop-up window and checks it for the pixel.
- You want to see Pixel detected. If you see Pixel not detected, the code is not in the head of your page. Go back to number 6 and try again.
Step 2: Add Cometly parameters to your ads
Why: This is how Cometly knows which ad sent each visitor. Without it, Cometly sees your visitors but can’t tell you which ad deserves the credit, and your reports will say “Unattributed.” These parameters go on the ad that points at your landing page. Copy the line for the ad platform you use. Meta / Facebook Ads: Open your ad in Ads Manager. Scroll down to the Tracking section. Paste this into the URL parameters box:About GrowRamp’s sub IDs
GrowRamp’s Tracking & Asset Generator lets you addsource_id and sub1 through sub10 to your tracking link. Those are separate from the Cometly parameters above, and there are three rules:
- sub1 through sub7 are yours. Use them for your own ad and creative labels, or leave them blank. Cometly does not read them.
- sub8 is reserved for Cometly. Never type anything into it. The script in Step 4 fills it in automatically for every visitor. If you put anything there yourself, you overwrite the visitor’s ID and the sale cannot be attributed.
- Never use
{click.id}. It is not a Meta macro. It arrives at GrowRamp as the literal text{click.id}and does nothing.
Step 3: Add the View Content event to your landing page
Only if your ads send people to a landing page you own. If your ads go straight to your GrowRamp link, skip this step. The View Content event goes on the landing page itself, the page your ads point to. Not your homepage, not a thank-you page, and never the vendor’s page.
- Open the landing page your ads send people to in your page builder.
- Find the box for footer code. Depending on your builder it may be called “Body end code”, “Footer code”, or “Before </body>”.
- Copy this and paste it into that box:
Step 4: Add the Cometly affiliate script to your landing page
Why: Here’s the problem this solves. The sale doesn’t happen on your page. It happens on GrowRamp’s side, minutes or hours later. So Cometly needs a way to recognize that the person who bought is the same person who clicked your ad. This script does that: it quietly attaches the visitor’s Cometly ID to your offer links assub8. When GrowRamp reports the sale, that ID comes back with it, and Cometly matches the sale to the exact ad that brought the visitor.
Don’t worry about this script breaking your page. If the pixel is missing, or a visitor has no Cometly ID, the script simply does nothing. It never changes anything else on your page.
You need to make one small edit to the script before you paste it. Here’s how.
4a. Figure out where your offer button points
Open your landing page, right-click your offer button, choose Copy link address, and look at what you copied. Setup 1: your button goes straight to your GrowRamp tracking link. The copied link is the one from GrowRamp’s Tracking & Asset Generator, something like:https:// and the next /. In this example:
www. if your link has it. Write it down and go to 4b.
Setup 2: your button goes to a page the vendor controls, and their page has the GrowRamp tracking link. The copied link is some other website, something like:
- Open the vendor’s page in your browser with
?sub8=TEST123added to the end of the address, like this:https://offer.example.net/watch-video?sub8=TEST123 - On the vendor’s page, right-click their offer button and choose Copy link address.
- Look for
sub8=TEST123in the copied link.
offer.example.net. Write it down and go to 4b.
If it’s not there: ask the vendor: “Can you pass incoming URL parameters through to your tracking links?” This is a standard request in affiliate marketing and most vendors know exactly what it means. Until they do it, sales from that funnel can’t be matched to your ads.
4b. Edit and paste the script
Here is the script:- Copy the whole script into a notes app.
- Find the line near the top that says
PASTE-YOUR-TRACKING-DOMAIN-HERE. - Replace only that text with the tracking domain you wrote down in 4a. Keep the quote marks. Touch nothing else.
4c. Check it worked
- Open your landing page in your browser.
- Right-click your offer button and choose Copy link address.
- Paste it into a notes app. The link should now end with
sub8=followed by a long number:
sub8=? You’re good. Move on.
Don’t see it? Check these three things:
- The domain you typed into the script must match your tracking link’s domain exactly, including
www.if your link has it. Compare them letter by letter. - The pixel from Step 1 must be in the head of the page.
- The script must be in the footer, and the page must be published.
Step 5: Get your Cometly webhook link
Why: A webhook link is a private address where GrowRamp will report your sales to Cometly. Think of it as Cometly’s mailbox for GrowRamp. You’re about to hand that address to GrowRamp in Step 6.- In Cometly’s left menu, click Events Manager.
- Click Create Event.
- Under App / Integration, choose Webhooks (or click the Select Webhooks link below the field).
- Choose Purchase as the event and click Create. The new event appears in your events list.
- Click Configure next to it. Cometly shows you your link under Your webhook URL on the Receive Data step. It looks something like this:
Step 6: Add the Purchase postback in your GrowRamp dashboard
Why: A postback is GrowRamp’s way of reporting a sale the moment it happens. Right now GrowRamp isn’t telling anyone. In this step you tell it: “every time I make a sale, report it to my Cometly link, and include the sale amount and the visitor’s Cometly ID.”- Log in to your GrowRamp dashboard.
- In the left menu, click Postbacks.
- Click + Postback (top right).
-
Set these three options:
- Level: Global (this means: report sales from all my offers, not just one)
- Type: Conversion (this means: report sales)
- Method: Postback
- Now build the URL. Take your Cometly link from Step 5 and add this text to the very end of it, with no space in between:
- Don’t edit the parts in curly braces like
{sub8}or{payout_amount}. They are placeholders. GrowRamp fills them in automatically with each sale’s real values. - The
email=at the very end, with nothing after it, is correct. Leave it exactly like that. - If your GrowRamp rep sets the postback up for you, send them this exact URL. The names on the left of each
=(comet_token,amount,order_id,idempotency_key,event_time) must stay exactly as written. A postback that saysclick_id={sub1}instead ofcomet_token={sub8}will not attribute.
Step 7: Tell Cometly what the data means
Why: GrowRamp is now sending sale reports to Cometly, but Cometly doesn’t yet know what each piece means. In this step you label the pieces once: “this one is the sale amount, this one is the visitor ID.” After that, every future sale is understood automatically.- Go back to the Cometly tab from Step 5.
- Click Check for Data. Cometly is now waiting to receive something.
-
Send it a test sale:
- Message your GrowRamp rep: “Can you run a postback test on my Purchase postback? I need it to fire once so I can map the fields in Cometly.” GrowRamp has a built-in test tool on their side that fires your postback with a fake click and sale. This is a normal request.
- If your GrowRamp dashboard shows a Test Conversion button on the offer, that works too.
- Within a minute, a record appears in Cometly. Select it and click Continue With Selected Record.
- You are now on Configure Mapping. You see Cometly’s fields with a dropdown next to each one. Set them exactly like this:
This is the row that makes attribution work. Comet Token is not on the screen by default. Click Add Field, choose Comet Token, then pick
comet_token from the dropdown. The sample value next to it should be a long number. That is the visitor’s Cometly ID that came in through sub8. If it shows an ad label, {click.id}, or nothing at all, stop and go back to Step 4c. Without this row, every sale will say “Unattributed.”About Email: affiliate offers almost never include customer info, so the
email field will be empty. That is completely normal. You’re promoting someone else’s product, so GrowRamp doesn’t share the buyer’s details with you. Cometly doesn’t need them: it matches the sale using Comet Token instead. Map Email to the empty email field and move on. Do not map Email to comet_token or to any other field to “fill it in.” That breaks the match. The only exception: if you work directly with a vendor and their postback includes the buyer’s email, map Email to that field instead.Step 8: Track Initiate Checkout (clicks to the offer)
Why: This records an Initiate Checkout every time someone clicks from your page through to the offer. Together with View Content from Step 3, this completes your funnel: ad clicks, landing page views, clicks to the offer, sales. Now you can tell exactly where you’re losing people. Lots of page views but few clicks to the offer? Fix your page. Lots of offer clicks but few sales? The problem is the offer, not you. It works the same way as Steps 5 to 7, just for clicks instead of sales.- In Cometly, go to Events Manager > Create Event, choose Webhooks under App / Integration, and this time choose Initiate Checkout. Click Create, then Configure next to the new event. Copy the link it gives you. This is a different link from the one in Step 5.
-
In your GrowRamp dashboard, go to Postbacks and click + Postback again. Set:
- Level: Global
- Type: CPC (might be called Click. This means: report clicks instead of sales)
- Method: Postback
- Take your new Cometly link and add this to the very end, no space:
email, Event Time to event_time, Comet Token to comet_token, Order Id to order_id, Idempotency Key to idempotency_key. There is no Amount for clicks.
Click Save & Continue. On the Filtering screen, click Clear to remove the pre-added email filter (same as in Step 7), then click Activate.
Don’t see a CPC or Click option when creating the postback? It may be turned off for your account. Ask your affiliate manager: “Can you enable click postbacks on my account?” And if they can’t, no problem: skip this step. Your Purchase tracking from Steps 5 to 7 still works completely. You just won’t see clicks to the offer in your funnel.
Step 9: Connect your ad accounts
Why: Everything so far tracks what you earn. This step pulls in what you spend, so Cometly can put the two side by side and show you profit and return per ad.- In Cometly’s left menu, click Integrations.
- In the Ad Platforms section, open the row for the platform you advertise on (Meta Ads, TikTok Ads or Google Ads) and click its sign-in button, for example Sign in with Facebook.
- Log in, then click Connect & Sync Data next to your ad account.
Check it worked
In Events Manager, your Purchase and Initiate Checkout webhook events show a switch that is turned on in the Status column. After your next GrowRamp sale, open the Events Log tab: the postback GrowRamp sent appears there. You’re done. Every sale GrowRamp approves now shows up in Cometly as a Purchase, with your payout as the revenue, attached to the exact ad that earned it. View Content and Initiate Checkout show you where people drop off along the way, and your ad spend sits right next to it all.How long until I see data?
GrowRamp reports a sale within seconds of approving it. Cometly reports usually catch up within an hour. One thing to know: if GrowRamp later reverses or changes a sale, Cometly keeps the original. Each sale is reported only once.Something’s not working
Nothing shows up in Check for Data (Step 7)- In your GrowRamp dashboard, open the postback and make sure it is Active.
- Compare your postback URL against Step 6 character by character. The most common mistake is a missing
?between your Cometly link andcomet_token. - Sales that are still pending approval may not be reported until GrowRamp approves them. Ask your rep to run a postback test.
-
Start in GrowRamp: go to Reporting > Postback. Each row shows the exact URL GrowRamp sent to Cometly. Look at the
comet_token=value.- A long number: the ID arrived. Check that the ad that sent the visitor has the Step 2 parameters on it.
- Empty: the script in Step 4 isn’t attaching the ID. Go back to 4c.
- An ad label,
{click.id}, or anything typed by hand: something is writing into sub8. Clear sub8 in the Tracking & Asset Generator and in any ad URL, and re-copy your links.
- Make sure the pixel from Step 1 is in the head, and the scripts from Steps 3 and 4 are in the footer.
- Make sure your ads point at your landing page, not straight at the GrowRamp link. If a visitor never loads your page, there is nothing to attach the sale to. See “Read this first” at the top.
- The Step 3 script is not in the footer, or the Step 1 pixel is missing from the head.
- Initiate Checkout comes from GrowRamp’s click report (Step 8), not from your page. Check that the CPC/Click postback exists and is Active, and that your offer links carry
sub8=(Step 4c).
- Make sure Idempotency Key is mapped to
idempotency_keyin Step 7.
- GrowRamp may hide payout amounts on postbacks. Ask your affiliate manager: “Can you enable payout visibility on my postbacks?”
- It still works. GrowRamp sends back whichever sub your postback names. You only need to move to sub8 if you want to use sub1 for your own labels. If you do, change the script (Step 4b), the postback (Step 6), and the click postback (Step 8) together, all on the same day.
- Then Cometly cannot attribute those sales to ads. It will still receive them through the postback, so your revenue totals are right, but they will stay “Unattributed.” Two options: ask the vendor for a page dedicated to your traffic that you can add the three scripts to, or put a simple page of your own in front. There is no parameter-only workaround.
Frequently asked questions
Do I need a separate postback for each GrowRamp offer?
No. The postbacks in this guide use Level: Global, which reports activity from all your offers. One Purchase postback covers every sale, and one click postback covers every click to an offer.Can I use the same Cometly webhook link for GrowRamp sales and clicks?
No. Each webhook event in Cometly has its own link. Use the Purchase link from Step 5 for the sales postback and the Initiate Checkout link from Step 8 for the click postback, so each one is recorded as the right event.Can Cometly send my GrowRamp sales back to my ad platforms?
Yes. GrowRamp sales arrive in Cometly as Purchase events, and the Conversion API sends the events Cometly tracks back to your ad platforms. Set it up for each platform you advertise on by following the Conversion API guides.Next steps
- See your GrowRamp sales next to ad spend in the Ads Manager
- Use the Events Log to check incoming events
- Send your purchases back to your ad platforms with the Conversion API
- Review the URL parameters for every ad channel
- Look up what each metric means in the metrics glossary