> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Installer Radar dans une application Angular

> Ajoutez le script Radar à une application Angular via src/index.html, ou chargez-le au démarrage depuis un service qui lit la clé de projet dans vos fichiers d'environnement.

Dans une application Angular, le moyen le plus simple d'installer Radar est de coller le script dans `src/index.html`. Tous les écrans de l'application sont servis depuis ce seul fichier : le script se charge donc partout. Remplacez `pk_xxxx` par votre clé de projet.

```html src/index.html theme={null}
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>Angular App</title>
    <base href="/" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />

    <script
      async
      src="https://taap.it/scripts/tracker.js"
      data-project="pk_xxxx"
      data-track-outbound="true"
      data-track-forms="true"
    ></script>
  </head>
  <body>
    <app-root></app-root>
  </body>
</html>
```

N'écrivez pas de commentaire HTML à l'intérieur de la balise, à côté des attributs : cela casse le script.

Pour savoir à quoi sert chaque attribut, consultez [le fonctionnement du script](https://docs.taap.it/fr/radar/how-the-script-works.md).

## Variante : le charger depuis un service

Utilisez cette version si vous voulez lire la clé de projet dans vos fichiers d'environnement. Le service ajoute le script au head du document. Il ne fait rien quand la clé est vide ou quand le script est déjà sur la page.

```typescript src/app/core/radar.service.ts theme={null}
import { DOCUMENT } from '@angular/common';
import { inject, Injectable } from '@angular/core';

@Injectable({ providedIn: 'root' })
export class RadarService {
  private readonly document = inject(DOCUMENT);

  load(projectKey: string): void {
    if (!projectKey) return;
    if (this.document.querySelector('script[data-project]')) return;

    const script = this.document.createElement('script');
    script.src = 'https://taap.it/scripts/tracker.js';
    script.async = true;
    script.setAttribute('data-project', projectKey);
    script.setAttribute('data-track-outbound', 'true');
    script.setAttribute('data-track-forms', 'true');

    this.document.head.appendChild(script);
  }
}
```

Appelez le service au démarrage de l'application, avec `APP_INITIALIZER`. Choisissez l'onglet qui correspond à la façon dont votre application est démarrée.

```typescript app.config.ts (standalone) theme={null}
import { ApplicationConfig, APP_INITIALIZER } from '@angular/core';
import { RadarService } from './core/radar.service';
import { environment } from '../environments/environment';

export const appConfig: ApplicationConfig = {
  providers: [
    {
      provide: APP_INITIALIZER,
      useFactory: (radar: RadarService) => () => radar.load(environment.radarProjectKey),
      deps: [RadarService],
      multi: true,
    },
  ],
};
```

```typescript app.module.ts (NgModule) theme={null}
import { NgModule, APP_INITIALIZER } from '@angular/core';
import { BrowserModule } from '@angular/platform-browser';
import { AppComponent } from './app.component';
import { RadarService } from './core/radar.service';
import { environment } from '../environments/environment';

@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule],
  providers: [
    {
      provide: APP_INITIALIZER,
      useFactory: (radar: RadarService) => () => radar.load(environment.radarProjectKey),
      deps: [RadarService],
      multi: true,
    },
  ],
  bootstrap: [AppComponent],
})
export class AppModule {}
```

## Ne pas utiliser la clé en développement

Avec le service, stockez la clé dans vos fichiers d'environnement et laissez-la vide pour le développement. Sans clé, le script n'est pas ajouté à la page : Radar ne se charge donc pas pendant que vous développez.

```typescript environment.ts theme={null}
export const environment = {
  production: false,
  radarProjectKey: '', // empty: Radar is not loaded locally
};
```

```typescript environment.prod.ts theme={null}
export const environment = {
  production: true,
  radarProjectKey: 'pk_xxxx',
};
```

Les deux fichiers se trouvent dans `src/environments`. Leurs noms dépendent de la configuration de votre projet : les projets créés avec une version récente d'Angular CLI utilisent `environment.development.ts` pour le développement et `environment.ts` pour la production. Mettez la clé vide dans le fichier de développement.

## Vérifier que tout fonctionne

Déployez votre site, ouvrez la version publiée, chargez deux pages et cliquez sur un lien. Le premier événement doit arriver dans votre tableau de bord Radar en quelques secondes. Si rien n'arrive, suivez les étapes de [vérification de votre installation](https://docs.taap.it/fr/help/radar/check-your-installation.md). Quand la balise est ajoutée par JavaScript au lieu d'être écrite dans le HTML, elle n'apparaît pas dans le code source brut de la page : cherchez plutôt `tracker.js` dans le panneau Éléments des outils de développement de votre navigateur.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.