Assets for the Movable Ink integration
Important: This integration is only available under controlled availability with Movable Ink. Please reach out to Movable Ink to check eligibility.
This integration lets you stream any event data within Oracle Infinity to Movable Ink's Customer Data API. Event data can then be used to personalize Movable Ink content across email and mobile messages.
In this topic, you can access information about the following assets:
Required parameters per Movable Ink event
This section details the required parameters per Movable Ink event:
In addition to the events outlined above, Movable Ink now has support for Custom Events. A Custom Event can be any event captured by Oracle Infinity.
Note: Any data transformations within Oracle are not needed because Movable Ink's Solutions team will complete an event mapping within MI and can add JSON to transform data (ex. reformat a timestamp, convert a number to a string, etc.)
Product Viewed
- Description: Upon view of a product within your website/mobile app.
Required Variables
Below is a sample event schema.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
properties.id |
Yes |
wt.pn_sku or wt.pn_id |
The unique identifier of the product. |
wt.pn_sku=56544-abc wt.pn_id=56544 |
Only one is required. |
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata'
|
|
properties.title |
No |
wt.product_name |
The title or name of the product. |
wt.product_name=All-Purpose Cleaning Wipes |
|
properties.price |
No |
wt.product_price |
The product price |
wt.product_price=14.99 |
Must be in decimal form (that is, no currency symbol). |
properties.url |
No |
wt.es |
The URL of the product. |
wt.es=https://mysite.com/product/56544 |
If tracking mobile app, the URL must point to your product page on your website (so that Movable Ink can visit the page to grab information about the page). |
properties.categories |
No |
wt.cg_n |
An array of Categories with which this product is associated |
wt.cg_n=bathroom |
If using Category View event, then this value must match list_id within that event. |
properties.category[i].id |
No |
data.wt.cg_n |
For each Category, the unique identifier of the Category. |
wt.cg_n = 'collections'
|
|
properties.category[i].url |
No |
|
For each Category, the URL of the Category. |
|
|
properties.meta |
No |
ext.browser.name |
A map of meta data to provide additional context about the event. |
ext.browser.name = 'chrome' |
|
Note: Movable Ink's Customer Data API is flexible. Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Back to required parameters list
Cart Add
- Description: Adding a product to your cart within your website/mobile app.
Required variables
Below is a sample event schema.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
properties.id |
Yes |
wt.pn_sku or wt.pn_id |
The unique identifier of the product. |
wt.pn_sku=56544-abc wt.pn_id=56544 |
Only one is required. |
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata'
|
|
properties.title |
No |
wt.product_name |
The title or name of the product. |
wt.product_name=All-Purpose Cleaning Wipes |
|
properties.url |
No |
wt.es |
The URL of the product. |
wt.es=https://mysite.com/product/56544 |
If tracking mobile app, the URL must point to your product page on your website (so that Movable Ink can visit the page to grab information about the page). |
properties.categories |
No |
wt.cg_n |
An array of Categories with which this product is associated |
wt.cg_n=bathroom |
If using Category View event, then this value must match list_id within that event. |
properties.category[i].id |
No |
data.wt.cg_n |
For each Category, the unique identifier of the Category. |
wt.cg_n = 'collections'
|
|
properties.category[i].url |
No |
|
For each Category, the URL of the Category. |
|
|
properties.meta |
No |
ext.browser.name |
A map of meta data to provide additional context about the event. |
ext.browser.name = 'chrome' |
|
Note: Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Back to required parameters list
Conversion
- Description: Completing an order within your website/mobile app.
Required variables
Below is a sample event schema.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
properties.id |
Yes |
wt.pn_sku or wt.pn_id |
The unique identifier of the product. |
wt.pn_sku=56544-abc wt.pn_id=56544 |
Only one is required. |
properties.products |
Yes |
wt.product_name |
An array of products purchased with this order. |
wt.product_name=[tv,laptop] |
|
properties.products[i].id |
Yes |
wt.pn_sku or wt.pn_id |
For each product, a unique identifier of the product. |
wt.pn_sku=56544-abc wt.pn_id=56544 |
|
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata' |
|
properties.revenue |
No |
wt.cart_subtotal |
The revenue generated by the purchase of this order. |
wt.cart_subtotal=34.97 |
Must be in decimal form (that is, no currency symbol) |
properties.products[i].title |
No |
wt.product_name |
For each product, a title or name of the product. |
wt.product_name=All-Purpose Cleaning Wipes |
|
properties.products[i].price |
No |
wt.product_price |
The product price. |
wt.product_price=14.99 |
Must be in decimal form (that is, no currency symbol). |
properties.products[i].quantity |
No |
wt.tx_u |
For each product, the quantity of this product purchased. |
wt.tx_u=1;2 |
Delimiter must be ';' |
properties. products[i].url |
No |
wt.es |
For each product, the URL of the product. |
wt.es=https://mysite.com/product/56544 |
If tracking mobile app, the URL must point to your product page on your website (so that Movable Ink can visit the page to grab information about the page). |
Note: Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Back to required parameters list
Identify
- Description: Any point during a user's website or mobile application visit where they declare their customer ID (for example, logging in or completing a purchase).
Required variables
Below is a sample event schema.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata'
|
|
Note: Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Back to required parameters list
Search
- Description: Upon search within your website or mobile application.
Required variables
Below is a sample event schema.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
properties.query |
Yes |
wt.product_name |
The title or name of the product |
wt.product_name=All-Purpose Cleaning Wipes |
|
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata'
|
|
properties.url |
No |
wt.es |
The URL of the product. |
wt.es=https://mysite.com/product/56544 |
If tracking mobile app, the URL must point to your product page on your website (so that Movable Ink can visit the page to grab information about the page). |
Note: Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Back to required parameters list
Category View
- Description: Upon view of a listings page for your product (for example, a page listing all of the clothing on your website).
Required variables
Below is a sample event schema.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
properties.id |
Yes |
wt.pn_sku or wt.pn_id |
The unique identifier of the product. |
wt.pn_sku=56544-abc wt.pn_id=56544 |
Only one is required. |
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata'
|
|
properties.title |
No |
wt.product_name |
The title or name of the product. |
wt.product_name=All-Purpose Cleaning Wipes |
|
properties.url |
No |
wt.es |
The URL of the product. |
wt.es=https://mysite.com/product/56544 |
If tracking mobile app, the URL must point to your product page on your website (so that Movable Ink can visit the page to grab information about the page). |
Note: Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Back to required parameters list
Custom Event
-
Description: A Custom Event can be any event captured by Oracle Infinity.
Required variables
Below is a description of the data which must be collected for this event by Oracle Infinity.
Movable Ink Parameter |
Required |
Recommended Infinity parameter |
Description |
Sample value |
Notes |
---|---|---|---|---|---|
timestamp |
Yes |
datetime_utc |
The time when the event occurred (Unix Time) |
2023-10-05T10:02:35.738Z |
|
user_id or anonymous_id |
Yes |
wt.dcsvid |
The unique identifier of the profile / anonymous profile that triggered this event. |
wt.dcsvid=customerid14323 |
Please speak to Movable Ink for suggestions on what identifier to use per customer. |
timezone |
No |
ext.geo.tzname |
The time zone of where the event took place (TZ database name in the IANA Time Zone Database) |
ext.geo.tzname = 'asia/kolkata' |
|
properties.meta |
No |
|
A map of meta data to provide additional context about the event. |
|
|
Note: Movable Ink does not require that event data sent use the exact same parameter names outlined here. For example, if the parameters in the event payload is originally "wt.product_price", it can be sent to Movable Ink with the label "wt.product_price" and does not have to be updated to use the label 'Price'.
Query Templates
Note: The below query templates are built assuming you are passing in the parameters exactly as per the Audit Tagging section (for example, Product Viewed). The parameter display names need not match exactly as per the event schema (For example, Timestamp vs time vs time_stamp can be used for time stamp). However, the parameter's original name as per Required Parameters Per Event, should be used to ensure it is capturing the correct information (datetime_utc for Time stamp). If you do not use the parameters as specified, you will need to update your Queries accordingly. If you are uncomfortable with Query Templates, you may be interested in an Oracle Consulting Services engagement to support you (please reach out to your Oracle representative for more details).
This section details the query templates and sample requests for each Movable Ink event:
Product Viewed
Sample request (for building query)
This sample request is used for firing sample requests when creating your queries:
Note: If you're not using the recommended parameters from the query template, then you will need to amend the sample request to use the parameters you are using (see How do I Fire the Correct Sample Request?).
Back to list of query templates and sample requests
Cart Add
Important: Product URL is mandatory for Cart Add event. Therefore, by default the Query above only triggers for products added on a product page. This is because the query can simply send the page URL collected by default (wt.es
) ) as the Product URL; however, in order to do this, the query must filter to run only on product pages. Therefore, you must update the following code to filter for your product pages only:
data.wt.es LIKE '*{change to URL search term for product pages, for example "product.php"}*'
For example, if your product pages all have a URL format of http://mywebsite.com/product/14234 then you could update the query as follows (see IQL Syntax for syntax support):
data.wt.es LIKE '*/product/*'
If you wish to support add to basket events on pages other than product pages, then please see Passing Product URLs for Cart Add Event.
Sample Request (for building query)
This sample request is used for firing sample requests when creating your queries:
Note: If you're not using the recommended parameters from the Queries template, then you will need to amend the sample request to use the parameters you are using (see How do I Fire the Correct Sample Request?).
Back to list of query templates and sample requests
Conversion
Sample Request (for building query)
This sample request is used for firing sample requests when creating your queries:
Note: If you're not using the recommended parameters from the query template, then you will need to amend the sample request to use the parameters you are using (see How do I Fire the Correct Sample Request?).
Back to list of query templates and sample requests
Identify
Sample Request (for building query)
This sample request is used for firing sample requests when creating your queries:
Note: If you're not using the recommended parameters from the queries template, then you will need to amend the sample request to use the parameters you are using (see How do I Fire the Correct Sample Request?).
Back to list of query templates and sample requests
Search
Sample Request (for building query)
This sample request is used for firing sample requests when creating your queries:
Note: If you're not using the recommended parameters from the query template, then you will need to amend the sample request to use the parameters you are using (see How do I Fire the Correct Sample Request?).
Back to list of query templates and sample requests
Category View
Sample Request (for building query)
This sample request is used for firing sample requests when creating your queries:
Note: If you're not using the recommended parameters from the query template, then you will need to amend the sample request to use the parameters you are using (see How do I Fire the Correct Sample Request?).
Back to list of query templates and sample requests
Custom Event
Sample Request (for building query)
This sample request is used for firing sample requests when creating your queries:
Back to list of query templates and sample requests
Destination Templates
Each of your chosen events will use the Infinity Connection — they will allow your events to be sent to Movable Ink in the correct format. To format the data, you will need to use the following templates per event (see Building your Destinations):
Product Viewed
Note: This code block is not prettified to ensure that it will fit within the character limit in the Twig input within the Infinity user interface.
Cart Add
Note: This code block is not prettified to ensure that it will fit within the character limit in the Twig input within the Infinity user interface.
Conversion
Note: If your line items per product variable are delimited by anything other than a ';' then please amend the ';' to the correct character in the below template under the line {% set _splitChar=";" %}
Note: This code block is not prettified to ensure that it will fit within the character limit in the Twig input within the Infinity user interface.
Identify
Note: This code block is not prettified to ensure that it will fit within the character limit in the Twig input within the Infinity user interface.
Search
Note: This code block is not prettified to ensure that it will fit within the character limit in the Twig input within the Infinity user interface.
Category View
Note: This code block is not prettified to ensure that it will fit within the character limit in the Twig input within the Infinity user interface.