Salesforce Commerce Cloud

Fanplayr 360 tracks user behavior on your site.

Both general page views and order details are tracked by Fanplayr 360.

Download

Installation

To install our cartridge and integrate into your store you will go through the following steps:

  • Import site preferences

  • Import the Cartridge into UX Studio

  • Add to Effective Cartridge Path

  • Set up site preferences

  • Add Fanplayr 360 tag to your template

  • Test tracking

Import site preferences

The first thing to do is import the preferences

  • Log into your Business Manager

  • Go to Administration / Site Development / Import & Export

  • Click Upload under Import & Export File

  • Choose the file at _/metadata/fanplayr_preferences.xml and click Upload

  • Go back to Administration / Site Development / Import & Export and click the Import link

  • Select the newly uploaded file. Click Next >>.

  • Step 3 should display the following information. Click the Import link at the bottom right.

You should now have access to Fanplayr 360 preferences at Merchant Tools / Site Preferences / Custom Site Preferences

Import Cartridge into UX Studio

If you are using UX Studio to work with your site these steps show you how to import our Cartridge including Scripts, Controllers and Pipelines. If developing your site using another technique please contact us for help or follow the general rules for adding Cartridges there.

  • Open UX Studio

  • Go to the File / Import menu

  • Choose General / Existing Projects into Workspace and click Next

  • Select the directory /int_fp360/ and then tick the box next to the Fanplayr listing. Click Finish. This should add the Fanplayr 360 components to your project. You may be asked if you want to sync this with your store, please do that.

Add to Effective Cartridge Path

We now need to add Fanplayr 360 to our Effective Cartridge Path. This let’s your site know to run the code imported with Fanplayr 360 on your site.

  • Log in to your Business Manager

  • Go to Administration / Sites / Manage Sites

  • Choose your site

  • Go to Settings

  • Add the string “int_fp360:” (no quotes, make sure there is a colon at the end) to the start of Cartridges field.

Set up site preferences

Before we get Fanplayr to start tracking we will need to add your Fanplayr Write Kye and Endpoint to the preferences. You can get this information by creating a new SFCC source in Fanplayr 360 portal.

  • Log in to your Business Manager

  • Go to Merchant Tools / Site Preferences / Custom Preferences

  • Click Fanplayr 360

The first two values, “Enable Fanplayr?”, “Write key” and ”Endpoint” are required to get Fanplayr to start tracking on your site.

Below are listed details about each option.

Enable Fanplayr 360? (required)

Set this value to true to enable Fanplayr tracking.

Write Key (required)

You must supply your Write Key to start tracking with Fanplayr 360. You can get a write key by creating a new SFCC source in Fanplayr 360 portal.

Endpoint (required)

You must supply your Endpoint to start tracking with Fanplayr 360. You can get a write key by creating a new SFCC source in Fanplayr 360 portal.

Track during Checkout?

By default this is set to false. We do not track during checkout to help you with PCI Compliance. If you would like Fanplayr to track during checkout please enable this option. Please note that we do not send any information about payment methods or details.

Add Fanplayr 360 tag to your template

The last step in getting Fanplayr to start tracking is to add our tag to your template. This should be done in a template that is on all pages. Normally this would either be in the header or footer files which should be located:

Header: Templates/components/header/htmlhead.isml Footer: Templates/components/footer/footer.isml

The tag to include is as follows:

<isinclude template="util/FanplayrTracking.isml"/>

This template will track both normal user tracking as well as order tracking.

Last updated