Apply profile templates
This guide explains how to quickly set up or update a target group's profile using Cint's pre-defined global templates, such as census representative templates, or your own custom-saved templates.
Global templates simplify the process of defining complex target audiences. Instead of manually specifying every demographic, behavioral, and quota parameter each time you create or update a target group, you can apply a pre-configured profile. This saves time, reduces errors, and ensures consistency across your projects.
Step 1: Identify the desired template
Determine which template you want to use. Cint offers various global templates (e.g., census representative templates for specific countries like the US), and you can also create and use your own custom templates for frequently used audiences.
Use the list profile templates endpoint to retrieve a list of available templates. The name will give you a general idea of what the template may be useful for.
Example cURL request to list global templates in U.S. English:
curl -X GET https://api.cint.com/v1/demand/accounts/{account_id}/profiling-templates?scope=global&locales=eng_us \
-H "Authorization: Bearer <YOUR_JWT_TOKEN>" \
-H "Content-Type: application/json"
Make sure to specify the locale of your target group, in order to get valid templates.
A successful response returns a 200 status code and a list of available templates.
{
"templates": [
{
"id": "639d12e7-ae66-4f16-a84e-b7447bd603a5",
"name": "census-representation",
"description": "Source: United States Census Bureau (2020)",
"label": "Census Representation",
"locales": [
"eng_us",
"spa_us"
],
"scope": "global"
} ,
{
"id": "43b73a4a-61bf-4d34-9afb-7ed436c934ce",
"name": "it-decision-maker",
"description": "Source: Cint Customer Development team.",
"label": "IT Decision Maker",
"locales": [
"chi_cn",
"eng_au",
"eng_ca",
"eng_gb",
"eng_in",
"eng_us",
"fre_ca",
"fre_fr",
"ger_de",
"ita_it",
"spa_es"
],
"scope": "global"
}
]
}
Step 2: Retrieve the template JSON
Use the get a profile template endpoint to retrieve the JSON description of a specific template and examine it.
Example cURL request to retrieve a global template for U.S. census representative sample:
curl -X GET https://api.cint.com/v1/demand/accounts/{account_id}/profiling-templates/{profile_template_id} \
-H "Authorization: Bearer <YOUR_JWT_TOKEN>" \
-H "Content-Type: application/json"
A successful response returns a 200 status code and the full profile template.
{
"id": "639d12e7-ae66-4f16-a84e-b7447bd603a5",
"name": "census-representation",
"description": "Source: United States Census Bureau (2020)",
"label": "Census Representation",
"locales": [
"eng_us",
"spa_us"
],
"profiling": {
"profile_adjustment_type": "percentage",
"profiles": [
{
"object": "regular",
"name": "age",
"description": "18 years old or older",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "range",
"text": "",
"text_translated": "",
"question_id": 42,
"min": 18,
"max": 24
}
],
"quota": {
"completes_goal_percentage": 11.9
}
},
{
"conditions": [
{
"object": "range",
"text": "",
"text_translated": "",
"question_id": 42,
"min": 25,
"max": 34
}
],
"quota": {
"completes_goal_percentage": 17.85
}
},
{
"conditions": [
{
"object": "range",
"text": "",
"text_translated": "",
"question_id": 42,
"min": 35,
"max": 44
}
],
"quota": {
"completes_goal_percentage": 16.42
}
},
{
"conditions": [
{
"object": "range",
"text": "",
"text_translated": "",
"question_id": 42,
"min": 45,
"max": 54
}
],
"quota": {
"completes_goal_percentage": 16.01
}
},
{
"conditions": [
{
"object": "range",
"text": "",
"text_translated": "",
"question_id": 42,
"min": 55,
"max": 64
}
],
"quota": {
"completes_goal_percentage": 16.64
}
},
{
"conditions": [
{
"object": "range",
"text": "",
"text_translated": "",
"question_id": 42,
"min": 65,
"max": 99
}
],
"quota": {
"completes_goal_percentage": 21.18
}
}
]
},
{
"object": "regular",
"name": "gender",
"description": "All genders",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 43,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 49.23
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 43,
"option": "2"
}
],
"quota": {
"completes_goal_percentage": 50.77
}
}
]
},
{
"object": "regular",
"name": "hispanic",
"description": "Hispanic and non-hispanic",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 47,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 81.27
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 47,
"option": "2"
}
],
"quota": {
"completes_goal_percentage": 18.73
}
}
]
},
{
"object": "regular",
"name": "ethnicity",
"description": "All ethnicities",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 113,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 61.63
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 113,
"option": "2"
}
],
"quota": {
"completes_goal_percentage": 12.4
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 113,
"option": "3"
}
],
"quota": {
"completes_goal_percentage": 25.97
}
}
]
},
{
"object": "regular",
"name": "region",
"description": "All regions",
"quotas_enabled": true,
"targets": [
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 122,
"option": "1"
}
],
"quota": {
"completes_goal_percentage": 17.06
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 122,
"option": "2"
}
],
"quota": {
"completes_goal_percentage": 20.82
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 122,
"option": "3"
}
],
"quota": {
"completes_goal_percentage": 38.25
}
},
{
"conditions": [
{
"object": "selection",
"text": "",
"text_translated": "",
"question_id": 122,
"option": "4"
}
],
"quota": {
"completes_goal_percentage": 23.87
}
}
]
}
]
}
}
Step 3: Integrate the template's JSON into your target group configuration
The profiling JSON object from the template that you retrieve may be inserted into your target group configuration as-is, or you may modify it to better suit your needs.
All templates have profile_adjustment_type set to percentage and quotas defined with percentage quotas.
- You should review the quotas and update if desired.
- You can convert the quotas to
nominalif you want to specify a specific number of respondents for each segment. - You can add additional profiles to the target group to build more complex sample configuration if desired.
Step 4: Submit your target group
Finally, use the complete target group JSON (including the applied template profile JSON) to create or update a target group.
- If you are creating a new draft or updating an existing draft target group (prior to launch):
- If you are updating an existing target group (after launch):