Terminology
How common ad-network terms map to the names mypinio uses in the Publisher API and Portal.
If you integrated with another survey wall or offer network before, some terms you expect don't exist here under the same name. This page maps common terms to their mypinio equivalent — no new concepts, just the names used elsewhere in this documentation.
| Term you may know | At mypinio | Notes |
|---|---|---|
| Publisher ID / Affiliate ID | App ID | Shown per app under Apps in the portal, with a copy button. There is no single organization-wide ID — each app has its own. See Apps API. |
| CID / Campaign ID | (no equivalent) | Not a concept in the mypinio API. |
| Transaction ID / Click ID | Your own: subId1–subId3. Ours: entryLinkCode | subId1–subId3 are optional tracking IDs you send in POST /api/v1/publishers/surveys; they are echoed back on return, unsigned. entryLinkCode is generated by mypinio for the session and only appears on the return redirect — it cannot be looked up beforehand. See Redirect URLs and POST /surveys. |
| Complete URL / Complete postback | Complete URL | Same name. Configured per app under Apps → your app → Redirect URLs. |
| Terminate URL | Screen-out URL, reason=qualification_mismatch | mypinio uses one Screen-out URL for all disqualification cases; the reason query parameter tells you which one. |
| Quota Full URL | Screen-out URL, reason=overquota | Same URL as Terminate, distinguished by reason. |
| Security / Fraud URL | Screen-out URL, reason=security | Same URL as Terminate and Quota Full, distinguished by reason. |
| Postback | Signed browser redirect to your Complete or Screen-out URL | There is no separate server-to-server postback call. mypinio redirects the panelist's browser to your URL with signed query parameters; treat that request as your postback and verify the signature server-side. See Redirect URLs. |
| Cancelled URL / Cancelled postback | Cancelled URL | Required field in app settings, but mypinio does not currently redirect panelists to it. |
See Redirect URLs for the full query-parameter and signature-verification reference, and POST /surveys for request fields.
Postbacks (server-to-server)
Receive a signed server-to-server call for every complete, screen-out, reversal and reinstatement — credit your users on the postback.
Troubleshooting & FAQ
Fix the common integration problems — empty lists, lists without participants, failed requests — and answers to the questions publishers ask most.