{"_id":"@adscrush/web-sdk","_rev":"2-f154962ae0bc94f89533e106003c26d9","name":"@adscrush/web-sdk","dist-tags":{"latest":"1.1.1"},"versions":{"1.1.0":{"name":"@adscrush/web-sdk","version":"1.1.0","keywords":["adscrush","conversion-tracking","affiliate-marketing","analytics","sdk","tracking","advertising","media-buyer"],"author":{"name":"AdsCrush","email":"support@adscrush.com"},"license":"MIT","_id":"@adscrush/web-sdk@1.1.0","maintainers":[{"name":"anonymous-sherlock","email":"anonymoushsherlock@gmail.com"}],"homepage":"https://github.com/adscrush/adscrush#readme","bugs":{"url":"https://github.com/adscrush/adscrush/issues"},"dist":{"shasum":"9e4ee9d07300adbd1edb60a59eca40ca3225c0c2","tarball":"https://registry.npmjs.org/@adscrush/web-sdk/-/web-sdk-1.1.0.tgz","fileCount":11,"integrity":"sha512-xYoH/92bytnM/TaVMoYbYw2NUQrZXWNagdI0AK2V4cmg3ZKXDy+tGdoDTK7xzP+OxhQc1MNUgMpbwbrIBEtpTg==","signatures":[{"sig":"MEYCIQCk4LiVxDizKzvkH/XspIFZA9sXoG8kPQr1WV+1ep0/+QIhAKCaFi1uMF6639ujZMG4MYs3G4NLJWxwN1dm0W5GWaEM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148923},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","unpkg":"dist/index.iife.min.js","module":"dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"4a77a462a855959fd737dc0a6535a75864e86343","scripts":{"dev":"tsup --watch","test":"vitest","build":"tsup","typecheck":"tsc --noEmit","test:watch":"vitest --watch","deploy:pages":"pnpm build && node ./scripts/deploy-pages.mjs","prepublishOnly":"pnpm build && pnpm typecheck"},"_npmUser":{"name":"anonymous-sherlock","email":"anonymoushsherlock@gmail.com"},"jsdelivr":"dist/index.iife.min.js","repository":{"url":"git+https://github.com/adscrush/adscrush.git","type":"git","directory":"packages/web-sdk"},"_npmVersion":"11.16.0","description":"Official JavaScript SDK for AdsCrush conversion tracking","directories":{},"_nodeVersion":"26.3.1","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.3","jsdom":"^29.1.1","vitest":"^3.0.0","wrangler":"^4.77.0","typescript":"^5.9.3","@types/node":"^25.1.0","@adscrush/typescript-config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/web-sdk_1.1.0_1785169064011_0.915674616768932","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@adscrush/web-sdk","version":"1.1.1","description":"Official JavaScript SDK for AdsCrush conversion tracking","author":"AdsCrush <support@adscrush.com>","license":"MIT","homepage":"https://github.com/adscrush/adscrush#readme","repository":{"type":"git","url":"git+https://github.com/adscrush/adscrush.git","directory":"packages/web-sdk"},"bugs":{"url":"https://github.com/adscrush/adscrush/issues"},"keywords":["adscrush","conversion-tracking","affiliate-marketing","analytics","sdk","tracking","advertising","media-buyer"],"type":"module","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","unpkg":"dist/index.iife.min.js","jsdelivr":"dist/index.iife.min.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"devDependencies":{"@types/node":"^25.1.0","jsdom":"^29.1.1","tsup":"^8.3.3","typescript":"^5.9.3","vitest":"^3.0.0","wrangler":"^4.77.0","@adscrush/typescript-config":"0.0.0"},"scripts":{"build":"tsup","typecheck":"tsc --noEmit","test":"vitest","test:watch":"vitest --watch","deploy:pages":"pnpm build && node ./scripts/deploy-pages.mjs"},"_nodeVersion":"26.3.1","_id":"@adscrush/web-sdk@1.1.1","dist":{"integrity":"sha512-DgC6QMYD9fo5QqcaZIW+NyJNvNH3904gMXhyb05C5wvrdmE63tlZMnxAcsj0PjsErTwRxb8re+Mx0VGmkETvUg==","shasum":"385505c0d0c39d35f2fc5f89440810363f5f1c7c","tarball":"https://registry.npmjs.org/@adscrush/web-sdk/-/web-sdk-1.1.1.tgz","fileCount":11,"unpackedSize":154667,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEy4YwZohSWBNp/lqDp0cLUhQSO7Y70Sge+xNGWgKCh8AiEA0mQ6jC118QTlyhvgmNSAOaQQ43BJgBHWLjWPwOyQo+M="}]},"_npmUser":{"name":"anonymous-sherlock","email":"anonymoushsherlock@gmail.com"},"directories":{},"maintainers":[{"name":"anonymous-sherlock","email":"anonymoushsherlock@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/web-sdk_1.1.1_1785299831762_0.3833816638377565"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-27T16:17:43.808Z","modified":"2026-07-29T04:37:12.078Z","1.1.0":"2026-07-27T16:17:44.198Z","1.1.1":"2026-07-29T04:37:11.926Z"},"bugs":{"url":"https://github.com/adscrush/adscrush/issues"},"author":"AdsCrush <support@adscrush.com>","license":"MIT","homepage":"https://github.com/adscrush/adscrush#readme","keywords":["adscrush","conversion-tracking","affiliate-marketing","analytics","sdk","tracking","advertising","media-buyer"],"repository":{"type":"git","url":"git+https://github.com/adscrush/adscrush.git","directory":"packages/web-sdk"},"description":"Official JavaScript SDK for AdsCrush conversion tracking","maintainers":[{"name":"anonymous-sherlock","email":"anonymoushsherlock@gmail.com"}],"readme":"# @adscrush/web-sdk\n\n[![npm version](https://img.shields.io/npm/v/@adscrush/web-sdk.svg)](https://www.npmjs.com/package/@adscrush/web-sdk)\n[![npm downloads](https://img.shields.io/npm/dm/@adscrush/web-sdk.svg)](https://www.npmjs.com/package/@adscrush/web-sdk)\n[![license](https://img.shields.io/npm/l/@adscrush/web-sdk.svg)](https://github.com/adscrush/adscrush/blob/main/packages/web-sdk/LICENSE)\n\nOfficial JavaScript SDK for AdsCrush conversion tracking.\n\n## Installation\n\n### CDN (Recommended)\n\nAdd this script to your page's `<head>` tag:\n\n```html\n<head>\n  <script src=\"https://sdk.adscrush.com/v1/index.iife.min.js\"></script>\n</head>\n```\n\n### NPM\n\n```bash\nnpm install @adscrush/web-sdk\n```\n\n## Usage\n\n### Landing Page (Capture Click ID)\n\n```html\n<head>\n  <script src=\"https://sdk.adscrush.com/v1/index.iife.min.js\"></script>\n</head>\n```\n\nThe SDK auto-initializes and captures the click ID from the `tid` URL parameter.\n\n### Thank You Page (Track Conversion)\n\n```html\n<head>\n  <script src=\"https://sdk.adscrush.com/v1/index.iife.min.js\"></script>\n  \n  <script>\n    AdsCrushSDK.trackConversion({\n      conversionData: {\n        event: 'purchase',\n        saleAmount: '99.99',\n        payout: '15.00',\n        currency: 'USD'\n      }\n    })\n  </script>\n</head>\n```\n\n### Custom Parameter Name\n\nIf your tracking links use a different parameter name (e.g., `clickid` instead of `tid`):\n\n```html\n<head>\n  <script>\n    window.adscrushConfig = {\n      paramName: 'clickid'\n    }\n  </script>\n  <script src=\"https://sdk.adscrush.com/v1/index.iife.min.js\"></script>\n</head>\n```\n\n### Set Click ID Directly\n\nIf you have the click ID from another source (e.g., a URL you constructed or a server-side redirect):\n\n```html\n<head>\n  <script src=\"https://sdk.adscrush.com/v1/index.iife.min.js\"></script>\n  \n  <script>\n    AdsCrushSDK.setClickId('abc-123-def-456')\n  </script>\n</head>\n```\n\n## API Reference\n\n### `trackConversion(options)`\n\nTrack a conversion event.\n\n**Parameters:**\n- `conversionData` - Object containing conversion details\n  - `event` - Event name (default: \"conversion\")\n  - `saleAmount` - Sale amount\n  - `payout` - Payout amount\n  - `currency` - Currency code (e.g., \"USD\")\n  - `coupon` - Coupon code\n  - `advSub1` through `advSub5` - Custom tracking parameters\n- `method` - Tracking method: \"pixel\" (default), \"iframe\", or \"postback\"\n- `clickId` - Override click ID\n- `onSuccess` - Success callback\n- `onError` - Error callback\n\n### `getClickId()`\n\nGet the current click ID.\n\n**Returns:** `string | null`\n\n### `setClickId(clickId)`\n\nManually set the click ID and store it in cookies/localStorage.\n\n```javascript\nAdsCrushSDK.setClickId('abc-123-def-456')\n```\n\n**Parameters:**\n- `clickId` - The click ID to store\n\n**Returns:** `void`\n\n### `hasTrackedConversion(event?)`\n\nCheck if a conversion has been tracked.\n\n**Parameters:**\n- `event` - Event name (default: \"conversion\")\n\n**Returns:** `boolean`\n\n### `destroy()`\n\nFully reset the SDK back to uninitialized state. Clears all stored data, configuration, and resets initialization. Call `init()` again after this to reinitialize.\n\n```javascript\nAdsCrushSDK.destroy()\n```\n\n**Returns:** `void`\n\n### `clear()`\n\nClear all stored data (click ID and deduplication flags). The SDK remains initialized.\n\n### `setDebug(enabled)`\n\nEnable/disable debug logging.\n\n## Configuration\n\nPass configuration via `window.adscrushConfig`:\n\n```javascript\nwindow.adscrushConfig = {\n  paramName: 'tid',        // URL parameter name (default: 'tid')\n  cookieExpiry: 30,        // Cookie expiration in days (default: 30)\n  cookieDomain: '.example.com', // Cookie domain for cross-subdomain tracking\n  debug: false,            // Enable debug logging (default: false)\n  autoInit: true          // Auto-capture click ID on load (default: true)\n}\n```\n\n## Examples\n\n### E-commerce\n\n```javascript\nAdsCrushSDK.trackConversion({\n  conversionData: {\n    event: 'purchase',\n    saleAmount: '149.99',\n    payout: '22.50',\n    currency: 'USD',\n    advSub1: 'order_12345'\n  }\n})\n```\n\n### Lead Generation\n\n```javascript\nAdsCrushSDK.trackConversion({\n  conversionData: {\n    event: 'lead',\n    payout: '5.00',\n    advSub1: 'form_submission'\n  }\n})\n```\n\n### Multi-Step Funnel\n\n```javascript\n// Step 1: Landing page visit (auto-captured)\n\n// Step 2: Sign up\nAdsCrushSDK.trackConversion({\n  conversionData: {\n    event: 'signup',\n    payout: '2.00'\n  }\n})\n\n// Step 3: Purchase\nAdsCrushSDK.trackConversion({\n  conversionData: {\n    event: 'purchase',\n    saleAmount: '99.99',\n    payout: '15.00'\n  }\n})\n```\n\n## TypeScript\n\nFull TypeScript support with type definitions included.\n\n```typescript\nimport AdsCrushSDK, { ConversionOptions } from '@adscrush/web-sdk'\n\nconst options: ConversionOptions = {\n  conversionData: {\n    event: 'purchase',\n    saleAmount: '99.99',\n    payout: '15.00',\n    currency: 'USD'\n  }\n}\n\nawait AdsCrushSDK.trackConversion(options)\n```\n\n## License\n\nMIT\n","readmeFilename":""}