Impact Radius

Send conversion and action data to Impact (formerly Impact Radius) for affiliate attribution, partnership tracking, and commission management.

Prerequisites

Complete these steps in the Impact dashboard before configuring Signal.

Create an Impact account

Sign up at impact.com and log in to the Impact dashboard. You need an advertiser (brand) account to configure server-to-server tracking.

Find your Account SID

Navigate to Settings > API (or Settings > Technical > API). Your Account SID is displayed at the top of the API credentials section. This is your unique account identifier.

Find your Auth Token

On the same Settings > API page, locate your Auth Token. If you do not see one, click Generate Token. Copy the token immediately. This authenticates all server-to-server API calls.

Find your Program ID

Go to Programs in the left sidebar and select the affiliate programme you want to track conversions for. The Program ID is shown in the programme details or in the URL bar. Note this ID for your Signal configuration.

Configure conversion actions

Navigate to Settings > Tracking > Actions and ensure your conversion actions (e.g. sale, lead) are defined. Each action type has its own ID that you can reference in your blueprint for granular tracking.

Configuration

Field	Type	Required	Description
`account_sid`	string	Yes	Your Impact Account SID from Settings > API.
`auth_token`	secret	Yes	Your Impact Auth Token from Settings > API.
`program_id`	string	Yes	The Impact Program ID for the affiliate programme receiving conversions.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Impact Radius 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/impact_radius/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Impact Radius",
    "variant": "default",
    "config": {
      "account_sid": "IRabcdef1234567890",
      "auth_token": "your_auth_token",
      "program_id": "12345"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

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

Signal Event	Impact Mapping	Notes
`purchase`	Conversion action (sale)	Requires `orderId`, `amount`, `currency`, and `actionTrackerId`
`lead`	Conversion action (lead)	Map to a lead-type action tracker
`sign_up`	Conversion action (registration)	Map to a registration action tracker
`app_install`	App install action	Requires device identifiers for mobile attribution

Impact requires the irclickid (Impact click ID) to attribute conversions to the correct partner. Ensure your site captures this parameter from landing page URLs and includes it in Signal events.

Testing

Generate a test click through an Impact tracking link to create a valid irclickid 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 Impact dashboard, navigate to Reports > Actions and look for your test conversion.
Check Live Logs in Signal to confirm delivery returned 200 OK.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid Account SID or Auth Token	Verify both credentials in Impact Settings > API and update Signal.
`400 Bad Request`	Missing required fields	Ensure `orderId`, `amount`, and `actionTrackerId` are mapped in the blueprint.
Conversions not appearing	Missing `irclickid`	The Impact click ID must be captured from the landing page URL and included in events.
Wrong programme	Incorrect `program_id`	Verify the Program ID matches the affiliate programme you are tracking.
Commission not calculated	Action tracker mismatch	Ensure the action tracker ID in your blueprint matches a defined action in Impact.

Visit Impact documentation for full API reference and credential setup instructions.

Commission Junction InMarket