Audience Profile¶
This article describes resources and services you can use to view audience profiles for the past 30 days.
Overview¶
Use audience profile to quickly understand demographic information including audience size, demographics, locations, and devices for custom audiences. The Yahoo DSP automatically generates audience insights for the custom audiences you build.
Note
For privacy purposes, Yahoo DSP only generates audience insights for audiences with more than 1,000 users. Additionally, Yahoo DSP requires two days to gather enough history for the audience insights to be accurate.
You can view audience profiles through the following criteria.
Criteria |
Description |
---|---|
|
Total audience reach for each day in the past 30 days. |
|
Audience demographic information broken down by age groups:
|
|
Audience demographic information broken down by gender:
|
|
Audience information broken down by the following device types:
|
|
Audience information broken down by locations (continents and countries). |
Endpoint¶
View an audience profile.
GET /traffic/audiences/audienceprofile?segmentId={segmentId}
Parameters¶
Parameter |
Description |
Data Type |
---|---|---|
|
Specifies the audience ID. |
|
Example Request URL¶
GET https://dspapi.admanagerplus.yahoo.com/traffic/audiences/audienceprofile?segmentId=12345
Example Response¶
{
"response": {
"audienceSize": [
{
"timestamp": "2019-10-27T00:00:00.000Z",
"count": 231411
},
{
"timestamp": "2019-10-28T00:00:00.000Z",
"count": 201326
}
],
"age": [
{
"name": "13-17",
"count": 52110,
"uniqueCount": 34502
},
{
"name": "18-24",
"count": 82111,
"uniqueCount": 42120
},
{
"name": "25-34",
"count": 91203,
"uniqueCount": 43688
},
{
"name": "35-44",
"count": 78842,
"uniqueCount": 43893
},
{
"name": "45-54",
"count": 49231,
"uniqueCount": 18396
},
{
"name": "55-64",
"count": 18424,
"uniqueCount": 8829
},
{
"name": "65Plus",
"count": 7821,
"uniqueCount": 2194
},
{
"name": "Unknown",
"count": 49281,
"uniqueCount": 22812
}
],
"device": [
{
"name": "Desktop",
"count": 53210,
"uniqueCount": 32845
},
{
"name": "Phone",
"count": 152336,
"uniqueCount": 90132
},
{
"name": "Tablet",
"count": 10321,
"uniqueCount": 8033
},
{
"name": "ConnectedTV",
"count": 1328,
"uniqueCount": 653
},
{
"name": "Other",
"count": 74231,
"uniqueCount": 44392
}
],
"gender": [
{
"name": "MALE",
"count": 321872,
"uniqueCount": 234212
},
{
"name": "FEMALE",
"count": 549910,
"uniqueCount": 411927
},
{
"name": "UNKNOWN",
"count": 3024,
"uniqueCount": 583
}
],
"location": [
{
"continent": "Asia",
"countries": [
{
"name": "Singapore",
"count": 3210,
"uniqueCount": 883
},
{
"name": "Korea",
"count": 5323,
"uniqueCount": 1737
}
]
},
{
"continent": "Africa",
"countries": [
{
"name": "Lesotho",
"count": 921,
"uniqueCount": 533
},
{
"name": "Ghana",
"count": 1212,
"uniqueCount": 835
}
]
}
]
},
"errors": null,
"timeStamp": "2019-11-23T20:08:38Z"
}