Skip to content
Audience API
/
Funnels
/
Retrieve funnel by ID

cdp-api (1.0.0)

All of the CDP 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 CDP API should be made to the following endpoints depending on the region. For historical reasons there are REST API endpoints and JSON:API endpoints. JSON:API endpoints are located under "/entities".

Treasure Data Support Site
Download OpenAPI description
audience_api_v1.json
audience_api_v1.yaml
Overview

Terms of Service

Languages
Servers

https://api-cdp.treasuredata.com/

https://api-cdp.treasuredata.co.jp/

https://api-cdp.eu01.treasuredata.com/

https://api-cdp.ap02.treasuredata.com/

https://api-cdp.ap03.treasuredata.com/

Parent Segment Configurations

Defining a data model for customer data is done by defining parent segments. Parent segments give you an ability to build a single view of a customer, including capturing all interactions, such as attributes and behaviors associated with your brand. In parent segments, you unify your customer data. When the customer data is unified, you can create customer segments without writing any SQL queries. You can personalize customer communications and conversations of any size and in any channel.


Treasure Data is making an effort to use more inclusive language in its product, content, and customer solutions. As we gradually make the move to replace insensitive language beginning in our UI, you may continue to see parent segments in the UI, for example, referenced as master segment in portions of Treasure Data APIs.

Operations

Parent Segments

After you have created the parent segment, you can view data about the parent segment, such as details about a single segment, audience data, the list of segment folders it contains, or a list of parent segments available.

Operations

Segments

In marketing, a segment is a container that groups profiles (usually people) who share one or more common characteristics. In Treasure Data, the parent segment is your total population of people, accounts, or other type of collection and can be both existing and potential customers.

You create segments to divide the population into subgroups of consumers based on some type of shared characteristics. Segments and subsegments enable more specific targeting for your marketing campaigns.


Treasure Data is making an effort to use more inclusive language in its product, content, and customer solutions. As we gradually make the move to replace insensitive language beginning in our UI, you may continue to see parent segments in the UI, for example, referenced as master segment in portions of Treasure Data APIs.

Operations

Folders

Folders are containers in which you can organize information. Nested folders offer flexible organization controls. Large volumes of data and application assets can be organized into multi-nested folders by categories such as geographical markets, brands, and business functions. Granular permissions can be set for each folder to ensure security.

Operations

Activations

Activation is the process that allows marketers to personalize communication to users interested in your brand.

  • Funnel activation — Create a funnel activation for each funnel stage. The activation exports to external marketing tools for campaigns or BI tools for analysis and reporting.
  • Segment activation — Activate the segment data (export) to external tools for activities such as marketing campaigns, business analysis, and social media. Targets include Email Marketing Systems, Marketing Automation Systems, Advertising Platforms, CRM, ERP, Cloud Services, and SFTP.

Known formerly as syndication in Audience Studio Legacy. You may continue to see syndication referenced in Treasure Data APIs.

Operations

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

Funnels

One of the challenges of targeting customers with relevant campaigns is understanding where they are in their customer journey. Many organizations use the traditional marketing funnel to understand where their customers are in the buying process. Knowing where customers are in the marketing funnel allows organizations to create campaigns and analyze customer behaviors that are specific to individual customers or customer groups. Being able to use all available customer data to accurately identify exactly in which stage customers are in gives marketers a clear advantage.

Treasure Data offers Funnels, a premium subscription feature in Audience Studio, which provides this advantage to its users. Funnels make it easier for marketers to see exactly where their customers are in the buying process, allowing them to create more customer-tailored marketing campaigns using multi-channel activations.

Funnels enables marketers to create and customize a marketing funnel with up to eight stages in the Audience Studio to reflect the exact buying experience of their customers. After the Funnel stages have been created, marketers can further analyze and refine the stages and activate specific stages for campaigns.

Operations

List of funnels

Request

Retrieves a list of funnels associated with a parent segment identifier and its stages.

Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Master Segment ID

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

Responses

succeeded to get

