Integrate Convert Experiences with SurveyMonkey GetFeedback (Formerly Usabilla)

 THIS ARTICLE WILL HELP YOU:

• Understand the Convert-SurveyMonkey GetFeedback integration
• Add Tracking Code Snippets
• Send Custom Variables
• View Convert data in SurveyMonkey GetFeedback

Convert-SurveyMonkey GetFeedback Integration

SurveyMonkey GetFeedback, formerly known as Usabilla, can be integrated with Convert Experiences to include Convert experiment data in your feedback forms, buttons, and campaigns.

Existing Usabilla customers may still see the Usabilla name in older implementations, account settings, code snippets, or JavaScript functions.

For each experiment, the integration can pass the following information for the experience in which a visitor is currently bucketed:

• Experiment name
• Variation name

 Add Tracking Code Snippets

Make sure the Convert tracking code is installed on your page.

Next, create or access your SurveyMonkey GetFeedback account and configure the feedback forms, buttons, or campaigns you want to use.

Install the SurveyMonkey GetFeedback website feedback code snippet on every applicable page. Unless your implementation instructions specify otherwise, place the snippet immediately before the closing </body> tag.

 Send Custom Variables

You can send custom variables from any page where Convert Experiences and SurveyMonkey GetFeedback are running.

The following example sends the Convert experiment name and variation name to SurveyMonkey GetFeedback:

_conv_q.push({
  what: 'addListener',
  params: {
    event: 'snippet.goals_evaluated',
    handler: () => triggerGetFeedbackIntegration() // Trigger GetFeedback (Usabilla) integration
  }
});

function triggerGetFeedbackIntegration() {
  if (!window.convert || !window.usabilla_live) return;
  const data = getIntegrationData();
  if (!data.length) return;
  // GetFeedback's usabilla_live('data', ...) REPLACES the custom object on every
  // call, so send one combined object (a distinct key per experience) in a single call.
  const custom = {};
  for (const {experienceName, variationName} of data)
    custom[`Convert - ${experienceName}`] = variationName;
  usabilla_live('data', {custom});
}

function getIntegrationData() {
  const data = [];
  if (!window.convert) return data;
  for (const experienceId in convert.currentData.experiences) {
    const variationId =
      convert.currentData.experiences[experienceId].variation.id;
    const experienceName = anonymizeData(
      convert.data.experiences.find(
        ({ id }) => String(id) === String(experienceId)
      )?.name || "unknown experience name",
      experienceId
    );
    const variationName = anonymizeData(
      convert.currentData.experiences[experienceId].variation.name ||
        "unknown variation name",
      variationId
    );
    data.push({
      experienceId,
      experienceName,
      variationId,
      variationName,
    });
  }
  return data;

  function anonymizeData(data, anonymized) {
    if (!data || !window.convert) return "";
    if (convert.data.project.settings.data_anonymization)
      return anonymized;
    return encodeURIComponent(data.replace(/[^a-zA-Z\-_.\s0-9]/g, "")).slice(
      0,
      40
    );
  }
}

View Convert Data in SurveyMonkey GetFeedback

The custom variables will be included with the relevant feedback items and campaign results in SurveyMonkey GetFeedback.

You can use these variables to:

• Identify the Convert experiment associated with a response
• Identify the variation shown to the visitor
• Compare feedback across experiment variations
• Add experimentation context to qualitative feedback
• Target campaigns using specific custom-variable values

In older accounts, interfaces, or exported data, you may still see references to Usabilla. These references relate to the same product now known as SurveyMonkey GetFeedback.