> 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 server-side, 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éer une source GTM dans Commanders Act
2. Ajoutez notre modèle à votre implémentation GTM
3. Configurez votre tag

## Créer une source dans Commanders Act

Dans votre Dashboard Commanders Act :

* Dans le menu du panneau de gauche, cliquez sur **Sources** > **Vue d'ensemble**.
* 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 ses destinations associées.
* Une fois terminé, cliquez sur le **Créer** bouton en bas.
* La clé de la source sera alors affichée :

![](/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 la 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)` la "**Nouveau**".

![](/files/e6ad317c7ac8aea15d3f7418e5d7c6f0b1e2bc4b)

Cliquez sur `(3)` la "**Tag Configuration**" section.

![](/files/7c3a12c6eeadaa7de397142d445fde8dc0de2f96)

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

![](/files/c54d22ea15f85176918c163c7dfe82d31142d797)

Recherchez `(5)` la "**Commanders Act | Serverside events bridge**" modèle personnalisé et cliquez dessus pour commencer 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 souhaiter 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 server-side *- **Purchase***")
{% endhint %}

Saisissez votre `(7)` "**Commanders Act Site ID**" et `(8)` "**Clé source Commanders Act**" (reportez-vous à la première section pour savoir comment créer une source et récupérer sa clé).

Sélectionnez `(9)` la "**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 ne renseignez pas un champ obligatoire, le modèle mettra en évidence l'élément manquant afin que vous puissiez fournir un mappage approprié.

Le "**Champs d'événement**" section 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 "**Champs produit**" section requièrent [une structure de tableau pour vos informations produit](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ù les informations sont stockées et tous les champs suivants sont les propriétés associées - par ex., vous pouvez mapper les informations sur `(11)` la "**ID produit**" en renseignant le nom de la propriété.

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

Dans la "**Champs utilisateur**" section, vous pouvez définir `(12)` la "**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 **➜** Advertising category
* 2 **➜** Analytics category
* 4 **➜** Functionality category

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

{% hint style="info" %}
Assurez-vous que les correspondances de vos 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" au "Facebook CAPI".
{% endhint %}

Terminez 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:

```
GET https://doc.commandersact.com/fr/fonctionnalites/sources/sources-catalog/web/gtm.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.
