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 ParameterDescription
AUIDAcuity Ads user identifier. Please input: context.providers.acuityAds.auid to pull value from sync injector.
COOKIEAcuity 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.

  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

Output KeyDescriptionExpected Input
pkString: Pixel key for page event.N/A - Enrichment
puString: Page url.context.page.url

Order Completed

Output KeyDescriptionExpected Input
pkString: Pixel key for order completed event.N/A - Enrichment
puString: Page URL.context.page.url
ordidString: Order ID.properties.order_id
crevString: Conversion Revenueproperties.total
prodidString: 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.

AttributeExampleSync Injector Required?
auid527998349489Yes
cauidN/AYes
user agentMozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0No
ip192.168.1.1No