Data Layer Connection

What: The Data Layer Connection can feed Segment or Profile information from BlueConic to your channels by pushing data into an existing or newly created data layer (JavaScript object). The import and export of data work in real time.

About BlueConic: BlueConic is a Customer Data Platform that harnesses the data required to power the recognition of an individual at each interaction, and then synchronizes their intent across the marketing ecosystem. Click here to learn more.

Why: Your marketing stack partly lives on your channels and can integrate data from a data layer. Use this connection to share first-party data out to the stack for your known and anonymous users, whether it was collected by BlueConic or integrated through another BlueConic connection.

 

Adding a Data Layer connection

  1. Click Connections in the Navigation bar.
  2. Click Add Connection.
  3. A pop-up window appears. Check the Show all box. Enter "data layer" in the Search bar.
  4. Click Data Layer connection.
    The Data Layer connection page opens.

    You can expand or collapse metadata fields (favorite, labels, and description) by clicking the gray + or .

Configuring the connection

Setup

  • Optional: Restrict the connection to only be active on specific channels or URLs.
  • Check the box Create a new data layer to tell the connection to create a new data layer on the page with the name you enter below.
  • Set up the connection by confirming the Data layer name that that you will be using. You can enter the name of an existing data layer or use a custom name.
  • Click Save to store the information.

Data exchange shows the total number of unique profiles that have been imported or exported via the connection. Note that these are unique profiles - if the same profile is exported multiple times, it is counted as 1.

DataLayer_exchange.png

The connection provides you with goals:

To make the connection work, you have to add at least one goal and switch the connection on.

Import data into BlueConic

To import data into BlueConic, click the Add goal button to add an import goal and follow the steps laid out in the goal.

  1. Select the BlueConic segment that holds the profiles that can be enriched with data from the data layer.

    In the top right-hand corner, the number of profiles available for the import appears.

    profiles.png

    This number shows how many profiles meet the conditions for the selected segment (for example, they have an email address and gave required consent for an objective) and therefore are available for the import. BlueConic tries to import only the profiles that have changed since the last import. The number of profiles imported might be lower than the number displayed here.

  2. Click Add mappings via visual picker or the link Add mapping (without visual picker) to add a mapping.
  3. Map the data layer data to BlueConic profile properties. Enter the name of the data layer field, or enter a Jsonpath expression (that starts with $.) to select the data. Select the BlueConic profile property the data populates by entering a search term.

    Select how to import the data from the drop-down list:

    • Set
    • Set if empty
    • Add the data field to the list of existing values
    • Sum a number with the existing values (if the data field is a number)

    Optional: Click the settings cogwheel to restrict when a value is allowed to be picked up. Enter a variable name and the value it should be equal to and click OK.
    mclip02.png
    Click Save on the top right corner of the screen to save your import goal.

  4. Optional: In the left panel, click Add goal and then Import goal to create another Import goal.

 

Export data into a data layer

To export data into a data layer, add an export goal and follow the steps laid out in the goal.

  1. Select the BlueConic segment that holds the visitors that will be exported to the data layer when they visit one of the channels selected under Setup.

    In the top right-hand corner, the number of profiles available for the export appears.

    profiles.png

    This number shows how many profiles meet the conditions for the selected segment (for example, they have an email address and gave required consent for an objective) and therefore are available for the export. BlueConic tries to export only the profiles that have changed since the last export. This number of profiles exported might be lower than the number displayed here. 

  2. Map the BlueConic data that you want to export into the data layer. Select a BlueConic profile property by entering a search term and enter the data field value it should populate. Click Add mapping to add a new mapping rule for a property, or click Add multiple mappings to add rules for a number of properties.

    Click the BlueConic icon to open a drop down menu where you can switch between the type of information you want to export. Pick one of:

    • BlueConic profile identifier: the unique identifier for a profile
    • Associated segments: all segments, or a selection of one or more specific segments that the profile is associated with
    • Profile property: the value of a specific profile property
    • All viewed interactions (all time): the interactions that the profile has seen
    • Permission level: the permission level set in the profile
    • Text value: enter any static text

    mclip03.png
  3. Set up data configuration for exporting profile properties to the data layer -- as a single text value (string) or as a list with multiple values( an array). Enter the character to be used as a separator between values.
  4. Define when BlueConic data should be pushed to the data layer:
    1. Select the Push frequency you prefer: upon each page view, only when values for the export properties change, once per visit, or when permission levels change.
    2. Optional: Select a BlueConic event that should also trigger this goal - in addition to the push frequency above.

Note that you can use the Add goal button create multiple export goals for this connection.

Connection status

Once you've set up and saved your connection, the icon at the top will reflect the status of the connection.

There is an arrow going from the data layer to BlueConic, signifying that data is being imported. At the same time, there is also an arrow going the other way, meaning data is being also exported from BlueConic to the data layer. Also, the arrows are green, meaning the connection is ready to be used.

On the Setup tab, under Data exchange you can see the number of unique profiles that were imported or exported by the connection.

mceclip5.png

Privacy management

Connections can be added to Objectives, allowing for privacy management of the information that is being picked up. A connection will only process the profiles of visitors who have consented to at least one of the objectives that the connection is linked to.

 

The Data Layer Connection is a standard plugin.