OwnerIQ Destination

OwnerIQ allows marketers to use transparent, directly sourced, deterministic, shopping and purchasing data from retailers and brands.

This destination is maintained by OwnerIQ. For any issues with the destination, contact the OwnerIQ Support team.

(new)

This document is about a feature in beta

This means the feature is actively being developed, and some functionality may change before it becomes generally available.

Getting Started

From the Segment web app, click Catalog.
Search for "OwnerIQ" in the Catalog, select it, and choose which of your sources to connect the destination to.
Enter the dataGroupId,analyticsTagId,dctTagId into your Segment Settings UI which you can find from My Data Tab under My Audience in CoEx.

Page

If you aren't familiar with the Segment Spec, take a look to understand what the Page method does. An example call would look like:

analytics.page()

OwnerIQ have mapped analytics.page() to OwnerIQ's Website Analytics Tag method and will forward all page views accordingly. Note that the integration will ignore any parameters you pass to analytics.page().

Track

If you aren't familiar with the Segment Spec, take a look to understand what the Track method does.

The following table shows how OwnerIQ map Segment's semantic ecommerce or custom event names to OwnerIQ's tag event:

Segment Event Name	ownerIQ tag event
Order Completed	Sale/Purchase (DCT)
All others	N/A

The following table shows how OwnerIQ maps Segment's raw message fields or properties to OwnerIQ's semantic conversion event parameters:

Segment Property	ownerIQ Conversion Parameters
orderId	order_id
total	total_cost_notax
products.$.brand	brand
products.$.sku	id
products.$.price	price
products.$.category	product_type
products.$.quantity	quantity
products.$.title	name

Since track events by default do not require you to send user metadata, it is still possible for OwnerIQ to send a conversion as long as you send a userId. However, for better attribution results, OwnerIQ recommend you send as much applicable user data through context.traits as shown in the mapping table below:

Segment `context.traits` Properties	ownerIQ Match Key Parameters
email	email
userId	customer_id

Order Completed

For each order completed you must include an orderId. All other properties are optional.

1analytics.track({
2  userId: '019mr8mf4r',
3  event: 'Order Completed',
4  properties: {
5    orderId: '50314b8e9bcf000000000000',
6    total: 27.5,
7    shipping: 3,
8    tax: 2,
9    discount: 2.5,
10    coupon: 'hasbros',
11    currency: 'USD',
12    repeat: true,
13    products: [
14      {
15        id: '507f1f77bcf86cd799439011',
16        sku: '45790-32',
17        brand: 'Monopoly',
18        name: 'Monopoly: 3rd Edition',
19        price: 19,
20        quantity: 1,
21        category: 'Games'
22      },
23      {
24        id: '505bd76785ebb509fc183733',
25        sku: '46493-32',
26        name: 'Uno Card Game',
27        price: 3,
28        quantity: 2,
29        category: 'Games'
30      }
31    ]
32  }
33});

analytics.track({event: 'Order Completed})' calls will be sent to OwnerIQ as a Sale/Purchase tag conversion event.