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.
- Why use field mapping?
- Mapped fields in Experiences
- Mapped fields in Audiences
- Setting up field mapping
- Defining fields
- Finalizing mapped fields from enrichment sources
- Standard fields
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.
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!
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.
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 Map fields.
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.
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.
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.
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.
That's it! You're now ready to map fields in Brightback! As always please email us if you have any questions or concerns.