Impact Radius

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

⚠️

This blueprint is currently alpha — schema and behaviour may change before GA.

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

The Retail variant maps the following Datafly events to Impact conversion events:

Datafly Event	Impact Event	Notes
`Product Added`	`add_to_cart`	Cart-stage event
`Order Completed`	`purchase`	Requires `orderId`, `amount`, `currency`, `actionTrackerId`
Custom events	Passed through	Add the Impact action type in the blueprint event map

Identity

The default blueprint forwards the following identifiers to Impact:

Source	Impact field
`user_id`	`customer_id`
`context.ip`	`ip_address`
`context.user_agent`	`user_agent`

Impact’s irclickid is the primary attribution token. Capture it from inbound URLs on your landing page and pass it via Datafly.js so it reaches Impact with each conversion.

Default consent category: advertising.

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.

Verify it’s working

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 Datafly event.
In the Signal Management UI, open your Impact integration and watch the Live Events stream.
In the Impact dashboard, navigate to Reports > Actions and look for your test conversion.
Confirm 200 responses in Signal’s Live Events log.

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.

Blueprint

The Impact blueprint version is 0.1.0 (alpha). It ships with a Retail variant covering add_to_cart and purchase conversion events.