# Dynamic Yield

[Dynamic Yield](https://www.dynamicyield.com) aide les entreprises à offrir des expériences client digitales personnalisées, optimisées et synchronisées. Cette destination exploite l' [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 que vous puissiez utiliser les informations pour le ciblage comportemental, le reporting, la définition d'objectifs d'optimisation, les recommandations et la constitution d'audiences.

## Fonctionnalités clés

La destination Dynamic Yield 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) couvre [Événements Dynamic Yield](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 les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Données enrichies**: vous pouvez envoyer librement des informations supplémentaires selon vos besoins spécifiques (par exemple, ajouter des événements personnalisés et des propriétés d’événements personnalisées).
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage 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 vers Dynamic Yield en un seul clic.

## Configuration de la destination

{% hint style="info" %}
Utilisez [**Destination filters**](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 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">LIEN</a>.</td></tr><tr><td><code>User Identifier</code></td><td>Identifiant utilisateur généré par Dynamic Yield et géré, avec leurs tags client-side, via 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">LIEN</a> (Voir les cookies <code>_dyid</code> et <code>_dyid_server</code>). Lorsque vous conservez "Default", 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 associée. Quelle que soit l'option choisie, si aucune valeur n'est disponible, notre propriété standard <code>user.consistent_anonymous_id</code> est utilisée.</td></tr><tr><td><code>Custom Property</code></td><td>Lors de la sélection de "[Custom Property]" avec le <code>User Identifier</code>ci-dessus, vous pouvez saisir le nom de votre propriété personnalisée contenant l'identifiant utilisateur (par ex. <code>user.mycustomid</code>).</td></tr><tr><td><code>Envoyer toutes les propriétés</code></td><td>Lorsque cette option est activée, toutes les propriétés incluses à la racine de vos événements Commanders Act sont également envoyées à Dynamic Yield dans l' <code>properties</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 (par 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>Event Mapping</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 mappings.</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act                                                                                  | 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`             |
| `[Any Other Event]` **\[1]**                                                                               | `[Not Set]` **\[2]**         |

{% hint style="info" %}

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

<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>User Identifier</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>value</code></td><td><code>value</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>progress</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>Your event property</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é.\
> \&#xNAN;**\[2]** Cette propriété est définie dans <mark style="color:bleu;">`events[0].properties`</mark>.\
> \&#xNAN;**\[3]** Voir [Référence rapide](#quick-reference) pour plus de détails.\
> \&#xNAN;**\[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) events.\
> \&#xNAN;**\[5]** Définissez avec <mark style="color:bleu;">`VIDEO_STARTED`</mark> , <mark style="color:bleu;">`VIDEO_FINISHED`</mark> ou <mark style="color:bleu;">`PREROLL_FINISHED`</mark> selon si 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.\
> \&#xNAN;**\[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 façon dont vous pouvez envoyer des propriétés personnalisées à Dynamic Yield.
> {% endhint %}