Integrate with Shopify through our Shopify Convert App

Follow the steps below to install, configure, and start using Convert on Shopify.

---

Step 1: Install the Convert Shopify App

• Locate the Convert Experience app:
  Locate the “Convert Experiences” app in the Shopify App Store by going to this URL: https://apps.shopify.com/convert-experiences
  
  
• Install the App:
  • • Click Install App and follow the prompts to add Convert to your Shopify store. The app will appear under Apps in your Shopify admin.
      
      
      
      

---

Step 2: Authenticate with Your Convert API Key

1. Open the Convert App:
   • In your Shopify admin dashboard, go to Apps and select Convert Experiences.
   • Next, click on Start Setup. 
     
2. Enter Your Convert API Key:
   • Paste your Convert API key in the designated field. To locate your API key, log into your Convert account and go to Account Settings > API Keys.
     
3. Click Connect:
   • Once connected, the app validates your key and securely links to your Shopify store.
     

---

Step 3: Configure Project Settings

1. Enter the required details:
   • After connecting, choose from the dropdown list:
     1. Project name you wish to track.
     2. Store’s currency from the dropdown list. This currency will be used to track revenue data.
     3. The goal name you use to track completed checkouts.
2. Save Settings:
   • Click Save to confirm your selection.

---

Step 4: Set Up Goals

With Convert, you can set specific goals to track user actions like adding items to the cart or making purchases.

1. View Available Goals:
   • You’ll see a list of goals including:
     • Revenue
     • Add to Cart
     • Cart Viewed
     • Product Added to Cart
     • Product Removed from Cart

1. Select Relevant Goals:
   • Use the dropdown to select the goals you wish to track in your experiments. Selected goals will automatically save to your project.
2. Click Save:
   • Once you’ve chosen your goals, click Save to apply them to your project.

---

Step 5: Enable the Tracking Script

To accurately capture data, enable Convert’s tracking script from the Shopify console:

1. On the right hand side under Theme Section, click on “Install  Tracking Script”
   
2. This will open the theme editor window with a toggle ON/OFF button to install the tracking script.
   
3. Click “Save” on the right-hand side in the top corner.
4. In the previous window click on “Check Tracking Script” button to verify if the installation was successful. You should see “Tracking Script Installed!” message.
   

---

Step 6: Create an Experiment in Convert

Now that your Shopify store is connected, it’s time to set up your A/B test.

1. Log into Convert:
   • Go to your Convert dashboard, click Experiments, and select Create New Experiment.
2. Enter Experiment Details:
   • Name your experiment, describe it, and specify the Shopify URLs you’ll be testing (e.g., homepage, product pages).
     
3. Select Goals:
   • Choose the goals you set up earlier (like Add to Cart or Revenue) to track their performance during the experiment.
     
4. Create Variations:
   • Open Convert’s Visual Editor to make changes such as altering button colors, updating CTAs, or adjusting product images. These changes apply directly to your Shopify pages without affecting your theme files.
     
5. Save and Start the Experiment:
   • Once configured, save and activate the experiment to begin collecting data.

---

Step 7: Monitor Experiment Results in Real-Time

With your experiment running, use Convert’s reporting features to monitor and analyze performance.

1. View Data in Real-Time:
   • Access live data in Convert to see metrics like goal completions, conversions, and traffic variations.
2. Evaluate Variation Performance:
   • Compare variations based on goals to identify changes that positively impact conversions.
3. Optimize Based on Findings:
   • Use the data from your experiments to make informed adjustments, launch additional tests, or implement winning changes on your Shopify store.

---

🧠 Advanced Information: Checkout Extensibility and A/B Testing

Due to Shopify’s recent Checkout Extensibility updates, direct checkout testing is currently unavailable. Here’s how it impacts Convert’s Shopify app:

• Restricted JavaScript Access:
  • Convert’s tracking does not apply to checkout pages directly due to sandbox restrictions. Instead, Convert relies on Shopify Pixels and Order Webhooks for checkout-related data tracking.
• Tracking Outside Checkout:
  • While direct checkout modifications are unavailable, you can still gather valuable data on pre- and post-checkout behaviors using Shopify Pixels.

These changes enhance security and ensure consistent checkout performance, even as Shopify introduces new features for future checkout testing.

❗ Compatibility Note

App embed blocks are only supported in Online Store 2.0 themes. If your store uses a vintage or legacy theme:

• App embed blocks may not function correctly.

• They could display as HTML comments or not render at all, depending on how the theme handles unsupported elements.

• You may need to consult the app developer for alternate methods of integration or migrate your theme.

Learn more: Shopify OS2.0 Migration Guide

---

❓ FAQ

Q: Can I test the checkout flow?

• Currently, A/B testing within checkout is unavailable due to Shopify’s Checkout Extensibility.

Q: How do I track conversions without relying on the order confirmation page?

• Convert uses Shopify Pixels to capture site-wide events, eliminating the need for an order confirmation dependency.

Q: Do I need to manually update the app?

• No, updates are automatic, and your experiments won’t be interrupted.

Q: Is the Convert app compatible with all Shopify plans?

• Yes, it’s compatible across all plans and aligns with Shopify’s API and infrastructure updates.

Q: Does the Convert app work with vintage themes?

• No. The Convert Shopify App relies on features available only in Online Store 2.0 themes. Vintage or legacy themes do not support app embed blocks, and the app may not function as intended.