> ## 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.

# Smadex

## Overview

Smadex is a mobile-first programmatic demand-side platform (DSP) for user acquisition, retargeting and branding campaigns.

The Smadex integration with Zeotap allows you to upload audience segments to Smadex using their API. Zeotap sends CSV files containing user data, along with a specified source and description for the audience update, so that your audiences become available for targeting in your Smadex campaigns — without any manual exports or file transfers.

## Supported Identifiers

The integration supports the following ID types:

| ID Type          | Description                            |
| :--------------- | :------------------------------------- |
| Raw device ID    | Unhashed mobile advertising ID (MAID). |
| Hashed device ID | Hashed mobile advertising ID.          |
| IDFV             | iOS Identifier for Vendors.            |
| IP               | IP address.                            |

<Note>
  **Note:**

  Smadex accepts a single ID type per audience. Select the **ID type** under **Additional Settings** that corresponds to the identifier you map, and ensure it matches how your Smadex campaigns are configured. You cannot activate the same audience using a different identifier. In Smadex, uploaded audiences appear under the tab matching their ID type (**Device ID**, **IP** or **IDFV**).
</Note>

## Available Actions

* Smadex Audience Upload

## Prerequisites

Before you create a Smadex Destination in Zeotap CDP, ensure that you have the following:

* An active Smadex account with access to the Smadex platform (`hub.smadex.com`).
* A **Smadex API Key**, used for Smadex API authentication. If you are unsure where to find your API Key, contact your Smadex account representative.

## Create a Destination for Smadex

Perform the following steps to create a Destination for Smadex:

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

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

  <Step>
    Under **All Destinations**, search for **Smadex** and click the Smadex card.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-1.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=1f0fcddfabd71058f8bd82d71e160c5a" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-1.png" />
    </Frame>
  </Step>

  <Step>
    On the **Enter Destination Details** screen, enter the required details:

    a. Enter a name for the Destination.

    b. Enter your **Smadex API Key**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-2.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=27e3a4a36f2a393c3952830656c3b6dc" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-2.png" />
    </Frame>

    c. Review the values and click **Next** to proceed to mapping.
  </Step>

  <Step>
    On the **Mapping** screen, under **Choose your Action**, select **Smadex Audience Upload**.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-3.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=b9b7ab35dd07e966e9605c3118fed876" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-3.png" />
    </Frame>
  </Step>

  <Step>
    Under **Map the Fields**, map the Catalogue attribute that holds your identifier (for example, **Maid**) to the **Identifier** Destination field.

    Then, under **Additional Settings**, select the **ID type** that corresponds to the mapped identifier from the [Supported Identifiers](#supported-identifiers) list.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-4.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=d8ccd28a4f82554feedc9fd365be28e5" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-4.png" />
    </Frame>
  </Step>

  <Step>
    Once the mapping is complete, click **Create Destination**. A confirmation message appears, and the created Destination gets listed on the **Destinations** page. It can now be linked to an audience (segment) in the **Audiences** application.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-5.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=7fd4fb27f3ea82a8b02e1e797ef7c9cb" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-5.png" />
    </Frame>
  </Step>
</Steps>

## Link an Audience to the Smadex Destination

Create the audience that you want to send to Smadex in the **Audiences** application: define the audience criteria as a **Batch** audience, click **Check Estimates** to review the estimated audience size, and then save the audience. After the audience is created, you can attach the Smadex Destination to it.

<Frame>
  <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-6.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=639e3ea92833f56f8a1c5c5e15373153" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-6.png" />
</Frame>

While linking the audience, select your Smadex Destination and review the **Destination Settings**, which show the action and the mapping you configured. Under **Refresh Frequency**, select how often you want the audience to be pushed — a one-time push or a recurring schedule — and set the start date and time. Then, click **Save Destination**.

<Frame>
  <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-7.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=36dcd9d558b48f140c04645f398a984d" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-7.png" />
</Frame>

Once the activation is saved, a confirmation message appears and the audience starts pushing to Smadex.

<Frame>
  <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-8.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=2bf7a6c2c13b95eb8c2adc56b9a5502b" width="1920" height="996" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-8.png" />
</Frame>

<Note>
  **Note:**

  Every push delivers a **full refresh** of the audience to Smadex; incremental (delta) uploads are not sent.
</Note>

For information about how to link an audience to the created Destination in the **Audiences** application, refer [here](/articles/integrate-customer/link-an-audience-to-the-destination).

## View the Pushed Data on Smadex

Once the audience is activated and the data is delivered, you can verify it in Smadex:

<Steps>
  <Step>
    Log into your **Smadex** account and go to **Audiences > My Audiences**.
  </Step>

  <Step>
    On the **My Audiences list** page, find the audience sent from Zeotap. Audiences are grouped under the tab that matches their ID type (**Device ID**, **IP** or **IDFV**), and the list shows the audience ID, name, number of active files, type and **Dev ID Type** (Raw or Hashed), along with the created and updated dates.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-9.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=f9fb93cc4bdf5afa85ea2d290bbe9d38" width="1726" height="950" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-9.png" />
    </Frame>
  </Step>

  <Step>
    Open the audience to review its details and upload activity. The uploaded files sent by Zeotap are listed with names in the `Zeotap_<audience_id>_<timestamp>.csv` format, along with the status of each file.

    <Frame>
      <img src="https://mintcdn.com/zeotap/wvUFdw6t_0UH99JT/articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-10.png?fit=max&auto=format&n=wvUFdw6t_0UH99JT&q=85&s=0581112278bda9dc6743a4d9d0446532" width="1726" height="950" data-path="articles/integrate-customer/Storage/integrate-customer/smadex/smadex-2026-07-06-10.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  **Note:**

  When a new file is uploaded, Smadex automatically removes the older files of the audience. This keeps the audience data fresh and prevents an incorrect audience count, so files showing a **DELETED** status after a new upload are expected and not an error.
</Note>

<Note>
  **Note:**

  The terms *Audiences* and *Segments* are used interchangeably to refer to customer cohorts belonging to a specific category. For example, an Audience or a segment could be a specific group of customers who are over 18 years of age and who have performed an `addToCart` event within the last 30 days.
</Note>

## Related Topics

* [Link an Audience to the Destination](/articles/integrate-customer/link-an-audience-to-the-destination)
* [Create a Destination](/articles/integrate-customer/create-a-destination)
* [Destination Access Rules](/articles/integrate-customer/destination-access-rules)
