> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/cashopapp.md).

# Shopify

L'application Commanders Act, disponible dans le [Shopify App Store](https://apps.shopify.com/commanders-act), aide les marchands à rationaliser leurs workflows en connectant les événements Shopify avec des partenaires. Que vous suiviez les interactions des clients ou optimisiez les performances des publicités, notre application simplifie le processus. En interceptant les événements Shopify Standard et Custom, l'application Commanders Act s'intègre de manière transparente à votre stack existante tout en exploitant la Shopify Customer Privacy API. Cela signifie moins de configuration manuelle et une collecte de données plus sécurisée.

{% hint style="success" %}
Notre [Shopify APP](https://apps.shopify.com/commanders-act) fonctionne avec [n'importe quel plan](https://www.shopify.com/pricing).
{% endhint %}

## Fonctionnalités clés

* Connectez [les événements standard Shopify](https://shopify.dev/docs/api/web-pixels-api/standard-events) et les événements personnalisés avec vos partenaires.
* Activez des capacités de suivi fiables server-side via [destinations](https://doc.commandersact.com/getting-started/concepts#destination).
* Garantissez la confidentialité des utilisateurs en prenant en charge [Shopify Customer Privacy API](https://shopify.dev/docs/api/customer-privacy).
* Conservez les données d'origine des événements Shopify.
* Configuration conviviale.
* Incluez des fonctionnalités de débogage pour le dépannage.

## Configuration de la source

1. Connectez-vous à votre [compte Commanders Act](https://app.commandersact.com/).
2. Dans le menu de gauche, cliquez sur `(1)` `Sources` pour développer la section :\
   \
   ![](/files/720def7837c17018b75ac0aed6486fe28d766f01)\\
3. Cliquez sur `(2)` `catalogue des sources` :\
   \
   ![](/files/6eaf95fd800829ee7e0a60e9b18983e798e22e11)\\
4. Dans la zone de recherche, saisissez `(3)` "Shopify" et cliquez sur le `(4)` `Shopify web` à droite :\
   \
   ![](/files/a21d3787d4d3065cc4188cb16aa03fce279b6426)\\
5. Cliquez sur `(5)` `Configurer` :\
   \
   ![](/files/8dae9476e4229b3025df49eff9c9e271660f7eb5)\\
6. Saisissez `(6)` un nom pour votre source, sélectionnez `(7)` un environnement et cliquez sur `(8)` `Suivant` :\
   \
   ![](/files/000e420172015a87580ccc51c40ada339e397170)\\
7. Si vous avez déjà des destinations en place, vous pouvez les connecter à votre source Shopify en cliquant sur le `(9)` case à cocher supérieure ou en `(10)` sélectionnant celui que vous souhaitez lier :\
   \
   ![](/files/465a4e899ef44c4a31fb372062c36ba1c3f79d09)\\
8. Faites défiler jusqu'en bas et cliquez sur `Enregistrer`.
9. Notez votre `(11)` `ID du site/compte` et `(12)` `clé de la source` :\
   \
   ![](/files/1ca0635b48e788012dc5476264a48fa16993a5a1)\
   \
   Vous utiliserez ces deux valeurs dans la section suivante : [Configuration de l'application](#app-setup).

## Configuration de l'application

1. Ouvrez notre [URL de l'application dans Shopify App Store](https://apps.shopify.com/commanders-act).
2. Installez l'application en cliquant sur le `(1)` `Installer` bouton :\
   \
   ![](/files/d6dc3ea3b9116040506dcbbce9416b3c2a4f44e4)\\
3. Configurez l'application en fournissant à la fois le `(2)` `ID du site/compte` et `(3)` `clé de la source` de la source que vous avez créée dans la section [Configuration de la source](#source-setup) (voir l'étape 9 ci-dessus.) puis mettez `(4)` le bouton bascule en vert pour activer la configuration de votre application :\
   \
   ![](/files/ca0d917806e403d14e5f512024e9ebbf559a39d2)\\
4. Cliquez sur `Enregistrer` pour terminer la configuration et activer l'application. Consultez la section suivante [Validez votre configuration](#validate-your-setup) pour vous assurer que le suivi est activé.

{% hint style="info" %}
À tout moment, vous pouvez désactiver l'application en mettant le `(4)` bouton bascule sur off/rouge et cliquez sur `Enregistrer` .
{% endhint %}

## Validez votre configuration

1. Connectez-vous à votre [compte Commanders Act](https://app.commandersact.com/).
2. Dans le menu de gauche, cliquez sur (1) `Sources` pour développer la section :\
   \
   ![](/files/720def7837c17018b75ac0aed6486fe28d766f01)\\
3. Cliquez sur (2) `Vue d'ensemble` :\
   \
   ![](/files/fd153e4582a0d8a063daf9c83db12b7288a58cb6)\\
4. Dans la zone de recherche, saisissez (3) le nom de votre source et (4) cliquez dessus :\
   \
   ![](/files/f4237c5b08f90a6e726ce6fab3e89bdcd50ee453)\
   \
   Vous avez peut-être déjà le (5) `Trend` montrant un pic, ce qui signifie que des événements arrivent.
5. Cliquez sur (6) `Event Inspector` :\
   \
   ![](/files/c68ee190c3cb11262406b839f4e88e340f106ee3)\\
6. Vérifiez les journaux/entrées signalés.\\

## Référence rapide

{% hint style="info" %}
Le tableau suivant montre la correspondance entre les événements Commanders Act et Shopify.\
Les événements Shopify personnalisés sont également transmis à Commanders Act avec le même nom d'événement Shopify d'origine.
{% endhint %}

| Événements Shopify                       | Propriétés Commanders Act                |
| ---------------------------------------- | ---------------------------------------- |
| `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`                                 |
| `[Nom d'événement Shopify personnalisé]` | `[Nom d'événement Shopify personnalisé]` |

## Mappages de champs

{% hint style="info" %}
Toutes les propriétés Shopify sont récupérées à partir de la `propriété event.` Les données d'origine de l'événement Shopify, avec toutes ses propriétés, sont stockées dans la propriété Commanders Act `partners.shopify.event` .
{% endhint %}

<table data-full-width="true"><thead><tr><th width="682.66650390625">Propriétés Shopify</th><th>Propriétés Commanders Act</th></tr></thead><tbody><tr><td><code>analytics.subscribe(...)</code></td><td><code>event_name</code> <strong>[1]</strong></td></tr><tr><td><p><code>data.checkout.order.id</code></p><p><code>data.element.id</code></p></td><td><code>ID</code></td></tr><tr><td><p><code>data.checkout.subtotalPrice.amount</code></p><p><code>data.cartLine.cost.totalAmount.amount</code></p><p><code>data.cart.cost.totalAmount.amount</code></p></td><td><code>value</code></td></tr><tr><td><code>data.checkout.totalPrice.amount</code></td><td><code>revenu</code></td></tr><tr><td><code>data.checkout.shippingLine.price.amount</code></td><td><code>shipping_amount</code></td></tr><tr><td><code>data.checkout.totalTax.amount</code></td><td><code>tax_amount</code></td></tr><tr><td><p><code>data.checkout.currencyCode</code></p><p><code>data.cartLine.cost.totalAmount.currencyCode</code></p><p><code>data.cart.cost.totalAmount.currencyCode</code></p></td><td><code>devise</code></td></tr><tr><td><code>context.document.location.href</code></td><td><code>URL</code></td></tr><tr><td><code>context.document.title</code></td><td><code>page_title</code></td></tr><tr><td><code>context.document.location.href</code></td><td><code>context.page.url</code></td></tr><tr><td><code>context.navigator.language</code></td><td><code>context.page.lang</code></td></tr><tr><td><code>context.navigator.userAgent</code></td><td><code>context.device.user_agent</code></td></tr><tr><td><code>data.searchResult.query</code></td><td><code>search_term</code></td></tr><tr><td><code>data.checkout.transactions.0.paymentMethod.type</code></td><td><code>payment_method</code> <strong>[2]</strong></td></tr><tr><td><code>data.checkout.discountApplications.X.title</code></td><td><code>coupon</code></td></tr><tr><td><code>data.checkout.order.customer.id</code></td><td><code>user.id</code></td></tr><tr><td><code>data.checkout.order.customer.isFirstOrder</code></td><td><code>user.status</code> <strong>[3]</strong></td></tr><tr><td><p><code>data.checkout.shippingAddress.firstName</code></p><p><code>data.checkout.billingAddress.firstName</code></p></td><td><code>user.firstname</code></td></tr><tr><td><p><code>data.checkout.shippingAddress.lastName</code></p><p><code>data.checkout.billingAddress.lastName</code></p></td><td><code>user.lastname</code></td></tr><tr><td><code>data.checkout.email</code></td><td><code>user.email</code></td></tr><tr><td><p><code>data.checkout.phone</code></p><p><code>data.checkout.shippingAddress.phone</code></p></td><td><code>user.phone</code></td></tr><tr><td><p><code>data.checkout.shippingAddress.address1 + data.checkout.shippingAddress.address2</code></p><p><code>data.checkout.billingAddress.address1 + data.checkout.billingAddress.address2</code></p></td><td><code>user.street</code></td></tr><tr><td><p><code>data.checkout.shippingAddress.city</code></p><p><code>data.checkout.billingAddress.city</code></p></td><td><code>user.city</code></td></tr><tr><td><p><code>data.checkout.shippingAddress.countryCode</code></p><p><code>data.checkout.billingAddress.countryCode</code></p></td><td><code>user.country</code></td></tr><tr><td><p><code>data.checkout.shippingAddress.province</code></p><p><code>data.checkout.billingAddress.province</code></p></td><td><code>user.state</code></td></tr><tr><td><p><code>data.checkout.shippingAddress.zip</code></p><p><code>data.checkout.billingAddress.zip</code></p></td><td><code>user.zipcode</code></td></tr><tr><td><code>data.collection.title</code></td><td><code>item_list_name</code></td></tr><tr><td><p><code>data.checkout.lineItems.X.variant.id</code></p><p><code>data.checkout.lineItems.X.merchandise.id</code></p><p><code>data.checkout.lineItems.X.id</code></p><p><code>data.cart.lines.X.variant.id</code></p><p><code>data.cart.lines.X.merchandise.id</code></p><p><code>data.cart.lines.X.id</code></p><p><code>data.collection.productVariants.X.variant.id</code></p><p><code>data.collection.productVariants.X.merchandise.id</code></p><p><code>data.collection.productVariants.X.id</code></p><p><code>data.searchResult.productVariants.X.variant.id</code></p><p><code>data.searchResult.productVariants.X.merchandise.id</code></p><p><code>data.searchResult.productVariants.X.id</code></p><p><code>data.productVariant.product.id</code></p><p><code>data.cartLine.merchandise.product.id</code></p></td><td><code>items.X.id</code> <strong>[4]</strong></td></tr><tr><td><p><code>data.checkout.lineItems.X.variant.product.title</code></p><p><code>data.checkout.lineItems.X.merchandise.product.title</code></p><p><code>data.checkout.lineItems.X.product.title</code></p><p><code>data.cart.lines.X.variant.product.title</code></p><p><code>data.cart.lines.X.merchandise.product.title</code></p><p><code>data.cart.lines.X.product.title</code></p><p><code>data.collection.productVariants.X.variant.product.title</code></p><p><code>data.collection.productVariants.X.merchandise.product.title</code></p><p><code>data.collection.productVariants.X.product.title</code></p><p><code>data.searchResult.productVariants.X.variant.product.title</code></p><p><code>data.searchResult.productVariants.X.merchandise.product.title</code></p><p><code>data.searchResult.productVariants.X.product.title</code><br><code>data.productVariant.product.title</code></p><p><code>data.cartLine.merchandise.product.title</code></p></td><td><code>items.X.product.name</code> <strong>[4]</strong></td></tr><tr><td><p><code>data.checkout.lineItems.X.variant.price.amount</code></p><p><code>data.checkout.lineItems.X.merchandise.price.amount</code></p><p><code>data.checkout.lineItems.X.price.amount</code></p><p><code>data.cart.lines.X.variant.price.amount</code></p><p><code>data.cart.lines.X.merchandise.price.amount</code></p><p><code>data.cart.lines.X.price.amount</code></p><p><code>data.collection.productVariants.X.variant.price.amount</code></p><p><code>data.collection.productVariants.X.merchandise.price.amount</code></p><p><code>data.collection.productVariants.X.price.amount</code></p><p><code>data.searchResult.productVariants.X.variant.price.amount</code></p><p><code>data.searchResult.productVariants.X.merchandise.price.amount</code></p><p><code>data.searchResult.productVariants.X.price.amount</code><br><code>data.productVariant.price.amount</code></p><p><code>data.cartLine.merchandise.price.amount</code></p></td><td><code>items.X.product.price</code> <strong>[4]</strong></td></tr><tr><td><p><code>data.checkout.lineItems.X.quantity</code></p><p><code>data.cart.lines.X.quantity</code></p><p><code>data.collection.productVariants.X.quantity</code></p><p><code>data.searchResult.productVariants.X.quantity</code><br><code>data.cartLine.quantity</code></p></td><td><code>items.X.quantity</code> <strong>[4]</strong></td></tr><tr><td><p><code>data.checkout.lineItems.X.variant.product.vendor</code></p><p><code>data.checkout.lineItems.X.merchandise.product.vendor</code></p><p><code>data.checkout.lineItems.X.product.vendor</code></p><p><code>data.cart.lines.X.variant.product.vendor</code></p><p><code>data.cart.lines.X.merchandise.product.vendor</code></p><p><code>data.cart.lines.X.product.vendor</code></p><p><code>data.collection.productVariants.X.variant.product.vendor</code></p><p><code>data.collection.productVariants.X.merchandise.product.vendor</code></p><p><code>data.collection.productVariants.X.product.vendor</code></p><p><code>data.searchResult.productVariants.X.variant.product.vendor</code></p><p><code>data.searchResult.productVariants.X.merchandise.product.vendor</code></p><p><code>data.searchResult.productVariants.X.product.vendor</code></p><p><code>data.productVariant.product.vendor</code></p><p><code>data.cartLine.merchandise.product.vendor</code></p></td><td><code>items.X.product.brand</code> <strong>[4]</strong></td></tr><tr><td><p><code>data.checkout.lineItems.X.discountAllocations.Y.amount.amount</code></p><p><code>data.cart.lines.X.discountAllocations.Y.amount.amount</code></p><p><code>data.collection.productVariants.X.discountAllocations.Y.amount.amount</code></p><p><code>data.searchResult.productVariants.X.discountAllocations.Y.amount.amount</code></p></td><td><code>items.X.discount</code> <strong>[4]</strong></td></tr><tr><td><p><code>data.checkout.lineItems.X.discountAllocations.Y.discountApplication.title</code></p><p><code>data.cart.lines.X.discountAllocations.Y.discountApplication.title</code></p><p><code>data.collection.productVariants.X.discountAllocations.Y.discountApplication.title</code></p><p><code>data.searchResult.productVariants.X.discountAllocations.Y.discountApplication.title</code></p></td><td><code>items.X.coupon</code> <strong>[4]</strong></td></tr><tr><td><code>analyticsProcessingAllowed</code></td><td><code>analyticsProcessingAllowed</code> <strong>[5]</strong></td></tr><tr><td><code>marketingAllowed</code></td><td><code>marketingAllowed</code> <strong>[5]</strong></td></tr><tr><td><code>preferencesProcessingAllowed</code></td><td><code>preferencesProcessingAllowed</code> <strong>[5]</strong></td></tr><tr><td><code>saleOfDataAllowed</code></td><td><code>saleOfDataAllowed</code> <strong>[5]</strong></td></tr><tr><td><code>[Données d'origine de l'événement Shopify]</code></td><td><code>partners.shopify.event</code></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Consultez la référence rapide pour plus de détails.\
> \&#xNAN;**\[2]** Voir les valeurs prises en charge [ici](https://doc.commandersact.com/developers/tracking-and-integrations/tracking/events-reference#payment-methods).\
> \&#xNAN;**\[3]** Défini avec "New".\
> \&#xNAN;**\[4]** Valeur basée sur la liste de priorité de la colonne de gauche.\
> \&#xNAN;**\[5]** Propriété définie à partir du chemin de base `partners.shopify.userConsent`.
> {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/cashopapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.