General Info

Events

Implanting ExposeBox script will provide the infrastructure for the data exchange between ExposeBox and your site. Copy and Paste the below script into a tag manager or thein all your web pages and make sure to replace necessary fields for start tracking.

The script loads asynchronously, therefore it won’t conflict with the page loading time or user experience.

The setup process can be accessed both through the workflow and the settings screen.

Following the script implementation on your website, you’ll be able to see your up-to-date statistics.

Status Meaning:

• Green – Set up successfully completed 

• Orange – Set up incomplete

For additional information, visit the ‘Settings’ page.

ExposeBox Basic Script

By sharing your Product Feed, it enables you to have a persist insight into your customer model and accurate product recommendation.

Add relevant product details in columns into the Data Feed. The new data automatically loaded to the free-data property of the product inside ExposeBox. We support all Feed standards.

When listing a new product, updating a previously reported product or removing a product from stock, all done seamlessly, as the Feed is processed periodically. 

In the following steps, we provide you with the code snippets for implementation, accompanied by explanations and examples.

 <script>

var companyId = 123456789; //Replace with your actual Company ID provided by ExposeBox.

var script = document.createElement(“script”);
script.type = “text/javascript”;
script.async = true;
script.src = “https://sf.exposebox.com/widget/predictl.min.js?c=&#8221; + companyId; //http(s): protocol depends on your website
document.getElementsByTagName(“head”)[0].appendChild(script);
window.predictlApi = window.predictlApi || function (cb) { var pa = window.predictlApi; pa.or = pa.or || []; pa.or.push(cb); }

</script>

Note: Replace the variable’s value with your CompanyID provided by ExposeBox. 

Product Pages

Integrating your products enables ExposeBox to suggest recommendations based on product performance. 

Integrate the following script on every product page on your site. In case the page contains multiple products, use an array of product IDs.

Category Pages

Integrating the Category pages enables ExposeBox to recommend products from the same category. The related categories should match the categories provided in the Product Catalogue.

The Event sends categories array that deducts from the breadcrumbs or the path in which the users place the products if they are consistent. 

The Category Array order is from the lowest level to the highest level of filtering (the current category will be the last)

Cart Events

Integrating Cart Events enables ExposeBox to detect abandoned items in the cart. This Event is used for both segmentation, recommendation, and can trigger the Marketing 360 automated journey.

The Event includes the ProductID, quantity and unit price of the SKU added to cart. The amount has to be the amount added/removed from the cart.

Example: user added 3 items of the same SKU to cart (event= “add 3”), then 2 removed from the cart (event=“remove 2”), then additional item added (event=“add 1”).

Purchase Event

Integrating Purchases enables ExposeBox to display recommendations based on customer purchase behaviour.

The event can be fired, when a conversion event has occurred, for example, when displaying a “thank you” page after purchase is complete. 

The total price should be the amount paid by the customer, after discounts, coupons and delivery.

Customer Details

You must Integrate Customer Details to enable the synchronizing between your online and offline data to be able to launch email and SMS campaigns.

Note:

• Event type – Active session – post-registration or login. Bear in mind the login event can also occur during the checkout.
  • The CustomerID field is mandatory. All other fields are optional. 
  • An email address can be used as the Customer Identifier, meaning the CustomerID is the email address.
  • The FreeData field used to pass additional customer properties, and it overrides the current values.

Segmentation Tags

By adding Segmentation Tags on all your desired site pages allows you to

customized attributes which you can later group to Audiences.

• The Audiences are used for executing Sponsored Products campaigns.
• The Segmentation Tag contains a key-value pair which you set based on your marketing/business needs.
• Segmentation Tags must be determined before the integration. 

Usage Example: An article page with ‘Hobbies’ key containing values as “knitting” or “gardening”, will enable you to build Audience groups that are interested in knitting or gardening.

Search and Filter Tags

Adding the Search and Filter tags enable ExposeBox to know the items your current users are interested in.

This Event is fired when users are running a search or filtering their preferences.

Note:

• The best practice is to send the top 6 products at the top of the search results page.
• You can always add additional properties, based on the filter parameters entered by the customer on your website.
• All fields are optional.

In the below example, a customer searched for “Men winter coats”, and next filtered the results by category, then min prices and fabric type.

Optional Custom Events

Integrating the Custom Script Event enables ExposeBox to provide additional learnings about customers’ behaviour. For example, when customers save a product to a Wish List, this improves the results provided by the algorithm and can also trigger the Marketing 360 Automation rules.

Checkout

The Event is fired once the customer clicked on the checkout button, usually at the cart page. Note that this Event doesn’t mean that the customer has completed the purchase.

Wishlist – Add and Remove

This enables ExposeBox to access the data of a specific user who is add/ removed an item to the Wish List.

Additional Custom Events

For custom Events please contact ExposeBox Professional Services through Customer Support.

Product Catalog (Feed)

This section of the Onboarding Guide details how your Product Feed provided to ExposeBox; Customer Model and Products Recommendations based on product properties.

Product Properties Determination

Product Definitions

The Product Property assists us in providing a better user experience, both by understanding the associations between the products and using the properties as part of a campaign layout. 

For example, a customer views a red dress and the Colour Property records the behaviour. ExposeBox then provides a recommendation to the customer and may show additional products tagged as ‘red’.

When additional details about the product are available, you should include it in the Feed in the form of new columns. The additional data automatically loaded to the free-data property of the product. We support all Feed conventions.

For Example, to add “colour map” or “relevant season” to the Product Properties, add two columns (one for each) with the product name convention. 

The order of the fields in the product catalogue is insignificant.

Feed Format

ExposeBox supports the following Product Feed formats:

• ExposeBox – custom Feed format explained below
• Google Merchant – Google Feed format
• Facebook Ads – Facebook Feed format

File types: text (.txt), a comma-separated values file (.csv).

Delimiter

All the formats support the following delimiters:

• Comma
  id,title,description,google_product_category,link,image_link,availability …
• Tab
  id title description google_product_category link image_link availability …
• Semicolon
  id;title;description;google_product_category;link;image_link;availability …

Run Schedule

The Feed can run:

Every couple of hours | Daily | Based on your Feed update frequency

For other run times, please contact ExposeBox support. 

URL

Add the URL of the updated Feed file

ExposeBox Feed Format

Example Feed file: https://storage.googleapis.com/app.exposebox.com/general/ExposeBox%20Feed%20example.csv

The included Parameters are

Testing Assets

Events 

The following section is a detailed view of the event-data passed from your website to ExposeBox. The screen can found in settings -> Events.

The Status and Total Events provided in the Events window:

Event setup section: in the below screenshot you can implement missing or additional events as described in Events.

To View the Details:

• In the ‘Event’ window, click the ‘View Details’ link of the Event you want to view.

It presents as following:

✶Activity presents the last 100 received events of this type

✶Received Domains presents the number of received events by Domain for the selected event type

Product Catalog 

Once the Feed processed, you will see the periodic Feed upload results in the below screen. The screen is accessible through the setup icon -> Product Catalog screen

 

 

Moreover, you can see the Products Properties at our product explorer screen located at Assets-> Products

For Example, the Product Feed also includes the price, colour and size fields, the price field can be verified via the price field and colour and size fields can be seen in the free data field.