# Piano Analytics Enrichment API

Piano Analytics est le successeur d’AT Internet Analytics Suite 2 (AS2).\
C’est 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 mettre à jour et/ou enrichir vos données à l’aide de [Piano Analytics Enrichment API](https://support.piano.io/hc/en-us/articles/4465975814290-Enrichments).

## Fonctionnalités clés

La destination Piano Analytics Enrichment 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 couvre [les templates de Piano Analytics](https://support.piano.io/hc/en-us/articles/4465975814290-Enrichments#Creation), 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 les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Mappage intelligent**: le mappage 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 administrateur ou superviseur de données et que vous avez créé et configuré un enrichissement.

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

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Organization ID</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>L’identifiant de votre organisation. Il se trouve dans l’interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>SETTINGS</code>➜ <code>Data Management</code> ➜ <code>Enrichment</code> ➜ Modifiez votre enrichment ➜ <code>Import Data</code> puis recherchez la <strong>chaîne en gras</strong> dans votre URL : https://import.atinternet.io/<strong>[ORGANIZATION ID]</strong>/[ENRICHMENT ID]/[ENRICHMENT KEY]</p></td></tr><tr><td><code>Enrichment Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L’identifiant de votre enrichment. Il se trouve dans l’interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>SETTINGS</code> ➜ <code>Data Management</code> ➜ <code>Enrichment</code> ➜ Modifiez votre enrichment ➜ <code>Import Data</code> puis recherchez la <strong>chaîne en gras</strong> dans votre URL : https://import.atinternet.io/[ORGANIZATION ID]/<strong>[ENRICHMENT ID]</strong>/[ENRICHMENT KEY]</td></tr><tr><td><code>Enrichment Key</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé d’enrichment. Elle se trouve dans l’interface "Piano Analytics" en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>SETTINGS</code> ➜ <code>Data Management</code> ➜ <code>Enrichment</code> ➜ Modifiez votre enrichment ➜ <code>Import Data</code> puis recherchez la <strong>chaîne en gras</strong> dans votre URL : https://import.atinternet.io/[ORGANIZATION ID]/[ENRICHMENT ID]/<strong>[ENRICHMENT KEY]</strong></td></tr><tr><td><code>Access Key</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 <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 ce <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>Un hit pour chaque item</code></td><td>Cela indiquera à la destination d’envoyer un hit pour chaque item de votre "Item list". C’est utile lors de l’utilisation du template Piano Analytics "E-COMMERCE/product_id".</td></tr><tr><td><code>Configuration de l’enrichment</code></td><td>Mappez vos propriétés à enrichir. Votre <code>Enrichment Key</code> doit être inclus et mappé.<br>Dans <code>Nom de la propriété d’enrichment</code> définissez le nom de votre propriété dans Piano Analytics à enrichir et dans <code>Votre valeur</code> votre valeur correspondante. Dans <code>Votre chemin de valeur</code> vous pouvez sélectionner le niveau où <code>Votre valeur</code> est situé. Cela inclut : <code>Default (root)</code>, <code>In "items" {items.X}</code> et <code>In "product" {items.X.product}</code>.</td></tr></tbody></table>

## Référence rapide

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

{% hint style="info" %}
**\[1]** Utilisez [Destination filters](https://doc.commandersact.com/features/destinations/destination-filters) pour faire correspondre vos events avec [les templates de Piano Analytics](https://support.piano.io/hc/en-us/articles/4465975814290-Enrichments#Creation).
{% endhint %}

## Mappages des champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l'aide de notre fonctionnalité "Smart Mapping".
{% endhint %}

{% hint style="warning" %}
Votre clé d’enrichment/de réconciliation sélectionnée doit être incluse et mappée.
{% endhint %}

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

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


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.