> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/cookies/integration/quickstart.md).

# Démarrage rapide

Apprenez à intégrer la bannière de cookies Dastra dans une page web avec le SDK JavaScript.

## Prérequis : récupérer une clé d'API publique

La bannière a besoin d'une clé d'API publique. Cliquez sur l'icône d'engrenage de la barre supérieure (**Réglages de l'organisation**), puis sur **Clés d'API & MCP** dans le menu de gauche. Voir [Gestion des clés d'API](https://doc.dastra.eu/features/settings/api-keys.md).

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-48cf9361a1c99d0e8d5b2a5fd00bef0405f61be8%2Fcookies-quickstart-1.png?alt=media" alt="La page Clés d&#x27;API &#x26; MCP avec la liste des clés"><figcaption><p>La page « Clés d'API &#x26; MCP »</p></figcaption></figure>

## Configurez votre bannière

Configurez votre bannière en suivant le guide ci-dessous :

{% content-ref url="/pages/-M4QG18lMk2aXM5oxk6j" %}
[Mise en place de la bannière](https://doc.dastra.eu/features/cookies/banner.md)
{% endcontent-ref %}

## Insérez le code d'intégration HTML

Insérez le code HTML disponible dans la section **Installation** de la bannière, carte **Javascript**, **avant la fermeture de la balise `</body>`** de votre site, sur toutes les pages. Vous pouvez utiliser Google Tag Manager pour insérer ce code dynamiquement sur chaque page.

{% hint style="info" %}
Pour que le code fonctionne, la clé d'API publique doit être configurée au préalable.
{% endhint %}

Voici le code d'intégration de la bannière :

```html
<div id="dastra-cookie-consent" data-widgetid="{your_widget_id}"></div>
<script src="https://cdn.dastra.eu/sdk/dastra.js?key={your_public_key}" async></script>
```

La `div` dont l'id est `dastra-cookie-consent` est l'emplacement du rendu de la bannière. L'attribut `data-widgetid` identifie la bannière : c'est un nombre entier. `{your_public_key}` est votre clé d'API publique, disponible dans **Clés d'API & MCP**.

{% hint style="info" %}
Copiez toujours le code depuis l'application. Selon la région d'hébergement de votre organisation, l'adresse du script (`cdn-bleu.dastra.eu` plutôt que `cdn.dastra.eu`) et celle de l'API (`api-bleu.dastra.eu` plutôt que `api.dastra.eu`) changent.
{% endhint %}

Une fois le code inséré avant la balise `</body>` de votre site, la bannière s'affiche.

{% hint style="warning" %}
Pour de meilleures performances, le navigateur met la bannière en cache dans le `sessionStorage`.
{% endhint %}

## Rouvrir la bannière depuis un bouton

Retirer son consentement doit être aussi simple que le donner. Ajoutez sur votre site, par exemple dans le pied de page, un bouton qui rouvre la bannière. Le même extrait est affiché dans la section **Installation** de la bannière :

```html
<button type="button" onclick="dastra.openCookieConsent()">Check your cookie consent</button>
```

## WordPress

Si vous utilisez WordPress, la page suivante explique comment installer la bannière avec le plugin Dastra.

{% content-ref url="/pages/-M72kXoMUGfqIriz1ICc" %}
[Wordpress](https://doc.dastra.eu/features/cookies/integration/quickstart/wordpress.md)
{% endcontent-ref %}

Une fois la bannière intégrée, passez à la phase de test.

{% content-ref url="/pages/-M5n-JlwIaL2BmQOHPgl" %}
[Tester l'intégration d'une bannière](https://doc.dastra.eu/features/cookies/integration/test.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 by asking a question.

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

```
GET https://doc.dastra.eu/features/cookies/integration/quickstart.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.
