> 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/gtm.md).

# Google Tag Manager (GTM)

Commanders Act fournit un modèle GTM pour connecter votre implémentation GTM existante à notre endpoint serverside, dans un environnement sécurisé.

{% hint style="info" %}
Si vous utilisez GA4, vous pourriez être intéressé par le [Configuration ultra rapide GTM](/fr/premiers-pas/integrating-your-data/gtm-tutorial.md) permettant de transférer des événements depuis GA4. Il offre moins de flexibilité mais peut être installé en 2 minutes.
{% endhint %}

## Configuration

Récapitulatif de toutes les étapes recommandées :

1. Créez une source GTM dans Commanders Act
2. Ajoutez notre modèle à votre implémentation GTM
3. Configurez votre tag

## Créez une source dans Commanders Act

Dans votre Dashboard Commanders Act :

* Dans le menu du panneau de gauche, cliquez sur **Sources** > **Aperçu**.
* Cliquez sur le **Ajouter une source** bouton.
* Dans le catalogue, recherchez la **Google Tag Manager** source et cliquez dessus.
* Cliquez sur **Configurer** et définissez son nom, son environnement et les destinations associées.
* Une fois terminé, cliquez sur le **Créer** bouton en bas.
* La clé source s'affichera alors :

![](/files/2110de5a8e268f2751432a42e9c9568685b71b1a)

* Copiez sa valeur et conservez-la pour plus tard !

{% hint style="info" %}
**Astuce**: Si vous avez déjà créé une source GTM, vous pouvez récupérer sa clé en accédant à son **Paramètres** onglet.
{% endhint %}

## Ajoutez notre modèle à GTM

Tout d’abord, accédez à [GTM](https://tagmanager.google.com/) puis ajoutez notre modèle "**Commanders Act | Serverside events bridge**" de Google "[Community Template Gallery](https://tagmanager.google.com/gallery/#/owners/TagCommander/templates/Serverside-events-bridge)" dans votre espace de travail, puis sélectionnez `(1)` "**Tags**".

![](/files/3d40a260524929ab3a97ee9b1691eb99a43cab92)

Cliquez sur `(2)` le "**Nouveau**".

![](/files/e6ad317c7ac8aea15d3f7418e5d7c6f0b1e2bc4b)

Cliquez sur `(3)` le "**Configuration du tag**" zone.

![](/files/7c3a12c6eeadaa7de397142d445fde8dc0de2f96)

Cliquez `(4)` le **loupe** dans le coin supérieur droit.

![](/files/c54d22ea15f85176918c163c7dfe82d31142d797)

Recherchez `(5)` le "**Commanders Act | Serverside events bridge**" modèle personnalisé et cliquez dessus pour lancer la configuration.

![](/files/9284ac616cf2ec95bd231ea7998e85c5a2c90e65)

## Configurez votre tag

Commencez par renseigner `(6)` **un nom pour votre tag** dans le coin supérieur gauche.

![](/files/e4430939cdc74f3c608b6fdb2e37e84e54fd5762)

{% hint style="success" %}
**Astuce**: vous pouvez vouloir nommer votre tag en ajoutant le nom de l'événement que vous allez implémenter au final. (Par ex. "*Commanders Act |* Pont d'événements serverside *- **Purchase***")
{% endhint %}

Saisissez votre `(7)` "**ID de site Commanders Act**" et `(8)` "**Clé source Commanders Act**" (reportez-vous à la première section sur la création d'une source et la récupération de sa clé).

Sélectionnez `(9)` le "**Commanders Act Event**" dans le menu déroulant, qui est l'événement que vous souhaitez transférer.

<figure><img src="/files/dada4699ea24da76789bb63513eb3accc4cbd359" alt="" width="536"><figcaption></figcaption></figure>

Selon l'événement que vous sélectionnez, davantage (ou moins) de champs seront affichés. Si vous n'indiquez pas un champ obligatoire, le modèle mettra en évidence l'entrée manquante afin que vous puissiez fournir un mappage correct.

La section "**Event Fields**" contient des champs qui définissent l'événement lui-même et sont pour la plupart obligatoires ou fortement recommandés.

Les événements incluant la section "**Product Fields**" nécessitent [une structure de tableau pour les informations de vos produits](https://community.commandersact.com/tagcommander/tips-and-tricks/best-practices/common-datalayer-variables#product-arrays). Le premier champ sera toujours le `(10)` **tableau de base** où l'information est stockée et tous les champs suivants sont les propriétés associées - Par ex. vous pouvez mapper les informations concernant `(11)` le "**ID produit**" en renseignant le nom de la propriété.

<figure><img src="/files/fd8a51e508c144bfb84b54d5364f4fd7cb22982d" alt=""><figcaption></figcaption></figure>

Dans la section "**User Fields**" vous pouvez définir `(12)` le "**ID utilisateur**" et `(13)` "**e-mail utilisateur**" - L'un ou l'autre est requis si vous sélectionnez l'événement "Purchase". Le `(14)` "**User Consent Categories**" est un champ obligatoire contenant un tableau avec les identifiants des catégories de consentement de l'utilisateur.

<figure><img src="/files/65b39426ba2b9343f6d76dcf1dfa8f2b964cd2fe" alt=""><figcaption></figcaption></figure>

Il est important de définir et de mapper tous les identifiants de catégorie avec leurs noms respectifs. Par exemple, vous pouvez avoir le tableau suivant : *\[1,2,4]* et vous avez défini la relation suivante :

* 1 **➜** catégorie Publicité
* 2 **➜** catégorie Analytics
* 4 **➜** catégorie Fonctionnalité

Vous indiquez également à Commanders Act que la "catégorie Publicité" doit être activée pour activer "Facebook CAPI". Dans cet exemple, puisque l'identifiant de catégorie \[1] est inclus dans le tableau, nous pouvons activer le pont et transférer l'événement à Facebook.

{% hint style="info" %}
Assurez-vous que vos relations de catégories sont partagées avec Commanders Act.
{% endhint %}

{% hint style="warning" %}
Ce n'est qu'avec les paramètres de consentement convenus que nous sommes autorisés à relier les événements "Purchase" et "Refund" à "Facebook CAPI".
{% endhint %}

Finalisez votre configuration en sélectionnant l'activation appropriée dans la zone "Triggering" / "Firing Triggers".

Si vous prévoyez de configurer [Facebook Conversion API](/fr/fonctionnalites/destinations/destinations-catalog/facebook/facebook-conversions-api.md) via votre source GTM, suivez cette étape supplémentaire pour mettre à jour votre tag Facebook Pixel:

{% content-ref url="/pages/2d7b9208e5e35edf34cddaa9d14e2b20024a54fd" %}
[Facebook CAPI via GTM](/fr/fonctionnalites/destinations/destinations-catalog/facebook/facebook-conversions-api/facebook-capi-through-gtm.md)
{% endcontent-ref %}


---

# 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/gtm.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.
