p202 conversion simulate

Prove the click -> subid -> postback -> conversion loop works for a tracker

Writessupports --staged
All commands

01Run it

Replace the <placeholders> with your own values, or use the builder below.

p202 conversion simulate

02What you get

Pick the shape you need. People get a table. Add --json, --csv or --ndjson for scripts, or -q for ids only. An AI agent gets compact JSON without asking. All output formats

03Build your command

Pick values and the command line writes itself, quoted and ready to paste.

p202 conversion simulate

Set flags below; the command updates as you type.

04Flags

3 flags, plus the global flags every command takes.

FlagWhat it does
--payoutstring · default 1.00Conversion payout amount to post
--subid-fieldstringThe redirect's field that holds [[subid]] (c1, clickref, /pubref:), for a tracker whose campaign URL cannot say
--trackerstringInternal 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, CLAUDECODE or another agent variable set, output is compact JSON and errors arrive on stderr as a JSON envelope with a hint.
  • 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 --staged to record it as a proposal a person applies with p202 change apply.
p202 commands conversion simulate --json
{
  "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
    }
  ]
}