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

# Dépanner Looker Studio

> Résolvez les problèmes de connexion, de schéma, de période et d’alignement des indicateurs dans le connecteur Looker Studio de Qwairy

## Filtrer par date

Toutes les sources de données prennent en charge les contrôles de période natifs de Looker Studio. Ajoutez un **Date Range Control** à votre tableau de bord pour filtrer les données dynamiquement.

<Note>
  Si aucune période n’est indiquée, les données portent par défaut sur les 90 derniers jours.
</Note>

***

## Volume de données

Le connecteur demande les lignes correspondant à la période et aux dimensions sélectionnées. Des périodes longues ou des champs à forte cardinalité peuvent ralentir un rapport ou le rendre moins lisible. Réduisez la période et ne demandez que les champs nécessaires au graphique avant de répartir le rapport sur plusieurs sources de données.

***

## Problèmes courants

### Impossible de finaliser l’autorisation

Lorsque l’étape d’autorisation affiche « This app is blocked » sans possibilité de continuer :

<img src="https://mintcdn.com/qwairy/rp-9bX3KCDSaM2sc/images/looker-blocked-app-warning.png?fit=max&auto=format&n=rp-9bX3KCDSaM2sc&q=85&s=45b26df45e985350a0b596039b8f1420" alt="Avertissement Google Workspace indiquant que le connecteur est bloqué" width="1982" height="1144" data-path="images/looker-blocked-app-warning.png" />

**Cause :** les règles de sécurité Google Workspace de votre organisation bloquent les connecteurs tiers.

**Solution :** demandez à votre administrateur Google Workspace d’autoriser le connecteur Qwairy :

1. Ouvrez **Google Admin Console**
2. Allez dans **Security > API Controls**
3. Sélectionnez **Manage Third-Party App Access**
4. Autorisez l’accès pour le **connecteur Qwairy**

***

### Aucune donnée n’apparaît dans les rapports

1. Vérifiez que votre jeton d’API est valide dans Gestion de l’équipe
2. Vérifiez que la marque sélectionnée dispose de données de suivi
3. Vérifiez que la période inclut des dates avec des données
4. Vérifiez que l’abonnement de votre équipe est actif

***

### Actualiser les données

Looker Studio met les données en cache pour de meilleures performances. Pour actualiser :

* Sélectionnez le bouton **Refresh data** de votre rapport
* Ou configurez l’actualisation automatique dans les paramètres de votre source de données

***

### Les nouveaux champs n’apparaissent pas après une mise à jour du connecteur

Lorsque Qwairy ajoute ou modifie des champs du connecteur, les sources de données
Looker Studio existantes gardent leur ancien schéma jusqu’à ce que vous l’actualisiez manuellement :

1. Ouvrez votre rapport en mode édition
2. Allez dans **Resource > Manage added data sources**
3. Sélectionnez **Edit** sur la source de données Qwairy
4. Sélectionnez **Refresh fields**
5. Confirmez les modifications de champs

Actualisez les champs après les mises à jour du connecteur qui ajoutent des indicateurs comme `coverage`,
`responseCoverage`, `competitorId`, `brandMentionedLabel`,
`totalBrandMentions` ou `ownBrandMentions`.

***

### Les chiffres de Looker ne correspondent pas à l’interface de Qwairy

Dans **Performance Overview** et **Keyword Performance**, les indicateurs de ratio sont
calculés à partir des compteurs bruts dans Looker Studio :
`SUM(numerator) / SUM(denominator)`. Cela évite de faire la moyenne des lignes par fournisseur et
garde des totaux alignés sur l’interface de Qwairy. Si votre tableau de bord affiche encore
d’anciens chiffres, actualisez le schéma :
**Resource > Manage added data sources > Refresh fields**.

Dans **Competitor Metrics**, les lignes sont regroupées par `competitorId` et agrégées
sur l’ensemble des fournisseurs et des modèles. Les dimensions `provider` et `model` restent
disponibles pour la compatibilité, mais leurs valeurs sont `All Providers` et
`All Models`.

Pour les rapports de sources, utilisez `isCompetitor`, `relationship`, `competitorId` ou
`competitor` pour synchroniser les filtres entre **Source Domains** et
**Source URLs**.

***

### Concurrents « mentionnés sur la période » et « suivis au total »

Les lignes de Competitor Metrics n’incluent que les concurrents mentionnés pendant la
période sélectionnée. `totalTrackedCompetitors` renvoie le nombre de concurrents enregistrés au niveau de la marque
(constant, il ignore les filtres). Combinez les deux pour obtenir un taux de couverture :

```
COUNT_DISTINCT(competitor) / MAX(totalTrackedCompetitors)
```


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