> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/aeo-research/query-versus-report.md).

# Rapport Query Versus

Comparez les résultats Google et les citations de l’IA pour une requête cible avec Query Versus Report.

Query Versus Report analyse les pages qui se disputent une requête cible dans les résultats Google et les citations de l’IA. Utilisez-le pour étudier une opportunité de contenu avant d’avoir une page propriétaire à comparer.

## Aperçu

Fournissez un Brand Kit et la question que vous souhaitez analyser. Le rapport rassemble les pages concurrentes et les recherches associées pour vous aider à évaluer le contenu couvrant cette question. Un prompt cible est requis ; un mot-clé seul ne suffit pas.

## Comment configurer

1. Ajoutez une **Query Versus Report** Ajoutez cette étape à votre workflow.
2. Définissez le **ID du Brand Kit** et le **Prompt cible**.
3. Définissez éventuellement un type de contenu pour cibler les pages concurrentes.
4. Vérifiez la région Google, la langue et les plateformes d’IA.
5. Exécutez l’étape et examinez son rapport avant de le transmettre à une étape de rédaction ou de planification.

## Paramètres

| Paramètre       | Obligatoire | Description                                                                                                      |
| --------------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
| `brand_kit_id`  | Oui         | Brand Kit utilisé pour l’analyse.                                                                                |
| `target_prompt` | Oui         | La question ou le prompt à étudier.                                                                              |
| `content_type`  | Non         | Type de contenu libre utilisé pour filtrer les pages concurrentes.                                               |
| `gl`            | Non         | Code de région Google. Par défaut : `us`.                                                                        |
| `hl`            | Non         | Code de langue Google. Par défaut : `en`.                                                                        |
| `ai_platforms`  | Non         | Valeurs séparées par des virgules : `chatgpt`, `gemini`, `perplexity`, `google_ai_mode`. Par défaut : `chatgpt`. |
| `soft_fail`     | Non         | Laissez le workflow continuer si cette étape échoue.                                                             |

## Exemple

Utilisez un prompt comme « Quels outils de gestion de projet conviennent bien aux équipes distribuées ? » avec votre Brand Kit. Définissez `content_type` à `comparaison` si vous souhaitez vous concentrer sur les pages de comparaison.

```json
{
  "brand_kit_id": 123,
  "target_prompt": "Quels outils de gestion de projet conviennent bien aux équipes distribuées ?",
  "content_type": "comparison",
  "gl": "us",
  "hl": "en",
  "ai_platforms": "chatgpt,perplexity"
}
```

Remplacez `123` par votre ID de Brand Kit. Examinez les pages renvoyées et les recherches à l’appui avant de décider quoi créer.

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-f0952f7848bbf175eda611d6cfe958f336e5b135%2Fquery-versus-01-step-config.png?alt=media" alt="Query Versus Report step comparing Google and AI results for a rideshare launch booking prompt"><figcaption><p>Définissez le prompt cible, le type de contenu, la région, la langue et les plateformes d’IA pour le rapport.</p></figcaption></figure>

<figure><img src="https://344527547-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-c8f3f5465378f4fafd3fc4c91cea65984bba32a2%2Fquery-versus-02-report.png?alt=media" alt="Query Versus Report output comparing Google results with AI-cited pages for a rideshare launch prompt"><figcaption><p>Le rapport montre où les résultats Google et les citations de l’IA divergent.</p></figcaption></figure>


---

# 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://docs.airops.com/docs/fr/actions/workflow-concepts/workflow-steps/aeo-research/query-versus-report.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.
