Conversion Attribution

Track a conversion attributed to a Pro link click

Uses 30-day last-click attribution. Browser calls must provide the signed clickSignature received as mu_sig. Server calls may instead authenticate with the API key belonging to the clicked link's account. Safe retries use eventId or externalOrderId and return the original conversionId.

post/api/analytics/link-conversion

Request

  • Base URL: https://workers.miniurl.com
  • URL: https://workers.miniurl.com/api/analytics/link-conversion
  • Auth: one of:
    • HTTP bearer
    • none

Request body

clickIdstring required

Value captured from the mu_click redirect parameter.

clickSignaturestring

Value captured from mu_sig. Required unless the request uses the matching account API key.

conversionTypestring required
valuenumber

Non-negative amount. Send a refund as a positive value with conversionType=refund.

currencystring

ISO 4217 currency code; required when value is provided.

externalOrderIdstring

Required for purchase, sale, and refund. Also acts as a deduplication key per conversion type.

eventIdstring

Stable idempotency key. Required when externalOrderId is absent.

occurredAtstring date-time

Defaults to receipt time. Must be after the click, no more than five minutes in the future, and inside the 30-day window.

sourcestring
metadataunknown

Example request

{
  "conversionType": "purchase"
}

Response

Duplicate retry accepted; returns the previously stored conversionId

Changes

No recorded changes to this operation across all 1 revision of this API.