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. Open Shopify App Store.
2. In the search box, on the top, type: "Commanders Act" and click on it.

3. Install the app by clicking the (1) Install button:
4. 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 step 9.):
5. Click Save Configuration to complete the setup and activate the app. See the next section Validate your setup to ensure tracking is activated.

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.