What Is Acuity Ads (illumin)?

Illumin (formerly AcuityAds) 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.

What are the benefits of integrating MetaRouter with illumin?

• Up to 30% more data into illumin compared to third-party tags.
• Server-side event stream that enables real-time journeys.
• First-party, parameter-by-parameter control over data sent to illumin.
• No illumin or other third-party tags required.

---

Getting Started - From Your illumin Account

Client ID - Please reach out to your illumin support team to get your Client ID. The Client ID will be needed for the illumin sync injector.

Pixel Key - Please reach out to your illumin support team to get a pixel key for each event you will implement.

---

Getting Started - From Your MetaRouter Account

Adding an Acuity Ads (illumin) integration.

From the integration library, add an Acuity Ads integration. Then, fill out the Connection Parameters:

Adding an illumin Sync

To gather the auid value, cauid value, etc., you must add an Acuity Ads sync.

1. From the Pipelines page, find the pipeline associated with the web property you’d like to add a sync to. Hover over the three dot dropdown and select “Build AJS File.”
2. In the Identity Syncs section, select the Acuity Ads sync.
3. Fill out the following fields:
   1. Consent Type - We recommend that you consult with your legal team when determining your consent requirements.
   2. Client ID - Your account’s unique Client ID.
   3. API Timeout (in milliseconds) - Sets a time limit for how long the Sync Injector will wait for an API response from the vendor. The maximum timeout value is 300ms.
   4. Cookie Lifetime (in days) - 365 default.
4. Scroll down and click the Save and Build File button.
5. Deploy your AJS file to propagate changes to your web property.

---

Event Mappings

MetaRouter provides all of the event mappings that Acuity Ads (illumin) integrations typically require. You may add custom events, parameters or mappings in accordance with illumin’s API documentation.

Event Specific

Page

Order Completed

---

Required Identifiers

These identifiers must be mapped to illumin in order for successful user matching to occur. Without these IDs, any events sent to illumin will be rejected. For your convenience, required and recommended IDs are mapped as Global parameters to ensure they are added to every event.