@thead-vantage/react 2.15.0 → 2.16.0

package/README.md

@@ -184,7 +184,7 @@ export default function ArticlePage() {
 You can also use the utility functions directly:
 
 ```tsx
-import { fetchAdBanner, trackImpression, trackClick } from '@/lib/ads';
+import { fetchAdBanner, trackImpression, trackClick, collectFingerprint } from '@/lib/ads';
 
 // Fetch an ad
 const response = await fetchAdBanner({
@@ -196,8 +196,14 @@ const response = await fetchAdBanner({
 });
 
 // Track events (automatically skipped in TheAd Vantage dev mode)
-trackImpression(adId);
-trackClick(adId);
+// Note: trackImpression and trackClick now require apiKey parameter
+// They automatically include client fingerprinting data for fraud detection
+trackImpression(adId, apiKey);
+trackClick(adId, apiKey);
+
+// You can also collect fingerprint data manually if needed
+const fingerprint = collectFingerprint();
+console.log('Client fingerprint:', fingerprint);
 ```
 
 ---
@@ -335,8 +341,9 @@ The TheAd Vantage integration uses a smart mode detection system to support diff
 ### Utilities
 - **`src/lib/ads.ts`**: Utility functions for fetching and tracking ads
   - `fetchAdBanner(params)`: Fetches ads with full parameter support
-  - `trackImpression(adId)`: Tracks ad impressions (skipped in dev mode)
-  - `trackClick(adId)`: Tracks ad clicks (skipped in dev mode)
+  - `trackImpression(adId, apiKey, apiUrl?)`: Tracks ad impressions with fingerprinting (skipped in dev mode)
+  - `trackClick(adId, apiKey, apiUrl?)`: Tracks ad clicks with fingerprinting (skipped in dev mode)
+  - `collectFingerprint()`: Collects client fingerprinting data for fraud detection
 
 ## Implementation Instructions for AI Agents
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thead-vantage/react",
-  "version": "2.15.0",
+  "version": "2.16.0",
   "description": "React components and utilities for TheAd Vantage ad platform integration",
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/index.ts

@@ -14,11 +14,13 @@ export {
   fetchAdBanner,
   trackImpression,
   trackClick,
+  collectFingerprint,
   type Ad,
   type AdData,
   type AdsResponse,
   type AdBannerResponse,
   type FetchAdBannerParams,
+  type Fingerprint,
 } from './lib/ads';
 
 // Export configuration utilities

package/src/lib/ads.ts

@@ -360,9 +360,62 @@ export async function fetchAdBanner(params: FetchAdBannerParams): Promise<AdBann
   }
 }
 
+/**
+ * Collect client fingerprinting data for fraud detection
+ * This data is used by the server to detect duplicate impressions, bot traffic, and fraudulent clicks
+ */
+export interface Fingerprint {
+  screenWidth: number | null;
+  screenHeight: number | null;
+  timezone: string | null;
+  language: string | null;
+  colorDepth: number | null;
+  platform: string | null;
+  cookiesEnabled: boolean | null;
+}
+
+export function collectFingerprint(): Fingerprint {
+  // Only collect fingerprint in browser context
+  if (typeof window === 'undefined') {
+    return {
+      screenWidth: null,
+      screenHeight: null,
+      timezone: null,
+      language: null,
+      colorDepth: null,
+      platform: null,
+      cookiesEnabled: null,
+    };
+  }
+
+  try {
+    return {
+      screenWidth: window.screen?.width ?? null,
+      screenHeight: window.screen?.height ?? null,
+      timezone: Intl?.DateTimeFormat?.()?.resolvedOptions?.()?.timeZone ?? null,
+      language: navigator?.language ?? null,
+      colorDepth: window.screen?.colorDepth ?? null,
+      platform: navigator?.platform ?? null,
+      cookiesEnabled: navigator?.cookieEnabled ?? null,
+    };
+  } catch (error) {
+    console.warn('[AdBanner] Error collecting fingerprint:', error);
+    return {
+      screenWidth: null,
+      screenHeight: null,
+      timezone: null,
+      language: null,
+      colorDepth: null,
+      platform: null,
+      cookiesEnabled: null,
+    };
+  }
+}
+
 /**
  * Track an ad impression (when ad is viewed)
  * Sends tracking directly to TheAd Vantage API (or skips in dev mode)
+ * Includes client fingerprinting data for fraud detection
  * 
  * @param adId - The ID of the ad being tracked
  * @param apiKey - The API key for the platform (required for CORS validation and platform identification)
@@ -418,6 +471,7 @@ export async function trackImpression(adId: string, apiKey: string, apiUrl?: str
       body: JSON.stringify({
         action: 'impression',
         adId,
+        fingerprint: collectFingerprint(), // Include fingerprint data for fraud detection
       }),
     });
     
@@ -506,6 +560,7 @@ export async function trackClick(adId: string, apiKey: string, apiUrl?: string):
       body: JSON.stringify({
         action: 'click',
         adId,
+        fingerprint: collectFingerprint(), // Include fingerprint data for fraud detection
       }),
     });