How to setup Shopify

Learn how to setup your Shopify store with Cometly.

Updated over a week ago

Step 1 - Connect your integrations

To set up a Shopify workspace in Cometly, the first step is to simply connect your Ad Channel integrations and your Shopify store integrations. The video below explains exactly how to do this step by step.

A) Connect to ad channels

To connect your integrations, simply navigate to the Space Settings page to view all your connected integrations. To connect to your ad channels, click the "Manage Connections" link to go to the profile integrations page. From this page you can connect to your different ad channels by clicking the blue "connect" button next to the Ad Channel that you need to connect. You will be redirected to the ad channel platform where you will just need to click "Accept" before being redirected back into Cometly.

B) Connect your ad accounts to the Workspace

Once your Ad Channels have been connected, navigate back to the Space Settings Page

and click the green "Connect" button next to the ad account that you want to connect to the workspace for this specific Shopify store.

C) Connect your Shopify store to the Workspace

To connect your Shopify store to the space, add in the website URL for your Shopify store and click the "connect" button. You will be redirected to the Shopify store where you will be prompted to Install the Cometly app. Once that is complete, you will be redirected back to Cometly where you will see that the Shopify store is now "connected"


Step 2 - Install the Cometly Pixel on your store

Important: If you have multiple Shopify stores with different spaces, please note that each space has a unique pixel.

A) Add the 'Base Code' of the Comet Pixel to theme before the closing body tag

  1. Navigate to "Online Store" in Shopify.

  2. Select "Actions" dropdown, and click "Edit Code"

  3. Select "theme.liquid" dropdown, and find the closing body tag </body>

  4. Paste the Comet Pixel 'Base Code' just before the closing body tag </body>

  5. Click "Save"

  6. Repeat this step for any other layouts that begin with "theme." and end with ".liquid", i.e. if you are using pagefly or gempages, you likely have other layouts that you will need to add the Comet Pixel base code to just before the closing </body> tag.

*Please note: your code will look slightly different from the code in the screenshot*

B) Add the 'Conversion Code' of the Comet Pixel to checkout "Additional Scripts"

  1. Navigate to "Settings" in Shopify.

  2. Select "Checkout"

  3. Scroll down to "Additional Scripts"

  4. Add the Comet Pixel 'Conversion Code' to "Post Purchase Page" and "Order Status Page"

  5. Click "Save" at the bottom.

*Please note: your code will look slightly different from the code in the screenshot*

If you do not see a box for "Post-purchase page," do not worry. This is only for stores with an app that uses a Post-purchase page, like Zipify.


Step 3 - Setup UTM Parameters on your Ads

Important: Shopify has specific parameters for setup that are different from other Cometly integrations. Ensure that you use the parameters in the Getting Started section of your Shopify space or below.

Setting up your UTM parameters correctly is ESSENTIAL for accurate attribution with Cometly. If any of your ads are not set up correctly then Cometly will not be able to track a portion of your sales (i.e. Cometly will not track any purchases from an ad if it does not have the correct UTM set up). If you follow the instructions below, your UTM setup will be perfect for tracking your ads with Cometly.

A) Select Your UTM Parameter Configuration

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 All Shopify Spaces: You must make a UTM selection or purchases will not track. Please follow the easy steps below.

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

  • Select step 3 'Setup UTM parameters on your ads'

Setup UTM Parameters on your Ads For Cometly
  • Ensure you have selected your UTM configuration. You can assign any of the following UTM parameters to the {{ad.id}}:

    • utm_campaign

    • utm_medium

    • utm_content

    • utm_term

    • ref

  • utm_source can be one of the following, though we recommend you use the dynamic site_source_name:

    • {{site_source_name}}

    • facebook

    • google

    • tiktok

  • After you have selected your UTM configuration, the parameters will automatically configure so you can easily click 'Copy Code' and add them to your Website URL, tracking template, or tracking section (depending on the ad channel).

Important: When you make the selection below, the parameters you can copy above will change depending on your selection. You can edit your configuration at any time. You must make a selection for the ad.id or Cometly will not track.

B) Choose The Ad Channel You Want To Set Up First

Setup UTM Parameters on your Meta Ads

The following UTM parameters are required on every Meta Ad that you want to track with Cometly:

?utm_source={{site_source_name}}&utm_medium={{ad.id}}

To set these up inside the FB Ads manager, navigate to the ad level and select an ad that you want to track with Cometly. There should be a section titled "Destination" with a box for "Website URL". Simply paste the above UTM parameter code onto the end of the Website URL that you have in this section.

Important: If you want to track Carousel Ads, Catalogue Ads, Existing Post Ads, or if you have a link to your store in the ad, please see the instructions below.

Carousel Ads → setup instructions

  • Multiple Website URL's

Catalogue Ads → setup instructions

  • Dynamic Website URL's

Existing Post Ads → setup instructions

  • Running ads as an existing post

Store Link In Ad Copy → setup instructions

  • URL in the ad copy

Website URL In Facebook Ads

