Brand Safety in Digital Advertising

// Example: Brand safety pre-bid integration
class BrandSafetyFilter {
    constructor(config) {
        this.urlDb = new URLCategorization(config.apiKey);
        this.brandProfiles = config.brandProfiles;
    }

    async evaluateBidRequest(bidRequest, brandId) {
        const domain = new URL(bidRequest.site.page).hostname;
        const brandProfile = this.brandProfiles[brandId];

        // Get domain categories
        const categoryData = await this.urlDb.lookup(domain);

        // Check against brand's blocked categories
        const blockedMatch = categoryData.categories.find(
            cat => brandProfile.blockedCategories.includes(cat)
        );

        if (blockedMatch) {
            return {
                safe: false,
                reason: `Blocked category: ${blockedMatch}`,
                garmLevel: this.getGarmLevel(blockedMatch),
                action: 'NO_BID'
            };
        }

        // Check GARM risk level
        const garmRisk = this.calculateGarmRisk(categoryData.categories);
        if (garmRisk > brandProfile.maxGarmRisk) {
            return {
                safe: false,
                reason: `GARM risk level ${garmRisk} exceeds threshold`,
                garmLevel: garmRisk,
                action: 'NO_BID'
            };
        }

        // Check brand suitability (beyond safety)
        const suitabilityScore = this.calculateSuitability(
            categoryData.categories,
            brandProfile.preferredCategories
        );

        return {
            safe: true,
            garmLevel: garmRisk,
            suitabilityScore: suitabilityScore,
            action: 'BID',
            bidModifier: this.getBidModifier(suitabilityScore)
        };
    }

    calculateGarmRisk(categories) {
        const garmMapping = {
            'adult': 'high',
            'violence': 'high',
            'hate-speech': 'high',
            'terrorism': 'high',
            'drugs': 'high',
            'gambling': 'medium',
            'alcohol': 'medium',
            'controversial-news': 'medium',
            'politics': 'low'
        };

        let maxRisk = 'none';
        for (const cat of categories) {
            if (garmMapping[cat] === 'high') return 'high';
            if (garmMapping[cat] === 'medium') maxRisk = 'medium';
            if (garmMapping[cat] === 'low' && maxRisk === 'none') maxRisk = 'low';
        }
        return maxRisk;
    }
}

// Example brand profile configuration
const familyBrandProfile = {
    blockedCategories: [
        'adult', 'violence', 'gambling', 'alcohol',
        'drugs', 'hate-speech', 'weapons'
    ],
    preferredCategories: ['family', 'education', 'entertainment', 'lifestyle'],
    maxGarmRisk: 'low'
};