Shopify

Our Shopify application and the related source are currently under final review and will be available soon. This page will walk you through the steps to add and configure your Shopify source and connect it to our Shopify Store application so you can get the most out of their sinergy.

The Commanders Act application, which is available in the Shopify App Store, helps merchants streamline their workflows by connecting Shopify events with partners. Whether you’re tracking customer interactions, or optimizing ad performance, our app simplifies the process. By intercepting Shopify Standard and Custom events, the Commanders Act application seamlessly integrates with your existing stack while leveraging Shopify Customer Privacy API. This means less manual setup and more secure data collection.

Key features

  • Connect Shopify standard and custom events with your partners.

  • Enable reliable server-side tracking capabilities via destinations.

  • Ensure user privacy by supporting Shopify Customer Privacy API.

  • Preserve original Shopify event data.

  • User-friendly configuration.

  • Include debugging functionality for troubleshooting.

Source setup

  1. Log in into your Commanders Act account.

  2. From the left menu, click on (1) Sources to expand the section:

  3. Click (2) Source catalog :

  4. In the search box, type (3) "Shopify" and click the (4) Shopify web on the right:

  5. Click on (5) Configure :

  6. Input (6) a name for your source, select (7) an environment and click (8) Next :

  7. If you already have destinations up and running, you can connect them with your Shopify source by clicking the (9) top checkbox or by (10) selecting which one of them you want to link:

  8. Scroll down to the bottom and click Save.

  9. Take note of your (11) Site/Account Id and (12) Source Key : You're going to use both values in the next section: App setup.

App setup

  1. In the search box, on the top, type: "Commanders Act" and click on it.

  2. Install the app by clicking the (1) Install button:

  3. Configure the app by providing both the (2) Site/Account Id and (3) Source Key from the source you created in the section Source setup (See the above step 9.) and then turn (4) the toggle to activate your app configuration:

  4. Click Save to complete the setup and activate the app. See the next section Validate your setup to ensure tracking is activated.

At any point in time, you can deactivate the app by turning the (4) toggle off and click Save .

Validate your setup

  1. Log in into your Commanders Act account.

  2. From the left menu, click on (1) Sources to expand the section:

  3. Click (2) Overview :

  4. In the search box, type (3) the name of your source and (4) click it: You may already have the (5) Trend showing a peak meaning that events are coming in.

  5. Click (6) Event Inspector :

  6. Check for reported log/entries.

Quick reference

The following table shows the mapping between Commanders Act and Shopify events. Custom Shopify events are also forwarded to Commanders Act with the same original Shopify event name.

Shopify Events
Commanders Act Events

cart_viewed

view_cart

checkout_completed

purchase

checkout_shipping_info_submitted

add_shipping_info

checkout_started

begin_checkout

collection_viewed

view_item_list

page_viewed

page_view

payment_info_submitted

add_payment_info

product_added_to_cart

add_to_cart

product_removed_from_cart

remove_from_cart

product_viewed

view_item

search_submitted

search

[Custom Shopify event name]

[Custom Shopify event name]

Field mappings

All Shopify properties are retrieved from the event property. The original Shopify event data, with all its properties, is stored in the Commanders Act property partners.shopify.event .

Shopify Properties
Commanders Act Properties

analytics.subscribe(...)

event_name [1]

data.checkout.order.id

data.element.id

id

data.checkout.subtotalPrice.amount

data.cartLine.cost.totalAmount.amount

data.cart.cost.totalAmount.amount

value

data.checkout.totalPrice.amount

revenue

data.checkout.shippingLine.price.amount

shipping_amount

data.checkout.totalTax.amount

tax_amount

data.checkout.currencyCode

data.cartLine.cost.totalAmount.currencyCode

data.cart.cost.totalAmount.currencyCode

currency

context.document.location.href

url

context.document.title

page_title

context.document.location.href

context.page.url

context.navigator.language

context.page.lang

context.navigator.userAgent

context.device.user_agent

data.searchResult.query

search_term

data.checkout.transactions.0.paymentMethod.type

payment_method [2]

data.checkout.discountApplications.X.title

coupon

data.checkout.order.customer.id

user.id

data.checkout.order.customer.isFirstOrder

user.status [3]

data.checkout.shippingAddress.firstName

data.checkout.billingAddress.firstName

user.firstname

data.checkout.shippingAddress.lastName

data.checkout.billingAddress.lastName

user.lastname

data.checkout.email

user.email

data.checkout.phone

data.checkout.shippingAddress.phone

user.phone

data.checkout.shippingAddress.address1 + data.checkout.shippingAddress.address2

