PWAReference
Macro reference
The full macro list for offer URLs, tracking links, outgoing postbacks, and click parameters.
Macros are placeholders such as {click_id} that darkcore replaces with real values when it builds offer URLs, tracking links, and outgoing postbacks. Insert them with the macro selector in the editor or type them manually.
Core
| Macro | Meaning |
|---|---|
{click_id} | darkcore click identifier |
{status} | Canonical conversion status |
{payout} | Payout amount |
{currency} | Always USD |
{timestamp} | Click Unix time |
{sub1} … {sub10} | Click sub parameters |
Ad-platform click IDs
| Macro | Meaning |
|---|---|
{fbclid}, {fbp}, {fbc} | Facebook click / browser / cookie ID |
{ttclid} | TikTok click ID |
{gclid}, {gbraid}, {wbraid} | Google Ads click IDs |
{campaign_id}, {campaign_name} | Campaign |
{adset_id}, {ad_id} | Ad set / ad |
GEO and device
| Macro | Meaning |
|---|---|
{geo} | Country |
{lang} | Language |
{timezone} | Timezone |
{ip} | IP address |
{os}, {os_version} | Operating system |
{device}, {device_type} | Device / device type |
{browser}, {browser_version} | Browser |
{user_agent} | User-Agent |
UTM and source
| Macro | Meaning |
|---|---|
{source} | Source |
{utm_source}, {utm_medium}, {utm_campaign} | UTM |
{utm_content}, {utm_term} | UTM |
Push attribution
| Macro | Meaning |
|---|---|
{push_id}, {push_name} | Push campaign |
{is_push}, {is_push_sub} | Push traffic / subscription flag |
Click parameters
darkcore reads these query parameters on the click (the stream URL https://your-domain.com/?...) and makes them available in macros:
- Subs:
sub1…sub10 - Platform click IDs:
fbclid,gclid,ttclid,gbraid,wbraid,twclid,rdt_cid,bigo_click_id,kwai_click_id,ysclid,msclkid - Campaign:
campaign_id(alias:utm_id),campaign_name(alias:utm_campaign),adset_id,ad_id - UTM:
utm_source,utm_medium,utm_campaign,utm_content,utm_term - Pixel override:
fb_pixel,fb_token,tt_pixel,tt_token,pixel_id - Push:
push_id,push_name,is_push,is_push_sub
Escaping is automatic: values in a URL are always URL-encoded; in a postback body, it follows the content type (form → URL-encode, JSON → JSON-safe, text → as-is).