Overview
You don’t need to configure anything to make the join work. When Affiliate.com builds a
Shopnomix outclick redirect, it automatically appends
cid=cl-<id> to the outbound URL,
where <id> is the same click identifier returned as the id field in the outclick
report. Shopnomix captures that value in its click_id field.Step 1 — Get clicks (Affiliate.com)
UseGET /v1/reports/outclick to retrieve individual
click rows, including the product, price, merchant, and sub_id.
See the endpoint reference for the full parameter and
response field list.
Example request
Example response row
Join key from this row. Prefix the outclick
id with cl- to get the value Shopnomix
stores in click_id: cl-01kyn6z1rg0vnabvnenwfxr25c.Step 2 — Get conversions (Shopnomix)
UseGET /api/v2/reporting/conversion on https://r.v2i8b.com. This returns individual
conversions, each with a click_id you can join on. Shopnomix does not expose a
per-click feed — only conversions.
Auth:
Authorization: Bearer <SHOPNOMIX_API_KEY> · Pagination: follow
meta.next_page until it is null.
Example request
Example response
Step 3 — Join clicks to conversions
Join on the click id, adding thecl- prefix to the outclick id:
id of 01kyn6z1rg0vnabvnenwfxr25c matches a Shopnomix
click_id of cl-01kyn6z1rg0vnabvnenwfxr25c.
Pseudo-code
Match a conversion to your own customer
sub_id goes to Shopnomix as source, so use it for what you want to group earnings by (for example the client, company-3). To tie a click to a specific customer, add your own parameter to the outclick link, such as &customer_ref=abc123. It is stored with the click and is not sent to Shopnomix.
Each outclick report row returns it under origin_query_parameters. For a conversion, find the row whose id equals the click_id without the cl- prefix, then read your value from that row:
affiliate_id, sub_id, format, click_tracking, aff_id, cid and ref_id. If you link to merchants rather than products, request the report with offer_type=merchant. See Outclick report for the full details.