Before you publish the ad, make sure this area on the ad level is completely EMPTY like in the screenshot below:

URL Parameters In Facebook Ads

PLEASE NOTE: Make sure you do not use any of the same parameters more than once in your UTM string (i.e. do not use utm_content={{ad.id}} AND utm_content=paid in the same UTM string).

If there is another "?" in your Website URL (for example if you have a variant in your URL), that means you are already using UTMs, so you would need to switch the "?" to a "&" before adding it to the end of your Website URL,

For example, if your Website URL is:

www.test.com?variant=123456

Then instead of adding:

?utm_source={{site_source_name}}&utm_medium={{ad.id}}

You would need to add:

&utm_source={{site_source_name}}&utm_medium={{ad.id}}

So your final Website URL would be:

www.test.com?variant=123456&utm_source={{site_source_name}}&utm_medium={{ad.id}}

Now you can go ahead and publish your ad. As long as you use this setup process on EVERY ad, your tracking and attribution with Cometly will be accurate.

You can quickly check that every ad is set up correctly by navigating to the ad level in the FB Ads manager, and selecting the column option "Setup" which will show you a column for Website URL and column for URL Parameters. As you can see below, this makes it very easy to quickly check that all of your ads are set up correctly.

Setup UTM Parameters on your Google Ads

Important: Any Performance Max campaign , Shopping campaign, or other campaign types that do not have an ad level or a have a dynamic ad level, you must use the Smart campaign tracking template below.

For Search Campaigns

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

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

For Performance Max & Shopping Campaigns

  • Any Performance Max campaign , Shopping campaign, or any other campaign types that do not have an ad level or a have a dynamic ad level, you must use the Smart campaign tracking template below.

Cometly needs the following UTM parameter code attached to the end of every Website URL in the 'Tracking Template' section of each of your 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.

Ensure you set up the tracking template at the campaign level so all of your ad groups and ads automatically have the tracking template applied.

Change Tracking Template In Google Ads

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

New Tracking Template In Google Ads

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

Apply New Tracking Template In Google Ads

Setup UTM Parameters on your TikTok Ads

Cometly needs the UTM parameter code attached to the end of every Website URL in the "Destination page" section of each of your TikTok ads:

?utm_source=tiktok&utm_medium=__CID__

To set this up inside the TikTok Ads manager, navigate to the ad level and select an ad that you want to track with Cometly. There should be a section titled "Destination page" with a box for "Website URL".

Add UTM Parameters On TikTok Ads

Simply "copy" the above code (include the "?") and "paste" the code at the end of your Website URL in that section.

PLEASE NOTE: Make sure you do not use any of the above parameters more than once in your UTM string (i.e., do not use utm_content=__CID__ AND utm_content=paid in the same UTM string).

If there is another ? in your Website URL, that means you are already using UTMs, so you would need to switch the first "?" to a "&" before adding it to the end of your Website URL:

i.e. if your Website URL is

www.test.com?variant=12345667

then instead of

?utm_source=tiktok&utm_medium=__CID__

you would want to add

&utm_source=tiktok&utm_medium=__CID__

So your Final website URL would be

www.test.com?variant=12345667&utm_source=tiktok&utm_medium=__CID__

Now you can go ahead and publish your ad. As long as you use this setup process on EVERY ad, your tracking and attribution with Cometly for TikTok ads will be setup correctly.

Please reach out to support with any questions about setting up the UTM parameters on your TikTok Ads.

If you do not want to use the default UTM tracking parameters provided by Cometly, and you are already using Ad ID and Site Source in your existing UTM parameter setup, then you can configure the UTMs in Cometly to reflect your current setup by following the instructions in this article.


Step 4 - Import existing ad campaigns

Instructions For Importing Shopify Active Ad Campaigns

The Import Campaigns page is a tool that allows Cometly to track existing campaigns that were created before you had Cometly.

  • Cometly cannot track retroactively, so all metrics will be tracked starting at the moment that you turn tracking “ON”.

After turning tracking on, you will see your campaigns in Ads Manager. It will take between 30-60 minutes to start receiving data.

Follow the steps below to find out how to turn tracking “ON” for existing campaigns:

A) Visit the Import Campaigns page in your Cometly account

B) Select the ad account containing the campaigns that you want to track

C) Select the campaign status “ALL”

  • If you select “Tracking”, the Import Campaigns page will only populate the campaigns that you have already turned on tracking for

  • If you select “Not Tracking”, the Import Campaigns page will populate all of the campaigns that you have not turned on tracking for

D) Select the date range

Important: The Import Campaigns page will pull in all of the Facebook campaigns that you launched between your "start date" and your "end date."

  • The start date should be from BEFORE you launched the oldest ad you wish to track (i.e. If your oldest ad was launched 30 days ago, pick a start date of 31 days ago)

  • The end date should be today’s date

E) Turn on tracking

  • Click the Update button

  • Click the toggle to turn tracking ON for your campaigns that you want to track

PRO TIP: If you click the top bar where it says “Delivery”, all of your “Active” campaigns will be filtered to the top


Did this answer your question?