App Settings: Configure ABConvert for Your Store

Documentation Index

Fetch the complete documentation index at: https://docs.abconvert.io/llms.txt

Use this file to discover all available pages before exploring further.

The Settings page is where you control the core behavior of ABConvert across your store. Most settings apply globally to all experiments, so it’s worth reviewing them before you launch your first test.

​

Theme connection

The ABConvert unified script must be activated in your theme for experiments to run. This app embed loads the tracking and experiment logic on every page of your storefront. You can check connection status or change methods here.

​

Connect method 1: Theme embed app (recommended)

1. Click Change method
2. Choose Use app embed
   
3. Follow the steps to enable in Shopify theme editor and click Verify status to check
   

Once enabled, the unified script loads automatically on all pages. You don’t need to re-enable it unless you switch to a new theme.

​

Connect method 2: Manual installation (for edge cases)

If your theme has a unique pattern or needs special configuration for better performance, you can install the script manually by adding a code snippet to your theme’s theme.liquid file. This method requires manual management to your theme files, only change to this method when needed. Steps for manual installation:

1. Click Change method
2. Choose Add script to theme code
   
3. Follow the steps to add scripts to your Shopify theme.liquid file
   

After finishing, when you update or change your theme, you still need to re-add this snippet to the new theme’s theme.liquid file.

​

WebPixel status

ABConvert uses a Shopify web pixel to track visitor events — page views, add-to-cart, checkout — with high accuracy. The web pixel is required for accurate analytics. Without it, ABConvert cannot collect and show experiment data correctly in analytics dashboard. If the web pixel is not enabled, please create Webpixel before start a test. If it becomes misconfigured, use the Reset option to recreate it.

​

Carrier service

Carrier service configuration is required for shipping rate experiments. When a carrier service is registered, ABConvert intercepts Shopify’s shipping rate requests and returns the test rates for visitors in the experiment group. The Settings page shows whether a carrier service is currently configured. You can delete the carrier service from this page if you no longer need shipping tests.

​

Order tag

ABConvert can automatically tag orders with experiment data, making it easy to segment orders by test group in your Shopify admin or in reports exported from ABConvert. Click Configure order tags in Settings to open the tag configuration panel. For each experiment type, you can choose one of three tagging modes: Order tags are available for: Price Test, Shipping Test, URL Redirect Test, Template Test, Theme Test, and Checkout Test.

​

Price test method

ABConvert evaluates your store during setup and assigns the optimal price test method. Currently, you cannot switch your method on your own, and all stores will be using Shopify function by default.

​

Order outlier filter

The order outlier filter excludes unusually large orders from your Analytics dashboard, preventing them from skewing your experiment results. You can choose from three filtering methods:

​

Maximum revenue per order

Set a dollar threshold (e.g., $500). Any order above this amount is excluded from analytics. Use this when you know the upper bound of typical orders for your store.

​

Z-score exclusion

Define a threshold between 1 and 5 (typical range: 2 to 4). Higher values keep more orders; lower values exclude more outliers. A threshold of 3 excludes orders more than 3 standard deviations from the mean.

​

COGS settings

ABConvert uses your COGS (cost of goods sold) data to calculate profit metrics in analytics, including Profit per Visitor, Profit Uplift, and other profit-based comparisons. Click Manage COGS settings to configure these fields: Product Costs

• Automatic mode: Sync product costs directly from Shopify. Choose daily sync frequency if your costs change often.
• Manual mode: Upload a CSV file with product costs for more control

Shipping Costs

• Set your average shipping or fulfillment cost per order

Transaction Fees

• Configure payment processing fees as percentage + fixed amount (e.g., 2.9% + $0.30)

Tier Costs (optional)

• Override base product costs by quantity tier for wholesale or bulk order scenarios
• Define cost breaks at different quantity thresholds

​

GA4 Measurement ID

Enter your Google Analytics 4 Measurement ID here to connect ABConvert to your GA4 property. When configured, ABConvert fires a custom event in GA4 each time a visitor is assigned to an experiment, letting you analyze experiment data alongside your other GA4 metrics. See GA4 Integration for setup instructions.

​

Settings FAQs