Audience Management & Data Activation

In the Martailer ecosystem, Audiences are the mechanism for monetizing and activating your first-party data. Unlike opaque ad networks, our architecture gives you full control: you define the segment via API, you set the price (Markup) in the UI, and you explicitly share it with specific vendors.

The Data Lifecycle

1. Push: You sync segments from your CDP/Data Warehouse using the API.
2. Monetize: You set a markup percentage in the Audience Manager.
3. Share: You grant specific vendors access to these segments.
4. Activate: Vendors select these audiences when creating campaigns.

Part 1: API Reference

Use these endpoints to programmatically sync your user segments.

Base URL: https://api.martailer.com Authentication: All requests require the x-api-key header.

1. Create Audience

Defines a new audience container. You must provide your own audienceId (e.g., the ID from your internal CDP), which acts as the primary key for future updates.

Request Body Parameters:

curl --request POST \
  --url [https://api.martailer.com/v1/audiences](https://api.martailer.com/v1/audiences) \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'content-type: application/json' \
  --data '{
    "audienceId": "seg_sports_001",
    "name": "Sports Enthusiasts",
    "description": "Shoppers who bought sports gear in last 30d"
  }'

2. Add Users to Audience

Populates the audience with users. This endpoint supports batching and can be called repeatedly to add new users to an existing segment.

Request Body Parameters:

🚧

Data Privacy Requirement User emails must be trimmed of whitespace and converted to lowercase before applying the SHA-256 hash.

curl --request POST \
  --url [https://api.martailer.com/v1/audiences/seg_sports_001/users](https://api.martailer.com/v1/audiences/seg_sports_001/users) \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'content-type: application/json' \
  --data '{
    "identifiers": [
      "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8",
      "a3b84898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d154299"
    ]
  }'

3. Delete Users from Audience

Removes specific users from a segment (e.g., if a user opts out or no longer qualifies).

curl --request POST \
  --url [https://api.martailer.com/v1/audiences/seg_sports_001/users/delete](https://api.martailer.com/v1/audiences/seg_sports_001/users/delete) \
  --header 'x-api-key: <YOUR_API_KEY>' \
  --header 'content-type: application/json' \
  --data '{
    "identifiers": [
      "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8"
    ]
  }'

4. Get List of Audiences

Retrieves all audiences created under your account.

curl --request GET \
  --url [https://api.martailer.com/v1/audiences](https://api.martailer.com/v1/audiences) \
  --header 'x-api-key: <YOUR_API_KEY>'

5. Delete Audience

Permanently deletes an audience container and all its associated users.

curl --request DELETE \
  --url [https://api.martailer.com/v1/audiences/seg_sports_001](https://api.martailer.com/v1/audiences/seg_sports_001) \
  --header 'x-api-key: <YOUR_API_KEY>'

Part 2: Platform Workflow (UI)

Once the data is synced via the API, use the Audience Manager to monetize and share it.

Step 1: Set Markup

The API defines the content of the audience, but the UI defines the value.

1. Go to Audience Manager.

2. Locate your audience (synced from API).
3. Set the Markup (%). This is the fee added to vendor bids when they target this audience.

   • Example: A 20% markup means a €1.00 bid becomes €1.20 cost to the vendor, with the premium attributed to you.

     
     

Step 2: Share with Vendors

Audiences are private by default. To allow a vendor to target an audience, you must explicitly share it.

1. In the Audience Management list, find the Shared with column.

2. Select the vendors (e.g., TrendTrail, EMarket) who should have access.

Step 3: Activation (Vendor View)

Once shared, the vendor can select the audience in their Campaign Creation flow.

1. Vendor navigates to Create Campaign.

2. Opens Advanced Settings.

3. Selects the audience from the Audiences dropdown.