ActionIQ

What Is ActionIQ?

ActionIQ is a Customer Data Platform (CDP) that helps businesses manage and leverage their customer data effectively. It integrates data from various sources to create a unified view of customers, allowing for advanced segmentation and personalized marketing campaigns. The platform offers robust analytics and reporting tools to understand customer behavior and measure campaign performance. Additionally, ActionIQ supports personalization and helps support compliance with privacy regulations.


Product Type: Customer Data Platform
Integration Type: Starter Kit
Event Source Type: Web, Mobile Browser, and Mobile App
Event Scope: Full-Funnel Events


Capabilities

  • Sends server-side (non-browser) event data to ActionIQ.
  • Routes data through a private, single-tenant, first-party environment for each client.
  • Negotiates relevant vendor user IDs into a first-party graph within track events.
  • Supports identify, page, screen, and default (track) event types.
  • Supports batching of events for delivery.
  • Allows straightforward addition of identity and data parameters.

Considerations

  • Authentication uses basic auth with a username and password provided by ActionIQ.
  • The endpoint identifier determines which ActionIQ stream MetaRouter sends data to and must match the value provided by ActionIQ.
  • Each event type is sent to a dedicated ActionIQ endpoint (identify, page, screen, and a default track stream).
  • Events are delivered in batches of up to 100 per request.

Starter Kit Setup Guide

1. Gather Credentials

  • Ask ActionIQ representatives for the following credentials:
    • Username
    • Password
    • Endpoint Identifier

2. Add an ActionIQ Integration

  • From the integration library, add an ActionIQ integration. Then, fill out the Connection Parameters:
Connection ParameterDescription
USERNAMEUsername for the API. Ask your ActionIQ account manager for this.
PASSWORDPassword for the API. Ask your ActionIQ account manager for this.
ENDPOINT_IDENTIFIERDefines the ActionIQ endpoint MetaRouter sends data to. Ask your ActionIQ account manager for this.

3. Configure Event Mapping

  • MetaRouter provides all of the event mappings that ActionIQ integrations typically require. You may add custom events, parameters, or mappings in accordance with ActionIQ's API documentation.

4. Deploy to Pipeline

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

Event Mappings

Global

Global mappings will be applied to all events. If your parameter names do not match the Expected Inputs provided, you will need to overwrite the Inputs provided with your own.

Output KeyDescriptionExpected Input
uuidString: ID used to identify a single event.messageId
userString: User ID associated to a known user, if it exists.userId
timestampString: Timestamp of the event in milliseconds since epoch.Expression – converts timestamp to milliseconds since epoch

Event Specific

Identify

Output KeyDescriptionExpected Input
properties.traitsTraits Object: The AJS traits object is mapped in its entirety to properties.traits
properties.anonymousIdString: Anonymous ID associated to a user. This will always exist.anonymousId
properties.contextContext Object: The AJS context object is mapped in its entirety to properties.context.context
properties.isAnonymousBoolean: True if userId is null.anonymousId

Page

Output KeyDescriptionExpected Input
propertiesProperties Object: The AJS properties object is mapped in its entirety to properties.properties
properties.anonymousIdString: Anonymous ID associated to a user. This will always exist.anonymousId
properties.contextContext Object: The AJS context object is mapped in its entirety to properties.context.context
properties.isAnonymousBoolean: True if userId is null.anonymousId

Screen

Output KeyDescriptionExpected Input
propertiesProperties Object: The AJS properties object is mapped in its entirety to properties.properties
properties.anonymousIdString: Anonymous ID associated to a user. This will always exist.anonymousId
properties.contextContext Object: The AJS context object is mapped in its entirety to properties.context.context
properties.isAnonymousBoolean: True if userId is null.anonymousId

Default

Output KeyDescriptionExpected Input
properties.contextContext Object: The AJS context object is mapped in its entirety to properties.context.context
properties.anonymousIdString: Anonymous ID associated to a user. This will always exist.anonymousId
properties.isAnonymousBoolean: True if userId is null.anonymousId
properties.eventTypeString: Type of the event, usually based on the event name.input.event

Required & Recommended Identifiers

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

AttributeExampleSync Injector Required?
userId111222No
anonymousIdb171a9b06ce011ecafcd1b209be8601bNo

Integration Validation

  • Reach out to your ActionIQ representative to validate that events are being received and processed on their backend.