> 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 flux de travail en connectant les événements Shopify avec des partenaires. Que vous suiviez les interactions clients ou optimisiez les performances publicitaires, notre application simplifie le processus. En interceptant les événements standard et personnalisés Shopify, l'application Commanders Act s'intègre de manière fluide à votre stack existante tout en tirant parti de Shopify Customer Privacy API. Cela signifie moins de configuration manuelle et une collecte de données plus sécurisée.

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

## Fonctionnalités clés

* Connecter [Shopify standard](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).
* Assurez 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.
* Inclure une fonctionnalité 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 `(2)` `Catalogue des sources` :\
   \
   ![](/files/6eaf95fd800829ee7e0a60e9b18983e798e22e11)\\
4. Dans le champ de recherche, saisissez `(3)` "Shopify" puis 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, puis cliquez sur `(8)` `Suivant` :\
   \
   ![](/files/000e420172015a87580ccc51c40ada339e397170)\\
7. Si vous avez déjà des destinations en production, vous pouvez les connecter à votre source Shopify en cliquant sur le `(9)` la case à cocher du haut ou en `(10)` sélectionnant celle 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é source` :\
   \
   ![](/files/1ca0635b48e788012dc5476264a48fa16993a5a1)\
   \
   Vous allez utiliser les 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é 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 activez `(4)` le bouton bascule en vert pour activer la configuration de votre application :\
   \
   ![](/files/ca0d917806e403d14e5f512024e9ebbf559a39d2)\\
4. Cliquez `Enregistrer` pour terminer la configuration et activer l'application. Consultez la section suivante [Validez votre configuration](#validate-your-setup) pour vérifier que le suivi est activé.

{% hint style="info" %}
À tout moment, vous pouvez désactiver l'application en mettant le `(4)` bouton bascule sur désactivé/rouge et en cliquant 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) `Aperçu` :\
   \
   ![](/files/fd153e4582a0d8a063daf9c83db12b7288a58cb6)\\
4. Dans le champ de recherche, saisissez (3) le nom de votre source et (4) cliquez dessus :\
   \
   ![](/files/f4237c5b08f90a6e726ce6fab3e89bdcd50ee453)\
   \
   Vous avez peut-être déjà le (5) `Trend` affichant un pic, ce qui signifie que des événements arrivent.
5. Cliquez sur (6) `Event Inspector` :\
   \
   ![](/files/c68ee190c3cb11262406b839f4e88e340f106ee3)\\
6. Vérifiez les logs/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                          | 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`                                    |
| `[Nom de l'événement Shopify personnalisé]` | `[Nom de l'événement Shopify personnalisé]` |

## Correspondances des champs

{% hint style="info" %}
Toutes les propriétés Shopify sont récupérées à partir de la `événement` propriété.\
Les données d'origine de l'événement Shopify, avec toutes leurs 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>valeur</code></td></tr><tr><td><code>data.checkout.totalPrice.amount</code></td><td><code>revenue</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>currency</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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.