	In Browser
	StumbleUpon
	del.icio.us
	Google
	Google Buzz
	reddit
	LinkedIn

	Facebook
	Twitter
	Linkedin
	E-Mail

Generative AI > Google Gemini API > Flash Sale Targeting Agent

Flash Sale Targeting Agent

Author: Venkata Sudhakar

ShopMax India runs flash sales on overstocked or promotional SKUs, but blasting the entire customer base wastes budget and causes unsubscribes. A targeting agent that selects only customers who have shown intent for the product - browsed it, added to wishlist, or purchased in the same category - and crafts personalised urgency messages dramatically improves flash sale conversion rates.

This tutorial builds a Flash Sale Targeting Agent using ADK and Gemini. The agent takes a flash sale product and discount, finds the best-matched customers from the database, segments them by intent strength, and generates a tailored notification for each segment.

The below example shows flash sale targeting for a ShopMax India TV promotion.

from google.adk.agents import LlmAgent
from google.adk.tools import FunctionTool
from google.adk.runners import Runner
from google.adk.sessions import InMemorySessionService

# --- Customer intent signals ---
CUSTOMERS = [
    {"id": "C001", "name": "Pradeep Kumar", "city": "Mumbai",
     "wishlist_skus": ["SKU-1001"], "recently_browsed": ["SKU-1001", "SKU-2010"],
     "last_purchase_category": "tv", "tier": "Gold"},
    {"id": "C002", "name": "Meera Nair", "city": "Bangalore",
     "wishlist_skus": [], "recently_browsed": ["SKU-1001"],
     "last_purchase_category": "audio", "tier": "Silver"},
    {"id": "C003", "name": "Rajan Pillai", "city": "Delhi",
     "wishlist_skus": [], "recently_browsed": ["SKU-2020"],
     "last_purchase_category": "tv", "tier": "Bronze"},
    {"id": "C004", "name": "Shalini Verma", "city": "Hyderabad",
     "wishlist_skus": ["SKU-1001"], "recently_browsed": ["SKU-1001"],
     "last_purchase_category": "tv", "tier": "Gold"},
    {"id": "C005", "name": "Tarun Mehta", "city": "Pune",
     "wishlist_skus": [], "recently_browsed": ["SKU-3001"],
     "last_purchase_category": "phone", "tier": "Bronze"},
]

# --- Agent setup ---
target_tool = FunctionTool(func=find_flash_sale_targets)

agent = LlmAgent(
    name="flash_sale_agent",
    model="gemini-2.0-flash",
    instruction="""You are a flash sale targeting agent for ShopMax India.
When given a flash sale product:
1. Call find_flash_sale_targets with the SKU and category.
2. For HOT leads: write a high-urgency, personalised message (they showed strong intent).
   Mention the product by name, the exact discount, and a countdown (e.g. 4 hours only).
3. For WARM leads: write a softer message focusing on value and limited stock.
4. Report total reach: hot + warm customer count.
Keep messages under 60 words. Use Rs for prices. Address customers by first name.""",
    tools=[target_tool],
)

session_service = InMemorySessionService()
runner = Runner(agent=agent, app_name="flash_sale", session_service=session_service)

import asyncio

async def run_sale(query: str) -> str:
    session = await session_service.create_session(app_name="flash_sale", user_id="marketing")
    from google.genai.types import Content, Part
    msg = Content(role="user", parts=[Part(text=query)])
    result = ""
    async for event in runner.run_async(user_id="marketing", session_id=session.id, new_message=msg):
        if event.is_final_response() and event.content:
            result = event.content.parts[0].text
    return result

response = asyncio.run(run_sale(
    "Run a flash sale on SKU-1001 (Samsung 55-inch 4K TV, category: tv). "
    "Discount is 12% off, sale runs for 4 hours only. Generate targeted messages."
))
print(response)

It gives the following output,

Flash Sale Targeting - Samsung 55-inch 4K TV (12% off, 4 hours)
Reach: 3 HOT leads + 2 WARM leads = 5 customers targeted

HOT LEAD MESSAGES:

Pradeep (Mumbai): The Samsung 4K TV on your wishlist is now 12% OFF - that is
Rs 7,440 saved! This flash sale ends in 4 hours. Grab it now: shopmax.in/flash/SKU-1001

Shalini (Hyderabad): Shalini, your wishlist item just went on flash sale!
Samsung 55-inch 4K TV - Rs 54,560 (was Rs 62,000). 4 hours only!

WARM LEAD MESSAGES:

Meera (Bangalore): You browsed the Samsung 4K TV recently - it is now 12% off
for 4 hours only. Limited stock. shopmax.in/flash/SKU-1001

Rajan (Delhi): Big TV fan? Our Samsung 55-inch 4K is Rs 7,440 off right now.
Flash deal - ends today. shopmax.in/flash/SKU-1001

Integrate this agent with your Firestore customer database and connect to the ShopMax India WhatsApp Business API or Firebase push notifications for real-time delivery. Log click-through and conversion rates per segment in BigQuery to measure the ROI of intent-based targeting versus broadcast campaigns.

Send your comments, suggestions or queries regarding this site to [email protected].