Parameter Reference
When you send data to Oracle Infinity, you will want to ensure you use the standard naming convention for your parameters (as per the Parameter Reference) and follow the correct Parameter Syntax.
Following the naming convention ensures that your data can be used for a variety of use cases as you use Oracle Infinity over time. For example, for Infinity Analytics it’s important that if you are tracking funnels then you use parameters like wt.si_n
, wt.si_p
and wt.si_x
so that your data is visible in the Infinity Analytics Funnel Analysis Reports.
Contents
Parameter Syntax
Please see the Oracle Infinity Help Center - Parameter Syntax for full parameter syntax.
If you can’t find a suitable Parameter Name in the Parameter Reference or Parameters per Scenario then you may want to declare a custom parameter using the naming convention of wt.MY_PARAMNAME
(for example, wt.pagename=website homepage
).
Parameter Reference
For a full reference of all available parameters, please see the Oracle Infinity Help Center - Full Parameter Reference.
CX Tag Automatically Generated Parameters (Web)
A list of some of the key automatically generated parameters is provided below:
Please see Oracle Infinity Help Center - Data Collected By Default for full list
Parameter | Parameter Name | Description | Sample Value |
wt.ti |
Page Title | wt.ti identifies the HTML page title of the associated web content or the name of the mobile app in the case of the SDK |
ACME.co.uk - Homepage |
dcssip
|
Domain | dcssip is the domain of the current page |
acme.co.uk |
dcsuri
|
Pathname | dcsuri is the portion of the URL after the domain, URI stem, such as /folder/page.html |
/home |
wt.es
|
URL | wt.es identifies the page a user was on when an event occurred |
acme.co.uk/home |
wt.co_f |
Visitor ID | wt.co_f is a random value used as a visitor ID and stored in a first-party cookie |
b8ab57c1-c897-48e0-91a3-713f47fac161 |
Parameters per Scenario
Please see Oracle Infinity Help Center - Full Parameter Reference for full list of all available parameters.
Here are some recommended naming conventions to be used for various scenarios you may want to track across your properties:
Generic
Here are some typical scenarios for most websites/apps:
Search Results Page
Upon page load of site search results:
Parameter | Parameter Name | Sample Value | Notes |
wt.oss |
Search Phrase | My Search Phrase | Your Search Phrase |
wt.oss_r
|
Search Result Count | 32 | Set as ‘0’ if none |
Login Event
Upon successful login:
Parameter | Parameter Name | Sample Value | Notes |
wt.event_name |
Event Name | Login | Name of your event |
wt.dcsvid |
Customer ID | CUST123 | Your ID for the customer |
wt.customer_type
|
Customer Type | Premium | Customer Type |
Logged in Users
Send as parameters on all events if logged in:
Parameter | Parameter Name | Sample Value | Notes |
wt.dcsvid |
Customer ID | CUST123 | Your ID for the customer |
wt.customer_type
|
Customer Type | Premium | Customer Type |
E-Commerce
Here are some typical scenarios for an E-Commerce implementation:
Product View
Upon load of product page:
Parameter | Parameter Name | Required | Sample Value | Notes |
wt.tx_e
|
E-Commerce Action | Required | co | Preset Value |
wt.currency
|
Currency | Recommended | GBP | Currency Code |
wt.product_coupon
|
Product Coupon | Recommended | SPRINGDISCOUNT | Discount Code |
wt.cart_subtotal
|
Cart Subtotal | Recommended | 105.00 | Cart value (minus tax + shipping) |
wt.cart_total
|
Cart Total | Recommended | 116.00 | Cart value |
wt.cart_tax
|
Cart Tax | Recommended | 10.00 | Cart tax |
wt.cart_shipping
|
Cart Shipping | Recommended | 1.00 | Shipping costs |
wt.cart_discount
|
Cart Discount | Recommended | 4.00 | Any discounts applied |
wt.tx_s
|
Product Line Item Price | Recommended | 10.00;80.00;15.00 | ‘;’ delimited list per line item (Product Quantity * Product Unit Price) |
wt.product_price
|
Product Unit Price | Recommended | 10.00;20.00;5.00 | ‘;’ delimited list per product (by line item) |
wt.tx_u
|
Product Units | Recommended | 1;4;3 | ‘;’ delimited list (by line item) |
wt.pn_sku
|
Product SKU | Recommended | SKU1;SKU3;SKU9 | ‘;’ delimited list (by line item) |
wt.cg_n
|
Content Group | Recommended | accessories;womens;accessories | ‘;’ delimited list (by line item) |
wt.cg_s
|
Content Sub Group | Recommended | shoes;dresses;socks | ‘;’ delimited list (by line item) |
wt.si_p
|
Step Name | Recommended | Checkout | Name of step in your funnel |
wt.si_x
|
Step Number | Recommended | 4 | Step in your funnel |
wt.si_n
|
Scenario Name | Recommended | Basket Funnel | Name of your funnel |
wt.product_discount
|
Product Discount | Optional | 0.00;1.00;0.00 | ‘;’ delimited list per product (by line item) |
wt.pn_id
|
Product ID | Optional* | 232432;23423;32123 | ‘;’ delimited list per product (by line item) |
wt.product_name
|
Product Name | Optional | big trainers;big dress;stripey socks | ‘;’ delimited list per product (by line item) |
wt.pn_ma
|
Product Brand | Optional | acme;fudd;acme | ‘;’ delimited list per product (by line item) |
wt.product_variant
|
Product Variant | Optional | green;grey;stripey | ‘;’ delimited list per product (by line item) |
Order Confirmation
Upon load of order confirmation page:
Parameter | Parameter Name | Required | Sample Value | Notes |
wt.tx_e
|
E-Commerce Action | Required | p | Preset Value |
wt.tx_id
|
Invoice Date | Required | 12/25/2021 | mm/dd/yyyy |
wt.tx_it
|
Invoice Time | Required | 23:58:10 | hh:mm:ss |
wt.tx_i
|
Invoice Number | Required | 132432ASP34 | Invoice/Order ID |
wt.currency
|
Currency | Required | GBP | Invoice/Order ID |
wt.cart_subtotal
|
Cart Subtotal | Required | 105.00 | Cart value (minus tax + shipping) |
wt.cart_total
|
Cart Total | Required | 116.00 | Cart value |
wt.tx_s
|
Product Line Item Price | Required | 10.00;80.00;15.00 | ‘;’ delimited list per line item (Product Quantity * Product Unit Price) |
wt.product_price
|
Product Unit Price | Required | 10.00;20.00;5.00 | ‘;’ delimited list per product (by line item) |
wt.tx_u
|
Product Units | Required | 1;4;3 | ‘;’ delimited list (by line item) |
wt.pn_sku
|
Product SKU | Required* | SKU1;SKU3;SKU9 | ‘;’ delimited list (by line item) |
wt.cg_n
|
Content Group | Recommended | accessories;womens;accessories | ‘;’ delimited list (by line item) |
wt.cg_s
|
Content Sub Group | Recommended | shoes;dresses;socks | ‘;’ delimited list (by line item) |
wt.product_coupon
|
Product Coupon | Recommended | SPRINGDISCOUNT | Discount Code |
wt.cart_tax
|
Cart Tax | Recommended | 10.00 | Cart tax |
wt.cart_shipping
|
Cart Shipping | Recommended | 1.00 | Shipping costs |
wt.cart_discount
|
Cart Discount | Recommended | 4.00 | Any discounts applied |
wt.si_p
|
Step Name | Recommended | Order Confirmation | Name of step in your funnel |
wt.si_x
|
Step Number | Recommended | 5 | Step in your funnel |
wt.si_n
|
Scenario Name | Recommended | Basket Funnel | Name of your funnel |
wt.conv
|
Conversion Name | Recommended | 1 | Set to ‘1’ |
wt.pn_id
|
Product ID | Optional* | 232432;23423;32123 | ‘;’ delimited list per product (by line item) |
wt.product_name
|
Product Name | Optional | big trainers;big dress;stripey socks | ‘;’ delimited list per product (by line item) |
wt.pn_ma
|
Product Brand | Optional | acme;fudd;acme | ‘;’ delimited list per product (by line item) |
wt.product_variant
|
Product Variant | Optional | green;grey;stripey | ‘;’ delimited list per product (by line item) |
wt.product_discount
|
Product Discount | Optional | 0.00;1.00;0.00 | ‘;’ delimited list per product (by line item) |
Product SKU is the standard required parameter for declaring your products in Infinity. You can optionally also declare Product ID in your implementation if you wish (you may skip Product SKU if you wish but this will mean some features within Infinity are not available without customised workflow).
Frequently Asked Questions
What is Each Parameter Used For?
Please see Infinity Help Center - Parameters for further details per parameter.
What Parameters are Required?
Within Parameters per Scenario you may see Required against various parameters. Ideally, you would surface all available parameters but if you have concerns over supporting maximum request lengths in older browsers (for example, Internet Explorer) then you may use this to help you prioritise which parameters you should implement:
What? | Description |
Required | Typically required for core functionality for Infinity IQ and connected CX products |
Recommended | Typically required for recommended functionality for Infinity IQ and connected CX products |
Optional | Typically required for optional functionality for Infinity IQ and connected CX products |
You may wish to contact your Oracle Representative about an engagement with the Oracle Consulting team to help you with your implementation.