Skip to main content
Tracking is a two-step setup: enable the CreatorCommerce SDK (sets cart attributes for creator context) and enable the Web Pixel (tracks funnel events for analytics).

​
What Gets Tracked

  • Landing page visits
  • Product views in creator context
  • Add to cart events
  • Checkout starts
  • Completed orders
  • Revenue attribution to creators

​
Step 1: Enable the CreatorCommerce SDK

The SDK is a theme app embed that detects affiliate context and writes cart attributes to personalize the shopping experience.
1

Open Theme App Embeds

In Shopify Admin → Online Store → Themes → Customize → App embeds (in the left sidebar).
2

Enable CreatorCommerce SDK

Find “CreatorCommerce” in the app embeds list and toggle it on. Save the theme.
3

Verify it's working

Visit your store through a creator link, then check that cart attributes are set:
// Run in browser console on your store
fetch(window.Shopify.routes.root + 'cart.js')
  .then(response => response.json())
  .then(cart => {
    console.log('Cart attributes:', cart.attributes);
    // Should show: cc-creator-handle, cc-creator-id, cc-campaign-id
  });

​
Cart Attributes Set by the SDK

AttributeDescriptionExample
cc-creator-handleCreator’s metaobject handle for Liquid lookupssarah-jones
cc-creator-idCreator’s unique ID for attribution68d4828e02627cba69144aa2
cc-campaign-idCampaign ID (if applicable)67a93e156cc51f6c4e878e0c
cc-shop-idShop/channel ID67a93e156cc51f6c4e878e0c
These attributes persist through the entire session and are included in the order metadata.

​
Step 2: Enable the CC Web Pixel

The web pixel provides funnel-level analytics for co-branded experiences.
1

Open the CreatorCommerce dashboard

Navigate to the CreatorCommerce app in your Shopify admin.
2

Go to Settings → Tracking

Find the Web Pixel settings in the CreatorCommerce dashboard.
3

Enable the pixel

Toggle the web pixel on. This installs a Customer Events pixel in your Shopify store that tracks co-branded funnel activity.
Default: The web pixel is enabled by default. You should only disable it if you have a specific reason (custom tracking solution, testing phase, troubleshooting). The web pixel is essential for accurate attribution and performance measurement.
What gets tracked:
  • Landing page visits
  • Product views in creator context
  • Add to cart events
  • Checkout starts
  • Completed orders
  • Revenue attribution to creators
Keep the web pixel enabled unless you have a specific reason to disable it. Disabling it will prevent accurate attribution tracking and performance measurement.

​
Verification Checklist

After enabling both the SDK and web pixel:
  1. Visit a creator link — Navigate to a creator’s landing page URL
  2. Check cart attributes — Run the console snippet above to verify attributes are set
  3. Browse products — Navigate to a product page and verify creator context is present
  4. Add to cart — Add a product and confirm the cart still has CC attributes
  5. Complete a test checkout — Verify the order is tagged with creator attribution

​
How to Verify Cart Attributes (Full Snippet)

Paste in your browser console: 
var formData = new FormData();
fetch(window.Shopify.routes.root + 'cart/update.js', {
  method: 'POST',
  body: formData
})
.then(response => response.json())
.then(res => {
  console.log('Full cart response:', res);
  console.log('CC attributes:', {
    handle: res.attributes['cc-creator-handle'],
    creatorId: res.attributes['cc-creator-id'],
    campaignId: res.attributes['cc-campaign-id'],
    shopId: res.attributes['cc-shop-id']
  });
})
.catch(error => console.error('Error:', error));

​
Using Cart Attributes in Liquid

Once the SDK sets cart attributes, reference them in any Liquid template: 
{% liquid
  if metaobject
    assign cc_creator = metaobject
  else
    assign cc_handle = cart.attributes['cc-creator-handle']
    assign cc_creator = metaobjects.creator[cc_handle]
  endif
  
  assign has_creator = cc_creator != blank
%}

{% if has_creator %}
  {%- comment -%} Creator context is active — personalize the page {%- endcomment -%}
{% endif %}