System Architecture

​

Who is this guide for?

​

System overview

​

Unified Auction

​

Problems with the waterfall approach

• Sequential calls: Ad sources are called one by one in priority order
• Missed opportunities: Lower-priority sources that could bid higher miss out
• Inefficient revenue: The first ad to respond wins, not the highest bid

​

Benefits of Unified Auction

• Simultaneous competition: Direct Sales, Ad Networks, and DSPs bid at the same time
• Yield optimization: Real-time highest-bid wins raise eCPM
• Header Bidding support: Maximizes ad revenue using the industry-standard approach

​

Core components

​

A2 Manager (management console)

• Create and manage campaigns
• Configure and manage placements
• Upload and approve creatives
• Request and approve allocations
• View and analyze performance data
• Manage user accounts and permissions

​

A2 Edge (ad serving engine)

• Receive and process ad requests
• Select ads that match targeting conditions
• Run bidding logic (CPM, CPC, CPA)
• Return ad responses
• Collect impression/click events

​

A2 Datahub (data pipeline)

• Collect ad event logs (impressions, clicks, conversions)
• Collect user behavior logs (purchases, searches, cart, etc.)
• Cleanse and store data
• Prepare data for analysis
• Detect and filter click fraud

​

Data flow

​

Ad serving flow

1. A user visits the retailer’s service.
2. The SDK or API installed on the page requests an ad from Edge.
3. Edge selects the best ad based on placement information, user information, and active campaigns.
4. Edge returns the selected ad information (image URL, click URL, etc.).
5. The ad is displayed on the user’s screen.
6. The impression event is sent to Datahub and recorded.

​

Configuration data flow

1. Admins, retailers, and advertisers configure campaigns, placements, and allocations in Admin.
2. The configured data is saved to the database.
3. Edge servers sync the latest settings.
4. Ad serving starts with the new settings applied.

​

Integration methods

<!-- Placement tag example -->
<div id="a2-placement"></div>
<script src="https://{customer_id}.a2cloud.aiderx.app/a2-sdk.js"></script>
<script>
  let app = new A2_SDK.A2({
    base_url: "https://{customer_id}.a2cloud.aiderx.app"
  });
  let placement = document.getElementById("a2-placement");
  app.register_ad("your-tagid", placement, 300, 250, "fixed");
</script>

# Ad request example
curl -X POST https://{customer_id}.a2cloud.aiderx.app/app/v0/ad/{tagid} \
  -H "Content-Type: application/json" \
  -d '{"version": "0.1.0", "user": {"id": "user-123"}}'

​

Performance metrics