
At a glance
How it works
1
Push.House sends the click
A visitor clicks your ad. Push.House opens your ClickFlare campaign URL and fills in its macros: the click ID in
click_id, the click price in price, plus the source, ad, feed and subscriber details.2
ClickFlare stores the Push.House click ID
ClickFlare saves the value of
click_id as the visit’s External ID, records the cost, and redirects the visitor to your lander or offer.3
The conversion reaches ClickFlare
Your affiliate network or store posts the conversion back to ClickFlare, matched on the ClickFlare click ID.
4
ClickFlare posts it back to Push.House
ClickFlare fires the Push.House postback, replacing
{external_id} with the stored Push.House click ID and {payout} with the revenue. Push.House matches it to the original click.The mirror to keep straight: in the campaign URL you write ClickFlare’s parameter (
click_id) and Push.House’s macro ({click_id}). In the postback URL you write Push.House’s parameter (click_id) and ClickFlare’s token ({external_id}). The names look alike on both sides, but only {external_id} is a ClickFlare token.Before you start
- Set up your own tracking domain. Run the campaign and the postback on your own custom domain. Shared domains get flagged by networks and blocked by browsers. See Custom Domains.
- Have an offer ready in ClickFlare, and its affiliate network set up to post conversions back to ClickFlare. See Creating an Offer and Adding an Affiliate Network.
- Have a funded Push.House account. The minimum deposit is
$50. - Plan to set up the postback. Push.House’s CPA Goal model optimizes on the conversions it receives, and Push.House’s cashback only counts conversions sent by postback. Both need Step 2.
Step 1 – Create the campaign and the Push.House traffic source
- Go to Campaigns and click New.
- In Traffic Source, open the dropdown and click + New Traffic Source.
- Type
pushin the search box and select the Push.House template. - Enter a Name, for example
Push.House. - Leave Cost currency on USD. Push.House bills in US dollars.

