All Collections
Troubleshooting
Shopify Integration: How To Fix UTM Errors
Shopify Integration: How To Fix UTM Errors

Learn how to troubleshoot UTM errors on your ads for your Shopify integration.

Updated over a week ago

Understanding the Red Dot Indicator

Cometly provides a visual aid, a red dot, to alert you of potential UTM setup errors on your campaigns, ad sets, ad groups, and ads. If you see a red dot next to any of these items, it indicates a possible mistake in the setup of the UTM parameters.

Important: If you have imported your campaigns in the last hour, you may see a UTM setup error until the next data refresh. Please provide up to 1 hour for the next data refresh before taking additional troubleshooting steps.

Troubleshooting Steps

Step 1: Identify what ad channel is displaying the error

The troubleshooting steps are different depending on the ad channel. Hover over or click on the red dot. A tooltip will appear indicating that you have a set up issue.

Step 2: Ensure you have selected UTM parameters

For your Shopify space, you must make a UTM parameter configuration selection in the Getting Started section under the step 'Setup UTM parameters on your ads'.

To make a selection, please visit the Setup page and follow the steps below:

Select step Setup UTM parameters on your ads

Ensure you have selected the UTM configuration as shown below. You can choose any utm parameter for the ad.id. It must match the parameter setup that you have in place on your ads.

Important: When you make the selection below, the parameters you can copy above may change depending on your selection. Follow the steps below to check parameters.

Step 3: Check the UTM parameter setup inside Cometly Ads Manager

For your Shopify space, you must make a UTM parameter configuration selection in the Getting Started section under the step 'Setup UTM parameters on your ads'.

For Facebook & TikTok

  • For Facebook and TikTok, you can easily check your parameter configuration by navigating to the Cometly Ads Manager for your Facebook ad account or TikTok ad account and changing the columns to the preset 'Tracking Status'.

    • Make sure you go to the 'Ad Level' in the Cometly Ads Manager to see the Ad Link and URL Parameters.

    • TikTok should have parameters directly on the link.

If you need help updating your Facebook or TikTok UTM parameters, please click the button below.

For Google

  • For Google, you can easily check your parameters by navigating to the Cometly Ads Manager and select your Google Ad account.

  • Google uses a campaign tracking template, that is located at the 'Campaign Level'.

  • Select 'URL Params' in the columns

You should now see the tracking template, ensure that is the correct tracking template.

Cometly needs the following UTM parameter code attached to the end of every Website URL in the 'Tracking Template' section of each of your regular Google ad campaigns that are not Smart Campaigns:

{lpurl}?utm_source=google&utm_campaign={campaignid}&utm_content={adgroupid}&utm_term={keyword}&utm_medium={creative}

Cometly needs the following UTM parameter code attached to the end of every Website URL in the 'Tracking Template' section of each of your Google Smart Campaigns:

{lpurl}?utm_source=google&utm_medium={network}&utm_campaign={campaignid}&utm_content={creative}&utm_term={keyword}&ref=smart

To set these up inside the Google Ads manager, navigate to Settings > Campaign Settings and select the campaigns that you want to track with Cometly. Then click Edit > Change tracking templates.

Then you should see a box labeled New tracking template and this is where you will need to place the UTM parameters listed above.

Once those parameters have been pasted, you can click Apply to apply those changes.

Step 4: Wait for updates

Important: If you made any changes to your UTM parameters inside Facebook, TikTok, or Google, you may have fixed the issue but you will continue to see the red dot indicating a UTM Setup Error until the next data refresh.

Please allow Cometly up to 1 hour to refresh data.

If you have resolved the UTM Setup error, the red dot indicating an error will go away.

Did this answer your question?