> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful-staging.ferndocs.com/developers/docs/_mcp/server.

# Optimization SDK

## Docs

- [Optimization SDK](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/overview.md): An introduction to the Optimization SDK suite and how you can integrate it with your setup.
- [Choose the right SDK](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/choose-the-right-sdk.md): A guide to help you decide which SDK is best for your setup.
- [Integrate the Optimization Node SDK in a Node app](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/integrate-the-node-sdk-into-a-node-app.md): This guide helps you implement server-side personalization in a Node runtime such as Express, a custom SSR server, or a server-side function.
- [Integrate the Optimization SDK in a Next.js app (hybrid SSR + CSR takeover)](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/integrate-the-optimization-sdk-in-a-nextjs-app-ssr-csr.md): This guide helps you personalize a Next.js App Router application where the first page load is server-resolved (no flicker, SEO-friendly) and subsequent client-side interactions.
- [Integrate the Optimization SDK in a Next.js app (SSR-primary)](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/integrate-the-optimization-sdk-in-a-nextjs-app-ssr.md): Use this guide when you want to add personalization to a Next.js App Router application where the server is the single source of truth for which variant to show.
- [Integrate the Optimization React Native SDK in a React Native app](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/integrate-the-react-native-sdk-in-a-react-native-app.md): This guide helps you add personalization, analytics, screen tracking, and a preview panel to a React Native (or Expo) application.
- [Integrate the Optimization React Web SDK in a React app](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/integrate-the-react-web-sdk-in-a-react-app.md): This guide helps you add personalization and analytics to a React web application using `@contentful/optimization-react-web`.
- [Integrate the Optimization Web SDK in a web app](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/integrate-the-web-sdk-in-a-web-app.md): This guide helps you implement client-side personalization and analytics in a browser application, such as a static site, multi-page app, SPA, or custom frontend runtime.
- [Core state management](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/core-state-management.md): Understand how `CoreStateful` stores its internal state, why that state isprotected from outside interference, and which surface the SDK explicitly provides for consumers to observe and influence state.
- [Entry personalization and variant resolution](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/entry-personalization-and-variant-resolution.md): Understand how the Optimization SDK Suite resolves a Contentful baseline entry to the entry variant selected for a visitor.
- [Interaction tracking in Node and stateless environments](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/interaction-tracking-in-node-and-stateless-environments.md): Understand how the Optimization SDK Suite resolves a Contentful baseline entry to the entry variant selected for a visitor.
- [Interaction tracking in Web SDKs](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/interaction-tracking-in-web-sdks.md): Understand how browser interaction tracking works in `@contentful/optimization-web` and the React layer provided by `@contentful/optimization-react-web`.
- [Profile synchronization between client and server](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/profile-synchronization-between-client-and-server.md): Understand how the Optimization SDK Suite keeps a visitor profile continuous when a Node server and a browser client both participate in personalization and analytics.
- [React Native SDK interaction tracking mechanics](https://contentful-staging.ferndocs.com/developers/docs/personalization/optimization-sdk/react-native-sdk-interaction-tracking-mechanics.md): Understand what the `@contentful/optimization-react-native` SDK is tracking, when each event fires, and how it leaves the device.