Bodyapplication/jsonArray [
idstring(integer)
audienceIdstring(integer)
segmentFolderIdstring(integer)
namestring
populationinteger or null(int64)

The latest population of the funnel

descriptionstring
numSyndicationsinteger(int64)
needToRunWorkflowboolean

true if need to run workflow to load data

stagesArray of objects[ 3 .. 8 ] items

funnel stages

Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]
createdAtstring(date-time)
updatedAtstring(date-time)
createdByobject(User)
updatedByobject(User)
]
Response
application/json
[
  {
    "id": "string",
    "audienceId": "string",
    "segmentFolderId": "string",
    "name": "string",
    "population": 0,
    "description": "string",
    "numSyndications": 0,
    "needToRunWorkflow": true,
    "stages": [ … ],
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "createdBy": { … },
    "updatedBy": { … }
  }
]

Create funnel (legacy)

Request

Create a new funnel, assign it a name and description matching your business needs.


This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative.

Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Master Segment ID

Bodyapplication/jsonrequired

Funnel parameters to create

namestringrequired

name

descriptionstring

description

segmentFolderIdinteger(int64)required
stagesArray of objects[ 3 .. 8 ] itemsrequired

funnel stages

Example: [{"name":"Awareness"},{"id":1,"name":"Interest"},{"name":"Conversion"}]
stages[].​idinteger

null means new stage, non-null means no-op or updating existing stage name or updating stage orders

stages[].​namestringrequired
curl -i -X POST \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/funnels' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "segmentFolderId": 0,
    "stages": [
      {
        "name": "Awareness"
      },
      {
        "id": 1,
        "name": "Interest"
      },
      {
        "name": "Conversion"
      }
    ]
  }'

Responses

Succeeded to create funnel

Bodyapplication/json
idstring(integer)
audienceIdstring(integer)
segmentFolderIdstring(integer)
namestring
populationinteger or null(int64)

The latest population of the funnel

descriptionstring
numSyndicationsinteger(int64)
needToRunWorkflowboolean

true if need to run workflow to load data

stagesArray of objects[ 3 .. 8 ] items

funnel stages

Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]
createdAtstring(date-time)
updatedAtstring(date-time)
createdByobject(User)
updatedByobject(User)
Response
application/json
{
  "id": "string",
  "audienceId": "string",
  "segmentFolderId": "string",
  "name": "string",
  "population": 0,
  "description": "string",
  "numSyndications": 0,
  "needToRunWorkflow": true,
  "stages": [
    { … },
    { … },
    { … }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}

Retrieve funnel by ID

Request

Search and find a specific funnel by its identifier.


Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Master Segment ID

funnelIdinteger(int64)required

Funnel ID

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

Responses

succeeded to get

Bodyapplication/json
idstring(integer)
audienceIdstring(integer)
segmentFolderIdstring(integer)
namestring
populationinteger or null(int64)

The latest population of the funnel

descriptionstring
numSyndicationsinteger(int64)
needToRunWorkflowboolean

true if need to run workflow to load data

stagesArray of objects[ 3 .. 8 ] items

funnel stages

Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]
createdAtstring(date-time)
updatedAtstring(date-time)
createdByobject(User)
updatedByobject(User)
Response
application/json
{
  "id": "string",
  "audienceId": "string",
  "segmentFolderId": "string",
  "name": "string",
  "population": 0,
  "description": "string",
  "numSyndications": 0,
  "needToRunWorkflow": true,
  "stages": [
    { … },
    { … },
    { … }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}

Update funnel (legacy)

Request

Update a funnel.


This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative.

Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Master Segment ID

funnelIdinteger(int64)required

Funnel ID

Bodyapplication/jsonrequired

Funnel parameters to update

namestringrequired

name

descriptionstring

description

segmentFolderIdinteger(int64)required
stagesArray of objects[ 3 .. 8 ] itemsrequired

funnel stages

Example: [{"name":"Awareness"},{"id":1,"name":"Interest"},{"name":"Conversion"}]
stages[].​idinteger

null means new stage, non-null means no-op or updating existing stage name or updating stage orders

stages[].​namestringrequired
curl -i -X PUT \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/funnels/{funnelId}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "segmentFolderId": 0,
    "stages": [
      {
        "name": "Awareness"
      },
      {
        "id": 1,
        "name": "Interest"
      },
      {
        "name": "Conversion"
      }
    ]
  }'

Responses

Succeeded to update funnel

Bodyapplication/json
idstring(integer)
audienceIdstring(integer)
segmentFolderIdstring(integer)
namestring
populationinteger or null(int64)