Fill in the click ID row
TheexternalId row has no parameter and no macro, so the campaign URL carries no click ID and Push.House cannot match any conversion. Fix it before you save:
- In the
externalIdrow, enterclick_idas the TS Parameter. - Enter
{click_id}as the TS Token. This is Push.House’s click identifier macro. - Leave the ClickFlare Token on
{external_id}.
The other rows
Traffic Source ID ({site}) is the column you will use most. It tells you which sources convert, so you can blacklist or bid up sources in Push.House. Campaign ID carries {camp}, which Push.House’s own guide describes as the ad ID, so read that column as the ad rather than the campaign.
The User ID row sends {uid}. Push.House’s current macro list doesn’t include it. If the column shows {uid} as text or stays empty, replace the TS Token with {pdpid}, Push.House’s subscriber ID, and rename the row Subscriber ID.
To pass more Push.House data, click Add Parameter, give it a name and parameter, and enter the Push.House macro as the TS Token. ClickFlare assigns the next free tracking field. Push.House lists these macros under the Target Page field when you create a campaign:
{format} is worth adding if you run several formats in one campaign.
Step 2 – Set up the postback
The postback is what sends conversions to Push.House. It lives on the traffic source, so every campaign that uses this Push.House traffic source sends conversions the same way. The template has no postback, so you add it yourself.Get your postback URL from Push.House
- In your Push.House account, open the Tracking section.
- Select your tracker from the list. If ClickFlare isn’t listed, pick any tracker. Only its tokens differ, and you replace them below.
- Generate the postback URL and copy it.
click_id carries the click ID back. cost carries the conversion’s revenue. The name is Push.House’s, but the value is your payout, not your ad cost.
Add it to the traffic source in ClickFlare
- Back in the New Traffic Source form, scroll to Passing conversion info to traffic source.
- Turn on Traffic source postback URL. The URL field is empty, because the template has no postback.
- Paste the URL from Push.House, then replace the tracker’s tokens with ClickFlare’s. The value of
click_idbecomes{external_id}. The value ofcostbecomes{payout}. The result:
- Keep everything else in the URL Push.House generated exactly as it is, including any extra parameter or ID.
- In the dropdown on the left, choose the ClickFlare event that should fire the postback. Keep Conversions to send every conversion. If your final action is a custom conversion (for example
purchase), choose that instead. - Click Save. You are back in the campaign editor with the Push.House traffic source selected.
Step 3 – Finish the campaign and copy its URL
- Name the campaign.
- Set the Cost Model to Not Tracked, so ClickFlare uses the cost Push.House passes. See Cost.
- Choose Redirect or Direct tracking. Redirect is the usual choice for push and OnClick traffic.
- Click Next and, on Destination, add your lander (optional) and your offer.
- Save, open Tracking, select your own tracking domain and copy the campaign URL.
click_id={click_id}. If it doesn’t, the externalId row from Step 1 is still empty.
If you use a lander, its call-to-action must link to the ClickFlare click URL, not to the offer directly. Otherwise the visit reaches the offer without a ClickFlare click ID, and the conversion cannot be traced back to Push.House.
See Creating a Campaign in ClickFlare.
Step 4 – Create the campaign in Push.House
- In Push.House, click Create Campaign in the left menu.
- Enter the campaign name, choose the vertical and the ad format.
- Paste the ClickFlare campaign URL into the Target Page field.
- Set the traffic settings, country, click cost, targeting, budget and schedule as usual.
- Add your creatives and submit the campaign. It launches after moderation, unless you tick Stop After Moderation.
{...} macro when the ad is clicked.
Step 5 – Test the integration
- Run the campaign with a small budget, or click your own ad if your targeting allows it.
- In ClickFlare, open the campaign report. Check that the visit has a Push.House click ID in External ID and values in the Traffic Source ID and Feed columns.
- Complete a test conversion on your offer, or post one to ClickFlare from your affiliate network’s test tool.
- In ClickFlare, go to Logs → Postback Status and filter by the campaign. A successful request to
api.push.houseconfirms ClickFlare sent it. - Check the conversion in Push.House’s statistics. Push.House recommends a test conversion before you scale.
Sending one event
Push.House’s postback has no documented event or goal parameter. Send it one conversion type: the one Push.House should optimize on.- If you only send one conversion type, keep the postback on Conversions.
- If your funnel has several steps, create a custom conversion for the step Push.House should learn from, for example
deposit, and map the postback to it in the dropdown.
CPA Goal campaigns
CPA Goal campaigns
With CPA Goal you set a target cost per lead, and Push.House raises bids on sources that convert and switches off the ones that don’t. It does this from the conversions you post back, so the postback must be working before you switch a campaign to CPA Goal. You still pay per click, so cost tracking in ClickFlare stays the same.
Sending only some conversions
Sending only some conversions
To send a postback only for some conversions, for example only those above a certain payout, use Event filter under the postback to add conditions.
Cost
The template passes cost per click. Thecost row sends Push.House’s {price} macro, the price of the click, and ClickFlare records it as the visit’s cost.
On the campaign, set the Cost Model to Not Tracked so ClickFlare uses the cost passed in the URL. This works for both CPC and CPA Goal campaigns, because Push.House charges per click on both.
Compare the Cost column with your Push.House spend after launch. If they differ, correct ClickFlare with a manual cost upload. ClickFlare has no cost API integration for Push.House. See Cost Models.
Delayed revenue
If you run search arbitrage (RSOC or AFD) behind Push.House, the feed reports revenue hours or days after the click. To pass that revenue to Push.House once it arrives, see Sending Delayed Revenue to Traffic Sources.Troubleshooting
External ID is empty
External ID is empty
The
externalId row was left empty, so the campaign URL has no click_id={click_id}. Fill in the row as in Step 1, then copy the campaign URL again and update the Target Page in Push.House.Conversions show in ClickFlare but not in Push.House
Conversions show in ClickFlare but not in Push.House
- Traffic source postback URL is off, or the URL field is empty. The template has no postback of its own.
- Disable sending postbacks to traffic source is on in the campaign.
- The postback still has another tracker’s token, or Push.House’s
{click_id}, instead of{external_id}. - The postback is mapped to a different event than the one the conversion logged. Check Logs → Event Logs to see which event was recorded.
- Check Logs → Postback Status: a failed request shows the status code Push.House returned.
Push.House shows conversions with no payout
Push.House shows conversions with no payout
The postback’s
cost parameter is missing or still holds another tracker’s token. Set it to cost={payout}.The User ID column shows the macro as text
The User ID column shows the macro as text
{uid} is not in Push.House’s current macro list, so it may not be replaced. Change the row’s TS Token to {pdpid}. For other empty columns, check that the URL in Target Page is the one ClickFlare gave you, unchanged. See Traffic Source Tokens Arriving Empty.FREQUENTLY ASKED QUESTIONS
Q1: Can I use the same Push.House traffic source for all my Push.House campaigns?A1: Yes. Once you have filled in the click ID row and the postback, every campaign using the traffic source tracks and sends conversions the same way. You only fix the template once.
Q2: Why does the postback send my payout in a parameter called cost?
A2: That is Push.House’s name for it. In the postback, cost is the conversion’s value. Your click cost travels the other way, in the campaign URL’s price parameter.
Q3: Why is itA3: They are two halves of the same value. In the campaign URL,{click_id}in the campaign URL and{external_id}in the postback?
{click_id} is Push.House’s macro and Push.House fills it in. In the postback, {external_id} is ClickFlare’s token, and ClickFlare fills it with the click ID it stored.
Q4: Should I use Redirect or Direct tracking with Push.House?A4: Redirect is the usual choice and works with every Push.House format. Use Direct only if Push.House must see your lander’s domain as the destination. See Direct Campaign Tracking.
Q5: Do I need the postback on plain CPC campaigns?A5: It is strongly recommended. Push.House’s statistics only show conversions you send, and its cashback is only paid on campaigns with an active postback, for the conversions it records.
Related
Traffic source postbacks
Every token you can use in a postback.
Custom conversions
Pick the one event Push.House should receive.
Cost models
How CPC, CPA and RevShare costs are calculated.
Conversions not showing
The general checklist when postbacks don’t arrive.