Skip to main content

Parameter Mapping for Target URL

Rinku supports a set of predefined placeholders that you insert into your Target URL. When a click happens, Rinku substitutes each placeholder with the real value from that click.

Available placeholders​

Core​

PlaceholderLabelDescription
{click_id}Click IDUnique click identifier. Always include this for postback correlation.

Network parameters​

PlaceholderLabelDescription
{net_external_id}External IDExternal identifier from the network
{net_pid}Publisher IDPublisher / zone ID
{net_source}SourceTraffic source identifier
{net_creative}CreativeCreative ID
{net_campaign}CampaignNetwork campaign ID

Custom tokens​

PlaceholderDescription
{token_1} … {token_30}30 universal custom tokens for any values you need to pass. You can assign readable names to each token in your Account Settings → Token Names.

Geo​

PlaceholderDescription
{geo_country}Visitor's country
{geo_city}Visitor's city
{geo_region}Visitor's region

Device & browser​

PlaceholderDescription
{hdr_language}Browser language
{hdr_browser}Browser name
{hdr_os_name}Operating system
{hdr_device_name}Device model
{hdr_device_type}Device type (mobile / desktop / tablet)

Usage examples​

Basic example​

https://landing.example.com/offer?cid={click_id}&sub1={token_1}

With network parameters and geo​

https://landing.example.com/landing?cid={click_id}&aff_id={net_pid}&sub1={token_1}&country={geo_country}

Tips & recommendations​

Always include {click_id}

This guarantees correct postback attribution — without it, Rinku can't link a conversion back to a specific click.

Custom token names

If you assign names to tokens in Account Settings, the UI will show your label (e.g. "Zone ID") instead of token_1. The actual placeholder format {token_1} stays the same.

URL encoding

Always check that your Target URL is valid. Values that contain special characters should be URL-encoded to prevent broken links.

  • Test your setup: send a test request to your tracking link and confirm all parameters arrive correctly in the click log
  • Coordinate field names with your affiliate network (e.g. net_pid vs pid) to avoid mismatches