Acuity Ads

Send conversion events to Acuity Ads (illumin) for programmatic campaign attribution and performance optimisation across display, video, and CTV.

Prerequisites

Complete these steps in the Acuity Ads (illumin) platform before configuring the integration in Signal.

Create or access your Acuity Ads (illumin) account

Log in to illumin (formerly Acuity Ads). If you don’t have an account, contact Acuity Ads sales to set up a programmatic advertising account. You’ll need advertiser-level access to retrieve credentials.

Get your Advertiser ID from the campaign dashboard

Navigate to your campaign dashboard and locate the Advertiser ID in Advertiser Settings. This is the unique identifier for your advertiser account and is required for event attribution.

Generate an API key

Go to Settings > API in the illumin platform to generate an API key. If the API settings section is not visible, contact your Acuity Ads account manager to request API access be enabled for your account.

Configuration

Field	Type	Required	Description
`advertiser_id`	string	Yes	Your Acuity Ads advertiser ID. Found in the illumin platform under Advertiser Settings.
`api_key`	secret	Yes	API key for authenticating server-side event delivery. Generate in the illumin platform under Settings > API.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Acuity Ads or filter by Advertising.
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 configuration.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/acuity_ads/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acuity Ads",
    "variant": "default",
    "config": {
      "advertiser_id": "adv-12345",
      "api_key": "ak_acuity_abc123..."
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal Event	Acuity Ads Event	Description
`page_view`	`PageView`	Standard page view tracking
`purchase`	`Purchase`	Completed transaction with revenue
`add_to_cart`	`AddToCart`	Product added to shopping cart
`sign_up`	`SignUp`	New user registration
Custom events	Custom conversion	Map any Signal event to a custom Acuity Ads conversion type via blueprint configuration

Event mappings are fully configurable through blueprints. The table above shows common default mappings — you can customise these to match your campaign goals.

Delivery

Events are delivered server-side from your Datafly Signal infrastructure directly to the Acuity Ads API. No client-side scripts are loaded for this integration.

Testing

Install the integration with your Advertiser ID and API key.
Trigger a test event (e.g. a page view) on your site with the Datafly.js collector active.
Check the Live Events view in Signal to confirm the event was captured.
Verify the event appears in the illumin campaign dashboard under conversion reporting.
Check the Delivery Log in Signal for confirmation of successful delivery (HTTP 200 response).

⚠️

Conversions may take up to 15 minutes to appear in the illumin reporting dashboard due to processing delays on the Acuity Ads side.

Troubleshooting

Issue	Resolution
`401 Unauthorized`	Verify your API key is correct and has not been revoked. Regenerate in illumin Settings > API if needed.
`404 Not Found`	Check that the Advertiser ID matches your account exactly.
Events not appearing in illumin	Confirm the integration is enabled in Signal and check the Delivery Log for errors. Conversions may take up to 15 minutes to appear.
`429 Too Many Requests`	Acuity Ads rate limits are being hit. Signal will automatically retry with backoff.

Visit Acuity Ads documentation for full API documentation and credential setup instructions.

The Trade Desk Conversions adMarketplace