Simility Tag Setup Guide for Tealium iQ

Simility Tag Setup Guide for Tealium iQ

by Community Manager a week ago (24 Views)

With the Simility Tag, you can collect user data for detecting fraudulent activities. This article shows you how to add and configure the Tag in your Tealium iQ profile.

Table of Contents Placeholder


  • Simility account

Tag Configuration

First, go to Tealium's Tag Marketplace and add the Simility Tag to your profile (how to add a Tag?).

After adding the Tag, configure the below settings:

  1. Customer ID (Required): Enter the unique identifier that you (or your company) received from Simility during signup.
  2. Simility Lite: This is enabled by default. If you disable this feature, you have to provide additional user information to Simility.

Load Rules

Load Rules determine when and where to load an instance of this Tag on your site.

Recommended Load Rule: Load on all pages.

Data Mappings

Mapping is the process of sending data from a Data Layer Variable to the corresponding destination variable of the vendor Tag. For instructions on how to map a Variable to a Tag destination, see Data Mappings.

The destination variables for the Simility Tag are built into its Data Mapping tab. Available categories are:


Destination Name Description
Customer ID (Required) Customer/Account ID provided to you by Simility during signup
Simility Lite Boolean value (true/false) to determine whether or not Simility Lite is enabled.

Mapping to a Standard destination overrides its corresponding Tag Setting.

Transaction Info

Allows you to send transaction data, e.g. user, orders, transactions, applications, profile, etc. Data is sent through the transaction_info object in the payload.

Destination Name Description
Entity Entity type of the payload; required if using the transaction_info object
Transaction ID Unique id of the transaction; required if using the transaction_info object
First Name First name of the user
Last Name Last name of the user
User ID Username of the user
Email Email id of the user
Is First Order Boolean value (true/false) to determine whether it's the user's first order
Number Of Retries Number of attempts to place the order
Custom Field Custom data related to the user's transaction. Replace "custom" with your custom parameter name. E.g. field.order_categories
Custom Nested Field Send transaction data in a nested form. E.g. field.order_details.is_first_order

Example Payload

Notice how the transaction info mappings are wrapped in the transaction_info object whereas all non-transaction mappings are outside the object.

var similityContext = {
    "customer_id": "acme",  
    "session_id": "1234",  
    "user_id" : "user1234",  
    "simility_lite": true,  
    "transaction_info": [{ 
      "entity": "orders",  
      "id": "xyz101",   
      "fields": {          
          "first_name": "John",
          "last_name": "Doe",
          "user_id": "user1234",
          "email": "",
          "order_categories": ["123", "456", "789"],
          "order_details": { "is_first_order": true, "num_retries": 1 },


Since the Simility Tag is e-commerce enabled, it will automatically use the default E-Commerce Extension mappings. Manually mapping in this category is generally not needed unless:

  • you want to override any Extension mappings
  • your desired ecommerce variable is not offered in the Extension
Destination Name Description E-Commerce Extension Variable
Order ID Unique Order ID _corder
Order Total Total value of order _ctotal
Customer ID (Required) Unique customer ID. _ccustid
List of Product IDs Array of Product IDs _cprod
List of Names Array of Product Names _cprodname
List of Categories Array of Product Categories _ccat
List of Quantities Array of Product Quantities _cquan
List of Prices Array of Product Prices _cprice

Vendor Documentation