The latest population of the funnel

descriptionstring
numSyndicationsinteger(int64)
needToRunWorkflowboolean

true if need to run workflow to load data

stagesArray of objects[ 3 .. 8 ] items

funnel stages

Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]
createdAtstring(date-time)
updatedAtstring(date-time)
createdByobject(User)
updatedByobject(User)
Response
application/json
{
  "id": "string",
  "audienceId": "string",
  "segmentFolderId": "string",
  "name": "string",
  "population": 0,
  "description": "string",
  "numSyndications": 0,
  "needToRunWorkflow": true,
  "stages": [
    { … },
    { … },
    { … }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}

Delete funnel (legacy)

Request

Delete a funnel.


This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative.

Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Master Segment ID

funnelIdinteger(int64)required

Funnel ID

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

Responses

Succeeded to delete funnel

Bodyapplication/json
idstring(integer)
audienceIdstring(integer)
segmentFolderIdstring(integer)
namestring
populationinteger or null(int64)

The latest population of the funnel

descriptionstring
numSyndicationsinteger(int64)
needToRunWorkflowboolean

true if need to run workflow to load data

stagesArray of objects[ 3 .. 8 ] items

funnel stages

Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]
createdAtstring(date-time)
updatedAtstring(date-time)
createdByobject(User)
updatedByobject(User)
Response
application/json
{
  "id": "string",
  "audienceId": "string",
  "segmentFolderId": "string",
  "name": "string",
  "population": 0,
  "description": "string",
  "numSyndications": 0,
  "needToRunWorkflow": true,
  "stages": [
    { … },
    { … },
    { … }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}

Clone funnel

Request

Make a copy of a funnel.

Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Master Segment ID

funnelIdinteger(int64)required

Funnel ID to be cloned

Bodyapplication/jsonrequired

Funnel parameters to update

namestringrequired

name

descriptionstring

description

segmentFolderIdinteger(int64)required
curl -i -X POST \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/funnels/{funnelId}/clone' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "segmentFolderId": 0
  }'

Responses

Succeeded to update funnel

Bodyapplication/json
idstring(integer)
audienceIdstring(integer)
segmentFolderIdstring(integer)
namestring
populationinteger or null(int64)

The latest population of the funnel

descriptionstring
numSyndicationsinteger(int64)
needToRunWorkflowboolean

true if need to run workflow to load data

stagesArray of objects[ 3 .. 8 ] items

funnel stages

Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]
createdAtstring(date-time)
updatedAtstring(date-time)
createdByobject(User)
updatedByobject(User)
Response
application/json
{
  "id": "string",
  "audienceId": "string",
  "segmentFolderId": "string",
  "name": "string",
  "population": 0,
  "description": "string",
  "numSyndications": 0,
  "needToRunWorkflow": true,
  "stages": [
    { … },
    { … },
    { … }
  ],
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "createdBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  },
  "updatedBy": {
    "id": "string",
    "td_user_id": "string",
    "name": "string"
  }
}

Retrieve the population statistics of a funnel and its funnel stages

Request

Retrieve the population history of a funnel. The history is returned per day and those days are calculated in the timezone of the audience.

Security
TdApikeyAuth
Path
audienceIdinteger(int64)required

Audience ID of the funnel

funnelIdinteger(int64)required

ID of funnel to return

Query
fromstring(date)

from date

Example: from=2019-01-01
tostring(date)

to date (inclusive)

Example: to=2019-04-30
limitinteger(int64)

number of days to fetch funnel statistics

curl -i -X GET \
  'https://api-cdp.treasuredata.com/audiences/{audienceId}/funnels/{funnelId}/statistics?from=2019-01-01&to=2019-04-30&limit=0' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

array of tuple of statistics

Bodyapplication/json
populationinteger or null(int64)

the latest population of the funnel

Example: 1000
stagesArray of objects
Example: [{"id":44242,"history":[[1600297704,362,true],[1600383964,362,true]]},{"id":44240,"history":[[1600297667,122,true],[1600383950,122,true]]},{"id":44241,"history":[[1600297690,516,true],[1600383956,516,true]]}]
Response
application/json
{
  "population": 1000,
  "stages": [
    { … },
    { … },
    { … }
  ]
}

