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"
}
]
}