Segment Customer Data

Standardize and sync your survey data with your databases, marketing and SaaS tools to enrich, personalize and re-market.

With this integration, you can send labeled question responses to Segment which can then be passed to any of the different systems that Segment integrates with.

Note: The Segment integration is limited to one integration per survey. Additionally, this integration is an Enterprise level feature.

🏠 Where it lives

  1. Navigate to your survey's integration home page.
  2. Click + Add on the Segment Customer Data integration.

🔨 How it works

  • Start by selecting your Tracking method. Segmanta integrates with two different types of communication via Segment’s API (which is the same as Segment’s write key). Those include:
    • Track: It records any actions your users perform, along with any properties that describe the action. Data will be sent as an event  (i.e. consumer purchased, consumer reached sign-up), with additional information sent as properties.
    • Identify: It lets you tie a user to their actions and record traits about them. Data will be sent as a trait.

Note: Event name will only appear for Track.

Important: Only events that are toggled on will be sent to Segment. You will not be able to retroactively send previously collected data using this integration.

Important: If you add your Segment Write Key to a Survey, you are responsible for the data collected by Segment.

  • Toggle on the actions you want to act as triggers to send data to Segment.

  • Label the question pages or subjects and answers that you want sent to Segment using the Key and Values as defined in Segment.

Important: Label everything that is or might be relevant for you to pass to Segment. If a question, subject or answer choice is not labeled with a key and/or value, you will not have what you need to locate the data in Segment.

  • Optionally, set context fields that will be sent within the Segment context object. Context fields can be single-level or multi-level. You may also send additional static data as traits. Enter the key and value for traits.

💼 What it does

      • Segment has a progressive profiling approach. This means when a consumer is identified, it is anonymous before additional identifiers are added, which eventually form a user ID.
      • Therefore, if you are sending your survey to previously identified Segment users, you must provide their ID to the Segmanta survey by using a seg_erid, Segmanta’s external respondent ID.
      • You could also pass an anonymous user id using the ajs_aid param (which is not recommended by Segment). If neither parameter is passed into the Segmanta survey, Segment will consider the user anonymous and assign them with a new ID. 
      • Segmanta provides support for passing a list of Segment Custom ExternalIds through a dedicated URL query parameter sgmnt_ceids

      Pro-tip:

      For example, the following data

      "sgmnt_ceids": [
          {
             "collection": "users",
             "encoding": "none",
             "id": "1234567890",
             "type": "phoneNumber"
           }
      ]

      is to be passed as:
      sgmnt_ceids[0][collection]=users&sgmnt_ceids[0][encoding]=none&sgmnt_ceids[0][id]=1234567890&sgmnt_ceids[0][type]=phoneNumber

      Or for both embed types:

      <script>
              window.SEGMANTA__USER_METADATA = {
                  "sgmnt_ceids": [
          {
             "collection": "users",
             "encoding": "none",
             "id": "1234567890",
             "type": "phoneNumber"
           }
      ]
              }
      </script>

      Note: The externalId encoding field is always set to “none” and is not needed to be passed in the querystring. The collection field value is assumed to be ‘users’ if omitted.