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