Treasure Data Audience API

Based on Audience API, Audience Studio is designed to help global marketing teams deal with their organizational complexity and segmentation needs. Treasure Data ingests data from a variety of first-, second-, and third-party sources and enables users to unify data, resolve identities and build enriched, unified customer profiles into a parent segment. Users can analyze the parent segment either as a group or on an individual profile level, and create targeted segments and journeys within that parent segment in the Audience Studio. This enables users to activate highly personalized communications for specific segments or highly effective campaigns that accurately target segments.

Within Audience Studio, you can:

  • Respond to market changes, modifying your Parent Segments as needed
  • Precisely segment your Parent Segments based on attributes, behaviors, and characteristics
  • View the data at the Parent Segment level, targeted segment level, or individual profile level
  • Identify patterns of behaviors or shared customer attributes in your Parent Segment using a form of machine learning that we call Predictive Scoring
  • Activate customer specific data, perhaps by distributing personalized communications to targeted segments or using vendor tools to further process the segment

Audience API is built to enable you to create a functional application or integration quickly and easily as an alternative to using our Audience Studio User Interface. It allows our developer customers programmatic/machine-based access to CDP operations that are used to in our UI, in a much more automated fashion. These are the APIs that power the Treasure Data Audience Studio application.

All of the Audience APIs are organized around REST - if you've interacted with a RESTful API already, many of the concepts will be familiar to you. All API calls to Audience API should be made to the endpoint specific to your region.

We use many standard HTTP features, like HTTP verbs, which can be understood by many HTTP clients. JSON is returned in all responses, including errors. The APIs are designed to have predictable, straightforward URLs and to use HTTP response codes to indicate API errors.

Versions

Similar to Audience Studio Console, Audience API maintains Audience API Legacy and Audience API. The specific endpoints supported in Legacy and Audience API are specified below. If you have resources in Legacy and you are ready to migrate to Audience Studio, reach out to Customer Support to create a migration schedule from Audience Studio Legacy to Audience Studio.

INFO

If you decide to transfer Legacy-created resources to Audience Studio, only very limited Legacy endpoints can be used for resource creation. This is because the Audience API Legacy is not fully compatible with the Audience API. After your resource is migrated, you need to use Audience API to create/update/delete endpoints.

Exceptions, which can only be created using Audience API Legacy, include: Create Audience, Create Segment, Create Segment Folder, and Create Syndication.

Authentication

Audience API allows for authentication based on API keys. API keys are recommended for rapid prototyping.

Available Endpoints

Audience API allows GET, PUT, POST, DELETE, etc. operations for the following types of endpoints:

Authentications: Allows developers to create API Keys and authenticate to the API services after authentication is set up.

Parent Segments: The MasterSegmentConfig and Master Segment endpoints allow you to create, update, edit, delete, find, get a list of parent segment configurations and parent segments and much more. It is the top level endpoint based on which other related operations depend on and can be referenced by.*

Segments: You can create, edit, delete, get a list, and submit queries about segment profiles that are part of a Parent Segment.

Folders: You can create nested folders to organize large volumes of data and application assets by categories such as geographical markets, brands, and business functions. Granular permissions can be set for each folder to ensure security.

Activations: You can create, find, edit, delete, run, or schedule one or more activations (formerly syndications) for a segment that you created. Activations will send the segment data to external partners via our integrations, so that you can perform a marketing or media activity (launch a campaign, send an email, etc).

Tokens: You can create, delete, edit, update, or get a list of tokens associated with an audience.

Funnels: Allows you to create, edit, update, delete funnels and funnel stages for your segments and associate them with specific funnel stages you have defined for your customers. Available in Audience API Legacy.

Predictive Segments: Allows you to create, update, edit, run, delete predictive segments built using AI models. You can specify your input and output columns and their types and our platform does training/validation and scoring and returns scored rows for all the customers in the segment you are using to develop the predictive segment.

Journeys: Allows you to create a timeline of events that can help you motivate a customer’s behavior about your product. After marketers create journey stages, they can further analyze and refine the stages and activate specific stages for campaigns.

*Treasure Data is making an effort to use more inclusive language in its product, content, and customer solutions. As we continue to improve Audience Studio, we are updating feature language, for example, changing Master Segments to Parent Segments. Meanwhile, you may continue to see Parent Segments referenced as Master Segments in our previous UI and Audience API endpoints.