data.checkout.billingAddress.address1 + data.checkout.billingAddress.address2

user.street

data.checkout.shippingAddress.city

data.checkout.billingAddress.city

user.city

data.checkout.shippingAddress.countryCode

data.checkout.billingAddress.countryCode

user.country

data.checkout.shippingAddress.province

data.checkout.billingAddress.province

user.state

data.checkout.shippingAddress.zip

data.checkout.billingAddress.zip

user.zipcode

data.collection.title

item_list_name

data.checkout.lineItems.X.variant.id

data.checkout.lineItems.X.merchandise.id

data.checkout.lineItems.X.id

data.cart.lines.X.variant.id

data.cart.lines.X.merchandise.id

data.cart.lines.X.id

data.collection.productVariants.X.variant.id

data.collection.productVariants.X.merchandise.id

data.collection.productVariants.X.id

data.searchResult.productVariants.X.variant.id

data.searchResult.productVariants.X.merchandise.id

data.searchResult.productVariants.X.id

data.productVariant.product.id

data.cartLine.merchandise.product.id

items.X.id [4]

data.checkout.lineItems.X.variant.product.title

data.checkout.lineItems.X.merchandise.product.title

data.checkout.lineItems.X.product.title

data.cart.lines.X.variant.product.title

data.cart.lines.X.merchandise.product.title

data.cart.lines.X.product.title

data.collection.productVariants.X.variant.product.title

data.collection.productVariants.X.merchandise.product.title

data.collection.productVariants.X.product.title

data.searchResult.productVariants.X.variant.product.title

data.searchResult.productVariants.X.merchandise.product.title

data.searchResult.productVariants.X.product.title data.productVariant.product.title

data.cartLine.merchandise.product.title

items.X.product.name [4]

data.checkout.lineItems.X.variant.price.amount

data.checkout.lineItems.X.merchandise.price.amount

data.checkout.lineItems.X.price.amount

data.cart.lines.X.variant.price.amount

data.cart.lines.X.merchandise.price.amount

data.cart.lines.X.price.amount

data.collection.productVariants.X.variant.price.amount

data.collection.productVariants.X.merchandise.price.amount

data.collection.productVariants.X.price.amount

data.searchResult.productVariants.X.variant.price.amount

data.searchResult.productVariants.X.merchandise.price.amount

data.searchResult.productVariants.X.price.amount data.productVariant.price.amount

data.cartLine.merchandise.price.amount

items.X.product.price [4]

data.checkout.lineItems.X.quantity

data.cart.lines.X.quantity

data.collection.productVariants.X.quantity

data.searchResult.productVariants.X.quantity data.cartLine.quantity

items.X.quantity [4]

data.checkout.lineItems.X.variant.product.vendor

data.checkout.lineItems.X.merchandise.product.vendor

data.checkout.lineItems.X.product.vendor

data.cart.lines.X.variant.product.vendor

data.cart.lines.X.merchandise.product.vendor

data.cart.lines.X.product.vendor

data.collection.productVariants.X.variant.product.vendor

data.collection.productVariants.X.merchandise.product.vendor

data.collection.productVariants.X.product.vendor

data.searchResult.productVariants.X.variant.product.vendor

data.searchResult.productVariants.X.merchandise.product.vendor

data.searchResult.productVariants.X.product.vendor

data.productVariant.product.vendor

data.cartLine.merchandise.product.vendor

items.X.product.brand [4]

data.checkout.lineItems.X.discountAllocations.Y.amount.amount

data.cart.lines.X.discountAllocations.Y.amount.amount

data.collection.productVariants.X.discountAllocations.Y.amount.amount

data.searchResult.productVariants.X.discountAllocations.Y.amount.amount

items.X.discount [4]

data.checkout.lineItems.X.discountAllocations.Y.discountApplication.title

data.cart.lines.X.discountAllocations.Y.discountApplication.title

data.collection.productVariants.X.discountAllocations.Y.discountApplication.title

data.searchResult.productVariants.X.discountAllocations.Y.discountApplication.title

items.X.coupon [4]

analyticsProcessingAllowed

analyticsProcessingAllowed [5]

marketingAllowed

marketingAllowed [5]

preferencesProcessingAllowed

preferencesProcessingAllowed [5]

saleOfDataAllowed

saleOfDataAllowed [5]

[Original Shopify event data]

partners.shopify.event

[1] See Quick reference for more details. [2] See supported values here. [3] Set with "New". [4] Value based on the priority list on the left column. [5] Property set from the base path partners.shopify.userConsent.

Last updated

Was this helpful?