Flocktory is a complete marketing platform. SegmentStream allows you to send data about the behavior of your users to Flocktory.

Page contents


Introduction


With SegmentStream, you can fully integrate Flocktory with your site.

To set up integration with Flocktory:

  1. Log in to segmentstream.com
  2. Go to the “Integration” tab and click on the block with the Flocktory logo.
  3. In the panel that opens, configure the integration.

Required events and variables


For the correct integration of your site with Flocktory - you need to configure the transfer of events in the digitalData.events array. The list of events is as follows:

Required events

Required variables

Website ID


By entering your Flocktory website ID in this field you enable the main Flocktory integration. You can read about it in detail on the Flocktory documentation page

You can find your website’s ID in your Flocktory admin panel – or request the ID from your Flocktory account manager.

Enable Postcheckout


Enabling this toggle switch will activate the Flocktory Postcheckout module. You can read about it in detail on the Flocktory documentation page

Enable Precheckout


Enabling this toggle switch will activate the Flocktory Precheckout module. You can read about it in detail on the Flocktory documentation page

Enable Exchange


To activate the Flocktory Exchange module you have to enable the toggle switch, activate the Postcheckout module, and integrate a line of HTML code on all pages where you want to display Flocktory Exchange banners.

HTML code example:

<div class="i-flocktory" data-fl-action="exchange" data-fl-spot="some_spot" data-fl-user-name="Ivan Ivanov" data-fl-user-email="[email protected]"></div>

You can read about it in detail on the Flocktory documentation page

Exchange trigger event


By default, the Exchange banner is triggered when the Completed Transaction is pushed to the digitalData.events array. Fill this field with the name of the event that you want to trigger the Exchange banner.

This feature is usually used in scenarios where a website sends the Completed Transaction event right before redirecting to an online payment system, therefore leaving no chance for the Exchange banner to be viewed. To overcome this, a separate event has to be created, which is triggered when the user is redirected back from the payment system to the ‘Thank You’ page, for example Viewed Thank You Page.

Setting an exchange spot


Spot is an optional parameter that serves as an internal filter for Flocktory campaigns. It should be used if you have different “thank you” pages and want to show different campaigns on each one. There are two ways to set the Spot parameter through SegmentStream:

  • Add a spot parameter to the Completed Transaction event and the configured exchange trigger event, for example:
    window.digitalData.events.push({
      category: 'Ecommerce',
      name: 'Completed Transaction',
      transaction: {
        //transaction data
      },
      spot: 'desktop'
    });
    window.digitalData.events.push({
      name: 'Viewed Thank You Page',
      spot: 'desktop'
    });
    
  • Dynamically map digitalData parameters to different spot values, for example, if you need to pass a spot value of redesign if the digitalData.website.redesign value is true, and pass old if the value is false or undefined you have to follow the following steps:
    1. Open the Flocktory integration and click on the “Event variables” tab.
    2. Click “Add”
    3. Fill the ‘Variable name’ field (a) with the ‘spot’ value and leave the ‘Event name’ field (b) empty, so that the spot parameter of all events sent to Flocktory will be overwritten.
    4. Finally enter the code into the Handler function field (c), that will determine which value to set to the parameter depending on the value of the digitalData.website.redesign variable.
    5. Save (d) the event variable.

You can read about it in detail on the Flocktory documentation page