Acuity Ads (illumin)
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:
Connection Parameter | Description |
---|---|
AUID | Acuity Ads user identifier. Please input: context.providers.acuityAds.auid to pull value from sync injector. |
COOKIE | Acuity Ads cookie. Please input: context.providers.acuityAds.cauid to pull value from sync injector. |
Adding an illumin Sync
To gather the auid
value, cauid
value, etc., you must add an Acuity Ads sync.
- 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.”
- In the Identity Syncs section, select the Acuity Ads sync.
- Fill out the following fields:
- Consent Type - We recommend that you consult with your legal team when determining your consent requirements.
- Client ID - Your account’s unique Client ID.
- 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.
- Cookie Lifetime (in days) - 365 default.
- Scroll down and click the Save and Build File button.
- 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
Output Key | Description | Expected Input |
---|---|---|
pk | String: Pixel key for page event. | N/A - Enrichment |
pu | String: Page url. | context.page.url |
Order Completed
Output Key | Description | Expected Input |
---|---|---|
pk | String: Pixel key for order completed event. | N/A - Enrichment |
pu | String: Page URL. | context.page.url |
ordid | String: Order ID. | properties.order_id |
crev | String: Conversion Revenue | properties.total |
prodid | String: Product IDs (~ separated) | N/A - Expression |
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.
Attribute | Example | Sync Injector Required? |
---|---|---|
auid | 527998349489 | Yes |
cauid | N/A | Yes |
user agent | Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 | No |
ip | 192.168.1.1 | No |
Updated 2 months ago