01Run it
Replace the <placeholders> with your own values, or use the builder below.
p202 conversion simulate02What you get
--json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats03Build your command
Pick values and the command line writes itself, quoted and ready to paste.
p202 conversion simulateSet flags below; the command updates as you type.
04Flags
3 flags, plus the global flags every command takes.
| Flag | What it does |
|---|---|
| --payoutstring · default 1.00 | Conversion payout amount to post |
| --subid-fieldstring | The redirect's field that holds [[subid]] (c1, clickref, /pubref:), for a tracker whose campaign URL cannot say |
| --trackerstring | Internal tracker_id to simulate a conversion through |
05How it works
Fires a synthetic click through the tracker, reads back the subid, fires the real S2S postback (gpb.php), and reports whether it was accepted — so you can validate the loop before pointing a network's postback at this instance.
The subid is read from the field the campaign's offer URL puts [[subid]] in (clickref for Awin, aff_sub for TUNE, /pubref: for Partnerize, ...), and an offer URL without [[subid]] fails, as does a redirect that more than one rotated offer URL fits with a different id. For a redirector, a landing page, or a campaign the key cannot read, nothing says which field is [[subid]]: name it with --subid-field (the refusal lists the networks' usual SubID fields that carry a number). It is refused under --staged: the click and the postback are recorded at once.
06For agents
Running this from an agent
- Read the same facts as JSON:
p202 commands conversion simulate --json. - With
AI_AGENT,CLAUDECODEor another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with ahint. - Exit codes: 0 ok, 1 bad input, 2 auth, 3 network, 4 server error, 5 partial failure, 6 no Pro licence on the install.
- This command writes. Add
--stagedto record it as a proposal a person applies withp202 change apply.
{
"path": "p202 conversion simulate",
"use": "simulate",
"short": "Prove the click -> subid -> postback -> conversion loop works for a tracker",
"long": "Fires a synthetic click through the tracker, reads back the subid, fires the\nreal S2S postback (gpb.php), and reports whether it was accepted — so you can\nvalidate the loop before pointing a network's postback at this instance.\n\nThe subid is read from the field the campaign's offer URL puts [[subid]] in\n(clickref for Awin, aff_sub for TUNE, /pubref: for Partnerize, ...), and an\noffer URL without [[subid]] fails, as does a redirect that more than one\nrotated offer URL fits with a different id. For a redirector, a landing\npage, or a campaign the key cannot read, nothing says which field is\n[[subid]]: name it with --subid-field (the refusal lists the networks'\nusual SubID fields that carry a number). It is refused under --staged:\nthe click and the postback are recorded at once.",
"runnable": true,
"flags": [
{
"name": "payout",
"type": "string",
"default": "1.00",
"usage": "Conversion payout amount to post",
"required": false
},
{
"name": "subid-field",
"type": "string",
"default": "",
"usage": "The redirect's field that holds [[subid]] (c1, clickref, /pubref:), for a tracker whose campaign URL cannot say",
"required": false
},
{
"name": "tracker",
"type": "string",
"default": "",
"usage": "Internal tracker_id to simulate a conversion through",
"required": false
}
]
}