Monetize URL
split_monetize_urlTurn a product URL into a TRACKED destination URL — the URL a checkout runner or headless browser must open so the purchase is credited to this creator, without relying on a redirect. Finds the creator's existing link for the URL — among links carrying ALL the given tags, when tags are supplied — or creates one, then registers a click on the creator's behalf and returns the URL the SplitLink would have redirected to, with the click id embedded. tracked_url is the key output: hand it to whatever completes the purchase, unchanged. requires_redirect true means the merchant is on an affiliate network and tracked_url is the network's one-hop redirector (must be followed to reach the store, cookies kept); false means it is the store URL itself with Split's parameter attached. By default the click is the creator's own (as when they open their shop-it link); shop_it_url monetizes ANOTHER creator's link with this account as the shopper (prefer split_click_link for any SplitLink you RECEIVED); clicker: anonymous registers it as an unknown shopper instead, optionally carrying your own shopper id, so a provider can attribute per end user without that user having a Split account. Each call registers a click (repeat calls within 24h for the same link and clicker count as a re-click), so call it per purchase intent, not per impression. To segment by an end user or channel, pass a tag per segment (e.g. ["shopstack", "u-8f3a2c"]): the link is reused per (URL, tag set), and split_link_performance filtered by that tag reports that segment's clicks and earnings. Use split_get_share_url instead when the creator is posting a link for people to click.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The product or brand URL to monetize (required unless uuid or shop_it_url is given) | |
| tags | No | Scopes the lookup (a link must carry every tag to be reused) and is applied to a newly created link. Lowercase a-z, 0-9, - and _, starting with a letter or digit | |
| uuid | No | An existing link's uuid, to skip the URL lookup | |
| clicker | No | Who the click is attributed to. creator (default): the signed-in creator, as when they open their own shop-it link. anonymous: an unknown shopper, as when someone not signed in to Split clicks the SplitLink — the creator earns the whole commission and no buyer share is split off | |
| new_link | No | Always create a fresh link instead of reusing one for the same URL and tags | |
| target_url | No | With shop_it_url: the product url from the same click-history row, used only to work out requires_redirect | |
| shop_it_url | No | ANOTHER creator's link, as the shop_it_url from split_click_history: the tracked URL is minted with THIS account as the shopper, so that creator earns the commission and this account receives the buyer share. No link is created or looked up. Mutually exclusive with url/uuid/clicker | |
| anonymous_id | No | With clicker: anonymous, a stable id for the shopper from YOUR system (8-64 letters or digits, no punctuation). Its LAST 11 characters are stamped into the click id and therefore onto any commission, so make that tail unique per shopper. Omit to get a random one |