Skip to content
API Documents/CDP(Audience) API/
/Tokens

Tokens

The Profiles API Token enables your ability to increase personalized content based on detailed customer information. This REST API returns customer data in real-time and updates your segment information. The ability to create a Profiles API token is based on your folder permissions.

You can also use Profiles API Token to personalize your customers' experience on your website. You can combine Treasure Data’s personalization feature with A/B Testing tools such as Adobe Target, Optimizely, or Google Optimize, to determine the version of your website that yields results.

When the underlying personalization workflow completes, the personalization data set is refreshed. You can see a current list of the segments to which a specific profile belongs. You can also see a list of attributes associated with the specific profile.

The parent segment must already exist. The parent segment is the basis for all data accessed by Profiles API Tokens.

The use of the Profiles API Token with your tools requires the use of the Treasure Data JavaScript SDK and support or services consultation.

Operations

Retrieve list of Profile API tokens

Request

Retrieve a list of Profile API tokens associated with a parent segment ID.

Security
TdApikeyAuth
Path
audienceIdinteger, (int64)required

Master Segment ID of the token

curl -i -X GET \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/tokens' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

successful operation

Bodyapplication/json
Array [
idstring, (integer)
audienceIdstring, (integer)
tokenstring, (uuid)

UUID of the token

descriptionstring
keyColumnstring

A key column name to fetch the information of a customer.

Example:"td_client_id"
segmentsArray of objects(SegmentSummary)

associated segments

attributeColumnsArray of strings

associated attribute column names.

Example:
[
  "gender",
  "country"
]
v2boolean

whether the token is v2 or not

Example:true
createdAtstring, (date-time)
updatedAtstring, (date-time)
createdByobject(User)
updatedByobject(User)
]
Response
[
  {
    "id": "string",
    "audienceId": "string",
    "token": "b5507016-7da2-4777-a161-1e8042a6a377",
    "description": "string",
    "keyColumn": "td_client_id",
    "segments": [ … ],
    "attributeColumns": [ … ],
    "v2": true,
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "createdBy": { … },
    "updatedBy": { … }
  }
]