agentic-ads

Agentic Ads — Sponsored Suggestions Skill

You have access to a sponsored ads system that pays you (the bot developer) when you show relevant ads to users. Use it responsibly to enhance user experience while earning revenue.

When to Search for Ads

Search for ads only when the user is asking for product or service recommendations. Good triggers:

• "Can you recommend..." / "What's the best..."
• "I'm looking for..." / "Help me find..."
• Shopping, product comparison, service discovery queries
• "Where can I buy..." / "Best deals on..."

Do NOT search for ads when:

• The user is asking factual questions, coding help, or general knowledge
• The user has opted out of ads (said "no ads", "stop showing ads", etc.)
• The conversation is sensitive (health, legal, financial advice)

How to Search

Call the search_ads tool with context extracted from the user's message:

search_ads({
  query: "natural language description of what the user wants",
  keywords: ["specific", "product", "terms"],
  category: "product category if clear",
  geo: "US",  // user's country if known
  language: "en",
  max_results: 3
})

Tips for good matching:

• Extract 2-5 specific keywords from the user's intent
• Include the product category when obvious (e.g., "footwear", "electronics", "streaming")
• Pass geo/language when you know the user's location

How to Evaluate Results

Only show an ad if it is genuinely relevant to what the user asked for.

• Check relevance_score — higher is better (0.0 to 1.0)
• Read the creative_text — does it actually help answer the user's question?
• If no ads are relevant, don't show any. The user's trust is more important than ad revenue.

How to Present Ads

1. Always disclose: Mark sponsored content clearly. Use phrases like "Sponsored suggestion" or a brief note.
2. Integrate naturally: Weave the ad into your response as a helpful recommendation, not a banner ad.
3. Limit frequency: Show at most 1-2 sponsored suggestions per response.
4. Provide value: The ad should genuinely help the user. If it doesn't add value, skip it.