Simility Tag Setup Guide

Prerequisites

• Simility account

Tag Configuration

First, go to the tag marketplace and add the Simility Tag to your profile (See Add a tag).

After adding the tag, configure the below settings:

1. Customer ID: The unique identifier that you (or your company) received from Simility during signup. Customer ID is required; you may specify it in this field or set it dynamically via Data Mappings.
2. Zone: The location of the datacenter hosting your data. Available options are US (default) and EU.
3. Simility Lite: This is turned ON by default. If you turn it OFF, you must send additional user information such as geo-location, mouse movements, etc.
4. Simility Lite Level: The numeric (decimal) value you received from the Simility support team.

Simility Lite and Simility Lite Level settings are advanced configurations. For more details on these, please contact the Simility support team.

Load Rules

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

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:

Standard

Mapping to a Standard destination overrides its corresponding Tag Setting.

Transaction Info

Allows you to send transaction data (for example: user, orders, transactions, applications, profile, et cetera). Data is sent through the transaction_info object in the payload.

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": "johndoe@example.com",
          "order_categories": ["123", "456", "789"],
          "order_details": { "is_first_order": true, "num_retries": 1 },
       }
   }]
  };

E-Commerce

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

Vendor Documentation

• Simility Javascript