Programmatic Advertising & Real-Time Bidding

// RTB Bid Request Enrichment Service
class BidEnrichmentService {
    constructor(urlDatabase) {
        this.db = urlDatabase;
        this.cache = new LRUCache({ maxSize: 100000, ttl: 3600000 });
    }

    async enrichBidRequest(openRtbRequest) {
        const domain = this.extractDomain(openRtbRequest.site?.page);

        // Sub-millisecond lookup from pre-loaded database
        const domainData = await this.getDomainIntelligence(domain);

        if (!domainData) return openRtbRequest;

        // Enrich site object with IAB categories
        openRtbRequest.site.cat = domainData.iab_v3_categories;
        openRtbRequest.site.sectioncat = domainData.iab_v3_tier2;
        openRtbRequest.site.pagecat = domainData.iab_v3_tier3;

        // Add content taxonomy for OpenRTB 2.6+
        openRtbRequest.site.content = {
            cattax: 7, // IAB Content Taxonomy 3.0
            cat: domainData.iab_v3_categories
        };

        // Inject first-party data segment with personas
        openRtbRequest.user = openRtbRequest.user || {};
        openRtbRequest.user.data = openRtbRequest.user.data || [];
        openRtbRequest.user.data.push({
            id: "urlcatdb",
            name: "URL Categorization Database",
            segment: domainData.personas.map(p => ({
                id: p.id,
                name: p.name,
                value: p.confidence.toString()
            }))
        });

        // Add domain quality signals via ext
        openRtbRequest.site.ext = {
            ...openRtbRequest.site.ext,
            domain_quality: {
                popularity_rank: domainData.popularity_rank,
                traffic_tier: domainData.traffic_tier,
                brand_safety_score: domainData.brand_safety_score
            }
        };

        return openRtbRequest;
    }

    calculateBidMultiplier(domainData, campaignTargeting) {
        let multiplier = 1.0;

        // Boost for category alignment
        const categoryMatch = campaignTargeting.targetCategories
            .some(tc => domainData.iab_v3_categories.includes(tc));
        if (categoryMatch) multiplier *= 1.5;

        // Boost for premium inventory tiers
        if (domainData.traffic_tier === "premium") multiplier *= 1.3;

        // Reduction for sensitive categories
        if (domainData.has_sensitive_content) multiplier *= 0.5;

        return multiplier;
    }
}

// Supply Path Optimization Implementation
class SupplyPathOptimizer {
    constructor(urlDatabase, spoConfig) {
        this.db = urlDatabase;
        this.config = spoConfig;
        this.pathScores = new Map();
    }

    async evaluateSupplyPath(bidRequest) {
        const domain = bidRequest.site?.domain;
        const sellerId = bidRequest.source?.schain?.nodes?.[0]?.sid;

        // Get domain category and quality data
        const domainData = await this.db.lookup(domain);

        const pathKey = `${domain}:${sellerId}`;
        const historicalData = this.pathScores.get(pathKey) || { wins: 0, spend: 0 };

        return {
            domain: domain,
            category: domainData?.iab_v3_categories?.[0],
            quality_tier: domainData?.traffic_tier,
            path_efficiency: this.calculatePathEfficiency(historicalData),
            recommended_action: this.getRecommendation(domainData, historicalData),
            duplicate_path_risk: this.assessDuplicatePath(bidRequest)
        };
    }

    getRecommendation(domainData, historicalData) {
        if (!domainData) return "SKIP"; // Unknown inventory
        if (domainData.traffic_tier === "premium" && historicalData.efficiency > 0.7) {
            return "PREFERRED_PATH";
        }
        if (historicalData.efficiency < 0.3) return "DEPRIORITIZE";
        return "STANDARD";
    }
}