> 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/developpeurs/commanders-tag-gateway/manage-your-gateway.md).

# Gérez votre Gateway

### Configurez votre Gateway depuis l'interface d'administration

Vous créez, configurez et surveillez vos Gateways first-party dans **Administration > Gateway**sans code. La seule étape technique consiste à connecter votre CDN (voir [Acheminer le trafic](https://doc.commandersact.com/developers/commanders-tag-gateway#step-2-route-traffic)).

### Commencer <a href="#get-started" id="get-started"></a>

Si le site n'a pas encore de Gateway, vous voyez un écran d'introduction. Choisissez l'une des deux options :

* **Configurer ma première Gateway** — lance l'assistant de configuration en 5 étapes ci-dessous.
* **Charger une Gateway d'un autre site** — réutilise une Gateway existante de votre compte comme point de départ.

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FN5CszHNx0SjjLdUK9DBY%2F01-empty-state.png?alt=media&amp;token=2a47e4e8-55e0-4426-9527-fe2d71f47567" alt=""><figcaption><p>Aucune Gateway configurée</p></figcaption></figure>

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fer8DHA9iXp3ZwpqUdZ6t%2F02-load-gateway-modal.png?alt=media&amp;token=41d94c57-28ff-49d9-bacb-d449c48b2e90" alt=""><figcaption><p>Charger une Gateway d'un autre site</p></figcaption></figure>

> 💡 **Astuce :** Cliquez sur **Enregistrer et quitter** à tout moment. Votre progression est enregistrée, et la Gateway reste *inactive* jusqu'à la fin de la configuration.

### Configurez une Gateway en 5 étapes <a href="#set-up-a-gateway-in-5-steps" id="set-up-a-gateway-in-5-steps"></a>

```mermaid
flowchart LR
  A[1. Scope] --> B[2. Domain & path] --> C[3. CDN connection] --> D[4. Verification] --> E[5. Activation]
```

#### Étape 1 · Scope

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FVI10YdS122qdR2Ezqs7x%2F03-step1-scope.png?alt=media&amp;token=7ea67add-85a6-4910-8a9a-af288c5bd58f" alt=""><figcaption><p>Étape de scope</p></figcaption></figure>

Sélectionnez ce que vous souhaitez acheminer via votre domaine. Vous pourrez ajouter des cas d'usage plus tard sans recréer la Gateway.

| Cas d'usage                                 | Ce que cela fait                                                                             |
| ------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **Google Tag Gateway** *(par défaut)*       | Charge Google Tag et envoie les mesures Google depuis un chemin first-party.                 |
| **Conteneur Commanders Act** *(par défaut)* | Charge votre conteneur web Commanders Act depuis votre propre domaine.                       |
| **server-side tracking**                    | Envoie vos événements vers vos destinations server-side via votre domaine.                   |
| **Collections Commanders Act**              | Achemine les hits CMP et d'autres collections Commanders Act via votre domaine.              |
| **Third-party libraries**                   | Héberge les bibliothèques partenaires sur votre domaine avec des noms de fichiers obfusqués. |

Choisissez ensuite qui gère le CDN : **J'ai l'accès**, ou **Je transmettrai cela à mon équipe technique** *(par défaut)*, qui prépare des instructions prêtes à être partagées avec l'IT.

#### Étape 2 · Domaine et chemin

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FhbJTpGtVzLxgKvCg7RL8%2Fimage.png?alt=media&amp;token=386a6b9c-0d6a-4cfd-b168-390c0bcc5257" alt=""><figcaption></figcaption></figure>

Renseignez les informations nécessaires pour réserver votre chemin first-party :

<table data-header-hidden data-search="false"><thead><tr><th>Champ</th><th>Notes</th></tr></thead><tbody><tr><td><strong>Champ</strong></td><td><strong>Notes</strong></td></tr><tr><td><strong>Nom interne de la Gateway</strong></td><td>Pour votre propre référence.</td></tr><tr><td><strong>Chemin first-party</strong></td><td>Généré automatiquement, peut être régénéré. L'URL unique sur votre domaine qui transporte le trafic Gateway.</td></tr><tr><td><strong>Domaine</strong></td><td>Le site web sur lequel la Gateway fonctionne.</td></tr><tr><td><strong>ID Google tag</strong></td><td>Uniquement si vous avez sélectionné <em>Google Tag Gateway</em>.</td></tr><tr><td><strong>Chemin Google Tag Gateway</strong> <br><em>(Avancé, facultatif)</em></td><td>Uniquement si vous avez sélectionné <em>Google Tag Gateway</em>. Cliquez sur <strong>Avancé</strong> sous le chemin first-party pour personnaliser le sous-chemin utilisé pour les requêtes Google. Il est ajouté à votre chemin first-party (par ex. <code>https://www.example.com/kqj9exxu/MyGooglePath</code>). Prérempli, modifiable, et peut être régénéré avec <strong>Générer un autre chemin</strong>.</td></tr><tr><td><strong>Fournisseur CDN / équilibreur de charge</strong></td><td>Cloudflare Free, Cloudflare Enterprise, Akamai (bêta), Fastly (bêta), autre CDN ou « Je ne sais pas ».</td></tr><tr><td><strong>Cookies à exclure</strong> <em>(facultatif)</em></td><td>Prérempli avec les 2 cookies exclus par le code Worker standard.</td></tr></tbody></table>

💡 La personnalisation du chemin Google Tag Gateway est facultative. Conservez la valeur par défaut, sauf si vous avez besoin d'un chemin spécifique, par exemple pour correspondre à une configuration existante.

> ⚠️ Évitez *tracking, analytics, metrics, tag, google* ou *ads* dans le chemin first-party et le chemin Google Tag Gateway — les bloqueurs les détectent plus facilement. Votre équipe technique doit également confirmer que le chemin n'est pas déjà utilisé sur votre site.

#### Étape 3 · Connexion CDN

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FN1RDyMMf0F02pfRJlvFQ%2F06-step3-cdn-connection.png?alt=media&amp;token=e2e5060d-9194-4a6d-9e53-116b5c190b89" alt=""><figcaption></figcaption></figure>

La plateforme génère la configuration exacte (domaine, route, infrastructure) et un guide pas à pas pour votre CDN. Suivez-le vous-même, ou copiez le lien partageable pour votre équipe IT. Détails spécifiques au CDN : [Acheminer le trafic](https://doc.commandersact.com/developers/commanders-tag-gateway#step-2-route-traffic).

#### Étape 4 · Vérification

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FXj2QhRLzsHWyRL0Qx4Pq%2Fimage.png?alt=media&amp;token=e58e41f7-a875-4771-a1ae-0873ba501b50" alt=""><figcaption></figcaption></figure>

Deux vérifications s'exécutent automatiquement : **validation du chemin** et **transmission de la géolocalisation**. Les deux doivent renvoyer « ok » avant de pouvoir continuer. Si l'une échoue, corrigez votre configuration CDN et cliquez sur **Relancer la vérification**.

#### Étape 5 · Activation

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FnoFrUiBXUqgghGyO45pj%2Fimage.png?alt=media&amp;token=486e0919-be7f-4bf8-aa57-1aadfd43fab5" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FiCTutw10sk1c1Ry5HV1J%2Fimage.png?alt=media&amp;token=58d31107-a45d-4718-9269-e28ee1ec2561" alt=""><figcaption></figcaption></figure>

Votre point d'entrée first-party est en ligne. Complétez la carte d'action pour chaque cas d'usage (voir ci-dessous), puis cliquez sur **Terminer**. Le panneau de droite récapitule votre configuration et renvoie vers le centre d'aide.

### Finalisez l'activation de chaque cas d'usage <a href="#finish-activating-each-use-case" id="finish-activating-each-use-case"></a>

| Cas d'usage                                               | Que faire                                                                                                                                  |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Google Tag Gateway**                                    | Remplacez les URL de votre Google tag (gtag.js, GTM) par votre chemin first-party, dans chaque conteneur qui les charge.                   |
| **Conteneur Commanders Act**                              | Remplacez l'URL de chargement du conteneur par la nouvelle URL first-party.                                                                |
| **server-side tracking** / **Collections Commanders Act** | Aucun changement de tag. Régénérez et déployez votre/vos conteneur(s).                                                                     |
| **Third-party libraries**                                 | Déclarez chaque fichier JS (par ex. Meta Pixel) dans First-Party Tag Hosting, puis utilisez le nom de fichier obfusqué généré dans le tag. |

Vous pouvez ajouter ou modifier des cas d'usage plus tard depuis la configuration de la Gateway.

#### Gérez vos Gateways

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FzVlEif56qU3wVMzbURUK%2F11-gateway-dashboard.png?alt=media&amp;token=3b79a593-eead-47b5-87f2-a6968dbb4348" alt=""><figcaption></figcaption></figure>

Une fois qu'une Gateway existe, **Administration > Gateway** devient votre Dashboard. À partir de là, vous pouvez :

* **Rechercher** par nom ou **filtrer** par statut (Active, Suspended…).
* **Ajouter une Gateway** ou **Charger une Gateway d'un autre site**.
* **Consulter le tableau Gateway**: nom, domaine, chemin first-party, ID Google, statut et nombre de bibliothèques déclarées. Utilisez les icônes de ligne pour modifier ou supprimer (la suppression demande une confirmation).
* **Décharger** les configurations listées sous *Chargées depuis d'autres sites* lorsque vous n'en avez plus besoin.
* Ouvrir **Gérer les bibliothèques** (sous le tableau) pour accéder à First-Party Tag Hosting.

#### First-Party Tag Hosting

<figure><img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2FjiTsuMeGV0LVBThbOOW5%2F12-first-party-libraries.png?alt=media&amp;token=9212f8ec-ebf0-4441-a7f1-543c92bfc132" alt=""><figcaption></figcaption></figure>

Dans **Administration > First-Party Tag Hosting**, déclarez les bibliothèques JS Third-party à diffuser via vos Gateway(s).

1. Cliquez sur **Ajouter une URL JS** et saisissez l'URL Third-party d'origine de la bibliothèque.
2. Trouvez les **liens hébergés** dans le tableau — une URL first-party par Gateway où la bibliothèque est active. Le tableau affiche également le statut et la date du dernier déploiement ; utilisez les icônes de ligne pour modifier ou supprimer.
3. Utilisez l'URL first-party dans votre tag à la place de l'URL d'origine.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/developpeurs/commanders-tag-gateway/manage-your-gateway.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.