@thead-vantage/react 2.17.0 → 2.18.0

package/package.json

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

package/src/components/AdBanner.tsx

@@ -12,6 +12,8 @@ export interface AdBannerProps {
   userId?: string | null;
   userSegment?: string | null;
   className?: string;
+  clickMetadata?: Record<string, unknown>; // Optional metadata to send with click events
+  impressionMetadata?: Record<string, unknown>; // Optional metadata to send with impression events
 }
 
 export function AdBanner({
@@ -22,6 +24,8 @@ export function AdBanner({
   userId = null,
   userSegment = null,
   className = '',
+  clickMetadata,
+  impressionMetadata,
 }: AdBannerProps) {
   const [ad, setAd] = useState<Ad | null>(null);
   const [loading, setLoading] = useState(true);
@@ -63,7 +67,7 @@ export function AdBanner({
           setDevMode(response.dev_mode || false);
 
           // Track impression (will be skipped in dev mode)
-          trackImpression(response.ad.id, apiKey, apiUrl);
+          trackImpression(response.ad.id, apiKey, apiUrl, impressionMetadata);
         } else {
           // Create a more detailed error message
           const errorDetails = [];
@@ -111,7 +115,7 @@ export function AdBanner({
 
   const handleClick = () => {
     if (ad) {
-      trackClick(ad.id, apiKey, apiUrl);
+      trackClick(ad.id, apiKey, apiUrl, clickMetadata);
       // The link will handle navigation
     }
   };

package/src/lib/ads.ts

@@ -430,8 +430,9 @@ export function collectFingerprint(): Fingerprint {
  * @param adId - The ID of the ad being tracked
  * @param apiKey - The API key for the platform (required for CORS validation and platform identification)
  * @param apiUrl - Optional API base URL override
+ * @param metadata - Optional metadata object to send with the impression event
  */
-export async function trackImpression(adId: string, apiKey: string, apiUrl?: string): Promise<void> {
+export async function trackImpression(adId: string, apiKey: string, apiUrl?: string, metadata?: Record<string, unknown>): Promise<void> {
   try {
     if (!apiKey) {
       console.warn('[AdBanner] Cannot track impression: API key is required');
@@ -482,6 +483,7 @@ export async function trackImpression(adId: string, apiKey: string, apiUrl?: str
         action: 'impression',
         adId,
         fingerprint: collectFingerprint(), // Include fingerprint data for fraud detection
+        ...(metadata && { metadata }), // Include metadata if provided
       }),
     });
     
@@ -519,8 +521,9 @@ export async function trackImpression(adId: string, apiKey: string, apiUrl?: str
  * @param adId - The ID of the ad being tracked
  * @param apiKey - The API key for the platform (required for CORS validation and platform identification)
  * @param apiUrl - Optional API base URL override
+ * @param metadata - Optional metadata object to send with the click event
  */
-export async function trackClick(adId: string, apiKey: string, apiUrl?: string): Promise<void> {
+export async function trackClick(adId: string, apiKey: string, apiUrl?: string, metadata?: Record<string, unknown>): Promise<void> {
   try {
     if (!apiKey) {
       console.warn('[AdBanner] Cannot track click: API key is required');
@@ -571,6 +574,7 @@ export async function trackClick(adId: string, apiKey: string, apiUrl?: string):
         action: 'click',
         adId,
         fingerprint: collectFingerprint(), // Include fingerprint data for fraud detection
+        ...(metadata && { metadata }), // Include metadata if provided
       }),
     });