Skip to content

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.

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/json
Array [
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": "" }, { "id": "3", "name": "Conversion", "numSyndications": 0, "audienceId": "1", "funnelId": "10", "segmentFolderId": "30", "segmentId": "" } ]
createdAtstring, (date-time)
updatedAtstring, (date-time)
createdByobject(User)
updatedByobject(User)
]
Response
[ { "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": {} } ]