Allowed Affiliate Categories
Restrict affiliate results to only the categories relevant to your product. If you run a fitness app, you might allow only Sports & Fitness and Health & Beauty — anything outside those categories gets filtered out. Not 100% perfect and decreases fill rates, but leads to a better user experience. ChatAds may auto-populate this based on your traffic patterns.Excluded Affiliate Categories
The inverse of allowed categories. All categories are included by default — use this to block specific ones you want to avoid. More permissive than defining allowed categories. Use allowed when you know exactly what fits. Use excluded when most things are fine but a few don’t belong.Skip Keywords
Keywords added here will be stripped and not used for affiliate matching. Case insensitive, up to 20 keywords, max 25 characters each. Useful when ChatAds consistently picks up low-value or irrelevant terms from your messages — for example, if your app frequently mentions a product by name that you don’t want to monetize.Hard Stop Keywords
If any of these keywords appear in a message, the request stops immediately and returns with no offer. You are not charged for blocked requests. Use this for compliance or security — block terms related to sensitive topics you never want associated with affiliate links.Brand Only Mode
When enabled, ChatAds prioritizes branded product mentions (e.g., “Lululemon yoga mat”) over generic terms (e.g., “yoga mat”). Lowers fill rates but can improve conversion rates since branded recommendations feel more specific and trustworthy. You are not charged for requests that are filtered by this setting.Country Targeting
ChatAds currently supports US affiliate partners only. You can send non-US traffic, but offers may not be relevant for those users. For identifying country, you can either:- Send a
countryparameter (e.g.,"US") to hardcode it - Send an
ipparameter and let ChatAds detect the country automatically
country and ip missing — will be matched to affiliate partners. You are not charged for non-US traffic that gets proactively blocked.
Language Targeting
ChatAds currently supports English content only. Non-English messages are auto-detected and blocked. You are not charged for non-English requests.Auto-Blocked Categories
ChatAds automatically excludes low-value, noisy categories from all results:- Apps & Games
- Books
- Collectibles
- Digital & Physical Media
- Gift Cards
- Grocery
- Scientific & Industrial
- Software
PII Scrubbing
ChatAds automatically strips personally identifiable information before analyzing text for affiliate matching. This includes content that looks like API keys, emails, SSNs, phone numbers, and credit card numbers. Always on — cannot be disabled.FAQ
How do I set up geo-targeting?
How do I set up geo-targeting?
Pass the You can also pass
country parameter with an ISO 3166-1 alpha-2 code:ip for automatic geo-detection. If you already know the user’s country, pass country directly — otherwise pass ip and ChatAds will detect it.What happens if I send non-US or non-English traffic?
What happens if I send non-US or non-English traffic?
Non-US and non-English requests are blocked and not billed. The response will show the relevant status (
country_not_allowed, ip_country_not_allowed, or language_not_allowed) with an empty offers array.What's the difference between Skip Keywords and Hard Stop Keywords?
What's the difference between Skip Keywords and Hard Stop Keywords?
Skip Keywords are stripped from the message before analysis. The request continues, but these words won’t influence ad matching. Use this for words that shouldn’t affect targeting but aren’t problematic.Hard Stop Keywords block the entire request if detected (returns early without analysis). Use this for content that should never receive affiliate links. Blocked requests are not billed.Both have limits: max 20 keywords per list, max 25 characters per keyword, alphanumeric only.
Will ChatAds expand to other countries besides US?
Will ChatAds expand to other countries besides US?
Currently, ChatAds only supports US affiliate partners. International expansion is on our roadmap.If you have specific country requirements, contact team@getchatads.com to discuss timeline and priorities.