Targeting
Target Reddit ads by location, gender, language, interest, subreddit, conversation keyword and custom audience, and search Reddit's targeting catalog.
The targeting fields go on POST /v1/ads/create, inside targeting on a boost, and in targeting on PUT /v1/ads/{adId} (Manage ads).
Targeting fields
| Field | Reddit targeting | Values from |
|---|---|---|
countries | Locations | ISO country codes. With no location at all, the ad targets US |
regions, metros, cities, zips | Locations | { "key": "..." } from targeting search, dimension=geo |
excludedLocations | Excluded locations | countries, regions, cities and zips only; other shapes return 400 |
gender | Gender | all, male or female |
languages | Languages | Language codes such as en or de |
targeting.interests | Interests | { "id": "..." } from targeting search, dimension=interest |
audienceInclude, audienceExclude | Custom audiences | Reddit custom audience ids, created in Reddit Ads Manager |
targeting.communities, targeting.excludedCommunities | Subreddits | Subreddit names, with or without r/; from targeting search, dimension=community |
targeting.conversationKeywords, targeting.excludedConversationKeywords | Conversation keywords | Free text; suggestions from targeting search, dimension=conversationKeyword |
Age, income, behaviors, radius and every other targeting field return 400 naming the field, because Reddit has no slot for them.
Custom audiences cannot be created or uploaded through Zernio: POST /v1/ads/audiences returns 422 on a redditads account. Build them in Reddit Ads Manager and target them by id.
Find targeting values
GET /v1/ads/targeting/search with the redditads accountId searches Reddit's own catalog (Search ad targeting).
It takes dimension set to geo, interest, community or conversationKeyword; any other dimension returns 400.
On geo, geoType is city (the default), zip, region, metro_area, country or all, and countryCode narrows the search to one country.
const { data: search } = await zernio.adtargeting.searchAdTargeting({
query: { accountId: '66b2e19d8c3f5a7e9d0b1c2d', q: 'gaming', dimension: 'community' }
});
const subreddits = search.results.map((result) => result.id);A community result's id is the subreddit name to send in targeting.communities, with the subscriber count in audienceSize.
Geo results carry the Reddit location id as id (send it as key), and interest results the interest id with its category in path.
Related
- Search ad targeting: locations, interests, subreddits and keywords.