Create funnel

Request

Create a funnel.

Bodyapplication/vnd.treasuredata.v1+json
idstring[1-9][0-9]*
typestring
Value"funnel"
attributesobject
relationshipsobject
curl -i -X POST \
  https://api-cdp.treasuredata.com/entities/funnels \
  -H 'Content-Type: application/vnd.treasuredata.v1+json' \
  -d '{
    "id": "string",
    "type": "funnel",
    "attributes": {
      "name": "string",
      "description": "string",
      "stages": [
        {
          "id": "string",
          "segmentId": "string",
          "name": "string",
          "numSyndications": 0
        }
      ]
    },
    "relationships": {
      "parentFolder": {
        "data": {
          "id": "string",
          "type": "folder-segment"
        }
      }
    }
  }'

Responses

Created funnel

Bodyapplication/vnd.treasuredata.v1+json
dataobject(FunnelJsonApiResource)required
data.​idstring[1-9][0-9]*required
data.​typestringrequired
Value"funnel"
data.​attributesobjectrequired
data.​attributes.​audienceIdstring[1-9][0-9]*required
data.​attributes.​namestringrequired
data.​attributes.​descriptionstring or nullrequired
data.​attributes.​populationnumber or nullrequired
data.​attributes.​numSyndicationsinteger(int64)required
data.​attributes.​createdAtstring(date-time)required
data.​attributes.​updatedAtstring(date-time)required
data.​attributes.​countPopulationboolean
data.​attributes.​stagesArray of objects(FunnelStageJsonApiResource)[ 3 .. 8 ] characters
data.​relationshipsobjectrequired
data.​relationships.​parentFolderobject(RelationshipsFolderJsonApiResource)
data.​relationships.​createdByobject(RelationshipsUserJsonApiResource)
data.​relationships.​updatedByobject(RelationshipsUserJsonApiResource)
includedArray of objects(UserJsonApiResource)required
included[].​idstring[1-9][0-9]*required
included[].​typestringrequired
Value"user"
included[].​attributesobjectrequired
included[].​attributes.​tdUserIdstring[1-9][0-9]*required
included[].​attributes.​namestringrequired
Response
application/vnd.treasuredata.v1+json
{
  "data": {
    "id": "string",
    "type": "funnel",
    "attributes": { … },
    "relationships": { … }
  },
  "included": [
    { … }
  ]
}

Retrieve funnel by ID

Request

Retrieve a funnel by ID.

Path
idinteger(int64)required

Funnel ID

curl -i -X GET \
  'https://api-cdp.treasuredata.com/entities/funnels/{id}'

Responses

Returns a funnel by ID

Bodyapplication/vnd.treasuredata.v1+json
dataobject(FunnelJsonApiResource)required
data.​idstring[1-9][0-9]*required
data.​typestringrequired
Value"funnel"
data.​attributesobjectrequired
data.​attributes.​audienceIdstring[1-9][0-9]*required
data.​attributes.​namestringrequired
data.​attributes.​descriptionstring or nullrequired
data.​attributes.​populationnumber or nullrequired
data.​attributes.​numSyndicationsinteger(int64)required
data.​attributes.​createdAtstring(date-time)required
data.​attributes.​updatedAtstring(date-time)required
data.​attributes.​countPopulationboolean
data.​attributes.​stagesArray of objects(FunnelStageJsonApiResource)[ 3 .. 8 ] characters
data.​relationshipsobjectrequired
data.​relationships.​parentFolderobject(RelationshipsFolderJsonApiResource)
data.​relationships.​createdByobject(RelationshipsUserJsonApiResource)
data.​relationships.​updatedByobject(RelationshipsUserJsonApiResource)
includedArray of objects(UserJsonApiResource)required
included[].​idstring[1-9][0-9]*required
included[].​typestringrequired
Value"user"
included[].​attributesobjectrequired
included[].​attributes.​tdUserIdstring[1-9][0-9]*required
included[].​attributes.​namestringrequired
Response
application/vnd.treasuredata.v1+json
{
  "data": {
    "id": "string",
    "type": "funnel",
    "attributes": { … },
    "relationships": { … }
  },
  "included": [
    { … }
  ]
}

Update funnel

Request

Update a funnel.

