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
Navigate to "Online Store" in Shopify.
Select "Actions" dropdown, and click "Edit Code"
Select "theme.liquid" dropdown, and find the closing body tag </body>
Paste the Comet Pixel 'Base Code' just before the closing body tag </body>
Click "Save"
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"
Navigate to "Settings" in Shopify.
Select "Checkout"
Scroll down to "Additional Scripts"
Add the Comet Pixel 'Conversion Code' to "Post Purchase Page" and "Order Status Page"
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'
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
Before you publish the ad, make sure this area on the ad level is completely EMPTY like in the screenshot below:
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.
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.
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".
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
Navigate to Space Settings
Click Import Campaigns
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
