Particular Audience Particular Audience
Talk to us

AI for search, personalisation and retail media

A different store for every customer.

Bring what each shopper wants together with what your business needs.

Search, recommendations, retail media and promotions across your digital store and AI shopping experiences.

JavaScript SDK — Open Source on GitHub | Particular Audience

Add Particular Audience personalisation, recommendations and retail media tracking to any website with one JavaScript library.

Open source on GitHub

Add Particular Audience personalisation, recommendations and retail media tracking to any website with one JavaScript library.

Source: https://github.com/Particular-Audience/javascript-sdk

Automatic session management: Creates and keeps customer and session IDs for you.

Event tracking: Supports every PA event type, including views, clicks and purchases.

Recommendations API: Request recommendations from the PA engine with a few lines of code.

Auto product detection: Detects and tracks product views on product pages, with configurable detection patterns.

Declarative click and impression tracking: Track clicks and impressions using HTML data attributes.

Event batching and mobile detection: Batches events for performance and detects mobile devices for better personalisation.

Install from GitHub with npm, or load the script tag from GitHub Pages or a release.

Set up a small backend proxy that handles authentication, so credentials never reach the browser. The repo includes a Node.js example.

Initialise the SDK with your configuration, then track events and request recommendations.

Related: Hyper-Personalization & Recommendations, Retail Media Suite, Developers & Architecture.

Can I call the PA API straight from the browser? No. The PA API needs authentication, so the SDK talks to your own backend proxy, which holds the credentials and forwards requests.

How do I install it? Install it from GitHub with npm (main branch or a tagged release), or load the built file with a script tag.

Where is the full API reference? At docs.particularaudience.com, including getting started, configuration and authentication guides.