Path
idinteger(int64)required

Funnel to update

Bodyapplication/vnd.treasuredata.v1+json
idstring[1-9][0-9]*
typestring
Value"funnel"
attributesobject
relationshipsobject
curl -i -X PATCH \
  'https://api-cdp.treasuredata.com/entities/funnels/{id}' \
  -H 'Content-Type: application/vnd.treasuredata.v1+json' \
  -d '{
    "id": "string",
    "type": "funnel",
    "attributes": {
      "name": "string",
      "description": "string",
      "stages": [
        {
          "id": "string",
          "segmentId": "string",
          "name": "string",
          "numSyndications": 0
        }
      ]
    },
    "relationships": {
      "parentFolder": {
        "data": {
          "id": "string",
          "type": "folder-segment"
        }
      }
    }
  }'

Responses

Updated funnel

Bodyapplication/vnd.treasuredata.v1+json
dataobject(FunnelJsonApiResource)required
data.​idstring[1-9][0-9]*required
data.​typestringrequired
Value"funnel"
data.​attributesobjectrequired
data.​attributes.​audienceIdstring[1-9][0-9]*required
data.​attributes.​namestringrequired
data.​attributes.​descriptionstring or nullrequired
data.​attributes.​populationnumber or nullrequired
data.​attributes.​numSyndicationsinteger(int64)required
data.​attributes.​createdAtstring(date-time)required
data.​attributes.​updatedAtstring(date-time)required
data.​attributes.​countPopulationboolean
data.​attributes.​stagesArray of objects(FunnelStageJsonApiResource)[ 3 .. 8 ] characters
data.​relationshipsobjectrequired
data.​relationships.​parentFolderobject(RelationshipsFolderJsonApiResource)
data.​relationships.​createdByobject(RelationshipsUserJsonApiResource)
data.​relationships.​updatedByobject(RelationshipsUserJsonApiResource)
includedArray of objects(UserJsonApiResource)required
included[].​idstring[1-9][0-9]*required
included[].​typestringrequired
Value"user"
included[].​attributesobjectrequired
included[].​attributes.​tdUserIdstring[1-9][0-9]*required
included[].​attributes.​namestringrequired
Response
application/vnd.treasuredata.v1+json
{
  "data": {
    "id": "string",
    "type": "funnel",
    "attributes": { … },
    "relationships": { … }
  },
  "included": [
    { … }
  ]
}

Delete funnel

Request

Delete a funnel.

Path
idinteger(int64)required

Delete a funnel

curl -i -X DELETE \
  'https://api-cdp.treasuredata.com/entities/funnels/{id}'

Responses

Deleted funnel

Bodyapplication/vnd.treasuredata.v1+json
dataobject(FunnelJsonApiResource)required
data.​idstring[1-9][0-9]*required
data.​typestringrequired
Value"funnel"
data.​attributesobjectrequired
data.​attributes.​audienceIdstring[1-9][0-9]*required
data.​attributes.​namestringrequired
data.​attributes.​descriptionstring or nullrequired
data.​attributes.​populationnumber or nullrequired
data.​attributes.​numSyndicationsinteger(int64)required
data.​attributes.​createdAtstring(date-time)required
data.​attributes.​updatedAtstring(date-time)required
data.​attributes.​countPopulationboolean
data.​attributes.​stagesArray of objects(FunnelStageJsonApiResource)[ 3 .. 8 ] characters
data.​relationshipsobjectrequired
data.​relationships.​parentFolderobject(RelationshipsFolderJsonApiResource)
data.​relationships.​createdByobject(RelationshipsUserJsonApiResource)
data.​relationships.​updatedByobject(RelationshipsUserJsonApiResource)
includedArray of objects(UserJsonApiResource)required
included[].​idstring[1-9][0-9]*required
included[].​typestringrequired
Value"user"
included[].​attributesobjectrequired
included[].​attributes.​tdUserIdstring[1-9][0-9]*required
included[].​attributes.​namestringrequired
Response
application/vnd.treasuredata.v1+json
{
  "data": {
    "id": "string",
    "type": "funnel",
    "attributes": { … },
    "relationships": { … }
  },
  "included": [
    { … }
  ]
}

Retrieve population statistics of funnel stage

Request

