From 80a00300891890e65696169ddd15a42d541d92d6 Mon Sep 17 00:00:00 2001
From: Nicolas Girardot <nicolas.girardot+github@gmail.com>
Date: Mon, 29 Sep 2025 14:52:41 +0200
Subject: [PATCH 1/6] feat/add-react-native-docs

---
 docs.json                            |   4 +-
 getting-started/mobile-sdk.mdx       |  38 ++-
 getting-started/react-native-sdk.mdx | 452 +++++++++++++++++++++++++++
 getting-started/sdk.mdx              |  21 +-
 package-lock.json                    | 232 ++++++++++----
 package.json                         |   2 +-
 6 files changed, 674 insertions(+), 75 deletions(-)
 create mode 100644 getting-started/react-native-sdk.mdx

diff --git a/docs.json b/docs.json
index 6575316..017a669 100644
--- a/docs.json
+++ b/docs.json
@@ -103,7 +103,9 @@
                 "pages": [
                   "getting-started/sdk",
                   "getting-started/js-sdk",
-                  "getting-started/react-sdk"
+                  "getting-started/react-sdk",
+                  "getting-started/react-native-sdk",
+                  "getting-started/mobile-sdk"
                 ]
               },
               "getting-started/component-configuration",
diff --git a/getting-started/mobile-sdk.mdx b/getting-started/mobile-sdk.mdx
index 7182114..edb0bd5 100644
--- a/getting-started/mobile-sdk.mdx
+++ b/getting-started/mobile-sdk.mdx
@@ -1,16 +1,34 @@
----
-title: Mobile SDK
-description: Integrate Edgee with a mobile application.
-icon: mobile
----
-
-import EdgeeSdk from '/snippets/edgee-sdk.mdx';
 
 <EdgeeSdk />
 
-We're currently working on native mobile SDKs for iOS and Android that will allow you
-to implement data collection in your mobile app.
+Edgee provides comprehensive mobile SDKs that allow you to implement data collection in your mobile applications with rich native context and privacy-first design.
+
+## Available Mobile SDKs
+
+<CardGroup>
+  <Card title="React Native SDK" icon="mobile" href="/getting-started/react-native-sdk">
+    Full-featured SDK for React Native applications with 30+ native data points, offline queue, and automatic screen tracking.
+  </Card>
+</CardGroup>
+
+### React Native SDK Features
+
+Our React Native SDK provides:
+
+- **Rich Native Context**: Automatically collects device, app, and system information
+- **Privacy-First**: GDPR/CCPA compliant with optional device ID collection
+- **Offline Queue**: Events are persisted and retried when network is available
+- **Lightweight**: Minimal impact on app size (~100KB total)
+- **Type-Safe**: Full TypeScript support with comprehensive type definitions
+- **Auto Screen Tracking**: Optional helpers for Expo Router and React Navigation
+- **Graceful Fallback**: Works without native modules (Expo Go compatible)
+
+[Get started with React Native SDK →](/getting-started/react-native-sdk)
+
+## Native iOS and Android SDKs
+
+We're currently working on native mobile SDKs for iOS and Android that will provide even deeper system integration.
 
-In the meantime, you can directly integrate with the data collection API of your Edgee project.
+In the meantime, you can directly integrate with the data collection API of your Edgee project for native iOS and Android apps.
 
 [Learn more about data collection API.](/api-reference/data-collection/)
