> 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/dynamic-yield.md).

# Dynamic Yield

[Dynamic Yield](https://www.dynamicyield.com) aide les entreprises à offrir des expériences client numériques personnalisées, optimisées et synchronisées. Cette destination exploite le [Experience API](https://support.dynamicyield.com/hc/en-us/articles/360010686157-Experience-APIs-Overview) pour suivre [des événements significatifs](https://dy.dev/reference/track-events), afin de pouvoir utiliser les informations pour le ciblage comportemental, le reporting, la définition d'objectifs d'optimisation, les recommandations et la création d'audience.

## Fonctionnalités clés

La destination Dynamic Yield offre les principales fonctionnalités suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre [Dynamic Yield events](https://dy.dev/reference/track-events), 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.
* **Données enrichies**: vous pouvez envoyer librement des informations supplémentaires en fonction de vos besoins spécifiques (par ex. en ajoutant des événements personnalisés et des propriétés d'événement personnalisées).
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Envoyer toutes les propriétés**: envoyez toutes les propriétés de vos événements à Dynamic Yield en un seul clic.

## Configuration de la destination

{% hint style="info" %}
Utilisez [**filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour affiner les événements et/ou d'autres propriétés correspondant à vos besoins spécifiques.
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Endpoint</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Sélectionnez votre centre de données d'endpoint : EU ou US.</td></tr><tr><td><code>API Key</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre clé API telle que générée dans l'interface Dynamic Yield. Plus de détails sont disponibles en suivant ce <a href="https://support.dynamicyield.com/hc/en-us/articles/360022734893#create-an-api-key-0-1">LINK</a>.</td></tr><tr><td><code>Identifiant utilisateur</code></td><td>Identifiant utilisateur généré par Dynamic Yield et géré, avec leurs tags client-side, via des cookies. Plus de détails sont disponibles en suivant ce <a href="https://support.dynamicyield.com/hc/en-us/articles/4415087403281#making-api-requests-0-1">LINK</a> (Voir cookies <code>_dyid</code> et <code>_dyid_server</code>). Lorsque l'option "Default" est conservée, les deux cookies ci-dessus sont utilisés pour récupérer une valeur. En sélectionnant "[Custom Property]", vous pouvez spécifier une propriété contenant la valeur correspondante. Quel que soit le choix effectué, si aucune valeur n'est disponible, notre propriété standard <code>user.consistent_anonymous_id</code> est utilisé.</td></tr><tr><td><code>Propriété personnalisée</code></td><td>Lorsque vous sélectionnez "[Custom Property]" avec les <code>Identifiant utilisateur</code>, vous pouvez saisir le nom de votre propriété personnalisée contenant l'identifiant utilisateur (p. ex. <code>user.mycustomid</code>).</td></tr><tr><td><code>Envoyer toutes les propriétés</code></td><td>Lorsque vous activez cette option, toutes les propriétés incluses à la racine de vos événements Commanders Act sont également envoyées à Dynamic Yield dans les <code>propriétés</code> objet. Les propriétés avec des sous-propriétés sont converties en une seule en utilisant le caractère de soulignement "_" comme séparateur (p. ex. device_lifecycle_last_session_start).</td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td>Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans <code>nom de propriété Dynamic Yield</code> et en ajoutant sa valeur dans <code>Votre valeur</code>.</td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifiez le mapping standard (voir <a href="#quick-reference">Référence rapide</a>) entre les événements Dynamic Yield et les vôtres, ou ajoutez de nouveaux mappages.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events                                                                                      | Types Dynamic Yield (dyType) |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `add_to_cart`                                                                                              | `add-to-cart-v1`             |
| `add_to_wishlist`                                                                                          | `add-to-wishlist-v1`         |
| `generate_lead`                                                                                            | `newsletter-subscription-v1` |
| `login`                                                                                                    | `login-v1`                   |
| `purchase`                                                                                                 | `purchase-v1`                |
| `remove_from_cart`                                                                                         | `remove-from-cart-v1`        |
| `search`                                                                                                   | `keyword-search-v1`          |
| `sign_up`                                                                                                  | `signup-v1`                  |
| <p><code>video\_start</code></p><p><code>video\_complete</code></p><p><code>video\_ad\_complete</code></p> | `video-watch-v1`             |
| `[Tout autre événement]` **\[1]**                                                                          | `[Non défini]` **\[2]**      |

{% hint style="info" %}
**1.** Les événements personnalisés sont également pris en charge.\
**2.** Les événements personnalisés Dynamic Yield n'ont pas de type. Plus de détails sont disponibles en suivant ce [LINK](https://support.dynamicyield.com/hc/en-us/articles/4414379007633-Reporting-Events#custom-events-0-3). Voir <mark style="color:bleu;">`Correspondance des événements`</mark> dans [Configuration](#configuration) pour plus de détails.
{% 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 %}

<table><thead><tr><th width="404.6685580062746">Propriétés Commanders Act</th><th>Propriétés Dynamic Yield</th></tr></thead><tbody><tr><td><code>Identifiant utilisateur</code></td><td><p><code>user.dyid</code></p><p><code>user.dyid_server</code></p></td></tr><tr><td><code>partners.dy.session_id</code></td><td><code>session.dy</code> <strong>[1]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>context.device.ip</code></td></tr><tr><td><code>event_name</code></td><td><code>events[0].name</code></td></tr><tr><td><code>(event_name)</code></td><td><code>dyType</code> <strong>[2][3]</strong></td></tr><tr><td><code>valeur</code></td><td><code>valeur</code> <strong>[2]</strong></td></tr><tr><td><code>currency</code></td><td><code>currency</code> <strong>[2]</strong></td></tr><tr><td><code>items.0.id</code></td><td><code>productId</code> <strong>[2][4]</strong></td></tr><tr><td><code>items.0.quantity</code></td><td><code>quantity</code> <strong>[2][4]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>cart.X.productId</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>cart.X.quantity</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>cart.X.itemPrice</code> <strong>[2]</strong></td></tr><tr><td><code>id</code></td><td><code>uniqueTransactionId</code> <strong>[2]</strong></td></tr><tr><td><code>user.email</code></td><td><code>hashedEmail</code> <strong>[2]</strong></td></tr><tr><td><code>(event_name)</code></td><td><code>progression</code> <strong>[2][5]</strong></td></tr><tr><td><code>search_term</code></td><td><code>keywords</code> <strong>[2]</strong></td></tr><tr><td><code>Votre propriété d'événement</code></td><td><code>nom de propriété Dynamic Yield</code> <strong>[6]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** si aucune propriété n'est fournie, le cookie <mark style="color:bleu;">`_dyjsession`</mark> est utilisé.\
**2.** Cette propriété est définie dans <mark style="color:bleu;">`events[0].properties`</mark>.\
**3.** Voir [Référence rapide](#quick-reference) pour plus de détails.\
**4.** Inclus pour [add\_to\_cart](https://doc.commandersact.com/developers/tracking/events-reference#add_to_cart), [remove\_from\_cart](https://doc.commandersact.com/developers/tracking/events-reference#remove_from_cart) et [add\_to\_wishlist](https://doc.commandersact.com/developers/tracking/events-reference#add_to_wishlist) les événements.\
**5.** Défini avec <mark style="color:bleu;">`VIDEO_STARTED`</mark> , <mark style="color:bleu;">`VIDEO_FINISHED`</mark> ou <mark style="color:bleu;">`PREROLL_FINISHED`</mark> selon que le nom de l'événement est [video\_start](https://doc.commandersact.com/developers/tracking/events-reference/video-event-reference#video-playback-started), [video\_complete](https://doc.commandersact.com/developers/tracking/events-reference/video-event-reference#video-playback-completed) ou [video\_ad\_complete](https://doc.commandersact.com/developers/tracking/events-reference/video-event-reference#video-a-d-completed) respectivement.\
**6.** Voir <mark style="color:bleu;">`Propriétés d'événement personnalisées`</mark> dans [Configuration ](#configuration)pour plus de détails sur la manière d'envoyer des propriétés personnalisées à Dynamic Yield.
{% 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/dynamic-yield.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.