Retrieve the population history of the audience. The history is returned per day and those days are calculated in the timezone of the audience.

Path
idinteger(int64)required

Funnel Stage ID to get statistics

Example: 1234
funnelIdinteger(int64)required

Funnel ID to get statistics

Example: 1234
Query
fromstring(date)

from date

Example: from=2019-01-01
tostring(date)

to date (inclusive)

Example: to=2019-04-30
curl -i -X GET \
  'https://api-cdp.treasuredata.com/entities/funnels/1234/stages/1234/statistics?from=2019-01-01&to=2019-04-30'

Responses

array of tuple of statistics

Bodyapplication/jsonArray [Array [
One of:
integer(int64)
]]
Response
application/json
[
  [
    1556382847,
    1234,
    true
  ]
]

Retrieve list of funnel by parent segment

Request

Retrieve a list of funnels based on a parent segment.

Path
parentSegmentIdinteger(int64)required

Parent Segment ID (audience id)

curl -i -X GET \
  'https://api-cdp.treasuredata.com/entities/parent_segments/{parentSegmentId}/funnels'

Responses

Returns a list of Funnels.

Bodyapplication/vnd.treasuredata.v1+json
dataArray of objects(FunnelJsonApiResource)required
data[].​idstring[1-9][0-9]*required
data[].​typestringrequired
Value"funnel"
data[].​attributesobjectrequired
data[].​attributes.​audienceIdstring[1-9][0-9]*required
data[].​attributes.​namestringrequired
data[].​attributes.​descriptionstring or nullrequired
data[].​attributes.​populationnumber or nullrequired
data[].​attributes.​numSyndicationsinteger(int64)required
data[].​attributes.​createdAtstring(date-time)required
data[].​attributes.​updatedAtstring(date-time)required
data[].​attributes.​countPopulationboolean
data[].​attributes.​stagesArray of objects(FunnelStageJsonApiResource)[ 3 .. 8 ] characters
data[].​relationshipsobjectrequired
data[].​relationships.​parentFolderobject(RelationshipsFolderJsonApiResource)
data[].​relationships.​createdByobject(RelationshipsUserJsonApiResource)
data[].​relationships.​updatedByobject(RelationshipsUserJsonApiResource)
includedArray of objects(UserJsonApiResource)required
included[].​idstring[1-9][0-9]*required
included[].​typestringrequired
Value"user"
included[].​attributesobjectrequired
included[].​attributes.​tdUserIdstring[1-9][0-9]*required
included[].​attributes.​namestringrequired
Response
application/vnd.treasuredata.v1+json
{
  "data": [
    { … }
  ],
  "included": [
    { … }
  ]
}

Predictive Segments

Using Treasure Data’s predictive scoring model, based on predictive segments, marketers can predict profile behavior such as who is likely to churn, purchase, click, or convert in the near future.

A predictive model is a set of rules that makes it possible to predict an unmeasured value from other, known values. The form of the rules is suggested by reviewing the data collected. Training is then used to make some predictions. Predictive modeling uses statistics to predict outcomes.

Predictive modeling is a typically used statistical technique to predict future behavior. Predictive modeling solutions analyze historical and current data and the generated model helps predict future outcomes. In predictive modeling, data is collected, a statistical model is formulated, predictions are made, and the model is validated (or revised) as additional data becomes available. For example, risk models can be created to combine member information in complex ways with demographic and lifestyle information from external sources to improve underwriting accuracy. Predictive models analyze past performance to assess how likely a customer is to exhibit a specific behavior in the future. This category also encompasses models that seek out subtle data patterns to answer questions about customer performance, such as fraud detection models. Predictive models often perform calculations during live transactions—for example, to evaluate the risk or opportunity of a given customer or transaction to guide a decision.

Treasure Data’s predictive scoring model uses predictive segments to customize predictive scoring models for a particular segment.

Operations

Journeys

In Audience Studio, a journey represents 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.

Journeys is a premium feature. Contact your Customer Success Representative for more information.

Operations

Activation Templates

Marketers find creating an activation challenging because they have to enter technical information they might not understand, which can lead to activations failing due to misconfigurations. Treasure Data solves this problem with the Activation Template. The Activation Template allows data engineers to create templates with pre-populated fields so that the marketer can confidently create an activation.

Operations