Ahrefs Analytics

Ahrefs Web Analytics is a cookieless analytics product configured with a single project key. The ahrefsAnalytics() helper wires that key into the data-key attribute that Ahrefs' loader reads at startup.

Integrate with c15t

import { type ReactNode } from 'react';
import { ConsentManagerProvider } from '@c15t/react';
import { ahrefsAnalytics } from '@c15t/scripts/ahrefs-analytics';

const scripts = [
  ahrefsAnalytics({
    key: 'your-ahrefs-project-key',
  }),
];

export function ConsentProvider({ children }: { children: ReactNode }) {
  return (
    <ConsentManagerProvider
      options={{
        mode: 'hosted',
        backendURL: 'https://your-instance.c15t.dev',
        scripts,
      }}
    >
      {children}
    </ConsentManagerProvider>
  );
}

How c15t loads it

• Category: measurement (Analytics)
• Loads when: measurement consent is granted
• On revocation: unloaded — c15t removes the script element from the DOM. Ahrefs Web Analytics is cookieless, so no client-side state needs clearing.

To run from a custom loader URL (for example a self-hosted proxy):

ahrefsAnalytics({
  key: 'your-ahrefs-project-key',
  scriptUrl: 'https://analytics.example.com/analytics.js',
});

Once loaded, Ahrefs exposes its runtime API on window.AhrefsAnalytics. The c15t helper only models the serializable script configuration — calls to window.AhrefsAnalytics.sendEvent(...) happen in your application code as needed.

Tracking events in your app

c15t gates the Ahrefs Analytics script from loading until measurement consent is granted. Your application code that calls Ahrefs' runtime API (window.AhrefsAnalytics.sendEvent) is not automatically gated — window.AhrefsAnalytics does not exist until the script is loaded, so unguarded calls before consent throw.

Guard event calls by checking consent state. From React:

import { useCallback } from 'react';
import { useConsentManager } from '@c15t/react';

function SignupExample() {
  const { has } = useConsentManager();

  const trackSignup = useCallback(() => {
    if (has('measurement')) {
      window.AhrefsAnalytics?.sendEvent('signup');
    }
  }, [has]);

  // Call trackSignup() from an event handler after signup succeeds.
}

From plain JavaScript:

import { getOrCreateConsentRuntime } from 'c15t';

const { consentStore } = getOrCreateConsentRuntime();

if (consentStore.getState().has('measurement')) {
  window.AhrefsAnalytics?.sendEvent('signup');
}

Types

AhrefsAnalyticsOptions

Script