> 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/fonctionnalites/destinations/destinations-catalog/piano-analytics/piano-analytics-enrichment-api.md).

# Piano Analytics Catalogs API

Piano Analytics est le successeur d'AT Internet Analytics Suite 2 (AS2) et un outil centré sur l'utilisateur qui simplifie l'analytique produit et marketing, tout en garantissant la qualité des données.\
Grâce à cette destination, vous pouvez connecter vos catalogues à vos données comportementales dans Piano Analytics en utilisant [Piano Catalogs API](https://developers.piano.io/analytics/data-collection/import/catalogs/).

{% hint style="info" %}
Les Catalogs sont l'évolution naturelle des enrichissements de Piano Analytics. Si vous avez déjà configuré des enrichissements par le passé, ceux-ci ont été migrés vers les Catalogs de manière transparente.
{% endhint %}

## Fonctionnalités clés

La destination Piano Analytics Catalogs API offre les fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) le modèle prend en charge [la structure de données du catalogue Piano Analytics](https://developers.piano.io/analytics/data-collection/import/catalogs/#payload), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.

## Configuration de la destination

Avant de commencer avec cette destination, assurez-vous que votre utilisateur dispose des droits d'administrateur ou de superviseur des données et que vous avez créé et configuré un catalogue/enrichissement.

{% hint style="info" %}
Vous pouvez créer/accéder aux catalogues en allant dans l'interface Piano Analytics en suivant ![](/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7) ➜ <mark style="color:bleu;">`PARAMÈTRES`</mark> ➜ <mark style="color:bleu;">`Data Management`</mark> ➜ <mark style="color:bleu;">`Catalogs`</mark>.
{% endhint %}

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Clé d'accès</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé d'accès. Vous pouvez la trouver ou la créer en suivant ce lien <a href="https://user-profile.atinternet-solutions.com/#/apikeys">LINK</a>.</td></tr><tr><td><code>clé secrète</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé secrète. Vous pouvez la créer en suivant ce lien <a href="https://user-profile.atinternet-solutions.com/#/apikeys">LINK</a> et elle n'est affichée qu'au moment de la création.</td></tr><tr><td><code>ID du catalogue</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant de catalogue (import). Vous pouvez le trouver dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code>➜ <code>Data Management</code> ➜ <code>Catalogs</code> (menu de gauche) <strong>→</strong> Cliquez sur votre catalogue dans la liste <strong>→</strong> Cliquez sur le <code>Importer des données</code> tab <strong>→</strong> <code>ID du catalogue</code>.</td></tr><tr><td><code>Clé du catalogue</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé de catalogue (rapprochement). Vous pouvez la trouver dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code>➜ <code>Data Management</code> ➜ <code>Catalogs</code> (menu de gauche) ➜ Cliquez sur votre catalogue dans la liste ➜ Cliquez sur le <code>Structure</code> onglet ➜ recherchez la ligne avec <code>Rôle</code> est égal à <code>Clé de rapprochement</code> et utilisez la valeur dans la colonne <code>Clé de propriété</code>.</td></tr><tr><td><code>Un hit pour chaque item</code></td><td>Cela indiquera à la destination d'envoyer un hit pour chaque item dans votre "Item list". C'est utile lorsque vous utilisez Piano Analytics <code>E-COMMERCE/product_id</code> template.</td></tr><tr><td><code>Configuration d'enrichissement</code></td><td>Associez vos propriétés à mettre à jour/enrichir. Votre <code>Clé du catalogue</code> doit être inclus et associé.<br>Dans <code>Votre chemin de valeur</code>, lorsque vous sélectionnez une valeur différente de "Default (root)", vous devez définir un nom de propriété dans <code>Votre valeur</code>.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events | Piano Analytics Templates |
| --------------------- | ------------------------- |
| `[Tout événement]`    | `[Any Template]` **\[1]** |

{% hint style="info" %}
**1.** Utilisez [filtres de destination](https://doc.commandersact.com/features/destinations/destination-filters) pour faire correspondre vos événements avec les templates de Piano Analytics.
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.
{% endhint %}

{% hint style="warning" %}
La clé de catalogue que vous avez sélectionnée doit être incluse et associée.
{% endhint %}

| Propriétés Commanders Act | Propriétés Piano Analytics |
| ------------------------- | -------------------------- |
| `[Any Property]`          | `[Any Property]` **\[1]**  |

{% hint style="info" %}
**1.** Voir [Configuration d'enrichissement](#configuration) pour plus de détails.
{% endhint %}


---

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/piano-analytics/piano-analytics-enrichment-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.