Skip to main content
This guide shows how to pull individual click rows from Affiliate.com, pull individual conversions from Shopnomix, and join them on a shared click id to get the click → conversion picture (commission revenue, not order value).

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)

Use GET /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)

Use GET /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

Only rows with a non-null click_id can be joined. Conversions with click_id: null have no link back to the outclick report.

Step 3 — Join clicks to conversions

Join on the click id, adding the cl- prefix to the outclick id:
For example, an outclick 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:
Reserved names to avoid: 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.