View as Markdown

Framework SDKs

Ezoic publishes official open-source SDKs that wrap the EzoicAds standalone integration for the major JavaScript frameworks. Each SDK manages the consent (CMP) and ad scripts in the required order, provides native components or services for ad placeholders, and handles single-page-app navigation so you don't have to hand-write the raw snippets.

Framework Package Source
Angular @ezoic/angular-sdk github.com/ezoic/ezoic-angular-sdk
React @ezoic/react-sdk github.com/ezoic/ezoic-react-sdk
Vue 3 @ezoic/vue-sdk github.com/ezoic/ezoic-vue-sdk
The SDKs are under active development (pre-1.0). See each repository's README for current install instructions, supported features, and roadmap.
These SDKs are for web apps running in the browser. Building a React Native mobile app for iOS or Android? Use the separate Ezoic React Native SDK (@ezoic/react-native-sdk), which bridges Ezoic's native mobile ad stacks.

What the SDKs handle for you

  • Script management — the Gatekeeper consent scripts, the ezstandalone.cmd queue stub, and the async sa.min.js bundle are injected once, in the correct order, idempotently, and SSR-safe.
  • Display ads — native placeholder components (for example <EzoicAd> in React and Vue, EzoicService in Angular) with typed showAds, refreshAds, and destroyPlaceholders passthroughs.
  • Single-page-app routing — page-view hooks that destroy and re-request ads on client-side navigation.
  • Consent — helpers for reading TCF consent state and the configuration options such as format toggles.
  • Rewarded ads and video — components and services for rewarded ads and Ezoic video, rolling out per the roadmap in each repository.

For Next.js specifically, see the Next.js guide.

Live Examples

Working example implementations of every integration style are available at examples.ezoic.com — id-less setup, placement IDs, Angular, React, Vue, and Web Games — each with copyable source. The entire examples site is open source at github.com/ezoic/examples.ezoic.com.