Ahrefs Web Analytics integration

.changeset/stupid-points-taste.md

@@ -0,0 +1,5 @@
+---
+"@gitbook/integration-ahrefs": patch
+---
+
+Ahrefs Web Analytics integration

README.md

@@ -24,6 +24,7 @@ Packages are the core of our integration platform, containing the code for the f
 
 It also hosts the default integrations provided by the GitBook team:
 
+- [`ahrefs`](./integrations/ahrefs/)
 - [`arcade`](./integrations/arcade/)
 - [`fathom`](./integrations/fathom/)
 - [`figma`](./integrations/figma/)

bun.lock

@@ -14,6 +14,18 @@
         "wrangler": "^2.1.12",
       },
     },
+    "integrations/ahrefs": {
+      "name": "@gitbook/integration-ahrefs",
+      "version": "0.1.0",
+      "dependencies": {
+        "@gitbook/api": "*",
+        "@gitbook/runtime": "*",
+      },
+      "devDependencies": {
+        "@gitbook/cli": "workspace:*",
+        "@gitbook/tsconfig": "workspace:*",
+      },
+    },
     "integrations/arcade": {
       "name": "@gitbook/integration-arcade",
       "version": "0.2.2",
@@ -941,6 +953,8 @@
 
     "@gitbook/document": ["@gitbook/document@workspace:packages/document"],
 
+    "@gitbook/integration-ahrefs": ["@gitbook/integration-ahrefs@workspace:integrations/ahrefs"],
+
     "@gitbook/integration-arcade": ["@gitbook/integration-arcade@workspace:integrations/arcade"],
 
     "@gitbook/integration-bucket": ["@gitbook/integration-bucket@workspace:integrations/bucket"],

integrations/ahrefs/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @gitbook/integration-ahrefs
+
+## 0.1.0
+
+### Minor Changes
+
+Added Ahrefs Web Analytics integration.

integrations/ahrefs/gitbook-manifest.yaml

@@ -0,0 +1,42 @@
+name: ahrefs
+title: Ahrefs
+icon: ./assets/icon.png
+previewImages:
+    - ./assets/ahrefs-preview.png
+description: Receive GitBook traffic insights directly in your Ahrefs dashboard.
+externalLinks:
+    - label: Documentation
+      url: https://www.gitbook.com/integrations/ahrefs
+visibility: public
+script: ./src/index.ts
+# The following scope(s) are available only to GitBook Staff
+# See https://developer.gitbook.com/integrations/configurations#scopes
+scopes:
+    - site:script:inject
+organization: gitbook
+contentSecurityPolicy:
+    script-src: https://analytics.ahrefs.com
+    connect-src: analytics.ahrefs.com
+summary: |
+    # Overview
+    [Ahrefs Web Analytics](https://ahrefs.com/web-analytics) is a privacy-friendly analytics platform that provides you with a simple and free solution to track and report your published sites' traffic. No cookies by default. Just the metrics you need.
+
+    # How it works
+    The Ahrefs integration allows you to track traffic in your published sites from your Ahrefs dashboard.
+
+    Automatic tracking in your documentation: Each of your connected GitBook sites will fetch the Ahrefs Web Analytics tracking script and inject it in your published content.
+
+    # Configure
+    Enable the Ahrefs integration by navigating to organization settings. The integration can be enabled on single or multiple sites.
+categories:
+    - analytics
+configurations:
+    site:
+        properties:
+            tracking_id:
+                type: string
+                title: Tracking ID
+                description: Look for this in your Ahrefs Web Analytics account.
+        required:
+            - tracking_id
+target: site

integrations/ahrefs/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "@gitbook/integration-ahrefs",
+    "version": "0.1.0",
+    "private": true,
+    "dependencies": {
+        "@gitbook/api": "*",
+        "@gitbook/runtime": "*"
+    },
+    "devDependencies": {
+        "@gitbook/cli": "workspace:*",
+        "@gitbook/tsconfig": "workspace:*"
+    },
+    "scripts": {
+        "typecheck": "tsc --noEmit",
+        "publish-integrations-staging": "gitbook publish .",
+        "check": "gitbook check",
+        "publish-integrations": "gitbook publish ."
+    }
+}

integrations/ahrefs/src/index.ts

@@ -0,0 +1,38 @@
+import {
+    createIntegration,
+    FetchPublishScriptEventCallback,
+    RuntimeContext,
+    RuntimeEnvironment,
+} from '@gitbook/runtime';
+
+import script from './script.raw.js';
+
+type AhrefsRuntimeContext = RuntimeContext<
+    RuntimeEnvironment<
+        {},
+        {
+            tracking_id?: string;
+        }
+    >
+>;
+
+export const handleFetchEvent: FetchPublishScriptEventCallback = async (
+    event,
+    { environment }: AhrefsRuntimeContext,
+) => {
+    const trackingId = environment.siteInstallation?.configuration?.tracking_id;
+    if (!trackingId) {
+        return;
+    }
+
+    return new Response((script as string).replace('<TO_REPLACE>', trackingId), {
+        headers: {
+            'Content-Type': 'application/javascript',
+            'Cache-Control': 'max-age=604800',
+        },
+    });
+};
+
+export default createIntegration<AhrefsRuntimeContext>({
+    fetch_published_script: handleFetchEvent,
+});

integrations/ahrefs/src/script.raw.js

@@ -0,0 +1,10 @@
+(function (win, doc) {
+    const trackingID = '<TO_REPLACE>';
+    const js = doc.createElement('script');
+    js.type = 'text/javascript'
+    js.async = true;
+    js.src = 'https://analytics.ahrefs.com/analytics.js';
+    js.dataset['key'] = trackingID;
+    const first = doc.getElementsByTagName('script')[0];
+    first.parentNode.insertBefore(js, first);
+})(window, document);

integrations/ahrefs/tsconfig.json

@@ -0,0 +1,3 @@
+{
+    "extends": "@gitbook/tsconfig/integration.json"
+}