++ Field Mapping Definitions

When setting up integration rules (for HubSpot, Pipedrive, Salesforce, Google Sheets, etc.), you can map the following data points to your CRM fields.

Event Details

• Event Name: The human-readable name of the custom user event triggered (e.g., "Pricing").
• Event Type: The system event type (eg: identity_conversion, contact_us, see full list of system events here) or custom for custom user events.
• Event Date: The exact date and time the event occurred.
• Event Code: The internal system code used to identify the specific custom user event (e.g., billing_page    ).

User Profile

• User Created Date: The date the user record was first created in Bread & Butter.
• User State: The current status of the user (e.g., Anonymous, Identified, Verified).
• User Email address: The primary email address associated with the user.
• User First Name: The user's first name.
• User Last Name: The user's last name.
• User Profile Image URL: A link to the user's profile picture (if available from social providers).
• User Company: The company name associated with the user (derived from email domain or enrichment data).
• User Provider: The authentication method the user originally used to sign up (e.g., Google, Microsoft, Local Login).

Marketing & Attribution (User Origin)

These fields capture the source of the user's first visit.

• User Referrer: The website that referred the user to your site originally.
• User UTM Source: The source of traffic (e.g., google, newsletter).
• User UTM Medium: The marketing medium (e.g., cpc, banner, email).
• User UTM Campaign: The specific campaign name.
• User UTM Term: The search term used (for paid search).
• User UTM Content: The specific content piece or link clicked.
• User UTM GCLID: The Google Click Identifier for Google Ads tracking.
• User UTM GCLSRC: The source of the Google Click (e.g., "aw" for AdWords).
• User UTM DCLID: The DoubleClick Click Identifier.
• User UTM FBCLID: The Facebook Click Identifier.
• User UTM MKCID: The Mailchimp Click Identifier.

Location & Network

• IP Address: The IP address of the user during the event.
• Continent: The name of the continent where the user is located.
• Continent Code: The two-letter code for the continent (e.g., NA, EU).
• Country: The name of the country where the user is located.
• Country Code: The two-letter country code (e.g., US, CA).
• State or Province: The full name of the state or province.
• State or Province Code: The abbreviated code for the state or province (e.g., NY, BC).
• City: The city where the user is located.
• Longitude: The longitude coordinate of the user's approximate location.
• Latitude: The latitude coordinate of the user's approximate location.
• ISP: The Internet Service Provider used by the user.

Device & Technology

• Operating System: The OS of the user's device (e.g., Windows 10, macOS, iOS).
• Device: The type of device used (e.g., Desktop, Mobile, Tablet).
• Browser: The web browser used (e.g., Chrome, Safari, Edge).
• Is Bot?: A boolean indicating if the traffic is identified as a bot or crawler.

Authentication Context

• Authentication Provider: The unique ID or code of the provider used for the current session.
• Authentication Provider Name: The human-readable name of the provider (e.g., "Google").
• Authentication Started Provider: The provider the user attempted to use to start the flow (useful if they switched providers mid-stream).

Page View Context (Current Session)

These fields capture data specific to the current page view where the event occurred.

• Page View Title: The title of the web page where the event happened.
• Page View Raw URL: The complete URL of the page, including all query parameters.
• Page View Base URL: The URL of the page without query parameters.
• Page View UTM Source: The source parameter present on the specific page view.
• Page View UTM Medium: The medium parameter present on the specific page view.
• Page View UTM Campaign: The campaign parameter present on the specific page view.
• Page View UTM Term: The term parameter present on the specific page view.
• Page View UTM Content: The content parameter present on the specific page view.
• Page View UTM GCLID: The Google Click ID present on the specific page view.
• Page View UTM GCLSRC: The Google Click Source present on the specific page view.
• Page View UTM DCLID: The DoubleClick ID present on the specific page view.
• Page View UTM FBCLID: The Facebook Click ID present on the specific page view.
• Page View UTM MKCID: The Mailchimp Click ID present on the specific page view.