Brightback Field Mapping

Field mapping allows you to map fields from your enrichment sources to be used in Brightback experiences, audiences or data analysis. Enrichment sources come from the Brightback.js or one of our supported enrichment providers.   In this article we'll cover when and how you can leverage field mapping in Brightback by highlighting a few features that Brightback offers.  

Field mapping enables:

  • Personalization of Brightback experience
  • Enriched notifications in Slack and Segment
  • Provides benchmarking data consistency
  • Provides enriched Brightback reporting

Data is retrieved every time the user hits your cancel page where the Brightback JS lives. We support the following sources for your Fields: Brightback JS, Salesforce, Stripe, Recurly and ChargeBee. For Salesforce, you can map to any Standard or Custom field on the Account Object. For Stripe, Recurly and ChargeBee Billing Enrichment we pull back a select set of fields from the subscription record that can be mapped into Brightback fields. 

Field mapping will be configured per Brightback Application to allow you to map different fields to support your various use cases. Integrations are also configured per Application now to map cleanly to Fields. For more on Brightback Integrations, visit this page

Back to top

Using mapped fields in Experiences

Mapped fields are available wherever you see the expression icon, is an area you can use to dynamically present content, add dynamic URL's or present engagement data. 

Pro Tip: Always use a fallback when placing expressions in experiences.  99% of the time the fallback is never used but if a canceler enters your experience a data issue you want the presentation to look polished!

The following headline would grab the cancellers name from Recurly and present it at the time of cancels.  This example below is simple but the possibilities are endless.   

For a more in depth look at how to create and edit your Brightback experiences check out our article here!

Back to top

Using mapped fields in Audiences

In addition mapped fields can be used as Properties for comparison when creating traffic rules for Audiences. For more on that check out our article on defining rules here

Back to top

Setup field mapping

To set up Field Mappings, navigate to Brightback Settings on the left hand navigation bar. Find the the field mappings section and click manage. 

FM2.png

Pro Tip: Map fields with caution! If you remove any of the mapped Fields, you will lose that data source!

Back to top

Defining fields sent through Brightback.js

By default, fields sent through Brightback.js are automatically detected but not mapped. To map them first click View all fields.

You will be presented with a field mapping modal that displays the discovered fields, standard fields and an option to add a custom field. 

Look for the field you would like to map and give it a meaningful name.  Remember to choose the correct field type. After you have saved imported fields, give it a display name you will remember and create the mapping to be used in Brightback experiences. 

Pro Tip: Choose the correct field type! Brightback provides numeric operators, URL validation and and Date comparison to be used for Audience Targeting. Choosing the wrong field type here can yield incorrect traffic routing. 

If you are working offline with your engineering team and our server has not picked up new fields yet, you can always manually create the field to prep for incoming sessions.  You'll need to know the exact syntax of what will be sent over so be sure to sync with your development team. 

After you have defined the fields coming from your Brightback.js snippet click save and get starting on mapping fields for use. 

Back to top

Finalizing mapped fields

After you've defined your fields sent through the Brightback.js snippet you can now map them for use in Brightback. Start by giving your fields a descriptive name so you can easily pick them from the expression and property dropdown selects.  

Type a name, select the field type and choose the source. You'll notice all of your enrichment sources in the drop down. 

Back to top

Standard fields

A  Standard Field Mapping maps directly to the Standard Fields on the JS Snippet. For a list of default Standard Fields, see our guide on Installing the JS Snippet.  Optionally you can swap these out for fields captured from your enrichment provider.  In the following image you'll see we've mapped the Salesforce Account Name to one our standard fields. 

Screen_Shot_2019-02-28_at_2.56.58_PM.png

That's it! You're now ready to map fields in Brightback! As always please email us if you have any questions or concerns. 

Back to top

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us