> 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 de AT Internet Analytics Suite 2 (AS2) et un outil centré sur l'utilisateur qui simplifie l'analytics 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 enrichments de Piano Analytics. Si vous avez déjà configuré des enrichments par le passé, ceux-ci ont été migrés de manière transparente vers les catalogs.
{% endhint %}

## Fonctionnalités clés

La destination Piano Analytics Catalogs API fournit 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 se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Smart Mapping**: le mappage des données peut être réajusté à l'aide de vos champs définis dans le data layer.

## Configuration de la destination

Avant de commencer avec cette destination, assurez-vous que votre utilisateur dispose des droits administrateur ou data supervisor et que vous avez créé et configuré un catalogue/enrichment.

{% 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:bleue;">`PARAMÈTRES`</mark> ➜ <mark style="color:bleue;">`Gestion des données`</mark> ➜ <mark style="color:bleue;">`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. Elle peut être trouvée ou créée en suivant ceci <a href="https://user-profile.atinternet-solutions.com/#/apikeys">LIEN</a>.</td></tr><tr><td><code>Secret Key</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé secrète. Elle peut être créée en suivant ceci <a href="https://user-profile.atinternet-solutions.com/#/apikeys">LIEN</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). Il peut être trouvé dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code>➜ <code>Gestion des données</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> onglet <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 (reconciliation). Elle peut être trouvée dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code>➜ <code>Gestion des données</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> égal à <code>clé de réconciliation</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 lors de l'utilisation du template Piano Analytics <code>E-COMMERCE/product_id</code> template.</td></tr><tr><td><code>Configuration des enrichments</code></td><td>Associez vos propriétés à mettre à jour/enrichir. Votre <code>Clé du catalogue</code> doit être incluse et mappée.<br>Dans <code>Le chemin de votre 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

| Propriétés Commanders Act | Piano Analytics Templates            |
| ------------------------- | ------------------------------------ |
| `[Tout événement]`        | `[N'importe quel 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 %}

## Mappages de champs

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

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

| Propriétés Commanders Act      | Propriétés Piano Analytics              |
| ------------------------------ | --------------------------------------- |
| `[N'importe quelle propriété]` | `[N'importe quelle propriété]` **\[1]** |

{% hint style="info" %}
**1.** Voir [Configuration des enrichments](#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.