What Is illumin?

illumin (formerly Acuity Ads) is a comprehensive journey advertising platform designed to help marketers engage with consumers at various stages of their journey, utilizing advanced machine learning and real-time data analytics to optimize campaigns across multiple channels, including display, video, and social media.

The illumin platform offers an intuitive drag-and-drop interface for planning, executing, and analyzing marketing strategies, ensuring that advertisers can deliver targeted messages effectively throughout the marketing funnel. The platform integrates with various media channels and provides tools for granular planning, audience engagement mapping, and performance analysis.

---

Product Type: Advertising
Integration Type: Starter Kit & ID Sync
Event Source Type: Web
Event Scope: Conversion Events Only

---

Capabilities

• Send server-side page and conversion events to illumin
• Capture and persist identifiers (auid, cauid) via identity sync
• Support revenue and product-level tracking for conversions
• Enable attribution using first-party stored identifiers

Considerations

• In our testing, requests above ~20,000 characters in the URL began to fail. While this isn’t a formally documented limit, it may be a practical constraint to consider when using this integration.
• All values must be URL-encoded and arrays pipe-delimited.
• One request per event; batching not supported.
• Complex lists (e.g., products) must be pipe-delimited.
• A valid Client ID is required to initialize the sync
• Pixel Key must be provided for each event
• Sync must be deployed to populate required identifiers before events are sent

Limitations

• Does not support batching of events
• Limited support for large payloads due to URL constraints
• No support for structured request bodies
• Events may fail if required identifiers are not present

---

Identity Sync

• Sync Available: Yes
• Required for Starter Kit: Yes
• Prerequisites: Client ID, consent configuration
• Documentation: See illumin Sync Documentation

Sync Details

• Captures auid and cauid identifiers from illumin
• Stores identifiers in first-party cookies
• Enables linking of conversion events to users
• Required for successful event attribution

---

Starter Kit Setup Guide

1. Deploy the illumin Sync

• To collect the sync values (e.g., auid, cauid), you must implement a illumin ID sync. Refer to the following documentation to complete the setup: illumin – ID Sync Guide.

2. Gather Credentials

Ask vendor representatives for the following credentials.

• Client ID (for ID sync)
• Pixel Key (per event)

3. Add an illumin Integration

• From the integration library, add an illumin integration. Then, fill out the Connection Parameters:

4. Configure Event Mapping

• MetaRouter provides all of the event mappings that illumin integrations typically require. You may add custom events, parameters, or mappings in accordance with illumin’s API requirements. Please reach out to your illumin representative for details.

5. Deploy to Pipeline

• In the Pipelines tab, add your illumin integration.
• Select the correct integration revision
• Click Add Integration to finalize deployment.

---

Event Mappings

Event Specific

Page

Order Completed

---

Required & Recommended Identifiers

These identifiers must be mapped to illumin in order for successful user matching to occur. Without these IDs, any events sent to illumin may not be accurately reflected in reporting.

---

Integration Validation

Confirm that events are successfully received and processed by illumin. Validate that required identifiers (e.g., auid, cauid) are present and populated on all events.

Please work with your illumin representative to verify that event data, attribution, and reporting align with expectations.