Skip to main content

Example Targeting Specs

Targeting Spec Examples for an Ad Squad

Example 1

United States, Male+Female, All Age Ranges

You can target both Male and Female by leaving out GENDER from the targeting spec.

{
"geos": [
{
"country_code": "us"
}
]
}

Example 2

United States, Male, Age Groups 21-34

{
"geos": [
{
"country_code": "us"
}
],
"demographics": [
{
"age_groups": ["21-24", "25-34"],
"gender": "MALE"
}
]
}

Example 3

Canada, Female, 13-20, iOS

{
"demographics": [
{
"min_age": 13,
"max_age": 20,
"gender": "FEMALE"
}
],
"geos": [
{
"country_code": "ca"
}
],
"devices": [
{
"os_type": "iOS"
}
]
}

Example 4

UK, Male+Female, Age 25, WIFI Only

{
"demographics": [
{
"min_age": 25,
"max_age": 25
}
],
"geos": [
{
"country_code": "uk"
}
],
"devices": [
{
"connection_type": "WIFI"
}
]
}

Example 5

United States - All States Except Arizona or Texas, M+F, All Ages

{
"geos": [
{
"country_code": "us",
"operation": "INCLUDE"
},
{
"country_code": "us",
"region_id": ["3"],
"operation": "EXCLUDE"
},
{
"country_code": "us",
"region_id": ["44"],
"operation": "EXCLUDE"
}
]
}

Example 6

United States, Female, 18-34, "Fashion & Style Gurus" OR "Film & TV Fans"

{
"demographics": [
{
"gender": "FEMALE",
"age_groups": ["18-20", "21-24", "25-34"]
}
],
"interests": [
{
"category_id": ["SLC_7", "SLC_8"]
}
],
"geos": [
{
"country_code": "us"
}
]
}

Example 7

United States, All genders/ages, "Comedy Fans"

{
"interests": [
{
"category_id": ["SLC_36"]
}
],
"geos": [
{
"country_code": "us"
}
]
}

Example 8

United States, Male, 18-20, member of Customer List segment ID "12345"

{
"demographics": [
{
"gender": "MALE",
"age_groups": ["18-20"]
}
],
"geos": [
{
"country_code": "us"
}
],
"segments": [
{
"segment_id": ["12345"]
}
]
}

Example 9

United States, Male, 18-20, NOT a member of Customer List segment ID "98765"

{
"demographics": [
{
"gender": "MALE",
"age_groups": ["18-20"]
}
],
"geos": [
{
"country_code": "us"
}
],
"segments": [
{
"segment_id": ["98765"],
"operation": "EXCLUDE"
}
]
}

Example 10

United States, AT&T

{
"geos": [
{
"country_code": "us"
}
],
"devices": [
{
"carrier_id": ["US_ATT"]
}
]
}

Example 11

United States, 21-24, (College Graduates OR Married People), Apparel Shoppers

{
"regulated_content": "false",
"demographics": [
{
"age_groups": ["21-24"],
"advanced_demographics": ["DLXD_100", "DLXD_300"]
}
],
"geos": [
{
"country_code": "us"
}
],
"interests": [
{
"category_id": ["DLXS_1"]
}
]
}

Example 12

United States, metros New York or Los Angeles only

{
"geos": [
{
"country_code": "us",
"metro_id": ["501", "803"]
}
]
}

Example 13

USA, Female, Spanish speaking, 13-17, iOS version 10.3.2

{
"demographics": [
{
"age_groups": ["13-17"],
"gender": "FEMALE",
"languages": ["es"]
}
],
"geos": [
{
"country_code": "us"
}
],
"devices": [
{
"os_type": "iOS",
"os_version_min": "9.0",
"os_version_max": "10.3.2"
}
]
}

Example 14

Zipcode Targeting

{
"geos": [
{
"country_code": "us",
"postal_code": ["90291", "90026"]
}
]
}

Example 15

Device Make: All iPhone 7 plus and iPhone 6s Plus users

{
"devices": [
{
"marketing_name": ["Apple/iPhone 7 Plus/", "Apple/iPhone 6s Plus/"]
}
]
}

Example 16

Location Categories: Targeting Sports Arenas, Fitness Centers

{
"locations": [
{
"location_type": [
"LOI_15004", // Sports Stadiums and Arenas
"LOI_15002" // Gyms and Fitness Centers
],
,
"proximity_unit": "MILES", // Proximity in miles
"proximity": 1
}
]
}

Example 17

Location Point Radius: Targeting 500 meter radius around Nordstrom locations in Seattle/Bellevue

{
"locations": [
{
"circles": [
{
"latitude": 47.612447,
"longitude": -122.336751,
"radius": 500
},
{
"latitude": 47.617102,
"longitude": -122.203961,
"radius": 50,
"unit": "KILOMETERS"
}
],
"operation": "INCLUDE"
}
]
}

Example 18

Multi-country targeting: Targeting the US and Canada

{
"geos": [
{
"country_code": "us",
"operation": "INCLUDE"
},
{
"country_code": "ca",
"operation": "INCLUDE"
}
]
}

Example 19

Snap Lifestyle Category inclusion of SLC_1, SLC_124 and exclusion of SLC_2

{
"interests": [
{
"category_id": ["SLC_1", "SLC_124"],
"operation": "INCLUDE"
},
{
"category_id": ["SLC_2"],
"operation": "EXCLUDE"
}
]
}

Example 20

App Install State targeting using a Snap App ID

