Target Account List Examples¶
Examples on this page:
List all Target Account Lists¶
GET /audience/v1/target_accounts
Request:
curl -H 'Authorization: Token YOUR_TOKEN' \
"https://services.adroll.com/audience/v1/target_accounts?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"
Response:
{
"results": [
{
"advertisable_eid": "MY_ADVERTISABLE_EID",
"eid": "TARGET_ACCOUNT_LIST_EID",
"items_count": 10000,
"name": "Top 10K",
"scoring_at": "2019-07-01T16:34:27.448382+00:00",
"scoring_auc": 0.99100798368454,
"scoring_by_user_eid": "USER_EID",
"scoring_filename": "top-1k-domains.csv",
"scoring_grades": {
"A": {
"threshold": 30,
"items_count": 468,
"min_item": {
"domain": "theglobeandmail.com",
"score": 0.999897
}
},
"C": {
"threshold": 85,
"items_count": 365,
"min_item": {
"domain": "reshet.tv",
"score": 0.939022
}
},
"B": {
"threshold": 80,
"items_count": 2057,
"min_item": {
"domain": "makeagif.com",
"score": 0.973098
}
},
"D": {
"threshold": 95,
"items_count": 2696,
"min_item": {
"domain": "profiles.google.com",
"score": 0.029493
}
},
"F": {
"threshold": 100,
"items_count": 2562,
"min_item": null
},
"unscored_count": 1852,
"scored_count": 8148
},
"scoring_holdout1_model_id": null,
"scoring_holdout1_retries": 0,
"scoring_holdout1_status": null,
"scoring_holdout2_model_id": null,
"scoring_holdout2_retries": 0,
"scoring_holdout2_status": null,
"scoring_holdout3_model_id": null,
"scoring_holdout3_retries": 0,
"scoring_holdout3_status": null,
"scoring_holdout4_model_id": null,
"scoring_holdout4_retries": 0,
"scoring_holdout4_status": null,
"scoring_holdout5_model_id": null,
"scoring_holdout5_retries": 0,
"scoring_holdout5_status": null,
"scoring_items_count": 862,
"scoring_items_pending": true,
"scoring_model_id": "f3f3e5cd-d606-4033-93cd-10c1af2cc232",
"scoring_production_model_id": null,
"scoring_production_retries": 0,
"scoring_production_status": null,
"scoring_status": "complete",
"sfdc_company_list_name": null,
"sfdc_company_list_object_id": null,
"sfdc_create_accounts": false,
"sfdc_initial_pull_pending": null,
"sfdc_scoring_company_list_name": null,
"sfdc_scoring_company_list_object_id": null,
"sfdc_sync_state": "none",
"sfdc_synced_at": null,
"sfdc_train_pending": null,
"suggestions_count": 2955,
"tiers": [
{
"eid": "all",
"items_count": 10000,
"tal_eid": "TARGET_ACCOUNT_LIST_EID"
},
{
"items_count": 9998,
"eid": "untiered",
"name": null,
"tal_eid": "TARGET_ACCOUNT_LIST_EID"
},
{
"items_count": 2,
"eid": "TARGET_ACCOUNT_GROUP_EID",
"name": "UCLA",
"tal_eid": "TARGET_ACCOUNT_LIST_EID"
}
],
"updated_at": "2019-09-16T13:28:43.678412+00:00",
"updated_by_user_eid": null
}
]
}
List all accounts in a Target Account List¶
GET /audience/v1/target_accounts
Request:
curl -H 'Authorization: Token YOUR_TOKEN' \
"https://services.adroll.com/audience/v1/target_accounts/TARGET_ACCOUNT_LIST_EID/tiers/all/items?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"
Response:
{
"total_items": 10000,
"results": [
{
"domain": "000webhost.com",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.99998,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "007.com",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.146781,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "013.nl",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.012467,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "01.ibm.com",
"updated_at": "2019-07-01T16:57:59.552388+00:00",
"source": "user_uploaded",
"score": null,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "01net.com",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.999756,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "03.ibm.com",
"updated_at": "2019-07-01T16:57:59.552388+00:00",
"source": "user_uploaded",
"score": null,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "0.gravatar.com",
"updated_at": "2019-07-01T16:57:59.552388+00:00",
"source": "user_uploaded",
"score": null,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "1001fonts.com",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.682038,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "1001tracklists.com",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.869826,
"sfdc_account_id": null,
"sfdc_synced_at": null
},
{
"domain": "101wkqx.com",
"updated_at": "2019-07-01T16:58:26.701943+00:00",
"source": "user_uploaded",
"score": 0.006115,
"sfdc_account_id": null,
"sfdc_synced_at": null
}
]
}
Add new accounts to a Target Account List¶
POST /audience/v1/target_accounts/(tal_eid)/tiers/(ta_tier_eid)/items
Request:
curl -X POST -H 'Authorization: Token YOUR_TOKEN' \
-H "Content-Type: application/json" \
-d '{"items":[{"domain":"new_domain.com"}]}' \
"https://services.adroll.com/audience/v1/target_accounts/TARGET_ACCOUNT_LIST_EID/tiers/all/items?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"
Response:
{
"existing_domains": [],
"new_domains": [
"new_domain.com"
]
}
Remove accounts from a Target Account List¶
DELETE /audience/v1/target_accounts/(tal_eid)/tiers/(ta_tier_eid)/items
Request:
curl -X DELETE -H 'Authorization: Token YOUR_TOKEN' \
-H "Content-Type: application/json" \
-d '{"domains":["new_domain.com"]}' \
"https://services.adroll.com/audience/v1/target_accounts/TARGET_ACCOUNT_LIST_EID/tiers/all/items?apikey=MYAPIKEY&advertisable=MY_ADVERTISABLE_EID"
Response:
The response is going to be empty with HTTP status code 204 (NO CONTENT)