diff --git a/getting-started/react-native-sdk.mdx b/getting-started/react-native-sdk.mdx
new file mode 100644
index 0000000..57e2708
--- /dev/null
+++ b/getting-started/react-native-sdk.mdx
@@ -0,0 +1,452 @@
+
+<EdgeeSdk />
+
+For React Native applications, we provide a comprehensive SDK that enables seamless data collection with rich native context. This SDK automatically collects 30+ device and app data points while maintaining privacy compliance and optimal performance.
+
+## Features
+
+- **Rich Native Context**: Automatically collects device, app, and system information
+- **Privacy-First**: GDPR/CCPA compliant with optional device ID collection
+- **Offline Queue**: Events are persisted and retried when network is available
+- **Lightweight**: Minimal impact on app size (~100KB total)
+- **Type-Safe**: Full TypeScript support with comprehensive type definitions
+- **Auto Screen Tracking**: Optional helpers for Expo Router and React Navigation
+- **Graceful Fallback**: Works without native modules (Expo Go compatible)
+
+## Installation
+
+### Step 1: Install Package & Dependencies
+
+<CodeGroup>
+
+```bash npm
+npm install react-native-edgee @react-native-async-storage/async-storage @react-native-community/netinfo
+```
+
+```bash yarn
+yarn add react-native-edgee @react-native-async-storage/async-storage @react-native-community/netinfo
+```
+
+```bash expo
+npx expo install react-native-edgee @react-native-async-storage/async-storage @react-native-community/netinfo
+```
+
+</CodeGroup>
+
+### Step 2: Platform Setup
+
+Choose your platform setup based on your React Native environment:
+
+<Tabs>
+  <Tab title="React Native CLI">
+    **iOS:**
+    ```bash
+    cd ios && pod install && cd ..
+    ```
+
+    **Android:**
+
+    1. **Add native module** to `android/app/src/main/java/.../MainApplication.java`:
+
+    ```java
+    import com.reactnativeedgee.EdgeeReactNativePackage;
+
+    public class MainApplication extends Application implements ReactApplication {
+      // ... existing code ...
+
+      @Override
+      protected List<ReactPackage> getPackages() {
+        @SuppressWarnings("UnnecessaryLocalVariable")
+        List<ReactPackage> packages = new PackageList(this).getPackages();
+
+        packages.add(new EdgeeReactNativePackage()); // 👈 Add this line
+
+        return packages;
+      }
+    }
+    ```
+
+    2. **Add permission** to `android/app/src/main/AndroidManifest.xml`:
+
+    ```xml
+    <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+        <!-- Your existing manifest content -->
+    </manifest>
+    ```
+
+    3. **Rebuild your app:**
+    ```bash
+    npx react-native run-android
+    ```
+  </Tab>
+
+  <Tab title="Expo Development Build">
+    ```bash
+    # Install the package
+    npx expo install react-native-edgee @react-native-async-storage/async-storage @react-native-community/netinfo
+
+    # Create development build (this compiles native modules)
+    npx expo run:ios     # For iOS
+    npx expo run:android # For Android
+    ```
+
+    <Note>Native modules require a development build, not Expo Go.</Note>
+  </Tab>
+
+  <Tab title="Expo Go">
+    ```bash
+    npx expo install react-native-edgee @react-native-async-storage/async-storage @react-native-community/netinfo
+    ```
+
+    <Warning>
+    **Limitations:** Native context collection is disabled. Only basic JavaScript context (screen size, platform, locale) will be available.
+    </Warning>
+  </Tab>
+</Tabs>
+
+### Step 3: Verify Installation
+
+Test that native modules are working:
+
+```typescript
+import { isNativeModuleAvailable } from 'react-native-edgee';
+
+console.log('Native modules available:', isNativeModuleAvailable());
+// Should log: true (React Native CLI, Expo Dev Build)
+// Should log: false (Expo Go)
+```
+
+## Quick Start
+
+### Basic Setup
+
+```typescript
+import { EdgeeClient } from 'react-native-edgee';
+
+// Create client instance
+export const edgee = new EdgeeClient({
+  host: "https://your-edgee-host.com",
+  debug: __DEV__, // Enable debug logging in development
+  collectDeviceId: false, // Set to true if you need unique device tracking
+});
+```
+
+Replace `https://your-edgee-host.com` with the URL provided in the Edgee console, in the project overview section.
+
+### Track Events
+
+```typescript
+// Track events (automatically includes rich native context)
+// Consent is handled transparently - no need to check before each call!
+edgee.track('App Launched', {
+  source: 'cold_start',
+  version: '1.0.0'
+});
+
+// Track user information
+edgee.user({
+  id: '123',
+  email: 'user@example.com',
+  plan: 'premium'
+});
+
+// Track screen views
+edgee.screen('Home Screen', {
+  category: 'main',
+  loaded_time: Date.now()
+});
+```
+
+### Consent Management (Optional)
+
+```typescript
+// Set consent - all tracking calls automatically respect this setting
+await edgee.setConsent('granted'); // 'granted', 'denied', or 'pending'
+
+// Check consent status
+console.log('Current consent:', edgee.getConsent());
+console.log('Can track:', edgee.canTrack());
+
+// Listen for consent changes
+const unsubscribe = edgee.onConsentChange((status) => {
+  console.log('Consent changed to:', status);
+});
+
+// Reset consent
+await edgee.resetConsent();
+```
+
+**Key Benefits:**
+- **Transparent**: No need to check consent before each tracking call
+- **Auto-sync**: Consent events automatically sent to your Edgee server
+- **Persistent**: Consent preference stored locally and remembered
+- **Compliant**: GDPR/CCPA ready with proper consent management
+
+## Rich Native Context
+
+With native modules enabled, each event automatically includes comprehensive context:
+
+### App Information
+- App name, version, build number
+- Bundle/package identifier
+- Installation and update timestamps
+
+### Device Information
+- Device model, manufacturer, brand
+- Screen dimensions, density, scale
+- Hardware capabilities (tablet, simulator/emulator detection)
+
+### System Information
+- OS name and version
+- Locale, language, country, timezone
+- Memory usage, storage info
+- Battery level and state (iOS)
+
+### Network Information
+- Connection type (WiFi, cellular, ethernet)
+- Carrier name and network codes
+- Radio technology (3G, 4G, 5G)
+
+### Privacy Information *(Optional)*
+- Advertising ID (with proper consent on iOS 14+)
+- Device ID (privacy-compliant, opt-in only)
+- Tracking authorization status
+
+## React Integration
+
+### Context Provider (Recommended)
+
+```typescript
+import { EdgeeProvider, useEdgee } from 'react-native-edgee';
+
+// Wrap your app
+export default function App() {
+  return (
+    <EdgeeProvider host="https://your-edgee-host.com" debug={__DEV__}>
+      <YourApp />
+    </EdgeeProvider>
+  );
+}
+
+// Use in components
+function SomeComponent() {
+  const edgee = useEdgee();
+
+  const handleButtonPress = () => {
+    // Tracking automatically respects consent - no need to check!
+    edgee.track('Button Pressed', { button_id: 'cta_main' });
+  };
+
+  const handleConsentGrant = async () => {
+    await edgee.setConsent('granted');
+  };
+
+  return (
+    <View>
+      <Button onPress={handleButtonPress} title="Track Me" />
+      <Button onPress={handleConsentGrant} title="Grant Consent" />
+    </View>
+  );
+}
+```
+
+### Consent Hook
+
+```typescript
+import { useEdgeeConsent } from 'react-native-edgee';
+
+function ConsentBanner() {
+  const {
+    consentStatus,
+    loading,
+    hasConsent,
+    isGranted,
+    isDenied,
+    isPending,
+    canTrack,
+    setConsent,
+    resetConsent,
+  } = useEdgeeConsent();
+
+  if (loading) return <Text>Loading...</Text>;
+
+  if (!hasConsent) {
+    return (
+      <View style={styles.banner}>
+        <Text>We use cookies to improve your experience.</Text>
+        <Button onPress={() => setConsent('granted')} title="Accept" />
+        <Button onPress={() => setConsent('denied')} title="Decline" />
+      </View>
+    );
+  }
+
+  return null;
+}
+```
+
+### Auto Screen Tracking
+
+<Tabs>
+  <Tab title="Expo Router">
+    ```typescript
+    import { EdgeeAutoTracker } from 'react-native-edgee';
+
+    export default function RootLayout() {
+      return (
+        <>
+          <EdgeeAutoTracker />
+          <Stack>
+            <Stack.Screen name="index" />
+            <Stack.Screen name="profile" />
+          </Stack>
+        </>
+      );
+    }
+    ```
+  </Tab>
+
+  <Tab title="React Navigation">
+    ```typescript
+    import { navigation } from 'react-native-edgee';
+
+    const navigationRef = useRef();
+
+    return (
+      <NavigationContainer
+        ref={navigationRef}
+        onStateChange={() => {
+          navigation.trackScreenChange(navigationRef, edgee);
+        }}
+      >
+        {/* Your navigation structure */}
+      </NavigationContainer>
+    );
+    ```
+  </Tab>
+</Tabs>
+
+## Configuration
+
+```typescript
+interface EdgeeConfig {
+  host: string;                    // Your Edgee endpoint URL (required)
+  debug?: boolean;                 // Enable debug logging (default: false)
+  collectDeviceId?: boolean;       // Collect unique device ID (default: false)
+}
+```
+
+### Privacy Considerations
+
+- **Device ID Collection**: Only enable `collectDeviceId: true` if you need persistent device tracking
+- **iOS Advertising ID**: Automatically respects App Tracking Transparency (iOS 14+)
+- **GDPR/CCPA Compliance**: All sensitive data collection is optional and clearly documented
+
+## Advanced Usage
+
+### Manual Native Context Access
+
+```typescript
+import { getNativeContext, isNativeModuleAvailable } from 'react-native-edgee';
+
+// Check if native modules are available
+if (isNativeModuleAvailable()) {
+  const context = await getNativeContext({ collectDeviceId: false });
+  console.log('Device model:', context.model);
+  console.log('Is tablet:', context.isTablet);
+  console.log('Network type:', context.networkType);
+  console.log('Total memory:', context.totalMemoryMB);
+}
+```
+
+### Context Caching
+
+```typescript
+import { clearContextCache } from 'react-native-edgee';
+
+// Clear cached context (useful for testing or when context might change)
+clearContextCache();
+```
+
+## Troubleshooting
+
+### Common Issues
+
+<AccordionGroup>
+  <Accordion title="Module not found Error">
+    **iOS:**
+    ```bash
+    cd ios && rm -rf build && pod install && cd ..
+    npx react-native run-ios
+    ```
+
+    **Android:**
+    - Ensure `EdgeeReactNativePackage` is added to `MainApplication.java`
+    - Clean build: `cd android && ./gradlew clean && cd ..`
+  </Accordion>
+
+  <Accordion title="No Native Context in Events">
+    1. Check if native modules are available:
+       ```typescript
+       console.log('Available:', isNativeModuleAvailable());
+       ```
+
+    2. If `false`, verify platform setup above
+    3. In Expo Go, this is expected (use Expo Development Build)
+  </Accordion>
+
+  <Accordion title="Build Errors">
+    **Clean everything:**
+    ```bash
+    # React Native CLI
+    cd ios && rm -rf build && cd ..
+    cd android && ./gradlew clean && cd ..
+    npx react-native start --reset-cache
+
+    # Expo
+    npx expo run:ios --clear-cache
+    ```
+  </Accordion>
+</AccordionGroup>
+
+### Debug Mode
+
+Enable debug logging to see what's happening:
+
+```typescript
+const edgee = new EdgeeClient({
+  host: "https://your-edgee-host.com",
+  debug: true, // This will log all events and native context
+});
+```
+
+## Compatibility
+
+| Platform | Version | Native Context | Auto-Linking |
+|----------|---------|----------------|--------------|
+| **React Native** | 0.72+ | ✅ Full | iOS: ✅ Android: Manual |
+| **iOS** | 11.0+ | ✅ Full | ✅ CocoaPods |
+| **Android** | API 21+ | ✅ Full | ⚠️ Manual setup |
+| **Expo Dev Build** | Latest | ✅ Full | ✅ Automatic |
+| **Expo Go** | Latest | ⚠️ Fallback | N/A |
+
+## TypeScript Support
+
+Full TypeScript support with comprehensive type definitions:
+
+```typescript
+import type {
+  EdgeeNativeContext,
+  EdgeeClientContext,
+  EdgeeConfig,
+  ConsentStatus
+} from 'react-native-edgee';
+```
+
+## Next Steps
+
+After integrating the React Native SDK, you're ready to start using Edgee's services.
+
+In the [Services section](/services/overview), you'll find comprehensive guides on activating and customizing features such as advanced analytics, A/B testing, security, and more, ensuring your mobile application not only performs efficiently but also delivers a superior user experience.
+
+For more details about the React Native SDK, visit the [react-native-edgee repository](https://github.com/edgee-cloud/react-native-edgee).
diff --git a/getting-started/sdk.mdx b/getting-started/sdk.mdx
index e8c16de..8abb707 100644
--- a/getting-started/sdk.mdx
+++ b/getting-started/sdk.mdx
@@ -1,10 +1,3 @@
----
-title: Choose your SDK
-description: Learn how to integrate the Edgee SDK to interact with Edgee services.
-icon: code
----
-
-import EdgeeSdk from '/snippets/edgee-sdk.mdx';
 
 <EdgeeSdk />
 
@@ -15,8 +8,8 @@ Getting up and runing with the Edgee SDK only takes a few minutes.
 You might wonder - If Edgee processes everything at the edge, why do I need a client-side SDK?
 
 Great question! This SDK acts as a bridge and replaces the SDKs of all the components you've enabled for your project.
-The SDK allows our edge processing capabilities to kick in. 
-When the Edgee proxy intercepts this script, it triggers analytics events and other services directly at the edge. 
+The SDK allows our edge processing capabilities to kick in.
+When the Edgee proxy intercepts this script, it triggers analytics events and other services directly at the edge.
 This means **you get real-time processing without compromising your application's performance**.
 Plus, the SDK lets you track client-side events such as button clicks or custom actions without reloading the page,
 communicating directly with the Edgee proxy so it can't be blocked.
@@ -46,7 +39,7 @@ You can enable this feature in your project settings with a simple toggle. If yo
 
 ### Manual SDK integrations
 
-We provide SDKs for different frameworks and libraries. 
+We provide SDKs for different frameworks and libraries.
 
 Choose the one that fits your project:
 
@@ -58,6 +51,14 @@ Choose the one that fits your project:
   <Card title="Edgee React Component" icon="react" href="/getting-started/react-sdk">
     Use the React component to inject the Edgee SDK into a React application.
   </Card>
+
+  <Card title="React Native SDK" icon="mobile" href="/getting-started/react-native-sdk">
+    Full-featured SDK for React Native apps with native context and offline support.
+  </Card>
+
+  <Card title="Mobile SDKs" icon="mobile" href="/getting-started/mobile-sdk">
+    Explore all available mobile SDKs for iOS, Android, and cross-platform development.
+  </Card>
 </CardGroup>
 
 
diff --git a/package-lock.json b/package-lock.json
index be279d7..4fbb9ae 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -5,7 +5,7 @@
   "packages": {
     "": {
       "dependencies": {
-        "mintlify": "^4.2.127"
+        "mintlify": "^4.2.131"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -1157,17 +1157,17 @@
       }
     },
     "node_modules/@mintlify/cli": {
-      "version": "4.0.731",
-      "resolved": "https://registry.npmjs.org/@mintlify/cli/-/cli-4.0.731.tgz",
-      "integrity": "sha512-FLAWpF/c1MbubxNU8w9iKtA9VrH9m/qhH+akXBfJl8vqw8WVunMQPeV1/ATfPx+PsK3YVIUoKjFGNgt0m/Sjgw==",
+      "version": "4.0.735",
+      "resolved": "https://registry.npmjs.org/@mintlify/cli/-/cli-4.0.735.tgz",
+      "integrity": "sha512-87Rm84crrhwFPZhJfMJP7iS9nP5YHHoFsw91CH0FK6P36FlEq7zDzP3MHeUqx1FCMTI1dH9m2UzNUHHdF6n7jQ==",
       "license": "Elastic-2.0",
       "dependencies": {
-        "@mintlify/common": "1.0.541",
-        "@mintlify/link-rot": "3.0.678",
+        "@mintlify/common": "1.0.545",
+        "@mintlify/link-rot": "3.0.682",
         "@mintlify/models": "0.0.230",
-        "@mintlify/prebuild": "1.0.665",
-        "@mintlify/previewing": "4.0.714",
-        "@mintlify/validation": "0.1.474",
+        "@mintlify/prebuild": "1.0.669",
+        "@mintlify/previewing": "4.0.718",
+        "@mintlify/validation": "0.1.476",
         "chalk": "^5.2.0",
         "detect-port": "^1.5.1",
         "fs-extra": "^11.2.0",
@@ -1188,16 +1188,16 @@
       }
     },
     "node_modules/@mintlify/common": {
-      "version": "1.0.541",
-      "resolved": "https://registry.npmjs.org/@mintlify/common/-/common-1.0.541.tgz",
-      "integrity": "sha512-qvnBjGJZLRH81FtMgKRIj4b3Gyg+TTusGuD69z9EXhq8YTBIBk3KvpJ+VHo+kj1zX1A/twOI3luF09y+cVqGAQ==",
+      "version": "1.0.545",
+      "resolved": "https://registry.npmjs.org/@mintlify/common/-/common-1.0.545.tgz",
+      "integrity": "sha512-0zDdaAyerFwRbMsaaMxCDn60Na6xeRE2pOx1b8zv894j41pWxVWoHZL2upscaXFdkxoq4urcJ3TVO8qksejwEg==",
       "license": "ISC",
       "dependencies": {
         "@asyncapi/parser": "^3.4.0",
-        "@mintlify/mdx": "2.0.11",
+        "@mintlify/mdx": "2.0.13",
         "@mintlify/models": "0.0.230",
         "@mintlify/openapi-parser": "^0.0.8",
-        "@mintlify/validation": "0.1.474",
+        "@mintlify/validation": "0.1.476",
         "@sindresorhus/slugify": "^2.1.1",
         "acorn": "^8.11.2",
         "acorn-jsx": "^5.3.2",
@@ -1237,9 +1237,9 @@
       }
     },
     "node_modules/@mintlify/common/node_modules/@mintlify/mdx": {
-      "version": "2.0.11",
-      "resolved": "https://registry.npmjs.org/@mintlify/mdx/-/mdx-2.0.11.tgz",
-      "integrity": "sha512-yXwuM0BNCxNaJetPrh89c5Q2lhzU2al4QrOM3zLUdrPOdjOpPmv8ewcdiXV/qIhZDpl5Ll9k47dsz33bZjVWTg==",
+      "version": "2.0.13",
+      "resolved": "https://registry.npmjs.org/@mintlify/mdx/-/mdx-2.0.13.tgz",
+      "integrity": "sha512-sAGk0j5COB4P1j2jG10ZYdLOQNhxFAhWX1w0lOXc3RhehVHMtMgImz+OzydR6yWcvH/S8eN0n8VEUy9BYXhe3w==",
       "license": "MIT",
       "dependencies": {
         "@shikijs/transformers": "^3.11.0",
@@ -1362,15 +1362,15 @@
       }
     },
     "node_modules/@mintlify/link-rot": {
-      "version": "3.0.678",
-      "resolved": "https://registry.npmjs.org/@mintlify/link-rot/-/link-rot-3.0.678.tgz",
-      "integrity": "sha512-BZsdUysacTVlP7/acAIJ8GglDyqJY9wFLpyZ+cS9pwR6PF0urs4rSG1wUgEtsR3lKrBp4YpoJCBE4ffIjTONHw==",
+      "version": "3.0.682",
+      "resolved": "https://registry.npmjs.org/@mintlify/link-rot/-/link-rot-3.0.682.tgz",
+      "integrity": "sha512-RsLJdMRMRWM6txY3UAW4g0Nq0xJuTYwvghG6iANbhXDTNH44emLI+fx0F54tY8Bvrkc8PUaWKl9BAr1fRCv8dA==",
       "license": "Elastic-2.0",
       "dependencies": {
-        "@mintlify/common": "1.0.541",
-        "@mintlify/prebuild": "1.0.665",
-        "@mintlify/previewing": "4.0.714",
-        "@mintlify/validation": "0.1.474",
+        "@mintlify/common": "1.0.545",
+        "@mintlify/prebuild": "1.0.669",
+        "@mintlify/previewing": "4.0.718",
+        "@mintlify/validation": "0.1.476",
         "fs-extra": "^11.1.0",
         "unist-util-visit": "^4.1.1"
       },
@@ -1474,15 +1474,15 @@
       }
     },
     "node_modules/@mintlify/prebuild": {
-      "version": "1.0.665",
-      "resolved": "https://registry.npmjs.org/@mintlify/prebuild/-/prebuild-1.0.665.tgz",
-      "integrity": "sha512-ip6DlHdIt2Frx7TTENm4RcPq09wlw2r7/WdxZ364sHkGOiA2uuXyc9wR5z6AN5CaOWZ1ctQ6LcAbypkbUc0flQ==",
+      "version": "1.0.669",
+      "resolved": "https://registry.npmjs.org/@mintlify/prebuild/-/prebuild-1.0.669.tgz",
+      "integrity": "sha512-0nndz9FbmC25YY8VbRRerZMw2i222PgUtkxnswSfKcG3piS4l+hSCScqMECeZTpwHnitIl5QH2KJ0uVFY0i1Cg==",
       "license": "Elastic-2.0",
       "dependencies": {
-        "@mintlify/common": "1.0.541",
+        "@mintlify/common": "1.0.545",
         "@mintlify/openapi-parser": "^0.0.8",
-        "@mintlify/scraping": "4.0.400",
-        "@mintlify/validation": "0.1.474",
+        "@mintlify/scraping": "4.0.404",
+        "@mintlify/validation": "0.1.476",
         "chalk": "^5.3.0",
         "favicons": "^7.2.0",
         "fs-extra": "^11.1.0",
@@ -1542,14 +1542,14 @@
       }
     },
     "node_modules/@mintlify/previewing": {
-      "version": "4.0.714",
-      "resolved": "https://registry.npmjs.org/@mintlify/previewing/-/previewing-4.0.714.tgz",
-      "integrity": "sha512-86PgTXEsgHUMhAty4eT8WYfsuJpKIjRevMUhDUH+GfdUQqGaqsP98FvajhF55vr+xEznd1WoLLP4SVdbx4ufhQ==",
+      "version": "4.0.718",
+      "resolved": "https://registry.npmjs.org/@mintlify/previewing/-/previewing-4.0.718.tgz",
+      "integrity": "sha512-wl/x160OoZ2+HAUj+TPlYlu8KW333nDgCR6mN0LINi8I+8ygHw6Ra+U0EH+dtGssC1luU7JoBkW8rxZUs9UkEw==",
       "license": "Elastic-2.0",
       "dependencies": {
-        "@mintlify/common": "1.0.541",
-        "@mintlify/prebuild": "1.0.665",
-        "@mintlify/validation": "0.1.474",
+        "@mintlify/common": "1.0.545",
+        "@mintlify/prebuild": "1.0.669",
+        "@mintlify/validation": "0.1.476",
         "better-opn": "^3.0.2",
         "chalk": "^5.1.0",
         "chokidar": "^3.5.3",
@@ -1622,12 +1622,12 @@
       }
     },
     "node_modules/@mintlify/scraping": {
-      "version": "4.0.400",
-      "resolved": "https://registry.npmjs.org/@mintlify/scraping/-/scraping-4.0.400.tgz",
-      "integrity": "sha512-x4ErgWCsNNYLr/ROcDWrMySGQEjvdHdXWOYAQio+f50hcRSs1DETrUrZyJZWhYLYUwOeQV4NA+tlmWDof60f1g==",
+      "version": "4.0.404",
+      "resolved": "https://registry.npmjs.org/@mintlify/scraping/-/scraping-4.0.404.tgz",
+      "integrity": "sha512-MDikh7rOtUguTAVbvMcPhTuvInZMh4BoOvLe71ivm0HxEBz4PZq6FiM2hm71KuKUq5viMrRRG8nKPX27OrwQSw==",
       "license": "Elastic-2.0",
       "dependencies": {
-        "@mintlify/common": "1.0.541",
+        "@mintlify/common": "1.0.545",
         "@mintlify/openapi-parser": "^0.0.8",
         "fs-extra": "^11.1.1",
         "hast-util-to-mdast": "^10.1.0",
@@ -1653,11 +1653,12 @@
       }
     },
     "node_modules/@mintlify/validation": {
-      "version": "0.1.474",
-      "resolved": "https://registry.npmjs.org/@mintlify/validation/-/validation-0.1.474.tgz",
-      "integrity": "sha512-jP9q0Fd1CRrBxc4SelDc0PQj+Z7d5E+kuySRxXMSp122Js9Hd0jMb588O1n7dLmedId3fRVauhNSf48FFFUPYQ==",
+      "version": "0.1.476",
+      "resolved": "https://registry.npmjs.org/@mintlify/validation/-/validation-0.1.476.tgz",
+      "integrity": "sha512-gLeOl/cS1KSDvRS/hKiBDCicJTW+Kx7eih4uyWvI8I90WT9MremwEnSw4Pju9erH/m8NdZH4VHjb971T331s7Q==",
       "license": "Elastic-2.0",
       "dependencies": {
+        "@mintlify/mdx": "2.0.13",
         "@mintlify/models": "0.0.230",
         "arktype": "^2.1.20",
         "lcm": "^0.0.3",
@@ -1667,6 +1668,131 @@
         "zod-to-json-schema": "^3.20.3"
       }
     },
+    "node_modules/@mintlify/validation/node_modules/@mintlify/mdx": {
+      "version": "2.0.13",
+      "resolved": "https://registry.npmjs.org/@mintlify/mdx/-/mdx-2.0.13.tgz",
+      "integrity": "sha512-sAGk0j5COB4P1j2jG10ZYdLOQNhxFAhWX1w0lOXc3RhehVHMtMgImz+OzydR6yWcvH/S8eN0n8VEUy9BYXhe3w==",
+      "license": "MIT",
+      "dependencies": {
+        "@shikijs/transformers": "^3.11.0",
+        "@shikijs/twoslash": "^3.12.2",
+        "hast-util-to-string": "^3.0.1",
+        "mdast-util-from-markdown": "^2.0.2",
+        "mdast-util-gfm": "^3.1.0",
+        "mdast-util-mdx-jsx": "^3.2.0",
+        "mdast-util-to-hast": "^13.2.0",
+        "next-mdx-remote-client": "^1.0.3",
+        "rehype-katex": "^7.0.1",
+        "remark-gfm": "^4.0.0",
+        "remark-math": "^6.0.0",
+        "remark-smartypants": "^3.0.2",
+        "shiki": "^3.11.0",
+        "unified": "^11.0.0",
+        "unist-util-visit": "^5.0.0"
+      },
+      "peerDependencies": {
+        "@radix-ui/react-popover": "^1.1.15",
+        "react": "^18.3.1",
+        "react-dom": "^18.3.1"
+      }
+    },
+    "node_modules/@mintlify/validation/node_modules/@radix-ui/react-popover": {
+      "version": "1.1.15",
+      "resolved": "https://registry.npmjs.org/@radix-ui/react-popover/-/react-popover-1.1.15.tgz",
+      "integrity": "sha512-kr0X2+6Yy/vJzLYJUPCZEc8SfQcf+1COFoAqauJm74umQhta9M7lNJHP7QQS3vkvcGLQUbWpMzwrXYwrYztHKA==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@radix-ui/primitive": "1.1.3",
+        "@radix-ui/react-compose-refs": "1.1.2",
+        "@radix-ui/react-context": "1.1.2",
+        "@radix-ui/react-dismissable-layer": "1.1.11",
+        "@radix-ui/react-focus-guards": "1.1.3",
+        "@radix-ui/react-focus-scope": "1.1.7",
+        "@radix-ui/react-id": "1.1.1",
+        "@radix-ui/react-popper": "1.2.8",
+        "@radix-ui/react-portal": "1.1.9",
+        "@radix-ui/react-presence": "1.1.5",
+        "@radix-ui/react-primitive": "2.1.3",
+        "@radix-ui/react-slot": "1.2.3",
+        "@radix-ui/react-use-controllable-state": "1.2.2",
+        "aria-hidden": "^1.2.4",
+        "react-remove-scroll": "^2.6.3"
+      },
+      "peerDependencies": {
+        "@types/react": "*",
+        "@types/react-dom": "*",
+        "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc",
+        "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        },
+        "@types/react-dom": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@mintlify/validation/node_modules/next-mdx-remote-client": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/next-mdx-remote-client/-/next-mdx-remote-client-1.1.2.tgz",
+      "integrity": "sha512-LZJxBU420dTZsbWOrNYZXkahGJu8lNKxLTrQrZl4JUsKeFtp91yA78dHMTfOcp7UAud3txhM1tayyoKFq4tw7A==",
+      "license": "MPL 2.0",
+      "dependencies": {
+        "@babel/code-frame": "^7.27.1",
+        "@mdx-js/mdx": "^3.1.0",
+        "@mdx-js/react": "^3.1.0",
+        "remark-mdx-remove-esm": "^1.2.0",
+        "serialize-error": "^12.0.0",
+        "vfile": "^6.0.3",
+        "vfile-matter": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=18.18.0"
+      },
+      "peerDependencies": {
+        "react": ">= 18.3.0 < 19.0.0",
+        "react-dom": ">= 18.3.0 < 19.0.0"
+      }
+    },
+    "node_modules/@mintlify/validation/node_modules/react": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
+      "integrity": "sha512-wS+hAgJShR0KhEvPJArfuPVN1+Hz1t0Y6n5jLrGQbkb4urgPE/0Rve+1kMB1v/oWgHgm4WIcV+i7F2pTVj+2iQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/@mintlify/validation/node_modules/react-dom": {
+      "version": "18.3.1",
+      "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-18.3.1.tgz",
+      "integrity": "sha512-5m4nQKp+rZRb09LNH59GM4BxTh9251/ylbKIbpe7TpGxfJ+9kv6BLkLBXIjjspbgbnIBNqlI23tRnTWT0snUIw==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0",
+        "scheduler": "^0.23.2"
+      },
+      "peerDependencies": {
+        "react": "^18.3.1"
+      }
+    },
+    "node_modules/@mintlify/validation/node_modules/scheduler": {
+      "version": "0.23.2",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
+      "integrity": "sha512-UOShsPwz7NrMUqhR6t0hWjFduvOzbtv7toDH1/hIrfRNIDBnnBWd0CwJTGvTpngVlmwGCdP9/Zl/tVrDqcuYzQ==",
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "loose-envify": "^1.1.0"
+      }
+    },
     "node_modules/@nodelib/fs.scandir": {
       "version": "2.1.5",
       "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -2776,9 +2902,9 @@
       }
     },
     "node_modules/@types/react": {
-      "version": "19.1.13",
-      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.1.13.tgz",
-      "integrity": "sha512-hHkbU/eoO3EG5/MZkuFSKmYqPbSVk5byPFa3e7y/8TybHiLMACgI8seVYlicwk7H5K/rI2px9xrQp/C+AUDTiQ==",
+      "version": "19.1.15",
+      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.1.15.tgz",
+      "integrity": "sha512-+kLxJpaJzXybyDyFXYADyP1cznTO8HSuBpenGlnKOAkH4hyNINiywvXS/tGJhsrGGP/gM185RA3xpjY0Yg4erA==",
       "license": "MIT",
       "peer": true,
       "dependencies": {
@@ -3240,9 +3366,9 @@
       "license": "Apache-2.0"
     },
     "node_modules/bare-fs": {
-      "version": "4.4.4",
-      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.4.4.tgz",
-      "integrity": "sha512-Q8yxM1eLhJfuM7KXVP3zjhBvtMJCYRByoTT+wHXjpdMELv0xICFJX+1w4c7csa+WZEOsq4ItJ4RGwvzid6m/dw==",
+      "version": "4.4.5",
+      "resolved": "https://registry.npmjs.org/bare-fs/-/bare-fs-4.4.5.tgz",
+      "integrity": "sha512-TCtu93KGLu6/aiGWzMr12TmSRS6nKdfhAnzTQRbXoSWxkbb9eRd53jQ51jG7g1gYjjtto3hbBrrhzg6djcgiKg==",
       "license": "Apache-2.0",
       "optional": true,
       "dependencies": {
@@ -8503,12 +8629,12 @@
       }
     },
     "node_modules/mintlify": {
-      "version": "4.2.127",
-      "resolved": "https://registry.npmjs.org/mintlify/-/mintlify-4.2.127.tgz",
-      "integrity": "sha512-+VIzpsKrf7JUKOPOTxvMyOeITyE8hrpUjGK4NNwTZbV5KXxntkmF+4AV8Qm3Atu5RveBzpWA1aOXpY3P7RHdKA==",
+      "version": "4.2.131",
+      "resolved": "https://registry.npmjs.org/mintlify/-/mintlify-4.2.131.tgz",
+      "integrity": "sha512-207Zknz/nq6lkQSyqIBT38zp8nwiDM9oKVJp6/afwfHI2r+YJNfF6zorj6u6MPT5mg6Hp9Xzcpg5ncvH/yJwaA==",
       "license": "Elastic-2.0",
       "dependencies": {
-        "@mintlify/cli": "4.0.731"
+        "@mintlify/cli": "4.0.735"
       },
       "bin": {
         "mint": "index.js",
diff --git a/package.json b/package.json
index d651dc1..c9a889d 100644
--- a/package.json
+++ b/package.json
@@ -4,6 +4,6 @@
     "links": "mintlify broken-links"
   },
   "dependencies": {
-    "mintlify": "^4.2.127"
+    "mintlify": "^4.2.131"
   }
 }

From 14c40e481e6b884254ee2810c1b6605ce1d4409e Mon Sep 17 00:00:00 2001
From: Nicolas Girardot <nicolas.girardot+github@gmail.com>
Date: Mon, 29 Sep 2025 17:37:57 +0200
Subject: [PATCH 2/6] feat: put back headers

---
 getting-started/mobile-sdk.mdx       | 7 +++++++
 getting-started/react-native-sdk.mdx | 8 ++++++++
 getting-started/sdk.mdx              | 6 ++++++
 3 files changed, 21 insertions(+)

diff --git a/getting-started/mobile-sdk.mdx b/getting-started/mobile-sdk.mdx
index edb0bd5..6aa1d85 100644
--- a/getting-started/mobile-sdk.mdx
+++ b/getting-started/mobile-sdk.mdx
@@ -1,3 +1,10 @@
+---
+title: Mobile SDK
+description: Integrate Edgee with a mobile application.
+icon: mobile
+---
+
+import EdgeeSdk from '/snippets/edgee-sdk.mdx';
 
 <EdgeeSdk />
 
diff --git a/getting-started/react-native-sdk.mdx b/getting-started/react-native-sdk.mdx
index 57e2708..56d7383 100644
--- a/getting-started/react-native-sdk.mdx
+++ b/getting-started/react-native-sdk.mdx
@@ -1,3 +1,11 @@
+---
+title: React Native SDK
+description: Integrate Edgee with a React Native application.
+icon: code
+---
+
+import EdgeeSdk from '/snippets/edgee-sdk.mdx';
+
 
 <EdgeeSdk />
 
diff --git a/getting-started/sdk.mdx b/getting-started/sdk.mdx
index 8abb707..4ac28f0 100644
--- a/getting-started/sdk.mdx
+++ b/getting-started/sdk.mdx
@@ -1,3 +1,9 @@
+---
+title: Choose your SDK
+description: Learn how to integrate the Edgee SDK to interact with Edgee services.
+icon: code
+---
+import EdgeeSdk from '/snippets/edgee-sdk.mdx';
 
 <EdgeeSdk />
 

From 2fd481feb950db897805583bbd98f4bfb0e36827 Mon Sep 17 00:00:00 2001
From: Nicolas Girardot <nicolas.girardot+github@gmail.com>
Date: Tue, 21 Oct 2025 17:13:02 +0200
Subject: [PATCH 3/6] docs: add native cookie support documentation for
 LinkedIn CAPI

Add comprehensive documentation for LinkedIn CAPI native cookie support, explaining how Edgee manages li_fat_id attribution at the edge level.

Key additions:
- New 'Native Cookie Support for LinkedIn Attribution' section
- Documentation of cookie format, expiry, and behavior
- Consent management modes (safe/strong/always) with examples
- Benefits: no JavaScript required, ad blocker resistant, cross-domain support
- Updated Getting Started to include mode setting configuration

This documentation helps users understand how to configure and leverage edge-level cookie management for persistent LinkedIn attribution tracking.

Ref: EDGEE-875
---
 components/data-collection/linkedin-capi.mdx | 97 ++++++++++++++------
 1 file changed, 69 insertions(+), 28 deletions(-)

diff --git a/components/data-collection/linkedin-capi.mdx b/components/data-collection/linkedin-capi.mdx
index b0ab892..809f2ec 100644
--- a/components/data-collection/linkedin-capi.mdx
+++ b/components/data-collection/linkedin-capi.mdx
@@ -1,11 +1,3 @@
----
-title: LinkedIn Conversions API
-description: Send your conversion events directly to LinkedIn's Conversions API (CAPI), **now at the edge**.
----
-
-<img src="/images/banners/linkedin-capi.png" className="rounded-lg" noZoom />
-
-import EdgeeSdk from '/snippets/edgee-sdk.mdx';
 
 <EdgeeSdk />
 
@@ -34,6 +26,54 @@ Here's how Edgee events map to LinkedIn CAPI events:
 
 When you make a `user` call, Edgee stores the user's data (user_id, anonymous_id, and properties) on the device. This enables proper attribution for subsequent page views and events.
 
+## Native Cookie Support for LinkedIn Attribution
+
+Edgee automatically manages LinkedIn's first-party attribution cookie (`_li_fat_id`) at the edge level, ensuring proper tracking across page views and domain boundaries.
+
+### How it Works
+
+When a user lands on your site from a LinkedIn ad with the `li_fat_id` URL parameter (e.g., `?li_fat_id=xxx`), Edgee:
+
+1. **Captures the parameter** from the URL
+2. **Sets a cookie** (`_li_fat_id`) with a 90-day expiry
+3. **Maintains attribution** across all subsequent page views and conversions
+
+This ensures LinkedIn can properly attribute conversions even when users navigate through your site or return later.
+
+### Cookie Format
+
+- **Name**: `_li_fat_id`
+- **Format**: `li.1.{timestamp}.{li_fat_id}`
+- **Expiry**: 90 days
+- **Purpose**: LinkedIn first-party ad tracking attribution
+
+### Consent Management
+
+The `mode` setting controls cookie behavior based on user consent:
+
+- **`safe`** (default): Only sets the cookie when explicit consent is granted
+- **`strong`**: Sets the cookie unless consent is explicitly denied
+- **`always`**: Always sets the cookie (bypasses consent management)
+
+Configure the mode in your component settings:
+
+```json
+{
+  "components": {
+    "edgee/linkedin-capi": {
+      "mode": "strong"
+    }
+  }
+}
+```
+
+### Benefits
+
+- **No JavaScript required**: Cookie management happens at the edge, before the page loads
+- **Works with ad blockers**: Server-side tracking ensures attribution isn't blocked
+- **Cross-domain support**: Perfect for scenarios like Shopify checkout flows
+- **Automatic persistence**: Users don't need the `li_fat_id` parameter on every page
+
 
 ## Getting Started
 
@@ -41,8 +81,9 @@ When you make a `user` call, Edgee stores the user's data (user_id, anonymous_id
 
 1. Open the Edgee console and navigate to your project's Components.
 2. Select "Add a component" and choose `edgee/linkedin-capi` from the list of available components.
-3. Enter the following credentials:
+3. Enter the following settings:
    - `LinkedIn Access Token`: Your LinkedIn CAPI access token
+   - `Native Cookies Mode`: Choose your consent mode (`safe`, `strong`, or `always`)
 4. Click Save to complete the setup.
 
 To know how to get your access token , visit the [LinkedIn Marketing API documentation](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api).
@@ -66,7 +107,7 @@ When configuring the component in your **Edgee Data Layer** or within SDK calls,
 3. Send a test event through Edgee
 4. Verify that the event is received by LinkedIn
 
-For more details on LinkedIn Conversions API implementation, refer to the 
+For more details on LinkedIn Conversions API implementation, refer to the
 [official LinkedIn CAPI documentation](https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/conversions-api).
 
 
@@ -74,29 +115,29 @@ For more details on LinkedIn Conversions API implementation, refer to the
 
 Implementing the LinkedIn Conversion API via Edgee is simple and straightforward. The next sections will guide you on:
 
-1. How to create a conversion pixel on LinkedIn  
-2. How to get your access token and set up LinkedIn Conversion in Edgee  
+1. How to create a conversion pixel on LinkedIn
+2. How to get your access token and set up LinkedIn Conversion in Edgee
 3. An implementation example
 
 ### Creating a LinkedIn Conversion API Pixel in a Nutshell
 
-* Go to your LinkedIn Advertising account, then navigate to **Data \-\> Signal Manager** and select **Direct API**.  
-* Click on **Direct API** and then on **Create Conversion**.  
-* Fill in your Conversion tracking goal.  
-* Select the correct category for the conversion.  
+* Go to your LinkedIn Advertising account, then navigate to **Data \-\> Signal Manager** and select **Direct API**.
+* Click on **Direct API** and then on **Create Conversion**.
+* Fill in your Conversion tracking goal.
+* Select the correct category for the conversion.
 * In the review section, associate the CAPI conversion with your campaign.
 
 ### LinkedIn Access Token and Setup in Edgee
 
-1. Go to your LinkedIn Advertising account, then navigate to **Data \-\> Signal Manager** and select **Direct API**.  
- 
+1. Go to your LinkedIn Advertising account, then navigate to **Data \-\> Signal Manager** and select **Direct API**.
+
   <img  src="/images/LinkedIn/linkedSignalManager.png" />
 
 
-2. Scroll down to the "**Direct API access token**" section. Follow LinkedIn's steps and copy your LinkedIn Access Token. This Access Token is consistent for all future LinkedIn CAPI implementations.  
+2. Scroll down to the "**Direct API access token**" section. Follow LinkedIn's steps and copy your LinkedIn Access Token. This Access Token is consistent for all future LinkedIn CAPI implementations.
      <img src="/images/LinkedIn/linkedInAPIaccess.png" />
 
-3. Go to your Edgee account and project, then navigate to **Components** (learn to set up components [here](https://www.edgee.cloud/docs/getting-started/component-configuration)). Select LinkedIn and input your token.  
+3. Go to your Edgee account and project, then navigate to **Components** (learn to set up components [here](https://www.edgee.cloud/docs/getting-started/component-configuration)). Select LinkedIn and input your token.
      <img  src="/images/LinkedIn/linkedin_api_edgee.png" />
 
 
@@ -114,8 +155,8 @@ You will find your conversion pixel that can be used for CAPI, and an associated
      <img  src="/images/LinkedIn/conversion_pixelD.png" />
 
 
-2. Once you have the ID, you can use the conversion to track in two different ways using our SDK:  
-   a.  Track the conversion of a user when you have their email address (e.g., from a form submission).  
+2. Once you have the ID, you can use the conversion to track in two different ways using our SDK:
+   a.  Track the conversion of a user when you have their email address (e.g., from a form submission).
    b.  Track standard landing page conversions without having the user's email.
 
 ### Example: Tracking a form submission where you have an email address:
@@ -134,17 +175,17 @@ edgee.track({ name: "urn:lla:llaPartnerConversion:[YOUR_CONVERSION_PIXEL_ID]"});
 ```
 
 <Note>Note: replace `[YOUR_CONVERSION_PIXEL_ID]` with your LinkedIn CAPI ID.</Note>
-   
+
 
 
 ```
 <script>
-const trackLinkedInFormSubmission = () => {   
+const trackLinkedInFormSubmission = () => {
   edgee.user({ "properties": { "email": "me@example.com"}      });
-  edgee.track({name:"urn:lla:llaPartnerConversion:[YOUR_CONVERSION_PIXEL_ID]"}  );};  
+  edgee.track({name:"urn:lla:llaPartnerConversion:[YOUR_CONVERSION_PIXEL_ID]"}  );};
 if (!window.edgee) {
     window.addEventListener('edgee:loaded', trackLinkedInFormSubmission);
-  } else {    
+  } else {
         trackLinkedFormSubmission();
  }
 </script>
@@ -179,12 +220,12 @@ The implementation of these events, such as Landing Page, is very straightforwar
 
 If you have InsightTag and want your LinkedIn CAPI to work alongside InsightTag, `event_id` can be used to deduplicate conversions.
 
-1. Create a JavaScript that will generate a unique number for every new event.  
+1. Create a JavaScript that will generate a unique number for every new event.
 2. Update the Edgee track SDK to collect `event_id` by adding it to the properties (shown below) and ensure the ID is also provided to your InsightTag.
 
 ```javascript
 edgee.track( {
-  name: "urn:lla:llaPartnerConversion:[YOUR_CONVERSION_PIXEL_ID]",    
+  name: "urn:lla:llaPartnerConversion:[YOUR_CONVERSION_PIXEL_ID]",
   properties: {event_id: "1234543"}
   });
 ```

From b97733caa536f923eb0d2f9ba94670b0ceee0212 Mon Sep 17 00:00:00 2001
From: Nicolas Girardot <nicolas.girardot+github@gmail.com>
Date: Tue, 21 Oct 2025 17:22:57 +0200
Subject: [PATCH 4/6] docs: update to reflect last-touch attribution behavior

Clarify that LinkedIn native cookie uses last-touch attribution:
- Cookie updates when new li_fat_id appears in URL
- Credits most recent LinkedIn ad click
- Ideal for remarketing campaigns and conversion optimization

This provides transparency about the attribution model and helps users understand how LinkedIn attribution works.
---
 components/data-collection/linkedin-capi.mdx | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/components/data-collection/linkedin-capi.mdx b/components/data-collection/linkedin-capi.mdx
index 809f2ec..5eb7ad0 100644
--- a/components/data-collection/linkedin-capi.mdx
+++ b/components/data-collection/linkedin-capi.mdx
@@ -32,13 +32,14 @@ Edgee automatically manages LinkedIn's first-party attribution cookie (`_li_fat_
 
 ### How it Works
 
-When a user lands on your site from a LinkedIn ad with the `li_fat_id` URL parameter (e.g., `?li_fat_id=xxx`), Edgee:
+Edgee uses **last-touch attribution** for LinkedIn's `li_fat_id` parameter:
 
-1. **Captures the parameter** from the URL
-2. **Sets a cookie** (`_li_fat_id`) with a 90-day expiry
-3. **Maintains attribution** across all subsequent page views and conversions
+1. **First LinkedIn ad click**: Captures `li_fat_id` from URL and sets the `_li_fat_id` cookie (90-day expiry)
+2. **Subsequent ad clicks**: Cookie automatically **updates** with the new `li_fat_id` from the URL
+3. **Regular page views** (no URL parameter): Cookie value persists and is used for attribution
+4. **Return visits**: Attribution maintained for 90 days from the last update
 
-This ensures LinkedIn can properly attribute conversions even when users navigate through your site or return later.
+This **last-touch** approach credits the most recent LinkedIn ad that brought the user to your site, which is ideal for remarketing campaigns and conversion optimization.
 
 ### Cookie Format
 

From 4624c376ea118fd07dae54fa9ee759e065f9d498 Mon Sep 17 00:00:00 2001
From: Nicolas Girardot <nicolas.girardot+github@gmail.com>
Date: Tue, 21 Oct 2025 17:47:12 +0200
Subject: [PATCH 5/6] feat: add header

---
 components/data-collection/linkedin-capi.mdx | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/data-collection/linkedin-capi.mdx b/components/data-collection/linkedin-capi.mdx
index 5eb7ad0..43c0af2 100644
--- a/components/data-collection/linkedin-capi.mdx
+++ b/components/data-collection/linkedin-capi.mdx
@@ -1,3 +1,11 @@
+---
+title: LinkedIn Conversions API
+description: Send your conversion events directly to LinkedIn's Conversions API (CAPI), **now at the edge**.
+---
+
+<img src="/images/banners/linkedin-capi.png" className="rounded-lg" noZoom />
+
+import EdgeeSdk from '/snippets/edgee-sdk.mdx';
 
 <EdgeeSdk />
 

From 85e4a002a56b91104c26b7510d3a8a95a0df9496 Mon Sep 17 00:00:00 2001
From: Nicolas Girardot <nicolas.girardot+github@gmail.com>
Date: Tue, 21 Oct 2025 18:00:42 +0200
Subject: [PATCH 6/6] docs: update cookie format to reflect raw value storage

Clarify that li_fat_id is stored as-is without timestamp wrapping.
---
 components/data-collection/linkedin-capi.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/data-collection/linkedin-capi.mdx b/components/data-collection/linkedin-capi.mdx
index 43c0af2..f2b8242 100644
--- a/components/data-collection/linkedin-capi.mdx
+++ b/components/data-collection/linkedin-capi.mdx
@@ -52,7 +52,7 @@ This **last-touch** approach credits the most recent LinkedIn ad that brought th
 ### Cookie Format
 
 - **Name**: `_li_fat_id`
-- **Format**: `li.1.{timestamp}.{li_fat_id}`
+- **Value**: Raw `li_fat_id` value from LinkedIn (stored as-is)
 - **Expiry**: 90 days
 - **Purpose**: LinkedIn first-party ad tracking attribution