{
"app_install_states": [
{
"state": "INSTALLED",
"snap_app_ids": ["85a0bfd4-2f0c-4797-bceb-b0a8375c5828"]
}
]
}

App Install State targeting is required for Ad Squads that use the optimization goal APP_REENGAGE_OPEN or APP_REENGAGE_PURCHASE.

Example 21

App Install State targeting - Prospecting Product Audience

App Install State targeting in use with Dynamic Product Ads of the type APP_INSTALL

{
"product_audiences": [
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "PAGE_VIEW",
"retention_seconds": 1209600,
"operation": "EXCLUDE"
},
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "ADD_CART",
"retention_seconds": 1209600,
"operation": "EXCLUDE"
},
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "PURCHASE",
"retention_seconds": 1209600,
"operation": "EXCLUDE"
},
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "VIEW_CONTENT",
"retention_seconds": 1209600,
"operation": "EXCLUDE"
}
],
"app_install_states": [
{
"state": "NOT_INSTALLED",
"snap_app_ids": ["2e1154ae-35fc-4b9e-8c40-4816dfb42038"]
}
]
}

Example 22

App Install State targeting - Retargeting Product Audience

App Install State targeting in use with Dynamic Product Ads of the type DEEP_LINK

{
"product_audiences": [
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "PAGE_VIEW",
"retention_seconds": 1209600,
"operation": "INCLUDE"
},
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "ADD_CART",
"retention_seconds": 1209600,
"operation": "INCLUDE"
},
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "VIEW_CONTENT",
"retention_seconds": 1209600,
"operation": "INCLUDE"
},
{
"product_set": "897cce5d-95c9-4c67-91e7-86ce8ea21f21",
"event_type": "PURCHASE",
"retention_seconds": 1209600,
"operation": "EXCLUDE"
}
],
"app_install_states": [
{
"state": "INSTALLED",
"snap_app_ids": ["85a0bfd4-2f0c-4797-bceb-b0a8375c5828"]
}
]
}

Example 23

Visitation Audience Segments: Targeting users in the US who visited an ice cream shop

In this example, we target users who have visited an ice cream shop by using the First Party Visitation Segment, "VAC_97", which contains users who have visited an ice cream shop.

{
"geos": [
{
"country_code": "us"
}
],
"interests": [
{
"category_id": ["VAC_97"],
"operation": "INCLUDE"
}
]
}

Example 24

Household income targeting: Targeting users in the US who have a household income of $200,000 or more

Here, we target users by using the advanced_demographics audience "DMG_4", which is a collection of users who have a household income of $200,000 or more.

{
"demographics": [
{
"advanced_demographics": ["DMG_4"]
}
],
"geos": [
{
"country_code": "us"
}
]
}

Example 26

Compact style targeting - UK targeting, Regional and Interest targeting

This targeting spec is defined in compact style, it uses interest targeting along with

{
"demographics": [
{
"min_age": "18",
"operation": "INCLUDE"
}
],
"interests": [
{
"category_id": [
"SLC_1",
"SLC_124",
"SLC_2",
"SLC_155",
"SLC_241",
"SLC_242",
"SLC_243"
],
"operation": "INCLUDE"
}
],
"geos": [
{
"country_code": "uk",
"region_id": ["25336", "25335", "25339", "34999", "35000"],
"operation": "INCLUDE"
}
]
}

Example 27

Compact style targeting -

This targeting spec is defined in compact style, it target age groups and US post codes

{
"demographics": [
{
"age_groups": ["18-20", "21-24", "25-34"],
"operation": "INCLUDE"
}
],
"geos": [
{
"country_code": "us",
"postal_code": ["20622", "20629", "20632", "20639", "20646", "20650"],
"operation": "INCLUDE"
}
]
}

Example 28

Compact style targeting using regions and audience segments

This targeting spec is defined in the compact style, it targets US regions and both includes and excludes audience segments

"targeting": {
"geos": [
{
"country_code": "US",
"region_id": ["5", "8","9","12","17"],
"operation": "INCLUDE"
}
],
"segments": [
{
"segment_id": [
"6152756160240352",
"6057756160240395",
"5056756160240354",
"5055756170240303",
"5052756160940351",
"5052756160223353",
"5058756190240353",
"6642356560874716",
"5029744549138135"
],
"operation": "INCLUDE"
},
{
"segment_id": [
"5893433182550125",
"5893433172550112",
"5052756160240353"
],
"operation": "EXCLUDE"
}
]
}

Example 29

Compact style targeting - UK and Ireland regional targeting

This targeting spec targets and excludes regions in UK and Ireland

{
"regulated_content": false,
"demographics": [
{
"min_age": "18",
"operation": "INCLUDE"
}
],
"geos": [
{
"country_code": "uk",
"region_id": ["25385", "25382", "25384", "25389", "25403", "25401"],
"operation": "INCLUDE"
},
{
"country_code": "ie",
"region_id": ["11820", "11843", "28393", "11825", "19982", "11821"],
"operation": "INCLUDE"
},
{
"country_code": "uk",
"region_id": ["25430", "25429", "25427", "25421"],
"operation": "EXCLUDE"
},
{
"country_code": "ie",
"region_id": ["11842", "11837", "11832"],
"operation": "EXCLUDE"
}
],
"devices": [
{
"os_type": "WEB",
"operation": "INCLUDE"
},
{
"os_type": "iOS",
"operation": "INCLUDE"
},
{
"os_type": "ANDROID",
"operation": "INCLUDE"
}
]
}
Was this page helpful?
Yes
No