Commission Junction

Send conversion and transaction data to Commission Junction (CJ Affiliate) for affiliate tracking, commission attribution, and publisher reporting.

Prerequisites

Complete these steps in the CJ Affiliate platform before configuring Signal.

Create a CJ Affiliate account

Find your Enterprise ID

Navigate to Account > Network Profile in the CJ Account Manager. Your Enterprise ID (also called Company ID) is displayed on the profile page. This identifies your organisation within the CJ network.

Find your Advertiser ID

Go to Account > Web Settings. Your Advertiser ID (also called CID) is shown in the account details. If you manage multiple advertiser accounts, select the correct one.

Create a Personal Key

Navigate to Account > Personal Key (or Account > API Credentials). Click Create Key to generate a new personal API key. Copy the key immediately as it will not be shown again. This key authenticates server-to-server conversion calls.

Define an Action ID

Go to Advertiser > Actions and create or locate the action (conversion type) you want to track. Each action has an Action ID that identifies the specific conversion type (e.g. sale, lead, registration). Note this ID for your Signal configuration.

Verify tracking parameters

Ensure your CJ tracking links include the required parameters (e.g. cjevent click ID). Server-to-server conversions require a valid click reference for attribution.

Configuration

Field	Type	Required	Description
`enterprise_id`	string	Yes	Your CJ Enterprise ID from Account > Network Profile.
`personal_key`	secret	Yes	Your CJ personal API key from Account > Personal Key.
`advertiser_id`	string	Yes	Your CJ Advertiser ID (CID) from Account > Web Settings.
`action_id`	string	Yes	The CJ Action ID for the conversion type being tracked.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Commission Junction or filter by Attribution.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default blueprint.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/commission_junction/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Commission Junction",
    "variant": "default",
    "config": {
      "enterprise_id": "1234567",
      "personal_key": "your_personal_key",
      "advertiser_id": "7654321",
      "action_id": "12345"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to CJ server-to-server conversions via your blueprint. Common mappings include:

Signal Event	CJ Mapping	Notes
`purchase`	Sale action	Requires `orderId`, `amount`, `currency`, and `actionId`
`lead`	Lead action	Map to a lead-type Action ID for CPL campaigns
`sign_up`	Registration action	Map to a registration Action ID

CJ requires the cjevent click ID to attribute conversions to the correct publisher. Ensure your site captures the cjevent parameter from landing page URLs and includes it in Signal events.

Testing

Generate a test click through a CJ tracking link to create a valid cjevent reference.
Complete a test conversion on your site that triggers a Signal event.
Send a test event through Signal using the Test Event button on the integration detail page.
In the CJ Account Manager, navigate to Reports > Transaction Detail to verify the test conversion (allow up to 30 minutes for processing).
Check Live Logs in Signal to confirm delivery returned 200 OK.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid personal key	Regenerate the personal key in Account > Personal Key and update Signal.
`400 Bad Request`	Invalid Action ID or Advertiser ID	Verify `action_id` and `advertiser_id` match active values in CJ.
Conversions not appearing	Missing `cjevent` click ID	The CJ click event parameter must be captured and forwarded with the conversion.
Wrong action type	Incorrect `action_id`	Ensure the Action ID matches the conversion type (sale, lead, etc.).
Duplicate conversions	Same order ID sent twice	CJ deduplicates by order ID within an action; ensure unique order references.

Visit CJ Affiliate documentation for full API reference and credential setup instructions.

Button Impact Radius