@adtogether/web-sdk 0.1.22 → 0.1.24

package/CHANGELOG.md

@@ -1,5 +1,11 @@
-## 0.1.22
+## 0.1.24
+* **Docs**: Standardized SDK documentation across all platforms.
+
+## 0.1.23
 
+* **Sync**: Version parity across all AdTogether SDKs.
+
+## 0.1.22
 * **Brand**: Added "Powered by AdTogether" attribution to all Interstitial ad formats.
 * **Sync**: Unified versioning (0.1.20) across all AdTogether SDKs.
 

package/README.md

@@ -1,5 +1,10 @@
 # AdTogether Web SDK
 
+
+<p align="center">
+  <img src="../../public/dashboard.png" width="800" alt="Developer Dashboard">
+</p>
+
 [![npm version](https://img.shields.io/npm/v/@adtogether/web-sdk)](https://www.npmjs.com/package/@adtogether/web-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -14,6 +19,9 @@
 
 This SDK allows web developers (React and Vanilla JS) to easily integrate AdTogether ads into their applications. By displaying ads from other community members, you earn **Ad Credits** that allow your own app's ads to be shown across the AdTogether network.
 
+> [!IMPORTANT]
+> **Developer Account Required**: Before integrating the SDK, you must create a developer account at [https://adtogether.relaxsoftwareapps.com](https://adtogether.relaxsoftwareapps.com) to generate your `appId` and configure your ad units. Integration will not work without a valid `appId`.
+
 ### 🖼️ Visualizing the Experience
 
 | **Native Banner Ad** | **Interstitial Full-Screen** |

package/dist/{chunk-RW43ES42.mjs → chunk-IDISPRGA.mjs}

@@ -72,6 +72,34 @@ var AdTogether = class _AdTogether {
   static trackClick(adId, token) {
     this.trackEvent("/api/ads/click", adId, token);
   }
+  /**
+   * Detect the user's country code from the browser locale.
+   * Uses Intl API (most reliable) with navigator.language as fallback.
+   * Returns an ISO 3166-1 alpha-2 code like "US", "DE", "JP", or null.
+   */
+  static detectCountry() {
+    try {
+      if (typeof Intl !== "undefined" && Intl.DateTimeFormat) {
+        const resolved = Intl.DateTimeFormat().resolvedOptions();
+        if (resolved.locale) {
+          const parts = resolved.locale.split("-");
+          if (parts.length >= 2) {
+            const region = parts[parts.length - 1].toUpperCase();
+            if (region.length === 2) return region;
+          }
+        }
+      }
+      if (typeof navigator !== "undefined" && navigator.language) {
+        const parts = navigator.language.split("-");
+        if (parts.length >= 2) {
+          const region = parts[parts.length - 1].toUpperCase();
+          if (region.length === 2) return region;
+        }
+      }
+    } catch (_) {
+    }
+    return null;
+  }
   static trackEvent(endpoint, adId, token) {
     if (!_AdTogether.shared.assertInitialized()) return;
     fetch(`${_AdTogether.shared.baseUrl}${endpoint}`, {
@@ -86,7 +114,8 @@ var AdTogether = class _AdTogether {
         ..._AdTogether.shared.bundleId ? { bundleId: _AdTogether.shared.bundleId } : {},
         // Send platform and environment to match Flutter SDK
         platform: "web",
-        environment: typeof process !== "undefined" && process.env?.NODE_ENV === "development" ? "development" : "production"
+        environment: typeof process !== "undefined" && process.env?.NODE_ENV === "development" ? "development" : "production",
+        country: _AdTogether.detectCountry()
       })
     }).catch(console.error);
   }

package/dist/index.d.mts

@@ -31,6 +31,12 @@ declare class AdTogether {
     static fetchAd(adUnitId: string, adType?: AdType): Promise<AdModel>;
     static trackImpression(adId: string, token?: string): void;
     static trackClick(adId: string, token?: string): void;
+    /**
+     * Detect the user's country code from the browser locale.
+     * Uses Intl API (most reliable) with navigator.language as fallback.
+     * Returns an ISO 3166-1 alpha-2 code like "US", "DE", "JP", or null.
+     */
+    private static detectCountry;
     private static trackEvent;
 }
 

package/dist/index.d.ts

@@ -31,6 +31,12 @@ declare class AdTogether {
     static fetchAd(adUnitId: string, adType?: AdType): Promise<AdModel>;
     static trackImpression(adId: string, token?: string): void;
     static trackClick(adId: string, token?: string): void;
+    /**
+     * Detect the user's country code from the browser locale.
+     * Uses Intl API (most reliable) with navigator.language as fallback.
+     * Returns an ISO 3166-1 alpha-2 code like "US", "DE", "JP", or null.
+     */
+    private static detectCountry;
     private static trackEvent;
 }
 

package/dist/index.js

@@ -98,6 +98,34 @@ var AdTogether = class _AdTogether {
   static trackClick(adId, token) {
     this.trackEvent("/api/ads/click", adId, token);
   }
+  /**
+   * Detect the user's country code from the browser locale.
+   * Uses Intl API (most reliable) with navigator.language as fallback.
+   * Returns an ISO 3166-1 alpha-2 code like "US", "DE", "JP", or null.
+   */
+  static detectCountry() {
+    try {
+      if (typeof Intl !== "undefined" && Intl.DateTimeFormat) {
+        const resolved = Intl.DateTimeFormat().resolvedOptions();
+        if (resolved.locale) {
+          const parts = resolved.locale.split("-");
+          if (parts.length >= 2) {
+            const region = parts[parts.length - 1].toUpperCase();
+            if (region.length === 2) return region;
+          }
+        }
+      }
+      if (typeof navigator !== "undefined" && navigator.language) {
+        const parts = navigator.language.split("-");
+        if (parts.length >= 2) {
+          const region = parts[parts.length - 1].toUpperCase();
+          if (region.length === 2) return region;
+        }
+      }
+    } catch (_) {
+    }
+    return null;
+  }
   static trackEvent(endpoint, adId, token) {
     if (!_AdTogether.shared.assertInitialized()) return;
     fetch(`${_AdTogether.shared.baseUrl}${endpoint}`, {
@@ -112,7 +140,8 @@ var AdTogether = class _AdTogether {
         ..._AdTogether.shared.bundleId ? { bundleId: _AdTogether.shared.bundleId } : {},
         // Send platform and environment to match Flutter SDK
         platform: "web",
-        environment: typeof process !== "undefined" && process.env?.NODE_ENV === "development" ? "development" : "production"
+        environment: typeof process !== "undefined" && process.env?.NODE_ENV === "development" ? "development" : "production",
+        country: _AdTogether.detectCountry()
       })
     }).catch(console.error);
   }

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   AdTogether
-} from "./chunk-RW43ES42.mjs";
+} from "./chunk-IDISPRGA.mjs";
 export {
   AdTogether
 };

package/dist/react/index.js

@@ -102,6 +102,34 @@ var AdTogether = class _AdTogether {
   static trackClick(adId, token) {
     this.trackEvent("/api/ads/click", adId, token);
   }
+  /**
+   * Detect the user's country code from the browser locale.
+   * Uses Intl API (most reliable) with navigator.language as fallback.
+   * Returns an ISO 3166-1 alpha-2 code like "US", "DE", "JP", or null.
+   */
+  static detectCountry() {
+    try {
+      if (typeof Intl !== "undefined" && Intl.DateTimeFormat) {
+        const resolved = Intl.DateTimeFormat().resolvedOptions();
+        if (resolved.locale) {
+          const parts = resolved.locale.split("-");
+          if (parts.length >= 2) {
+            const region = parts[parts.length - 1].toUpperCase();
+            if (region.length === 2) return region;
+          }
+        }
+      }
+      if (typeof navigator !== "undefined" && navigator.language) {
+        const parts = navigator.language.split("-");
+        if (parts.length >= 2) {
+          const region = parts[parts.length - 1].toUpperCase();
+          if (region.length === 2) return region;
+        }
+      }
+    } catch (_) {
+    }
+    return null;
+  }
   static trackEvent(endpoint, adId, token) {
     if (!_AdTogether.shared.assertInitialized()) return;
     fetch(`${_AdTogether.shared.baseUrl}${endpoint}`, {
@@ -116,7 +144,8 @@ var AdTogether = class _AdTogether {
         ..._AdTogether.shared.bundleId ? { bundleId: _AdTogether.shared.bundleId } : {},
         // Send platform and environment to match Flutter SDK
         platform: "web",
-        environment: typeof process !== "undefined" && process.env?.NODE_ENV === "development" ? "development" : "production"
+        environment: typeof process !== "undefined" && process.env?.NODE_ENV === "development" ? "development" : "production",
+        country: _AdTogether.detectCountry()
       })
     }).catch(console.error);
   }

package/dist/react/index.mjs

@@ -1,6 +1,6 @@
 import {
   AdTogether
-} from "../chunk-RW43ES42.mjs";
+} from "../chunk-IDISPRGA.mjs";
 
 // src/react/AdTogetherBanner.tsx
 import { useEffect, useRef, useState } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adtogether/web-sdk",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "The official AdTogether Web SDK — reciprocal ad exchange to increase conversions and grow your audience.",
   "repository": {
     "type": "git",

package/src/core/AdTogether.ts

@@ -95,6 +95,37 @@ export class AdTogether {
     this.trackEvent('/api/ads/click', adId, token);
   }
 
+  /**
+   * Detect the user's country code from the browser locale.
+   * Uses Intl API (most reliable) with navigator.language as fallback.
+   * Returns an ISO 3166-1 alpha-2 code like "US", "DE", "JP", or null.
+   */
+  private static detectCountry(): string | null {
+    try {
+      // Intl API gives the most reliable region
+      if (typeof Intl !== 'undefined' && Intl.DateTimeFormat) {
+        const resolved = Intl.DateTimeFormat().resolvedOptions();
+        // timeZone is like "America/New_York" — we can map it, but locale is simpler
+        if (resolved.locale) {
+          const parts = resolved.locale.split('-');
+          if (parts.length >= 2) {
+            const region = parts[parts.length - 1].toUpperCase();
+            if (region.length === 2) return region;
+          }
+        }
+      }
+      // Fallback: navigator.language (e.g. "en-US" -> "US")
+      if (typeof navigator !== 'undefined' && navigator.language) {
+        const parts = navigator.language.split('-');
+        if (parts.length >= 2) {
+          const region = parts[parts.length - 1].toUpperCase();
+          if (region.length === 2) return region;
+        }
+      }
+    } catch (_) {}
+    return null;
+  }
+
   private static trackEvent(endpoint: string, adId: string, token?: string) {
     if (!AdTogether.shared.assertInitialized()) return;
     
@@ -111,6 +142,7 @@ export class AdTogether {
         // Send platform and environment to match Flutter SDK
         platform: 'web',
         environment: typeof process !== 'undefined' && process.env?.NODE_ENV === 'development' ? 'development' : 'production',
+        country: AdTogether.detectCountry(),
       }),
     }).catch(console.error);
   }