Acuity Ads

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

Why route Acuity Ads through Datafly Signal

• Conversions survive ad blockers and tracking prevention. A browser tag served from an advertising domain is blocked outright for part of your traffic, and Safari’s ITP shortens the cookies it can set. Signal sends the event from your own server, so the conversions Acuity Ads optimises against are not filtered by the browser.
• Email and phone number are hashed before leaving your infrastructure. Signal normalises (trim and lowercase) and applies SHA-256 inside your own deployment, so Acuity Ads receives match keys rather than raw personal data.
• Client IP and user agent are carried in the payload. Both are taken from the original visitor request rather than your server, which is what Acuity Ads needs to attribute the event to the right session.
• One consent decision governs every destination. Acuity Ads is gated by the same consent state as the rest of your stack, so a withdrawal applies everywhere at once.
• No vendor tag on the page. Removing it removes its page weight and its independent access to your visitors.

Prerequisites

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

Configuration

Signal Setup

Quick Setup

1. Navigate to Integrations in the sidebar.
2. Open the Integration Library tab.
3. Find Acuity Ads or filter by Advertising.
4. Click Install, select a variant if available, and fill in the required fields.
5. 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"
  }'

API endpoint

GET https://secure.acuityplatform.com/track/cnv

Allow egress to secure.acuityplatform.com from the network your delivery workers run on.

Event Mapping

The default Retail preset maps a minimal set of conversion events:

To customise or extend, edit the integration’s Field Mappings in the Management UI.

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

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

Troubleshooting