> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynamic Yield Events

## Overview

Dynamic Yield is a personalisation platform that builds actionable customer segments in real time, enabling marketers to increase revenue through personalisation, recommendations, automatic optimisation, and one-to-one messaging. The platform offers an **Events API** to capture and send real-time user interaction and behavioural data—such as page views, product views, add-to-cart actions, and purchases—into the system.

## Supported Identifiers

This integration supports SHA256 Hashed email, Phone Numbers and DYID.

## Prerequisites

Before pushing the segments to Dynamic Yield, ensure that you have set up the feed as mentioned below.

1. Create an API Key.

<Note>
  **Note:**

  *For more information, refer to the [Dynamic Yield documentation](https://support.dynamicyield.com/hc/en-us/articles/4409595248017-Update-Your-User-Profile-Data-by-API#h_01HEQKN0GWZG127TJ14WAAJH77).*
</Note>

### Step 1 - Choose Unique User Identifier or Create one

Under **Unique User Identifier**, by default, you can choose \*\*Email Address (CUID)\*\*or **DYID**. In case you want to add a custom identifier, you can do so by performing the following steps:

<Steps>
  <Step>
    On the top bar, click **Settings** > **General Settings**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/LCxSbw6jRjl6WDYA/articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2024-12-06-1.png?fit=max&auto=format&n=LCxSbw6jRjl6WDYA&q=85&s=20495e11b263d904b75387b640c56a41" width="510" height="486" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2024-12-06-1.png" />
    </Frame>
  </Step>

  <Step>
    Under **User Identifier Types**, click **Add Identifier Type**and choose either**Phone number**or \*\*Others.\*\*If you choose **Others**, then you can add a custom identifier in Dynamic Yield as shown below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/LCxSbw6jRjl6WDYA/articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2024-12-06-3.png?fit=max&auto=format&n=LCxSbw6jRjl6WDYA&q=85&s=9bd7a707128e89f3d24b9f9bc14d23d9" width="1892" height="866" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2024-12-06-3.png" />
    </Frame>
  </Step>
</Steps>

### Step 2: Create the API Access Token/API Key

You must create an API Key which needs to be entered while creating a destination in Zeotap CDP. To do so, perform the following steps:

<Steps>
  <Step>
    In the Dynamic Yield console, click **Settings** > **API Keys**and click**New Key.**

    <Frame>
      <img src="https://mintcdn.com/zeotap/XvfkMbxDmHsFyji6/articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2025-01-26.png?fit=max&auto=format&n=XvfkMbxDmHsFyji6&q=85&s=20c8bf0dba41b1291f863a15120b9afe" width="3576" height="722" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2025-01-26.png" />
    </Frame>
  </Step>

  <Step>
    In the window that appears, provide the following details:

    a. Enter a name, and internal notes (optional).

    b. For the source, select either **Server-side** or **Client-side**. Each type can be used only with its designated endpoint.

    c. In the **ACL** section, use the checkbox to select the **Experience API**permission for the API Key.

    d. Click **Save**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/XvfkMbxDmHsFyji6/articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2025-01-26-1.png?fit=max&auto=format&n=XvfkMbxDmHsFyji6&q=85&s=c4e17898ae24244b8fe92bab4fcfdb7f" width="3450" height="1466" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2025-01-26-1.png" />
    </Frame>
  </Step>

  <Step>
    The created API Key gets listed as shown below, from where you can copy it and use while creating a destination in Zeotap CDP, as explained in the next section.

    <Frame>
      <img src="https://mintcdn.com/zeotap/LCxSbw6jRjl6WDYA/articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2024-05-17-3.png?fit=max&auto=format&n=LCxSbw6jRjl6WDYA&q=85&s=2780b0ee7c432ec10e99e479403102e5" width="2344" height="848" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield/dynamic-yield-2024-05-17-3.png" />
    </Frame>
  </Step>
</Steps>

## Create a Destination for Dynamic Yield Events

Once you have obtained the prerequisites mentioned in the above section, perform the following steps to create a Destination for Dynamic Yield Events:

<Steps>
  <Step>
    Log into the Zeotap CDP App and go to the DESTINATIONS application.
  </Step>

  <Step>
    Click **+ Create Destination**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/xGzkHY-dcQy5tLit/articles/integrate-customer/Storage/integrate-customer/ADOBE_DMP_3.png?fit=max&auto=format&n=xGzkHY-dcQy5tLit&q=85&s=102da1a60a97d389369069c7bad552ab" width="2870" height="796" data-path="articles/integrate-customer/Storage/integrate-customer/ADOBE_DMP_3.png" />
    </Frame>
  </Step>

  <Step>
    Under All Destinations, search for Dynamic Yield Events.

    <Frame>
      <img src="https://mintcdn.com/zeotap/xGzkHY-dcQy5tLit/articles/integrate-customer/Storage/integrate-customer/ADOBE_DMP_4.png?fit=max&auto=format&n=xGzkHY-dcQy5tLit&q=85&s=6a7ff3c41d25bca380ad1cdfe0d1f678" width="2866" height="888" data-path="articles/integrate-customer/Storage/integrate-customer/ADOBE_DMP_4.png" />
    </Frame>
  </Step>

  <Step>
    Click Dynamic Yield. A screen appears displaying details about the particular destination towards the left. On the right-hand side of the screen find a list of fields that are required for the integration to be established. Enter the required details as mentioned in the following steps:

    a. Enter a name for the Destination.

    b. Enter the**API Access Token**obtained from the Dynamic Yield. [Learn more](/articles/integrate-customer/dynamic-yield#h2_1256851356)

    c. Under **User Unique Identifier in Dynamic Yield**, choose the unique Identifier, that is, the identifier type chosen while [creating a User Data Feed](https://support.dynamicyield.com/hc/en-us/articles/4409595248017-Update-Your-User-Data-Feed-by-API#h_01HEQMZW4H67TBP9ZYP4Z5N1V0) in Dynamic Yield. You can either choose **Hashed Email Address** or **Custom Identifier**.

    i. If you choose **Hashed Email Address**, then a field called **Unique Identifier for Email**will be enabled with an auto populated value: **ihe**

    ii. If you choose **Custom Identifier**, then you need to enter the customer identifier added in Dynamic Yield. For more information about selecting Unique Identifier, refer [here](/articles/integrate-customer/dynamic-yield#h3_893954803).

    <Frame>
      <img src="https://mintcdn.com/zeotap/LCxSbw6jRjl6WDYA/articles/integrate-customer/Storage/integrate-customer/dynamic-yield-events/dynamic-yield-events-2026-02-06-2.png?fit=max&auto=format&n=LCxSbw6jRjl6WDYA&q=85&s=0ef688224d66aebc1b6dc37704e22e22" width="2880" height="1626" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield-events/dynamic-yield-events-2026-02-06-2.png" />
    </Frame>

    d. Review all the values entered above and then click **Next** to proceed to mapping.
  </Step>

  <Step>
    On the **Action and Mapping** screen, select the action, based on the identifiers and attributes you want to send. Then, map the **Catalogue** and **Destination** fields accordingly.

    <Frame>
      <img src="https://mintcdn.com/zeotap/LCxSbw6jRjl6WDYA/articles/integrate-customer/Storage/integrate-customer/dynamic-yield-events/dynamic-yield-events-2026-02-06-3.png?fit=max&auto=format&n=LCxSbw6jRjl6WDYA&q=85&s=6b7263f8270447b23971a54c21e4462e" width="2880" height="1628" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield-events/dynamic-yield-events-2026-02-06-3.png" />
    </Frame>

    a. If you choose **Send Add to Cart Events to Dynamic Yield or Send Remove from Cart Events**

    i. You can Map the following.

    1. **DYID**
    2. **Session DYID**
    3. **Product Value**
    4. **Product ID**
    5. **Product Quantity**

    b. If you choose **Send Login Events to Dynamic Yield / Send Signup Events to Dynamic Yield**

    ii. You can Map the following.

    1. **DYID**
    2. **Session DYID**
    3. **Custom Unique Identifier (Email/Phone number)**

    c. If you choose **Send Purchase Events to Dynamic Yield**

    i. You can Map the following.

    1. **DYID**
    2. **Session DYID**
    3. **Product ID**
    4. **Product Quantity**
    5. **Item Price**
    6. **Cart Value**
  </Step>

  <Step>
    Once the mapping is complete, click **Create Destination**.
  </Step>
</Steps>

## Activate the Destination on Journeys

After creating a destination, next, you need to link it in the Send to Destination node within the workflow, as explained below.

<Steps>
  <Step>
    In the workflow, click + and choose Send to Destinations.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-79.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=5dabbc7abee7825797bfe5383b084519" width="1032" height="542" data-path="articles/integrate-customer/Storage/integrate-customer/image-79.png" />
    </Frame>
  </Step>

  <Step>
    Choose the destination from the list of available destinations by using the search feature.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-80.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=2ecc8be62381819fe122e07d6131a94f" width="1600" height="891" data-path="articles/integrate-customer/Storage/integrate-customer/image-80.png" />
    </Frame>
  </Step>

  <Step>
    Under the Destination Details tab, the Feed ID and API Key fields are automatically populated based on the value that you have entered while creating the destination.
  </Step>

  <Step>
    Under the Destination Settings tab, choose the Action and mapping as per your requirement.
  </Step>

  <Step>
    Upon clicking Save Destination. The destination is attached as shown in the image below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/LCxSbw6jRjl6WDYA/articles/integrate-customer/Storage/integrate-customer/dynamic-yield-events/dynamic-yield-events-2026-02-06-4.png?fit=max&auto=format&n=LCxSbw6jRjl6WDYA&q=85&s=8f046fa9ed486af4fb2b8983d7e1d752" width="1584" height="1126" data-path="articles/integrate-customer/Storage/integrate-customer/dynamic-yield-events/dynamic-yield-events-2026-02-06-4.png" />
    </Frame>
  </Step>
</Steps>

## Where to View Events in Dynamic Yield

Perform the steps below to view events in Dynamic Yield:

<Steps>
  <Step>
    Log into the Dynamic Yield UI with appropriate credentials.
  </Step>

  <Step>
    Under the **Audience** tab, go to **Extensions** and click **V** **iew Logs in Events**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-81.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=8973bff461cf7551e8a7794bb8b4f2e5" width="2880" height="1626" data-path="articles/integrate-customer/Storage/integrate-customer/image-81.png" />
    </Frame>
  </Step>

  <Step>
    From the options, select **Experience API** to view your Events \*\*.

    <Frame>
      <img src="https://mintcdn.com/zeotap/yn2o-zYGriWZb6QH/articles/integrate-customer/Storage/integrate-customer/image-82.png?fit=max&auto=format&n=yn2o-zYGriWZb6QH&q=85&s=cdb99238a73919a45e20832793f022cc" width="2880" height="1622" data-path="articles/integrate-customer/Storage/integrate-customer/image-82.png" />
    </Frame>
  </Step>
</Steps>
