# Introduction

Cookie3 is an AI data layer for Web3 enterprise analytics across the whole funnel, trusted by 300+ top projects including Mantle, Polygon, Polkastarter, and Kyberswap. \
\
With a robust [growth suite](https://app.cookie3.co/signup?utm_source=docs\&utm_medium=docs), including Cookie3 Analytics, Community engagement, and KOL Intelligence, Cookie3 empowers projects to track it all from yaps to swaps providing complete visibility into the full off and onchain user journey.

{% embed url="<https://youtu.be/rdCBy8_9z6k>" %}

## Offchain & Onchain Analytics

The most advanced behavioral AI analytics platform, trusted by over 300 dApps:

* Track website traffic and measure attribution.
* Trach the full onchain & offchain user journey.
* Evaluate marketing performance through to onchain conversion events.
* Gain insights into community quality and preferences with combined on-chain and off-chain data

## KOL Intelligence

The first platform to evaluate KOL performance in Web3.

* Automatically monitor KOL and Ambassador engagement, eliminating the need for endless Twitter scrolling to find relevant posts.
* Correlate social media content with token performance and analyze brand sentiment.&#x20;

#### If you haven't already, [click here to sign up for free](https://app.cookie3.co/signup?utm_source=docs\&utm_medium=docs)


# Register your account

Learn how to get full access to the Cookie3 Analytics app.

Cookie3 provides a streamlined registration process to ensure users can quickly access its analytics tools.

You can access Cookie3 by going to [app.cookie3.co](https://app.cookie3.co/). You’ll be able to see different tools but you can't interact with them yet, as you haven’t created an account with the full access.

Click on Sign up button in the left bottom corner and follow the account creation steps.

Below is a step-by-step guide to account registration and onboarding.&#x20;

{% embed url="<https://youtu.be/nrbkddooP2s>" %}


# Setup your site or app

Cookie3 Analytics provides insights beyond traditional web metrics, including wallet activity on EVM blockchains, TON, and Solana.

## Introduction

<figure><img src="/files/BjbgWE01cbs3q8dYuYll" alt=""><figcaption></figcaption></figure>

In the world of Web3, understanding your users extends far beyond traditional web analytics. Cookie3 Analytics is designed for the decentralized future, enabling you to track not only visitor behavior but also valuable insights from users’ wallets on EVM blockchains, TON, and the Solana network. This means you get full attribution, real-time wallet data, and deeper onchain analytics, giving you a complete view of your audience across multiple networks.

With Cookie3, you can dive into advanced features like analyzing wallet activity, setting up custom event tracking, and seamlessly handling user consent—all while respecting privacy and Web3 principles. This guide will show you how to integrate Cookie3 Analytics with popular Web3 tech stacks and unlock its full potential through detailed setup instructions and pro tips for maximizing the power of your tracking snippet.


# Add your website or app

This article explains how to add a website or app to Cookie3 Analytics. In next steps, we'll go through installing the Cookie3 Analytics snippet

## How to add your website or app to Cookie3 Analytics

Simply go to Cookie3 Analytics and click on the "Website Analytics" menu item in the sidebar navigation panel. Over there, click on the "Add a website" button to initiate the process.

### Adding multiple websites or apps to Cookie3 Analytics

If you'd like to add another website or app to track in the Cookie3 Analytics app, open the Cookie3 Analytics app and in the sidebar navigation panel and click on the "Manage websites" item. Once there click on the "Add a new website" button.

## Configuring your website or app

### Add your domain name

After creating your Cookie3 Analytics account, you can start tracking your dApp, website or Telegram mini-app traffic by adding its domain name.

* **Important:** Remove the `https` and `www` prefixes from the URL, leaving only the hostname so it looks like this `yourdomain.com`.
* **Example:**
  * If your website URL is `https://www.yourdomain.com`, enter `yourdomain.com` in the “**Domain**” field.

{% hint style="info" %}
**The added domain doesn’t need to match the exact domain your app is hosted on**

* The domain entered in Cookie3 Analytics does not have to match the actual domain where you install the tracking snippet.
* Think of the “**Domain**” field more as a **site ID**. This allows flexibility in your setup depending on your specific needs.
* For example, if you’re unsure what the actual URL of your Telegram mini-app is or you’re about to change the URL of your website – it doesn’t matter! We’re still continue tracking the data for it \</aside>
  {% endhint %}

### **Tracking Multiple Subdomains or Apps With One Setup**

If your site operates across multiple subdomains, such as `docs.yourdomain.com` or `app.yourdomain.com`, follow these steps:

1. Add your main domain name (e.g., `yourdomain.com`) to your Cookie3 Analytics account.
2. Use the same tracking snippet across all subdomains.
3. This setup ensures that the visitor session remains active across both the main site and its subdomains.
4. This approach allows for comprehensive tracking across your entire domain ecosystem, providing a holistic view of user behaviour and interactions.

### **Tracking a Specific Subdomain Separately**

If you want to track a subdomain independently from the main domain, you can do so.

* For tracking `https://blog.yourdomain.com` separately, enter `blog.yourdomain.com` in the “**Domain**” field.
* This allows you to track and analyze the performance of your blog separately from your main website.
* You can set up different tracking snippets for each subdomain you want to monitor independently.

This approach offers flexibility in your analytics setup, allowing you to tailor your tracking strategy to your specific needs. Whether you're monitoring a single domain, multiple subdomains, or separate entities within your digital ecosystem, Cookie3 Analytics provides the tools to capture and analyze user behavior effectively.


# Install Cookie3 snippet in your website or app

This article explains how to install the Cookie3 Analytics snippet on your website, dApp or Telegram mini-app

## In-app configuration

Congrats! You have just added your app to your Cookie3 Analytics account. You can now see a new screen with additional details:

<figure><img src="/files/d9JOHTXEsV5nJsdMdZar" alt="" width="375"><figcaption><p>In-app configuration panel</p></figcaption></figure>

### Choosing your technology

To integrate your website with Cookie3 Analytics you need to insert the Cookie3 Analytics **tracking snippet** into the header section of your site. There are multiple ways to do that depending on how your website, dApp or mini-app is setup:

* Using **Google Tag Manager**
* Using **Next.js**
* Using **HTML `<script>` tag**
* Using **Nuxt**
* Using **Webflow**
* Using **Framer**

### Telegram mini-apps

For Telegram mini-apps, integrating the Cookie3 snippet is no different to integrating it with your website or dApp. The process remains the same, allowing you to easily track user interactions and gather valuable analytics data. Simply follow the integration method that best suits your development setup, whether it's using a script tag, Next.js, or any other supported technology.

### Feeling lost? Don’t hesitate to contact us!

If you're experiencing any difficulties or have questions about integrating the Cookie3 snippet, our support team is here to help. We understand that technical implementations can sometimes be challenging, and we're committed to ensuring a smooth setup process for all our users. Don't hesitate to reach out to us via Telegram, email or Intercom inside the app!


# Installation guide

Here are the guides that walk you through installing the Cookie3 Analytics snippet in your tech stack

## **Accessing the Tracking Snippet**

When adding a new site to your Cookie Analytics account, the tracking snippet will be displayed automatically.

For websites already added to your account, follow these steps to retrieve the snippet:

1. Log in to your **Cookie3 Analytics account**.
2. Click on the “Manage websites” button in the application’s sidebar.
3. Click on the "Install" or "Manage" button in the table row corresponding with your website

### What’s inside the tracking snippet?

The current version of the script should look like this:

```jsx
<script
   src="<https://cdn.markfi.xyz/scripts/analytics/><current-script-version>/cookie3.analytics.min.js"
   integrity="sha384-lp8ATuGdLnhwAutE0SOVmSINtZ4DObSNjODmbbjYxaX92FOPBLyZjN+wVIaoK4Qy"
   crossOrigin="anonymous"
   site-id="<your-site-id>"
   async="true"
></script>
```

The tracking snippet contains several important attributes:

* `src`: The URL of the Cookie3 Analytics script. Should be set to the `cdn.markfi.xyz` hostname
* `integrity`: A hash that ensures the script's integrity. Read more about our Security measures here →
* `crossOrigin`: Set to "anonymous" for CORS requests
* `site-id`: Your unique site identifier that you can copy within the app

## Installation guides

#### **Add The Tracking Snippet To Your Site’s \<head>**

* To integrate your website with Cookie3 Analytics, you need to insert the **Cookie3 tracking snippet** into the header section of your site.
* Place the snippet within the \<head> ... \</head> tags on your website’s pages.

### **Next.js**

For Next.js applications, you can add the Cookie3 tracking snippet to your pages by following these steps:

* Access your `layout.tsx` or `_app.tsx` in your project’s repository
* Add the following code to the file:

  ```jsx
  import Script from 'next/script'

  export default function RootLayout({ children }) {
    return (
      <html lang="en">
        <head>
          <Script
            src="<https://cdn.markfi.xyz/scripts/analytics/><current-script-version>/cookie3.analytics.min.js"
            integrity="sha384-lp8ATuGdLnhwAutE0SOVmSINtZ4DObSNjODmbbjYxaX92FOPBLyZjN+wVIaoK4Qy"
            crossOrigin="anonymous"
            site-id="<your-site-id>"
            strategy="lazyOnLoad"
            async
          />
        </head>
        <body>{children}</body>
      </html>
    )
  }
  ```
* Replace `current-script-version` and `your-site-id` with the appropriate values from your Cookie3 Analytics account.

### **Nuxt**

For Nuxt applications, you can add the Cookie3 tracking snippet by following these steps:

* Create a new file called `cookie3-analytics.client.js` in your `plugins` directory
* Add the following code to the file:

```jsx
export default defineNuxtPlugin(() => {
  useHead({
    script: [
      {
        src: '<https://cdn.markfi.xyz/scripts/analytics/><current-script-version>/cookie3.analytics.min.js',
        integrity: 'sha384-lp8ATuGdLnhwAutE0SOVmSINtZ4DObSNjODmbbjYxaX92FOPBLyZjN+wVIaoK4Qy',
        crossOrigin: 'anonymous',
        'site-id': '<your-site-id>',
        async: true,
      },
    ],
  })
})
```

* Replace `current-script-version` and `your-site-id` with the appropriate values from your Cookie3 Analytics account.

### **Wordpress**

For WordPress websites, you can add the Cookie3 tracking snippet by following these steps:

* Log in to your WordPress admin panel
* Navigate to Appearance > Theme Editor
* Select your active theme and locate the header.php file
* Add the Cookie3 tracking snippet just before the closing \</head> tag in the header.php file
* Save the changes and refresh your WordPress site

Remember to replace the \<current-script-version> and \<your-site-id> placeholders with the appropriate values from your Cookie3 Analytics account.

### **Framer**

For Framer websites, you can add the Cookie3 tracking snippet by following these steps:

* Open your Framer project and navigate to the Settings panel
* Click on the "Custom Code" tab
* Paste the Cookie3 tracking snippet into the "Head" section

### **Webflow**

For Webflow websites, you can add the Cookie3 tracking snippet by following these steps:

* Log in to your Webflow account and open your project
* Navigate to the project settings and select the "Custom Code" tab
* Paste the Cookie3 tracking snippet into the "Head Code" section


# Integration with Google Tag Manager (GTM)

This guide describes how to connect the Cookie3 Analytics snippet with your GTM.

{% hint style="info" %}
Cookie3 Analytics has a dedicated configuration for Google Tag Manager and provides a GTM-specific snippet during the site setup process.
{% endhint %}

## **Create a New Tag**

In your Google Tag Manager account, begin by adding a new tag.

* Click on “**Add New Tag**.”

### **Configure the Tag**

Under the tag configuration, choose “**Custom HTML**” as the tag type.

### **Insert the Cookie3 Analytics Snippet**

In the **HTML** field within the “Custom HTML” section, paste your Cookie3 Analytics GTM tracking snippet.

* If you’ve already added your site, you can retrieve this snippet in the “**Manage Websites**” page, which you can access from the application’s sidebar navigation

### **Set a Trigger for the Tag**

After adding the snippet, you need to create a trigger to fire the tag.

* Choose “**All Pages**” and filter by “**Page View**” to ensure the tag counts visits across all your pages.

{% hint style="warning" %}
Be cautious with advanced settings such as tag firing priority, tag sequencing, and consent checks, as these can affect how and when the Cookie3 Analytics script loads.
{% endhint %}

### **Name and Save the Tag**

* Give your tag a descriptive name for easy identification.
* Click on the “**Save**” button.

### **Submit and Publish Your Changes**

* After saving the tag, click on the “**Submit**” button to submit the changes.
* Then, click on the “**Publish**” button to apply the changes to your website.

### **Verify the Integration**

Once published, visit your website to confirm that the Cookie3 Analytics script has been added.

* You can also verify the tracking in your Cookie3 Analytics account to ensure stats are being collected.


# Verifying installation status

This page describes how to verify that a website or app was successfully connected to Cookie3 Analytics

{% hint style="success" %}
As of September 2024, the Website Analytics dashboards refresh data every 15 minutes. However, the installation status updates in real-time.
{% endhint %}

## Verifying the installation status

To verify the installation status, access your "Manage Websites" panel and look for a green dot next to your added website.

If you've connected the Cookie3 Analytics snippet but the status check remains red, please allow up to 15 minutes for the status to update. During periods of high system load, it may take longer to index all visits.

### Troubleshooting

#### **Have you implemented Cookie3 Anlaytics snippet using Google Tag Manager?**

Google Tag Manager (GTM) strips the `data-*` attributes by default, which can break the tracking. Please follow our GTM guide for instructions on how to integrate Cookie3 Analytics using GTM.

#### **Does your site use a Content Security Policy (CSP)?**

Implementing a proper CSP can significantly enhance your website's security by mitigating the risk of content injection attacks and unauthorized resource loading.

This policy allows scripts and connections from the cdn.markfi.xyz domain, which is necessary for the Cookie3 Analytics snippet to work correctly.Implementing a proper CSP can significantly enhance your website's security by mitigating the risk of content injection attacks and unauthorized resource loading.

Please ensure your website’s CSP contains the following lines: `Content-Security-Policy: default-src 'self'; script-src cdn.markfi.xyz; connect-src cdn.markfi.xyz`

#### **Have you inserted multiple Cookie3 Analytics snippets into your site?**

Inserting multiple snippets may compromise tracking accuracy. Please ensure you've added only one Cookie3 Analytics snippet to your site.

#### You don’t see your own visits in the Cookie3 Analytics dashboard?

{% hint style="info" %}
Please ensure you’re using the latest version of the Cookie3 Analytics snippet, to ensure that the data is not filtered by content blockers and other extensions.&#x20;
{% endhint %}

If you're not seeing your own visits in the Cookie3 Analytics dashboard, it could be due to several reasons. First, check if you have any ad-blocking or privacy extensions enabled in your browser, as these can interfere with tracking. Additionally, some browsers have built-in tracking prevention features that might affect the analytics. Try accessing your site from a different browser or device to see if the issue persists.

#### Are you seeing visitors only from your homepage?

If you're only seeing visitors from your homepage, it's possible that the Cookie3 Analytics snippet is not properly implemented across all pages of your website. Ensure that the snippet is placed in a common area of your site's code, such as the header or footer, that's included on every page. For single-page applications (SPAs), make sure the snippet is initialized correctly to track page changes.

### Manually Verifying Your Integration

In some cases a manual check is required to verify if the snippet is properly installed on your site. In this case, the best approach is to check it directly in the website’s HTML source code. Below, we’ll explain how to do this:

1. Head to your homepage where the Cookie3 Analytics snippet should be installed
2. Right-click anywhere on the page and select “**View Page Source**” (the exact wording may vary depending on your browser).

Once the source code is open, search for the Cookie3 snippet:

* **Mac:** Press Command + F
* **Windows/Linux:** Press Ctrl + F

Type "site-id" in the search box to locate the exact snippet.

* If the `src` parameter correctly points to the `cdn.markfi.xyz`domain, and
* If the “site-id” parameter matches the one you can see in your website configuration panel in the Cookie3 Analytics application

#### Are you not seeing data in your dashboards even after manually verifying that the script is properly connected?

If you've manually verified that the Cookie3 Analytics script is properly installed on your website but you're still not seeing any data in your dashboards, there could be a few reasons for this:

* The script might be blocked by ad-blockers or privacy extensions used by your visitors.
* There might be a delay in data processing, especially if you've just installed the script.
* Your website might have very low traffic, making it appear as if no data is being collected.

In other cases - please don’t hesitate to contact us either via Telegram, email or through the Intercom widget inside the application.


# Security measures

This page describes what steps Cookie3 took to ensure maximum security when installing the Cookie3 Analytics snippet for our users.

## Security Measures When Connecting the Cookie3 Analytics Snippet to Your Website

When you add the Cookie3 Analytics script to your website, there are a few important security features that can help ensure the script is safe and doesn't expose your site to risks. Let's break down what these features are and why they matter:

{% hint style="info" %}
**Note:** All of these security features are available out of the box when you install the Cookie3 Analytics snippet, meaning you don’t need to manually configure them—they're built in to protect your site.
{% endhint %}

### **`Integrity` Attribute**

The **integrity attribute** is like a safety check for the script you’re adding to your site. It helps ensure that the script hasn’t been altered or tampered with in any way.

* When you add a script to your site, you can use an integrity attribute that includes a unique "hash" (a string of characters) of the original script. Your browser will download the script and then compare it to this hash.
* If the script matches the hash, it’s considered safe. If it doesn’t match, the browser will block it from running because it might have been compromised.

#### **Why use it?**

It ensures that the script you’re running is exactly the one provided by Cookie3 Analytics, without any hidden changes or malicious code.

***

### **`Cross-Origin` Attribute**

The **cross-origin attribute** is used to control how a script interacts with content on different domains (websites). It sets rules for how the script can communicate between your site and other sites where the script might be hosted.

* By using this attribute, you can reduce the chance of security risks like *cross-site scripting attacks*, where malicious code from another site tries to hijack your content or data.

#### **Why use it?**

It limits the script’s ability to interact with other sites, reducing the risk of security breaches.

***

### **Content Security Policy (CSP) Setup**

A **Content Security Policy (CSP)** is a set of rules you can set for your website to control what types of content are allowed to run. It’s like a security firewall for your site.

* You can specify which websites your site is allowed to load scripts, images, or other resources from. This helps block any unauthorized or potentially harmful content.

#### **How to set it up:**

* Typically, you add CSP rules in your website's header section. For example, if you want to allow scripts only from Cookie3 Analytics, you could set a rule that allows scripts to load only from that specific domain.
* The domain that should be whitelisted is: `cdn.markfi.xyz`

***

## **Why Do All of This?**

1. **Protect your visitors:** These security measures help ensure that no one can inject harmful code into your site, which could steal data or compromise user privacy.
2. **Ensure the integrity of your site:** By using these settings, you prevent unauthorized scripts from running on your site, ensuring your website is as safe and secure as possible.
3. **Prevent attacks:** Security features like the integrity attribute, cross-origin attribute, and CSP help guard against attacks like data theft, unauthorized tracking, or malicious code execution.
4. **Build trust with your audience:** When your website is secure, visitors are more likely to trust your site with their data, which is especially important if you collect sensitive information.

By following these steps and enabling these security features, you can rest assured that the Cookie3 Analytics script is running safely and that your website is protected from common online threats.


# Setup in-app custom events

Custom events are user-defined interactions or actions that you want to track specifically for your website or application.

## What are custom events?

Custom events are user-defined interactions or actions that you want to track specifically for your website or application. They allow you to measure and analyze user behavior that goes beyond standard page views or default analytics metrics. Custom events provide deeper insights into how users engage with your content, features, or products, enabling you to make data-driven decisions to improve user experience and achieve your business goals.

### Key components of custom events

Custom events in Cookie3 Analytics consist of four main components, two of which are required:

| Attribute                     | Description                                     | Example                                                       |
| ----------------------------- | ----------------------------------------------- | ------------------------------------------------------------- |
| Category (Required)           | Describes the type of event you want to track   | Link Clicks, Videos, Outbound Links, Form Events              |
| Action (Required)             | Specifies the action taken within the event     | For Video category: Play, Pause, Complete                     |
| Name (Optional - Recommended) | Identifies the specific element interacted with | Name of a video played, form being submitted                  |
| Value (Optional)              | A numeric value, often dynamically generated    | Price of a product added to cart, percentage of video watched |

{% hint style="warning" %}
**Important Notes:**

* The **Category** and **Action** fields are mandatory for every event.
* The **Value**, if included, must always be a number.
* All values are customizable based on the events you want to track.
  {% endhint %}

### How to track custom events with the Cookie3 Analytics snippet?

{% hint style="info" %}
Tracking custom events with the Cookie3 Analytics snippet is completely free—no additional costs involved.
{% endhint %}

Currently the only way to track custom events is with the use of Javascript on your site. In order to do this, you must call the `window.cookie3.trackEvent({category, action, name, value})` method from within your application code. For example, if you’d like to track all button clicks from the application with a specific class or id parameter, you can simply do the following:

```jsx
// Example implementation for tracking button clicks
document.addEventListener('DOMContentLoaded', function() {
    // Select all buttons with the class 'track-click'
    var buttons = document.querySelectorAll('.track-click');
    
    buttons.forEach(function(button) {
        button.addEventListener('click', function() {
            // Get button text or a data attribute for the name
            var buttonName = this.textContent || this.getAttribute('data-name');
            
            // Track the event
            window.cookie3.trackEvent(
                {
                    category: 'Button Click',  // Category
                    action: 'Click',         // Action
                    name: buttonName,      // Name (optional)
                    value: 1                 // Value (optional)
                }               
            );
        });
    });
});
```

This example demonstrates how to track button clicks using the Cookie3 Analytics snippet. Here's what the code does:

* It waits for the DOM content to be fully loaded before executing.
* It selects all buttons with the class 'track-click'.
* For each button, it adds a click event listener.
* When a button is clicked, it retrieves the button's text or a custom data attribute for the event name.
* It then calls the `window.cookie3.trackEvent()` method with appropriate parameters.

To use this code, you would need to add the 'track-click' class to any buttons you want to track. For example:

```html
<button class="track-click">Sign Up</button>
<button class="track-click" data-name="Learn More">Read Our Blog</button>
```

This implementation allows you to easily track button clicks across your website or application, providing valuable insights into user interactions.

### **Example Event Configurations**

#### **Tracking Call To Action Clicks**

* **Event Category:** Call to action
* **Event Action:** Button click
* **Event Name:** Solana Summer Campaign
* **Event Value:** (blank)

#### **Tracking User Reviews**

* **Event Category:** Reviews
* **Event Action:** Published Matomo Review
* **Event Name:** (blank)
* **Event Value:** 10


# Setting up consent management

{% hint style="info" %}
To enable consent management in the Cookie3 Analytics snippet, ensure your script configuration in the tag includes this line: consent-required="true"
{% endhint %}

## Handling Consent Management with the `window.cookie3` Object

When handling consent management on your website using the `window.cookie3` object, you have access to several methods that allow you to give users control over their tracking and cookie consent decisions. Here's how you can use these methods to implement consent management.

### **Let Users Express Consent**

To let users express their consent for tracking and cookie usage, you can use the following method from `window.cookie3`. Call the `setTrackingConsentGiven()` method when the user agrees to tracking:

```jsx
window.cookie3.setTrackingConsentGiven();
```

### **Check if User Consented to Data Processing**

Before processing any data, it's essential to check if the user has already given their consent. You can check this using the `isTrackingConsentGiven()`method:

```jsx
if (window.cookie3.isTrackingConsentGiven()) {
	// you can handle your custom consent banner logic here
	// for example: hiding not displaying the banner if the consent is given 
}
```

### **Check if User Declined Data Processing**

If the user has explicitly declined tracking or cookie usage, you can detect this by checking the value returned by the `isTrackingConsentGiven()` method.

If the method returns `false`, it means the user has not consented to tracking (or has declined):

```jsx
if (!window.cookie3.isTrackingConsentGiven()) {
  // The user has declined tracking consent
}
```

### **Remember User's Decline Decision Using Local Storage**

When the user declines consent, you can remember their decision by using the `forgetTrackingConsentGiven()` method. This method store the user's decline decision in local storage, ensuring their preference is remembered across sessions:

```jsx
window.cookie3.forgetTrackingConsentGiven();
```

By storing these decisions, the user's choice will be remembered and you won't need to ask for consent again unless the user clears their browser's local storage.

### Summary of Methods:

* **Give consent:**
  * `window.cookie3.setTrackingConsentGiven()`
* **Check consent:**
  * `window.cookie3.isTrackingConsentGiven()`
* **Decline consent:**
  * `window.cookie3.forgetTrackingConsentGiven()`

This consent management flow helps you comply with privacy regulations by giving users full control over how their data is handled, while remembering their preferences for future visits.


# How to retrieve your siteID?

To find out the `siteId` of your website/app please head to our app at `https://app.cookie3.co`&#x20;

#### On desktop:

1. Hover over the sidebar navigation panel on the left of your screen
2. Click on the "Manage Websites" panel

#### On mobile:

1. Open the menu in the top-right corner of your screen
2. Click on the "Manage Websites" panel

{% hint style="info" %}
You should now be able to see a list of your websites/apps connected to Cookie3 Analytics.
{% endhint %}

1. Find the the particular website whose site id you'd like to retrieve
2. If your website is already connected to our platform click on the "Manage" button with a cogwheel icon
   1. If it's not yet connected click on the "Connect" button with a plug icon
3. A sidepanel should now be visible with an installation guide and you can find your siteID below.
   1. Your siteID should look similar to this: `cde56c54-a4cd-49ad-88bd-d2eef215502b`


# Upgrading the snippet version

## Upgrading Your Cookie3 Tracking Snippet

{% hint style="info" %}
The Cookie3 tracking snippet received significant updates in August 2024 that improve tracking accuracy and overall performance. We recommend upgrading your snippet to take advantage of these improvements.
{% endhint %}

### Upgrade Process

Follow these steps to update your tracking snippet:

1. **Access the Dashboard**
   * Go to [app.cookie3.co](https://app.cookie3.co)
   * Ensure you are logged into your account
2. **Navigate to Website Management**
   * Open the sidebar menu
   * Click on "Manage websites"
3. **Locate Your Website**
   * Find the website you want to update in the list
4. **Access Snippet Settings**
   * For websites with existing snippets: Click "Manage"
   * For new installations: Click "Install"
5. **Update the Code**
   * Select your website technology from the options provided
   * Copy the new snippet code
   * Replace the existing snippet in your website's code with the new version

### Benefits of Upgrading

The August 2024 update includes improvements to:

* Tracking accuracy
* Performance optimization
* Overall snippet efficiency

### Need Help?

If you encounter any issues during the upgrade process, please contact our support team for assistance.


# Troubleshooting

## I don't have a wallet connection feature installed, but there are wallet connection events visible on my website

Wallet connection events appearing on a website without implemented wallet features can be explained by several technical factors. Development artifacts may persist when developers test wallet connections locally, with connection data stored in browser storage (localStorage, sessionStorage) remaining detectable even after deployment. Browser extensions like MetaMask or Phantom inject wallet-related scripts into all web pages, often attempting automatic connections without user interaction. Cross-origin events from other websites or browser tabs can propagate across contexts, while third-party scripts (analytics tools, advertising modules, embedded widgets) might include independent wallet detection functionality. Embedded content through iFrames from web3-enabled sites can trigger connection attempts that bubble up to the parent page. Users' browsing history also plays a role, as those who visited crypto sites previously may have persistent wallet connections throughout their session. Test environments and development wallets that connect automatically may leave artifacts in production. Background processes like service workers can maintain or restore wallet connections independently of the visible page, and different wallet providers implement varying connection strategies, with some aggressively scanning for compatible websites or attempting automatic reconnection based on previous user behavior.

### Diagnosis and Solutions

To diagnose these issues, analyze the specific wallet types detected, compare event patterns between development and production environments, test in incognito mode to eliminate storage artifacts, and monitor event timing relative to page load. Potential solutions include implementing filtering to count only explicitly initiated connections from your domain, adding origin verification to ensure events come from your website, differentiating between new connections and restored connections in analytics, analyzing timestamps to identify automated versus user-initiated connections, and creating controlled test environments to establish baseline behavior. These approaches can help clarify the situation for clients and improve tracking accuracy by distinguishing genuine user wallet interactions from background technical processes.


# Add your team members

To add a team member follow the steps below:

<figure><img src="/files/EquNPcxgUmDGVM6izeRa" alt=""><figcaption></figcaption></figure>

#### 3 types of team members <a href="#id-3-types-of-team-members" id="id-3-types-of-team-members"></a>

| Type   | Description                                                                                                                                                                   |
| ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Viewer | Viewers have read-only access to the Team content. They can view resources but cannot make any modifications or perform actions that affect the Team's structure or settings. |
| Editor | Editors have the ability to modify resources within the Team. They can add, edit, and delete content, but they do not have access to Team management functionalities.         |
| Admin  | Admins have full control and access to all team features. They can manage Team settings, invite or remove members, and perform any actions related to Team management.        |


# Onchain Explorer

Learn how to use Onchain explorer to assess any community from the onchain perspective.

## Onchain explorer is a tool to analyze any Web3 community based on onchain data

<figure><img src="/files/5fStvWjF8PtytQPwjMX7" alt=""><figcaption><p>Accessing Onchain Explorer from within the Cookie3 Analytics app</p></figcaption></figure>

The onchain explorer utilizes blockchain data to provide insights into the activities, interactions, and trends within Web3 communities. By analyzing onchain transactions, smart contract interactions, and token movements, the onchain explorer offers a comprehensive view of community engagement and growth. This data-driven approach enables projects, investors, and researchers to make informed decisions based on real-time, verifiable information.

Read more about how to leverage the most out of the Onchain Explorer with the use of Filters:


# Filters

## What are filters?

The **onchain explorer tool** analyzes Web3 communities using blockchain data, offering insights into activities and trends. It employs various **filters** to examine specific wallet groups, utilizing both onchain and offchain data sources.

* Onchain filters analyze token holdings, transaction activity, smart contract interactions, net worth, and transaction dates.
* Offchain filters examine website visits, geographic location, traffic sources, UTM tags, and browser/OS information.
* This comprehensive approach facilitates **data-driven decision-making** for projects, investors, and researchers in the Web3 space.
* You can save your selected filter to an [**Audience**](/cookie3-analytics/features/onchain-explorer/audiences)

## List of available filters

| Filter Type                                                                     | Description                                        | Data Source   | Example Use Case                                 |
| ------------------------------------------------------------------------------- | -------------------------------------------------- | ------------- | ------------------------------------------------ |
| CSV List [(read more)](/cookie3-analytics/features/onchain-explorer/csv-import) | Select wallets from uploaded address list          | User-provided | Analyzing specific group of known wallets        |
| Token Holdings                                                                  | Filter wallets based on token holdings             | Onchain       | Identifying top holders of a project's token     |
| Token Buy/Sell Activity                                                         | Filter wallets based on token transactions         | Onchain       | Finding active traders of a specific token       |
| Smart Contract Interaction                                                      | Filter wallets interacting with specific contracts | Onchain       | Analyzing users of a particular DApp             |
| Net Worth                                                                       | Filter wallets based on their net worth            | Onchain       | Identifying high-value wallets in a community    |
| First/Last Transaction Date                                                     | Filter wallets based on transaction dates          | Onchain       | Segmenting users by longevity or recent activity |
| Website                                                                         | Filter wallets based on website visits             | Offchain      | Analyzing engagement with project's website      |
| Location                                                                        | Filter wallets based on geographic location        | Offchain      | Geographical analysis of community members       |
| Traffic Source                                                                  | Filter wallets based on traffic source             | Offchain      | Evaluating effectiveness of marketing channels   |
| UTM Tags                                                                        | Filter wallets based on UTM tags                   | Offchain      | Tracking success of specific marketing campaigns |
| Browser & OS                                                                    | Filter wallets based on browser and OS             | Offchain      | Optimizing user experience for popular platforms |


# Supported blockchains

## Blockchains available in the Onchain Explorer

* Ethereum
* BNB Chain
* Polygon
* X Layer
* Astar zkEVM
* Mantle
* Base
* Arbitrum
* Avalanche
* Blast

### Coming soon

* Solana
* TON
* Hyperliquid

## Blockchains available for Onchain Conversion Events

* Ethereum
* BNB Chain
* Polygon
* X Layer
* Astar zkEVM
* Mantle
* Base
* Arbitrum
* Avalanche
* Blast
* Ronin
* Fantom
* Optimism
* Goerli Testnet
* Mantle Testnet
* Linea
* Chilliz
* Manta
* Blast Testnet
* Metis
* Mode
* Scroll


# Charts & metrics

## What data can you utilize using the Onchain Explorer?

* **Detailed dashboards:** The tool offers specialized dashboards including Overview, Holdings, dApps and CEX, Multichain, and Wallet List, each providing unique insights into community behavior and trends.
* **Cross-chain analysis:** The Multichain dashboard allows for comparison of user activity across multiple blockchain networks, offering a holistic view of cross-chain behavior.

## Available dashboards

| Name          | Description                                                          | Example Features                                                                | Use Cases                                                                    |
| ------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Overview      | Provides general statistics on the selected audience                 | Transaction count, Volume, Wallet count, Balance breakdown                      | Quick assessment of audience activity and financial status                   |
| Holdings      | Displays token holdings of the audience                              | Token type breakdown (Native, Stablecoin, Altcoin, NFT), List of popular tokens | Understanding audience investment preferences and portfolio composition      |
| dApps and CEX | Shows interactions with decentralized apps and centralized exchanges | dApp categories, Specific dApp usage, CEX activity                              | Analyzing user engagement with various blockchain applications and exchanges |
| Multichain    | Aggregates activity across multiple blockchain networks              | Total multichain volume, Activity comparison across chains                      | Identifying cross-chain behavior and preferred blockchain networks           |
| Wallet List   | Presents detailed information on individual wallets                  | Sortable table of wallets, Individual wallet statistics                         | In-depth analysis of specific wallets within the selected audience           |


# Data export

The export feature allows you to easily analyze and manipulate your audience data outside of the platform. This can be particularly useful for integrating with other tools or performing custom analyses. Remember to respect data privacy regulations when handling exported user information.

## Exporting the data into a CSV file

At any time that you’re in the Onchain Explorer you can select on the “CSV” button to download the list of wallets from a given audience into a CSV file

{% hint style="info" %}
&#x20;Limits apply based on your subscription plan
{% endhint %}


# CSV import

## Importing your users

The CSV import feature allows you to import a list of your users (wallets) into Cookie3 Analytics for further analysis.

* The imported CSV file must contain a `wallet_address` header
* Only Ethereum addresses are currently supported
* Limits apply based on your subscription plan

{% hint style="info" %}
&#x20;Limits apply based on your subscription plan
{% endhint %}

### To import your data:

* Navigate to the "Import your users" section in your Cookie3 Analytics sidebar navigation
* Click on "Upload CSV" and select your prepared file
* Review the import summary and confirm to start the process


# Audiences

## What are audiences?

Think of Audiences like different neighborhoods in a city. You can focus on Manhattan with users who have high buying power and specific product preferences, or you can check out the NYC suburbs, which are less crowded, might have lower buying power, but are easier to target and satisfy.

<figure><img src="https://docs.cookie3.co/~gitbook/image?url=https%3A%2F%2F777584841-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F3qRGtQMGoQIUCQjK30D5%252Fuploads%252FmxVtO9nSez8K3BYAbMAl%252FZrzut%2520ekranu%25202024-03-24%2520o%252017.57.26.png%3Falt%3Dmedia%26token%3Dc80007cb-17bc-4453-bd0f-ecd477920382&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d4e8b7e7&#x26;sv=1" alt=""><figcaption></figcaption></figure>

### Get to choose which group of users fits your current marketing goals <a href="#get-to-choose-which-group-of-users-fits-your-current-marketing-goals" id="get-to-choose-which-group-of-users-fits-your-current-marketing-goals"></a>

* Maybe you want to see the user base from certain marketing campaigns to check their average portfolio balance, activity, and experience?
* Or you're curious about who owns a particular NFT because you're announcing a partnership with that collection?
* How about finding wallet addresses with at least $1,000 value that are active in specific countries?

Audiences can be created both from on- and offchain filters. Remember [to integrate your website first ](/cookie3-analytics/setup-your-site-or-app)before using offchain filters.


# Web Analytics

Learn how professional Web3 marketers analyze their website traffic.

## Web Analytics are the cornerstone of Cookie3 Analytics

From now on you can analyze offchain traffic (visits, time spent on site, bounce rate etc.) and then see how it converts into onchain transactions (NFT mints, token swaps, wallet connection, and more). This way you can compare different traffic sources like quests, social media, direct and others in their true purpose; driving onchain actions.

<figure><img src="/files/N9G6jvIfazU9CY3XflQ9" alt=""><figcaption><p>Dashboard</p></figcaption></figure>

With Cookie3's Web Analytics, you can gain valuable insights into user behavior across both offchain and onchain activities. This comprehensive approach allows you to optimize your marketing strategies and improve user engagement. By understanding the full user journey, from initial website visit to onchain transactions, you can make data-driven decisions to enhance your project's performance and user experience.

### [Click here to get started](https://app.cookie3.co/signup?utm_source=docs\&utm_medium=docs) <a href="#click-here-to-learn-how-how-to-measure-web3-marketing-performance" id="click-here-to-learn-how-how-to-measure-web3-marketing-performance"></a>


# Selecting a website or app

Learn how to select one or multiple websites to analyze in Cookie3 Analytics

## Make sure you have a website or app installed

In case you haven't done it yet, please go through the installation guide [here](/cookie3-analytics/setup-your-site-or-app).

## Select your website or app from the dropdown menu

<div align="left"><figure><img src="/files/QX62yU9ksU6dYtuPkG1i" alt="" width="241"><figcaption></figcaption></figure></div>

* You can select multiple websites or apps at once to aggregate data from multiple sources


# Filters

Use filters to focus on specific user groups

{% hint style="info" %}
In order to fully utilize this feature, please make sure you:

* Have a site or app installed in Cookie3 Analytics. [Read more](/cookie3-analytics/setup-your-site-or-app)
* Have at least one conversion event setup. [Read more](/cookie3-analytics/features/conversion-events)
  {% endhint %}

Filters are similar to the ones you can find in Google Analytics. You can filter your website traffic by choosing specific properties such as:

* UTM parameters
* Traffic source
* Location
* User agent
* Page

This way, you can narrow down the whole website traffic to your desired group and see how they behave, as well as assess the group traffic quality.

<figure><img src="/files/oPi1ZwBRAP00OrYTIWXf" alt=""><figcaption></figcaption></figure>


# Onchain reporting

{% hint style="info" %}
In order to fully utilize this feature, please make sure you:

* Have a site or app installed in Cookie3 Analytics. [Read more](/cookie3-analytics/setup-your-site-or-app)
* Have at least one conversion event setup. [Read more](/cookie3-analytics/features/conversion-events)
  {% endhint %}

## Community breakdown

Cookie3 Analytics unveils a new dimension for your website traffic data. The onchain section offers a deep dive into your community's net worth, token holdings, and dApp usage.

## Locations

Additionally, the Locations dashboard features a world map displaying users' holdings by country.

<figure><img src="/files/Or9PTmJBFFOzVx26cYss" alt=""><figcaption></figcaption></figure>


# Acquisition report

By analyzing both behavioral data and wallet activity, Cookie3 opens up a new world of insights that Web2 tools simply can’t provide.

{% hint style="info" %}
In order to fully utilize this feature, please make sure you:

* Have a site or app installed in Cookie3 Analytics. [Read more](/cookie3-analytics/setup-your-site-or-app)
* Have at least one conversion event setup. [Read more](/cookie3-analytics/features/conversion-events)
  {% endhint %}

## Acquisition report

<figure><img src="/files/ejSnjrnFOMJkKD3VGzqJ" alt=""><figcaption></figcaption></figure>

The **Acquisition Report** in Cookie3 Analytics gives you a detailed breakdown of where your visitors are coming from, how they interact with your site, and their onchain behavior—all from a Web3 perspective. It combines traditional web analytics with advanced blockchain tracking, allowing you to see both offchain and on-chain activity in one unified dashboard.&#x20;

### Using the acquisition report, you can:

* Track user behavior across multiple dimensions such as referrers, campaigns, devices, and geolocation.&#x20;
* Understand onchain wallet activity and connect it with traditional visitor metrics like engagement and conversions.&#x20;
* Optimize marketing strategies by knowing which channels and campaigns drive not just traffic, but meaningful, engaged interactions and onchain activity.&#x20;
* Attribute conversions to specific campaigns and channels, both offchain and onchain, providing a complete picture of how users are engaging with your decentralized app (dApp) or platform.&#x20;
* Monitor USD value generated from conversions, including those happening onchain, offering a direct link between user acquisition efforts and actual revenue.

{% hint style="info" %}
You can learn more about Conversion Events and understand how our attribution model works [in this article](/cookie3-analytics/features/conversion-events/how-our-attribution-works).
{% endhint %}

### Example use cases

1. **DeFi Platform:** A decentralized finance (DeFi) platform can track not only how users land on their app but also how many connect their wallets and begin interacting with liquidity pools or staking. By analyzing which marketing channels are driving the most wallet connections and onchain transactions, they can optimize their ad spend for the most impactful channels.
2. **NFT Marketplace:** An NFT marketplace can see which campaigns or referrers (e.g., Twitter or Discord) drive the highest number of wallet connections and, more importantly, which sources lead to actual NFT purchases. The acquisition report allows them to track the full customer journey from discovery to onchain purchase.
3. **Blockchain Game:** A Web3 game can use Cookie3 to track how users engage with their site or app, which marketing campaigns lead to wallet connections, and what onchain actions (like token purchases or in-game asset trades) occur after the user starts playing. By linking these actions to specific referrers, they can focus on the platforms driving the most valuable players.


# Data dimensions

These data dimensions can be utilized to breakdown the acquisition report:

<table><thead><tr><th>Dimension</th><th width="255">Description</th><th>Examples</th></tr></thead><tbody><tr><td>Channel groups</td><td>Categories of user acquisition channels</td><td>Direct, campaign, website, search, social</td></tr><tr><td>Referrer name</td><td>Name of the referring website or platform</td><td>Google, Twitter, Coinmarketcap</td></tr><tr><td>Referrer URL</td><td>Full web address of the referring site</td><td><a href="https://www.google.com/">https://www.google.com/</a></td></tr><tr><td>Campaign parameters</td><td>UTM tags used for tracking specific marketing campaigns</td><td>utm_campaign, utm_source, utm_medium, utm_keyword</td></tr><tr><td>Geographic data</td><td>Location information of users</td><td>Continent, country</td></tr><tr><td>Device information</td><td>Technical details about user's device</td><td>Device type, operating system</td></tr><tr><td>Page interaction</td><td>Information about user's first and last page views</td><td>Entry page, exit page</td></tr></tbody></table>


# Key metrics

{% hint style="info" %}
You can learn more about Conversion Events and understand how our attribution model works [in this article](/cookie3-analytics/features/conversion-events/how-our-attribution-works).
{% endhint %}

The metrics data in the table is broken down into the following metrics:

* Visitors
* Engaged visits: number of visits that had at least one event (page view, click, etc.)
* Wallets: number of users that connected a wallet
* Engagement rate: percentage of visits that had at least one event (page view, click, etc.)
* Engaged visits per user: Average number of visits that had at least one event (page view, click, etc.) per user
* Avg. visit duration
* Conversions, how many conversions were attributed to a specific channel including **onchain conversions**!
* USD Value, the total value of conversions in USD, including data collected **onchain**


# Conversions report

{% hint style="info" %}
In order to fully utilize this feature, please make sure you:

* Have a site or app installed in Cookie3 Analytics. [Read more](/cookie3-analytics/setup-your-site-or-app)
* Have at least one conversion event setup. [Read more](/cookie3-analytics/features/conversion-events)
  {% endhint %}

{% hint style="info" %}
This article includes information about [Conversion Events.](/cookie3-analytics/features/conversion-events) You can learn more about Conversion Events and understand how our attribution model works [in this article](/cookie3-analytics/features/conversion-events/how-our-attribution-works).
{% endhint %}

## **Conversions Dashboard: Merging OnChain and OffChain Data for Complete Conversion Insights**

The **Conversions Dashboard** in Cookie3 Analytics offers a powerful and comprehensive view of how your marketing efforts and user engagement translate into conversions—both onchain and offchain. This dashboard allows you to track **conversion events** over time, see which events are the most popular, and dive deep into specific metrics to better understand how effective your campaigns are.

By blending traditional web conversions with onchain activities, you gain a holistic understanding of user behavior across both Web2 and Web3 environments, making it a crucial tool for optimizing your Web3 project’s performance.

<figure><img src="/files/KjiFjZWCWc15h5hIiSM8" alt=""><figcaption></figcaption></figure>

### **How the Conversions Dashboard Elevates Your Web3 Analytics**

* **Complete Attribution Across Web2 and Web3**: The Conversions Dashboard gives you a unified view of how your audience interacts with your platform across both offchain (traditional web activities) and onchain (blockchain interactions) events. You can finally understand how users move from a marketing campaign or social media post to completing an onchain transaction, such as purchasing an NFT or making a token swap.
* **Real-Time Value Tracking**: With **Conversion Value** reporting, you can see the actual monetary impact of both offchain and onchain actions, allowing you to measure the return on investment (ROI) of your marketing efforts. This helps you connect marketing strategies directly to revenue.
* **Optimize for Maximum Impact**: By drilling down into specific conversion events, you can see which channels drive the most conversions. For example, you can identify if users coming from a particular campaign not only convert more but also perform higher-value onchain actions, such as large token purchases.


# Key metrics

## **Key Metrics in the Conversions Dashboard**

{% hint style="info" %}
You can learn more about Conversion Events and understand how our attribution model works [in this article](/cookie3-analytics/features/conversion-events/how-our-attribution-works).
{% endhint %}

The dashboard presents several important metrics that allow you to analyze conversions from multiple perspectives:

| Metric                    | Description                                                             | Importance                                                |
| ------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------- |
| Conversions               | Total number of conversion events completed over a selected time period | Measures overall conversion performance                   |
| Conversions per User      | Average number of conversion events per unique user                     | Indicates user engagement level                           |
| Unique Conversions        | Number of unique conversion actions performed                           | Differentiates between repeat and first-time interactions |
| Total OnChain Conversions | Number of conversions occurring on the blockchain                       | Measures Web3-specific engagement                         |
| Conversion Value          | Total value of all conversion events in USD                             | Quantifies financial impact of campaigns                  |


# Show attribution report per conversion event

### **Drill Down on Specific Conversion Events**

{% hint style="info" %}
You can learn more about Conversion Events and understand how our attribution model works [in this article](/cookie3-analytics/features/conversion-events/how-our-attribution-works).
{% endhint %}

One of the standout features of the Conversions Dashboard is the ability to click on a specific **conversion event** to explore its details and attributions. When you select an event, you can:

* **Track the attribution** for that particular conversion, revealing which marketing channels, campaigns, or referrers were most effective in driving that event.
* **Leverage dimensions** from the Acquisition Report (e.g., channel groups, campaign name, referrer, device type) to pinpoint which sources are driving the most valuable conversions.

This deeper layer of insight allows you to optimize specific campaigns, referrers, or content by focusing on the channels that generate the highest conversion rates and onchain engagement.


# Conversion Events

{% hint style="info" %}
In order to fully utilize this feature, please make sure you:

* Have a site or app installed in Cookie3 Analytics. [Read more](/cookie3-analytics/setup-your-site-or-app)
  {% endhint %}

## **Understanding Conversion Events: OnChain and OffChain Goals**

Conversion events in our system are divided into two categories: **OnChain Conversion Events** and **OffChain Conversion Events**. These two types of goals reflect how we track and attribute key actions that users take, both on the blockchain and outside of it. While the general approach for tracking these events is similar, the attribution process varies depending on whether the goal occurs onchain or offchain.

{% hint style="info" %}
You can learn more about Conversion Events and understand how our attribution model works [in this article](/cookie3-analytics/features/conversion-events/how-our-attribution-works).
{% endhint %}

### **OffChain Conversion Events**

Offchain goals occur outside the blockchain, such as signing up for a newsletter, completing a purchase, or submitting a form. For these types of events, we are able to identify the specific visitor who fulfilled the goal based on traditional web tracking methods.

The key to offchain goal attribution is linking the event back to the exact visit that influenced the conversion. By identifying this visit, we can assign credit to the referrer or marketing source responsible for driving the user to complete the goal. Our attribution process ensures that the correct marketing touchpoints receive credit for the conversion.

### **OnChain Conversion Events**

Onchain conversion events, such as completing a transaction or interacting with a smart contract, present a unique challenge because they occur directly on the blockchain. In these cases, we do not have direct information about the visitor who performed the onchain action, only the wallet address involved.

To solve this, we match the onchain action with the visitor by identifying website visits where the wallet in question was connected. Here’s how the process works:

1. **Search Website Visits**: We go through all the website visits to find instances where the visitor connected the wallet that was used to complete the onchain goal.
2. **Select the Closest Visit**: Once we have a list of visits where the wallet was connected, we select the visit closest to the goal completion date to maximize accuracy.
3. **Identify the Visitor**: After selecting the visit, we match it to the visitor responsible for the action. While we cannot directly link the wallet action to a specific user, this method ensures we associate the goal with the most relevant visitor activity.
4. **Apply Attribution Model**: After identifying the visit, we use the same attribution model as for offchain goals to credit the proper referrers and marketing sources.

**Conclusion**

By dividing conversion events into onchain and offchain categories, we ensure that every conversion, regardless of where it happens, is accurately tracked and attributed. While offchain goals allow us to directly identify the visitor, onchain goals require us to leverage wallet connection data to make the best possible attribution.

If you’re interested in learning more about how we attribute conversions, check out our detailed article on [Attribution Models](https://www.notion.so/a7c618797d81456680056ffe8d0ca164?pvs=21).


# How our attribution works?

## Conversion event attribution

### OnChain Conversion Events Attribution

For onchain conversion events, we cannot pinpoint the exact visitor who fulfilled the conversion event, as we only have information about the wallet that performed the onchain action.&#x20;

<figure><img src="/files/LQzjDb8bdYjnxot4u2Us" alt=""><figcaption><p>This is how we assign conversion events to specific website or app visits</p></figcaption></figure>

To attribute the goal, we search through all visits to the website for instances where the visitor connected the wallet that completed the goal. We then select the visit closest to the goal completion date, matching it to the wallet. Once the visitor is identified, we apply the last non-direct click attribution model, as outlined in the previous section.

### OffChain Conversion Event Attribution

For offchain goals, we can identify the specific visitor who fulfilled the goal. The goal of attribution is to determine the exact visit that should be linked to the goal’s completion. This is crucial because it allows us to credit the appropriate links or referrers responsible for driving the goal conversion. We use a **last non-direct click attribution** model. This model identifies the most recent visit before the goal completion that was not direct—meaning it had a referrer or UTM parameters associated with it. If all visits were direct, the model attributes the closest visit to the goal.


# Onchain conversion events

## List Of Ochain Conversion Events

### Swap specific token

Track when users swap a specific token after interacting with your website

### NFT Mint

Track when users mint NFTs after interacting with your website

### Contract interaction

Track when users interact with a specific smart contract after interacting with your website, including calling functions, sending transactions, etc.

### Swap on specific liquidity pool

Track when users swap tokens on a specific liquidity pool after interacting with your website

### Deposit on specific liquidity pool

Track when users deposit tokens on a specific liquidity pool after interacting with your website

### Swap on specific DEX

Track when users swap tokens on a specific DEX after interacting with your website

### Deposit on specific DEX

Track when users deposit tokens on a specific DEX after interacting with your website

## Blockchains available for Onchain Conversion Events

* Ethereum
* BNB Chain
* Polygon
* X Layer
* Astar zkEVM
* Mantle
* Base
* Arbitrum
* Avalanche
* Blast
* Ronin
* Fantom
* Optimism
* Goerli Testnet
* Mantle Testnet
* Linea
* Chilliz
* Manta
* Blast Testnet
* Metis
* Mode
* Scroll


# Attributed USD Value

### OnChain Goals Conversion Value

For certain goals, we calculate the USD value of conversions. These calculations are based on liquidity pools from DEXes compatible with Uniswap V2 and V3 protocols. The goals for which we calculate USD value include:

* Swapping a specific token
* Swapping within a specific liquidity pool
* Depositing into a specific liquidity pool
* Swapping on a specific DEX
* Depositing on a specific DEX&#x20;

#### The exact process for calculating the conversion value works as follows

1. We identify a swap or deposit action on a DEX that is compatible with Uniswap V2 or V3.
2. We retrieve the details of the liquidity pool pair where the action took place.
3. If one of the tokens in the pair is either a native token (e.g., WETH) or a stablecoin (e.g., USDT), we calculate the USD value based on the amount specified in the action.


# Offchain conversion events

## List of offchain conversion events

### Page visit

Track when users visit a specific page on your website

### Website event

Track when users perform a specific event on your website

### Time spent

Track when users spend a specific amount of time on your website

### Pages visited total

Track when users visit a specific number of pages on your website


# Retrieving your Conversion Event unique ID

{% hint style="info" %}
In order to fully utilize this feature you should first create a Conversion Event inside the Cookie3 Analytics app. Head to [this article](/cookie3-analytics/features/conversion-events) to read a short guide about how they work!
{% endhint %}

To find out the `conversionEventId` of your particular conversion event please head to our app at `https://app.cookie3.co`&#x20;

#### On desktop:

1. Hover over the sidebar navigation panel on the left of your screen
2. Click on the "Conversion Events" button

#### On mobile:

1. Open the menu in the top-right corner of your screen
2. Click on the "Conversion Events" button

{% hint style="success" %}
You should now be able to see a list of your conversion events created in Cookie3 Analytics.
{% endhint %}

1. Locate the particular conversion event whose ID you'd like to retrieve in the Table
   1. You can use filters on the top-right corner of the table to narrow down your search
2. Click on the "Three Dots" icon on the right to show a dropdown menu with additional options
3. Click on the "Copy Conversion Event ID" button to copy the id


# KOL Intelligence

[KOL Intelligence](https://app.cookie3.co/signup?utm_source=docs\&utm_medium=docs) automates the collection and analysis of social engagement data and correlates it with onchain activity. It tracks interactions from lists or searches, as well as posts mentioning specific projects, hashtags,Twitter handles, tokens, or subjects. This automation eliminates the need for manual data tracking, providing structured insights for evaluating social impact.<br>

{% embed url="<https://www.loom.com/share/54529d21abae4f88a661374ead746865?sid=1c3e573f-6e51-401f-9a55-6db1c20acc0c>" %}
KOL Intelligence demo
{% endembed %}

**Core Capabilities:**

1. **KOL Performance Evaluation:** Identify KOLs generating the most engagement, impressions, price impact, or wallet connections.
2. **Marketing ROI Analysis:** Automatically calculate return on investment (ROI) and cost per mille (CPM).
3. **Crypto Twitter Analytics:** Monitor the performance of team members, KOLs, ambassadors, and competitors across social media.
4. **Onchain and Social Correlations:** Align social media events with onchain performance to make data-driven strategic decisions.

## Scale your strategy with data driven insights

Effective KOL marketing relies on identifying key players, analyzing their impact, and making data-backed decisions to optimize engagement. [KOL Intelligence](https://app.cookie3.co/signup?utm_source=docs\&utm_medium=docs) provides the tools to monitor and refine influencer strategies, ensuring maximum effectiveness in reaching the right audience.

<figure><img src="/files/Qc4XHMJPHGmz3m0I6H8O" alt=""><figcaption><p>KOL Intelligence Preview</p></figcaption></figure>

By leveraging KOL Intelligence, users can:

* **Optimize Engagement:** Track and react to KOL activity by pinging inactive KOLs and acknowledging those who are actively engaging.
* **Identify High-Impact KOLs:**  Determine which KOLs contribute the most to engagement and impressions.
* **Correlate Social and Onchain Activity:**  Align key social media events with onchain performance to enhance strategic decision-making.
* **Trending Insights:** Discover trending narratives, tokens, and accounts to stay ahead of the curve.

The [platform](https://app.cookie3.co/signup?utm_source=docs\&utm_medium=docs) enables users to understand how KOL interactions translate into measurable outcomes such as token price fluctuations, and market trends.

### Key Features:

* **Advanced Search Interface:** Find KOLs using Boolean operators and filter by timeframes or topics.
* T**rending Insights:** Discover trending narratives, tokens, and accounts to stay ahead of the curve.
* **Top KOLs by Smart Engagement:** Identify the top-performing KOLs from the last 7 days.
* **Sentiment Analysis:** Gauge community sentiment towards your project.
* **KOL Tracking:** Monitor KOL interactions and engagement with your brand.
* **Social Traffic Insights:** Navigate over 430 million followers to understand your social footprint.
* **Price Impact Correlation:** Identify how social activity affects token prices.
* **KOL Analysis Tools:** Evaluate KOLs based on their score and social metrics to inform strategic decisions.
* **Influencer Identification:** Discover users who positively or negatively influence your brand.


# Getting started

<figure><img src="/files/uc2GpkndXVuV1YOzfofG" alt=""><figcaption><p>KOL Intelligence dashboard configured to show KOLs writing about @Cookie3_com or $COOKIE</p></figcaption></figure>

The platform serves as the central hub for tracking and analyzing KOL activity as well as trending insighs, offering a structured view of interactions and engagement trends. Users can leverage this dashboard to monitor KOL performance, measure campaign impact, and identify emerging trends in social and onchain activity. It provides a comprehensive analysis of KOL interactions, categorized by:

* Comprehensive Coverage: Monitor all KOLs discussing your project based on tailored filters.
* Advanced Analytics: Dive deep into smart engagement, trending narratives, top-performing KOLs, and their impact on social and on-chain metrics.
* Customizable Insights: Configure your dashboard to track and analyze exactly what matters to your brand: from trending tokens to campaign performance.

Follow the links below to explore each component of the KOL Intelligence Dashboard and unlock the full potential of your influencer strategy.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Who are Organic KOLs?</strong></td><td>View who talks about your brand organically</td><td></td><td><a href="/pages/L7fsBcziiEKY7EHMxOPt">/pages/L7fsBcziiEKY7EHMxOPt</a></td><td><a href="/files/4s2arWK0AkO6d2RpvjOi">/files/4s2arWK0AkO6d2RpvjOi</a></td></tr><tr><td><strong>KOL Activity Chart</strong></td><td>A dynamic representation of posts related to project</td><td></td><td><a href="/pages/o5CyFUARL6itwK3vJcZT">/pages/o5CyFUARL6itwK3vJcZT</a></td><td><a href="/files/hDcMPaO0bnyvRlO3yMEy">/files/hDcMPaO0bnyvRlO3yMEy</a></td></tr><tr><td><strong>Performance Table</strong></td><td>Breakdown of engagement and more for each KOL</td><td></td><td><a href="/pages/fmnzJT5UfSu0HCgKDhRS">/pages/fmnzJT5UfSu0HCgKDhRS</a></td><td><a href="/files/4uW7V9qovG4fHcuZsrEV">/files/4uW7V9qovG4fHcuZsrEV</a></td></tr><tr><td><strong>Post feed</strong></td><td>Explore actual content from your KOLs</td><td></td><td><a href="/pages/GvjQ5Fx8YZyVSIi9lFFm">/pages/GvjQ5Fx8YZyVSIi9lFFm</a></td><td><a href="/files/YsfybbvUUaQnkBXXQXcg">/files/YsfybbvUUaQnkBXXQXcg</a></td></tr></tbody></table>


# Organic KOLs and Lists

## Understanding Organic KOLs and KOL Lists

KOL Tracking in Cookie3 provides insights into KOLs engaging with a project. Users will see Organic KOLs by default: these are KOLs who naturally discuss the project without being manually added to a list.&#x20;

If a user has created and selected a KOL List (useful for tracking KOL partnerships, ambassadors etc.), the displayed data will reflect only those specific KOLs.

### Default view KOLs

<figure><img src="/files/XNf00iTjjXEAol5CpWqZ" alt="" width="563"><figcaption></figcaption></figure>

These are KOLs who naturally engage with and discuss your project without direct involvement. These KOLs:

* Are discovered through Cookie3's KOL Database
* Discuss your project on their own initiative
* Represent unprompted interest in your project
* Provide genuine market sentiment and engagement

***\*You can always include or exclude organic KOLs by clicking Include organic KOLs.***

### KOL Lists (Custom Groups)

{% embed url="<https://youtu.be/fdfgGYCsJwk>" %}
Step-by-Step Guide: KOL Lists with Cookie3
{% endembed %}

KOL Lists are customizable groups that help you organize and track specific influencers. This feature allows you to:

* Create targeted groups based on your marketing strategy
* Monitor different market segments separately
* Track KOLs across various target markets
* Analyze influence patterns within specific communities

The dual system of Organic KOLs and KOL Lists provides a comprehensive view of your project's influence:

* Organic KOLs show natural market traction and genuine community interest
* Activity Chart (Influence analysis, Price impact, Detailed metrics, Network)
* KOL Lists enable strategic monitoring of specific influencer segments

{% hint style="info" %}
*\*You can access* [*individual KOL page*](/cookie3-analytics/features/kol-intelligence/getting-started/kol-dashboard) *to dive deep into specific KOL performance outside of your brand.*
{% endhint %}

[Find out more about KOL Lists](/cookie3-analytics/features/kol-intelligence/your-kols).

<br>


# KOL Dashboard

The individual KOL page provides comprehensive analytics to evaluate influencer performance and authenticity.

{% embed url="<https://youtu.be/taspvo3RF1g>" %}

### Key Metrics

* [**Score:**](/cookie3-analytics/features/kol-intelligence/ai-powered-kol-scoring-system) A weighted metric combining reach, engagement quality, and content authenticity
* **Follower Analysis:** Breakdown of smart followers, follower types, and view-to-follower ratios
* **Top Performing Posts:** Content ranked by smart engagement metrics
* **Engagement Trends:** Historical data showing smart engager patterns and engagement evolution

### Primary Use Cases

**Campaign Vetting:** Evaluate potential KOL partners by analyzing:

* Audience quality and engagement authenticity
* Content focus and expertise areas
* Historical performance in your niche

### Performance Tracking

Monitor your existing KOLs, team members, and ambassadors:

* Track engagement trends
* Measure content effectiveness
* Compare performance across your network

### Bot Detection:&#x20;

Identify potential fake engagement through:

* Smart follower analysis
* Engagement pattern examination
* Follower-to-engagement ratios


# Searchbar

The search interface allows users to perform targeted queries to find relevant KOLs based on specific criteria. Users can filter by keywords, hashtags, projects, and token tickers to refine their search.&#x20;

{% embed url="<https://youtu.be/78NOlmRFlCU>" %}
Step-by-Step Guide: KOL Intelligence Searchbar
{% endembed %}

Below are examples of how to use the search functions effectively:

#### Using Boolean Operators:

* Write <kbd>AI Agents</kbd> <kbd></kbd><kbd><mark style="color:green;">AND<mark style="color:green;"></kbd> <kbd></kbd><kbd>NFT</kbd> to find KOLs who have tweeted about both topics in your specified timeframe.
* Write <kbd>ETH</kbd> <kbd></kbd><kbd><mark style="color:green;">OR<mark style="color:green;"></kbd> <kbd></kbd><kbd>BTC</kbd> to find KOLs who have discussed either cryptos.

#### Filtering by Timeframes\*:

* Select a custom date range or use presets such as 24 hours, 7 days, or 30 days to narrow down search results.

#### Search by Specific Inputs:

* **KOL Names:** Enter Twitter handles to find relevant influencers.
* **Token Tickers:** Use symbols like <kbd><mark style="color:green;">$ETH<mark style="color:green;"></kbd> or <kbd><mark style="color:green;">ETH<mark style="color:green;"></kbd> to find KOL discussions on specific tokens.
* **Keywords/Topics:** Search for discussions on subjects like "<kbd><mark style="color:green;">DeFi<mark style="color:green;"></kbd>" or "<kbd><mark style="color:green;">Web3.<mark style="color:green;"></kbd>"
* **Project Names:** Enter names like <kbd><mark style="color:green;">"Uniswap"<mark style="color:green;"></kbd> or <kbd><mark style="color:green;">"Arbitrum"<mark style="color:green;"></kbd> to track project-specific mentions.

#### Saved Queries:

* Save frequently used search combinations for quick access and organized tracking. Perform complex queries using Boolean operators (e.g., <kbd>AI Agents</kbd> <kbd></kbd><kbd><mark style="color:green;">AND<mark style="color:green;"></kbd> <kbd></kbd><kbd>NFT, ETH</kbd> <kbd></kbd><kbd><mark style="color:green;">OR<mark style="color:green;"></kbd> <kbd></kbd><kbd>BTC</kbd>).

#### Filter by KOL names, token tickers, project names, and keywords.

#### Customize search results using timeframes (24h, 7d, 30d, 1y) and save queries for future use.

{% hint style="info" %}
*\*The data is being analyzed from June 2024 onwards.*
{% endhint %}


# KOL Activity Chart

<div data-full-width="false"><figure><img src="/files/yjCW7K4NUDqIElWk4Bv5" alt=""><figcaption><p>Interacting with the Chart</p></figcaption></figure></div>

The Activity Chart provides key insights into social media discussions and their impact on project visibility and engagement. It visualizes data trends over time, helping to identify patterns in influencer activity and their correlation with onchain events.

* **Posts count:** Monitors the number of tweets mentioning a project over time, helping to identify periods of increased activity and engagement.
* **Impressions Count:** Measures the total number of times KOL-generated content is viewed, providing insight into the reach and visibility of discussions.
* **Engagement Rate:** Analyzes the effectiveness of content in generating audience interaction, calculated as the percentage of engagements per post.
* **Smart Engagement:** Filters interactions to measure genuine audience engagement by excluding low-value activities such as bot-generated interactions.<br>


# Extending the chart with additional Metrics

<figure><img src="/files/hsJNyhfc48hE6ES6zS54" alt=""><figcaption><p>Adding additional series to the chart</p></figcaption></figure>

### Additional Metrics:&#x20;

These optional data points provide deeper insights into the impact of KOL activity on user behavior and market performance.

* **Website Visitors** (requires website integration\*)**:** Analyzes the effect of KOL activities on platform traffic by tracking visitor surges following key influencer engagements.
* **Wallets Connected:** Measures the influence of social media discussions on new user adoption by monitoring wallet connections.
* **Token Price**: Examines the correlation between KOL discussions and token price fluctuations to identify emerging market trends.
* **Total Volume (24h):** Tracks the total trading volume of the token within a 24-hour period to assess market liquidity and gauge how KOL activities or major announcements drive trading behavior.
* **Market Cap:** Measures the total market value of the toke to provide context on overall project growth and market position.
* **X Impressions and Engagement:** Compares the performance of a project's official Twitter account with that of KOLs to provide context for outreach efforts.
* **Engagement Rate of the Project's Account**: Evaluates how project-generated content resonates with audiences relative to KOL-driven engagement.
* **Mindshare:** Assesses how frequently a project is mentioned across Crypto Twitter, indicating its overall share of attention and influence within the market.
* **Youtube Mindshare:** Tracks a project's visibility and discussion volume within YouTube content.
* **Sentiment:** Analyzes the tone of conversations on X surrounding the project to measure public perception and reputation trends.

You can select multiple metrics simultaneously, allowing you to see how different factors interact over time.

### Language filter:

You can also refine your search and content-based metrics by language to identify regional trends, audience sentiment, and community engagement across different markets.

<figure><img src="/files/pX9nVvt7CzLBWmmK6LcL" alt=""><figcaption><p>Language filtering</p></figcaption></figure>

{% hint style="info" %}
*\*In order to see website visitors and wallets connected metrics you need to integrate your website.* [*See the guide here.*](/cookie3-analytics/setup-your-site-or-app/add-your-website-or-app)&#x20;
{% endhint %}


# Advanced Metrics

The advanced metrics designed to provide actionable insights into your KOL ecosystem. These tools enable you to quantify influence, correlate social activity with token performance, and uncover critical engagement patterns. By leveraging these capabilities, you can refine your strategy, optimize resource allocation, and gain a comprehensive understanding of your project's social and market impact.

### Influence Analysis&#x20;

<figure><img src="/files/rSEtmRiospHjfmrr4JRc" alt=""><figcaption><p>KOL Intelligence: influence analysis of Jupiter</p></figcaption></figure>

The Influence Analysis provides a detailed breakdown of each KOL's proportional impact on your project. This feature helps you understand exactly how many posts, impressions, engagement, and smart engagement each KOL generates relative to others in your network. By measuring individual contributions against the total KOL activity, you can identify your most effective voices and understand the distribution of influence across your KOL ecosystem.

### Price Impact&#x20;

<figure><img src="/files/5mFUPbAomIja671OcAPy" alt=""><figcaption><p>KOL Intelligence: Price Impact of JUPITER</p></figcaption></figure>

Price Impact Analysis reveals the relationship between KOL activities and token performance. When KOLs post about your token, the system tracks subsequent price movements and compares them against major cryptocurrencies like BTC, ETH, and SOL. This comparison is crucial as it helps differentiate between price changes driven by KOL influence versus those resulting from broader market movements. You can pinpoint exactly when influential posts occurred and their potential effect on token value.

### Detailed Metrics

<figure><img src="/files/oo3wDZH1fuC4hw2fQXgJ" alt=""><figcaption><p>KOL Intelligence: Detailed Metrics of JUPITER</p></figcaption></figure>

The Detailed Metrics section offers a view of KOL performance through comparative matrices. It tracks which tokens and accounts are most frequently mentioned by your KOL network, providing insight into trending topics and key players in your ecosystem. These metrics help you understand not just how often KOLs engage, but also what they're talking about and who they're connecting with most frequently.

### Network Visualization&#x20;

<figure><img src="/files/96D6nUnKC3AeFeEgGJo1" alt=""><figcaption><p>KOL Intelligence: Network Visualization of JUPITER</p></figcaption></figure>

The Network feature creates a map of relationships between the top 50 accounts by impressions on X. The system identifies connections when three or more KOLs mention both accounts together, revealing natural clusters of discussion and common narratives in the crypto space. Particularly interesting are the isolated nodes – accounts that generate significant discussion but rarely appear in conversations alongside other tokens. This visualization helps you understand how information and influence flow through your KOL network, identifying both central hubs and independent voices.

<br>


# Performance Table

<figure><img src="/files/ypmJJnexPTUrZQyI0VbN" alt=""><figcaption><p>Interacting with the KOL Performance Table</p></figcaption></figure>

Below the chart, the Table section offers a detailed breakdown of engagement and other metrics for each KOL who has posted about your project. This area enables you to:

* Sort by Metrics: Organize KOLs based on any available metric, such as highest engagement or most impressions, to identify top performers.
* View Posts: Access all posts made by a specific KOL about your project, giving you insight into the content strategies that are most effective.
* Add to KOL Lists: Include KOLs in your custom lists for targeted tracking and future outreach, streamlining your influencer management.

Access Individual KOL Pages: Click on a KOL's name to explore detailed analytics, including their performance metrics, score, audience quality, and historical engagement trends.

#### Dynamic KOL Filtering:

<figure><img src="/files/hylMMkjFYuc9IscJpsED" alt=""><figcaption><p>Dynamic Kol Filters</p></figcaption></figure>

You can adjust filters dynamically to focus on top-performing creators, identify niche influencers, or compare KOL tiers by engagement or reach. This feature supports both broad overviews and highly targeted insights, helping tailor KOL analysis to campaign goals.

You can also include or exclude specific KOL lists to focus on particular groups or remove irrelevant profiles from your dataset.

**Available Filters:**

* **Mentioned Tokens:** Search and filter KOLs who have mentioned specific tokens. *(Note: Pre-TGE tokens cannot be used for filtering.)*
* **Account Type:** Filter by **Personal** or **Organizational** accounts to distinguish between individual creators and brand or media accounts.
* **Score:** Set a minimum and maximum KOL performance score range.
* **Followers:** Define a follower count range to target KOLs based on audience size.
* **Smart Followers:** Filter by the number of Smart followers.
* **Posts:** Limit the range based on total posts during the selected period.
* **Impressions:** Narrow results by visibility and reach performance.
* **Engagements / Likes / Quotes / Retweets:** Customize filters to focus on different forms of social interaction.
* **Smart Engagement Points:** Target KOLs driving high-quality interactions weighted by audience credibility.
* **Engagement Rate (%):** Filter by engagement ratio to surface KOLs with the strongest audience resonance.


# KOL metrics explained

When analyzing a Key Opinion Leader’s (KOL’s) engagement with a specific project (e.g., posts about @Solana), we utilize various metrics to provide a comprehensive overview of their influence and activity. Below is a summary of each metric and how it is calculated.

{% hint style="info" %}
How do we define an **engagement**?

We measure engagement by aggregating all the actions that users take on a KOL’s posts related to your project. This includes the total number of **likes**, **comments**, **bookmarks**, and **retweets** each post receives. By summing these interactions, we obtain the total engagement for the KOL’s content, as well as an average per post by a given KOL.
{% endhint %}

| Metric                   | Description                                              | Calculation                                                                                                                                                                     | Importance                                                                   |
| ------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Posts                    | Total tweets about the project                           | Count of project-related tweets                                                                                                                                                 | Indicates KOL's activity level                                               |
| Average Engagement       | Avg. interactions per post                               | Total engagements / Number of posts                                                                                                                                             | Measures audience interaction                                                |
| Average Post Impressions | Avg. views per post                                      | Total impressions / Number of posts                                                                                                                                             | Shows reach of content                                                       |
| Engagement Rate Percent  | Audience interaction rate                                | (Total engagements / Total impressions) × 100                                                                                                                                   | Reflects content effectiveness                                               |
| Score                    | Overall influence rating                                 | AI-powered system considering multiple factors                                                                                                                                  | Comprehensive KOL evaluation                                                 |
| First Post Date          | Date of first project-related tweet                      | Earliest date among project tweets                                                                                                                                              | Shows KOL's project engagement history                                       |
| Last Post Date           | Date of most recent project tweet                        | Latest date among project tweets                                                                                                                                                | Indicates ongoing KOL interest                                               |
| Followers Count          | Total Twitter followers                                  | Retrieved from Twitter account                                                                                                                                                  | Measures potential reach                                                     |
| Impressions Count        | Total views of project tweets                            | Sum of all project tweet impressions                                                                                                                                            | Quantifies content visibility                                                |
| Median Impressions Count | Middle value of tweet impressions                        | Median of all project tweet impressions                                                                                                                                         | Represents typical tweet reach                                               |
| Engagement Count         | Total interactions with project tweets                   | Sum of all project tweet engagements                                                                                                                                            | Measures audience interaction volume                                         |
| Median Engagements Count | Middle value of tweet engagements                        | Median of all project tweet engagements                                                                                                                                         | Indicates typical interaction level                                          |
| Total Time on Top        | Cumulative time as most recent post by a KOL             | Sum of time on top for each post by KOL about a project                                                                                                                         | Shows how long posts about the project were on top of a particular KOLs feed |
| Retweet Count            | Number of retweets for project-related posts             | Sum of retweets across all project tweets                                                                                                                                       | Measures content spread                                                      |
| Like Count               | Number of likes for project-related posts                | Sum of likes across all project tweets                                                                                                                                          | Indicates content appreciation                                               |
| Reply Count              | Number of replies to project-related posts               | Sum of replies across all project tweets                                                                                                                                        | Shows audience engagement level                                              |
| Hashtag Usage            | Frequency of project-related hashtags                    | Count of specific hashtags in project tweets                                                                                                                                    | Reflects alignment with project messaging                                    |
| Audience Quality         | Relevance and authenticity of the KOL’s followers        | Active and engaged followers versus bots or inactive accounts                                                                                                                   | Ensures the KOL’s audience aligns with your project’s target demographic     |
| KOL Score                | Weighted measure of KOL performance                      | Combines reach, engagement quality, audience authenticity, and balanced metrics                                                                                                 | Provides an overall evaluation of the KOL’s value                            |
| Tokens Shilled           | Tokens promoted by the KOL                               | Count of token mentions in tweets                                                                                                                                               | Helps evaluate KOL alignment with your project                               |
| Smart Engagement         | Quality of interactions filtered for authenticity        | Counting engagement (quotes, retweets, replies) from verified top 25K influential accounts rather than total engagement                                                         | Highlights meaningful audience connections and influence                     |
| Smart Followers          | Quality of followers filtered for authenticity           | Counting followers from verified top 25K influential accounts rather than total followers                                                                                       | Highlights meaningful audience connections and influence                     |
| Smart Reach              | Total number of impressions generated by a given account | <p>We calculate:<br>1. Impressions from the account’s own posts. <br>2. Impressions from posts mentioning the account. <br>3. Impressions from direct quotes of the account</p> | Highlights account's full reach                                              |


# Post Feed

<figure><img src="/files/lGgYeAebzOOLW6bZbiGW" alt=""><figcaption><p>Exploring a feed of posts about a given project</p></figcaption></figure>

To explore the actual content being shared, you can utilize the Twitter Feed feature at any time:

* **Accessing the Feed**: Click on a specific row in the table or on a bar in the chart to open a feed of posts either from a particular day or by a specific KOL. This immediate access allows you to delve deeper into the data that interests you most.
* **Sorting Options**: Within the feed, you have the flexibility to sort posts by time, impressions, or engagement. This helps you focus on the most recent updates, the most viewed posts, or the content generating the most interaction.
* **Top Post Metric**: Each post includes a metric indicating how long it stayed at the top of the KOL’s feed. This provides insight into the post’s prominence and longevity, showing you which content maintains audience attention over time.

By examining the Twitter Feed, you can gain a richer understanding of the narratives and messages that resonate with audiences, helping you tailor your own content and engagement strategies accordingly.


# Your KOLs

KOL Lists is a powerful feature that allows you to organize your KOLs into specific subgroups, making it easier to track and analyze their influence on your brand. Whether you’re managing a global brand with multiple target markets or focusing on niche communities, KOL Lists provide the flexibility to segment and monitor these key individuals more efficiently.

<figure><img src="/files/RJQ83VH2PJQ2svWdakWJ" alt=""><figcaption></figcaption></figure>

### Why Use KOL Lists?

Key Opinion Leaders play a crucial role in shaping public perception and driving brand awareness. By grouping KOLs into distinct categories, you can focus your research and monitoring efforts on specific regions, languages, or communities. For example, if you’re attending or promoting an event like Token2049, you might want to create lists such as:

* Token2049 Chinese KOLs
* Token2049 English KOLs
* Brand Ambassadors KOLs

This enables you to quickly access information and insights about how different lists of KOLs are engaging with and influencing your brand in different markets.


# Importing KOL Lists

## Step 1: Click on “Add KOLs” from the Project Dashboard

* Locate the “Add KOLs” Button

<figure><img src="/files/PTsHjOl4SxUaM9nqPAUJ" alt=""><figcaption></figcaption></figure>

## Step 2: Click the “Import CSV” Button

1. Find the “Import CSV” Option:
2. In the top-right corner of the “Add KOLs” page, click on the “Import CSV” button. This will open the CSV import interface.

## Step 3: Upload Your CSV File

Choose How to Upload:

* Drag and Drop:
  1. Locate your CSV file on your computer.
  2. Drag the file and drop it onto the highlighted area labeled “Drag and drop your CSV file here.”
* Use File Browser:
  * Click the “Import CSV” button again (if the drag-and-drop area isn’t suitable).
  * This will open your system’s file browser.
  * Navigate to the folder containing your CSV file.
  * Select the file and click “Open”.

## Step 4: Select the Relevant Column

Preview Your CSV Data:

* After uploading, a preview of your CSV file’s data will appear on the screen.
* Identify the Correct Column:
  * Look for the column that contains the Twitter handles or X profile URLs of the KOLs.
* Select the Column:
* Click on the header of the relevant column to select it.
* Ensure that only the column with the Twitter handles or profile URLs is selected for accurate processing.

## Step 5: Extract KOL Handles Automatically

Automatic Extraction:

* Our algorithm will automatically process the selected column.
  * It will extract the relevant KOL handles from Twitter handles (e.g., @exampleuser) or X profile URLs.
* Review Extracted Handles:
* Verify that the extracted handles are correct.
* If there are any errors, you may need to adjust your CSV file or re-select the appropriate column.

## Step 6: Name Your List and Save

1. Provide a List Name:
   1. Enter a unique and descriptive name for your KOL list in the “List Name” field. This helps you organize and manage multiple lists within the platform.
2. Save the List:
   1. Click the “Save” button to finalize the import process.
3. Confirmation:
   1. You should see a confirmation message indicating that your list has been successfully uploaded.
4. Processing:
   1. The platform will begin processing the KOLs in your list. This may take some time, during which the loading status will be displayed.

## Additional Tips

#### CSV File Format:

* Ensure your CSV file is properly formatted with headers for each column.
* Only one column should contain the Twitter handles or profile URLs.

#### Data Accuracy:

* Double-check that all Twitter handles are correct and active to avoid processing errors.

#### Handle Formats:

* Twitter handles shouldn't include the “@” symbol (e.g., @exampleuser).
* Profile URLs should be complete (e.g., <https://twitter.com/exampleuser>).

#### Avoid Duplicates:

* Remove any duplicate entries in your CSV file to streamline the processing time.

## What Happens Next?

#### Data Collection and Analysis:

1. The platform will collect data from each KOL’s Twitter activity over the past three months.
2. It will analyze tweets, engagements, and other relevant metrics.

#### Loading Status:

During this time, a loading status will appear next to each KOL in your list.

* Processing typically takes about one hour but may vary based on system load and data volume.


# Understanding the loading status during KOL upload

When you upload a Key Opinion Leader (KOL) to our platform, you might notice a “Loading” status appearing next to their profile. This status indicates that our system is actively collecting and analyzing data related to the KOL to provide you with comprehensive insights.

<figure><img src="/files/nV95srDAmecktt8c0YbA" alt=""><figcaption></figcaption></figure>

## What Does the Loading Status Mean?

The Loading status signifies that our platform is:

1. **Collecting Relevant Data**: Gathering all available tweets and interactions from the KOL over the past three months.
2. **Analyzing Tweets**: Carefully examining each tweet to assess various metrics.
3. **Scoring the KOL**: Calculating scores based on engagement, influence, and other key indicators.

## How Long Does It Take?

* **Typical Duration**: The process usually takes about one hour.
* **Possible Delays**: Processing may take longer if the system is experiencing high demand or if the KOL has a high volume of activity.

## What Happens During This Time?

1. ⏳ **Data Collection**&#x20;
   1. Our system retrieves all tweets, retweets, replies, and engagements from the KOL’s Twitter account over the last three months.
   2. We ensure that no significant interaction is missed to provide a holistic view of the KOL’s influence.
2. 🔬 **Data Analysis**
   1. Each piece of content is analyzed for sentiment, reach, engagement, and relevance.
   2. Advanced algorithms evaluate the quality and impact of the KOL’s activity.
3. 📈 **Scoring and Reporting**
   1. The KOL is scored based on predefined criteria important for your analytics needs.
   2. A detailed report is prepared for you to review once the processing is complete.


# Managing KOLs in a given project

<figure><img src="/files/aesnPeBCCOmsStHPTgzw" alt=""><figcaption><p>Button to include/exclude KOL lists from a given project</p></figcaption></figure>

We know that effectively managing your KOLs is crucial for amplifying your project’s reach and impact. That’s why we’ve made it easy for you to create and manage KOL Lists directly from your project dashboard.

{% hint style="info" %}
If you haven't imported your custom KOL Lists yet, use this [**guide**](/cookie3-analytics/features/kol-intelligence/your-kols/importing-kol-lists) to learn more!
{% endhint %}

## Customizing Your Dashboard with KOL Lists

* Toggle Your KOL Lists: Once you’ve created a KOL List, you can easily focus your dashboard on these specific influencers.
* Select and Add Your List: Choose your KOL List from the dropdown menu and click on the “Add +” button. Your dashboard will instantly update to highlight data from these KOLs.
* Visualize Their Impact: The charts and metrics will now showcase how your selected KOLs are engaging with your project. You’ll see bars in the chart split into subgroups, giving you a clear view of each KOL List’s contribution to your project’s success.

<figure><img src="/files/loa67BqTgRBnZWHNhcED" alt=""><figcaption><p>Chart showing engagement per KOL List in relation to organic engagement</p></figcaption></figure>

By managing your KOLs through these customizable lists, you gain greater control and insight into your influencer strategies. Whether you’re tracking brand ambassadors, new collaborators, or specific segments of influencers, our platform empowers you to:

1. Tailor Your Outreach: Focus on the KOLs who matter most to your goals.
2. Monitor Specific Groups: Compare performance across different KOL Lists to see who’s driving the most engagement.
3. Engage More Effectively: Organize your influencers in a way that streamlines communication and collaboration.


# KOL List summary

<figure><img src="/files/mx0X3d66nPmeTuJJ14cR" alt=""><figcaption><p>KOL List summary page</p></figcaption></figure>

## Dive Deeper into KOL Performance

Want to learn more about how your KOLs are performing overall?

* **Click on the KOL List Name**: At any time, you can click on the name of your KOL List to go to its dedicated Summary Page.
* **Explore Comprehensive Metrics**: Here, you’ll find detailed metrics about your KOL List’s overall influence, beyond just their interactions with a specific project. This helps you understand the broader impact your influencers have across different initiatives.


# AI-powered KOL scoring system

<figure><img src="/files/kssNT64PQr9C0bIYpHs9" alt=""><figcaption><p>Each KOL in KOL Intelligence is scored with advanced AI models</p></figcaption></figure>

Our platform employs an advanced AI-driven scoring system to evaluate Key Opinion Leaders (KOLs) comprehensively. This system helps you gain valuable insights into the influence, credibility, and reach of each KOL without delving into the intricate details of the calculations. Here’s an overview of the key components:

## Components

### Audience credibility

**Assessing Influence Through Followers**: We analyze the KOL’s follower base to determine the quality and credibility of their audience. By examining the influence of their followers—particularly other recognized KOLs—we gauge the potential reach and impact of their content.

#### Why it matters?

A KOL followed by other influential figures is more likely to have a significant impact, as their messages resonate through networks of credible sources

### Content Quality

**Evaluating Tweet Composition:** Our AI scrutinizes the KOL’s recent tweets to assess their quality. Factors considered include the richness of the content, appropriate use of hashtags, mentions, links, and the inclusion of multimedia elements like images or videos.

#### Why it matters?

High-quality content is more engaging and has a better chance of influencing the audience. Well-crafted messages with relevant elements enhance the KOL’s effectiveness.

### Impression Reach

**Measuring Visibility and Engagement:** We examine how many impressions the KOL’s tweets receive, reflecting the visibility and potential impact of their content within their audience.

#### Why it matters?

A higher impression count indicates that the KOL’s messages are widely seen, increasing the likelihood of engagement and influence.

## Final score calculation

Our AI synthesizes the evaluations from the above metrics to generate a final score for each KOL. This score is normalized to provide a clear comparison between different KOLs.


# Campaigns

Learn how to run KOL Campaigns with KOL Intelligence

## KOL Campaigns Overview <a href="#docs-internal-guid-7e578f23-7fff-7f42-5de6-83e27c50d3d5" id="docs-internal-guid-7e578f23-7fff-7f42-5de6-83e27c50d3d5"></a>

KOL (Key Opinion Leader) campaigns are an efficient way to track the performance of affiliates participating in your paid KOL marketing efforts. This guide will walk you through setting up, managing, and monitoring your KOL campaigns.

### Getting Started with KOL Campaigns

To create a KOL campaign, navigate to the KOL Intelligence section of the platform and follow the steps outlined below.

#### 1. Select KOL List

First, create or select a KOL list that will participate in the campaign. You can manage and create KOL lists by following the instructions[ here](https://docs.cookie3.com/cookie3-analytics/features/kol-intelligence/your-kols/importing-kol-lists).

#### 2. Set KOL Budget

Once the KOL list is selected, you will be asked to input the budget for each KOL. This budget will be used to calculate relevant metrics for reporting purposes.

#### 3. Specify Deliverables

Next, define the campaign's deliverables. For each deliverable, you will need to specify the following details:

* Name of the deliverable (e.g., Airdrop Post)
* Dates of the deliverable (e.g., 12.12.2024 – 24.12.2024)
* Required mentions within the content (e.g., $COOKIE, cookie.fun, or @cookiedotfun)
* Perform targeted queries with boolean operators such as <kbd><mark style="color:green;">AND<mark style="color:green;"></kbd>or <kbd><mark style="color:green;">OR<mark style="color:green;"></kbd> rather than commas ( e.g., AI Agents <mark style="color:green;">AND</mark> NFT)&#x20;

Once you have specified all the deliverables, you will be directed to a new page where you can monitor the performance of your campaign.

### Monitoring Campaign Performance

<figure><img src="/files/eHj028cA4mwdA3pcm2Of" alt=""><figcaption></figcaption></figure>

On the campaign monitoring panel, you will be able to view and analyze the following metrics:

* **Post Trends**: Visualizes posting activity over time in your campaign, allowing you to correlate KOL content volume with key performance metrics such as price, total volume (24h), market cap, sentiment, mindshare, and YouTube mindshare.

<figure><img src="/files/nSeB8O7YzCtvdancv52V" alt=""><figcaption></figcaption></figure>

* **Posts by KOL:** Breaks down total posting activity by individual KOLs to identify top contributors and assess who drives the highest content output during the campaign period.

<figure><img src="/files/7242AgjVkjrQtApcxRpB" alt=""><figcaption></figcaption></figure>

* **CPM by KOL:** Displays the cost per thousand impressions (CPM) for each KOL to evaluate cost efficiency and optimize budget allocation across influencer tiers.
* **Engagement Rate by KOL:** Measures the engagement ratio for each KOL’s posts, helping compare how effectively different creators connect with their audiences
* **Engagement vs. KOL Cost:** Plots engagement metrics against KOL spend to reveal the relationship between investment and performance, highlighting which KOLs deliver the best value for impact.

You can filter and analyze the data in real time to track the overall performance of the campaign.

#### Tracking Performance by KOL

At the bottom of the campaign panel, you will see a table view that provides a detailed breakdown of the performance for each KOL. This includes the metrics mentioned above, allowing you to assess the performance of each affiliate individually.

### Sidebar Features

The hand sidebar provides aggregated information about the overall campaign performance and contains options for editing various campaign details.

<figure><img src="/files/EiTj94JDhV4SyTV3vTjq" alt="" width="321"><figcaption></figcaption></figure>

#### Edit KOLs

Click the Edit KOLs button to add or remove KOLs from the campaign.

#### Edit Budget

Click the Edit Budget button to modify the budget allocated to each KOL.

#### Edit Campaign Details

Click the Edit button to update the following campaign information:

* Campaign Name
* Campaign Description
* Token Information: If the campaign is related to a specific on-chain token, you can track token-related data.
* Website Correlation: If you are using Cookie3 Website Analytics, you can associate a website with the campaign to track correlations between posts, website visitors, and wallet connections. Learn more about setting this up[ here](https://docs.cookie3.com/cookie3-analytics/setup-your-site-or-app).
* Public Page Configuration: Create an internal or public-facing webpage to report on campaign performance. You can also add information about your company and upload a logo for presentation purposes.

### Deliverables Section

<figure><img src="/files/vo9uYkqqz3QfVX9JcJ1l" alt="" width="322"><figcaption></figcaption></figure>

In the Deliverables section, you can:

* Search for deliverables
* Track the completion status of each deliverable
* Edit existing deliverables or add new ones if the campaign requires updates
* Add your type of deliverable, whether retweets, quote tweets, or replies.


# Token Analytics

### How to use Token analytics? <a href="#how-to-use-token-analytics" id="how-to-use-token-analytics"></a>

<figure><img src="/files/g8WalyOfblhhNey536dx" alt=""><figcaption><p>Token Analytics offers a unique perspective on the holders of a specific token</p></figcaption></figure>

#### Step 1: Choose a token or NFT collection <a href="#step-1-choose-a-token-or-nft-collection" id="step-1-choose-a-token-or-nft-collection"></a>

Paste in the smart contract or type in the name of a token or NFT collection.

#### Step 2: Analyze data <a href="#step-2-analyze-data" id="step-2-analyze-data"></a>

Discover token prices, holders count, whales insights, and token holders retention rate.

#### Step 3: View in the Onchain explorer <a href="#step-3-view-in-the-on-chain-explorer" id="step-3-view-in-the-on-chain-explorer"></a>

If you want to know more behavioral data about the token holders, switch to [Onchain explorer ](/cookie3-analytics/features/onchain-explorer)by clicking the *View in onchain explorer* button in the top right corner.


# Referral Systems

{% hint style="info" %}
In order to fully utilize this feature you should first create a Conversion Event inside the Cookie3 Analytics app. Head to [this article](/cookie3-analytics/features/conversion-events) to read a short guide about how they work!
{% endhint %}

### Getting Started

Welcome to Cookie3's Referral System! This guide will help you quickly set up and implement our referral tracking and conversion system.

### Overview

Cookie3's Referral System allows you to:

* Track user referrals through custom URL parameters
* Monitor conversion events
* Access detailed analytics on referral performance

### Prerequisites

Before you begin, ensure you have:

1. Connected your website to Cookie3 Analytics
2. Created a Conversion Event in the Cookie3 Analytics app
3. Obtained your website's `siteId`
4. Obtained your Conversion Event's ID

For more information on these prerequisites, please refer to our separate guides.

## Step-by-step setup guide

{% content-ref url="/pages/ziVlBdQHopMea3vWTxks" %}
[Setup referral tracking](/cookie3-analytics/api/referral-systems/setup-referral-tracking)
{% endcontent-ref %}

{% content-ref url="/pages/47rlUJgeh0tQ6cYCfI1Y" %}
[Accessing leaderboard and user data](/cookie3-analytics/api/referral-systems/accessing-leaderboard-and-user-data)
{% endcontent-ref %}

{% content-ref url="/pages/6sLSICVbMQzt69lbqWVT" %}
[API Response schema](/cookie3-analytics/api/referral-systems/api-response-schema)
{% endcontent-ref %}

## Best practices

{% content-ref url="/pages/Sq9YWmU517Bubwy2qkVT" %}
[Best practices](/cookie3-analytics/api/referral-systems/best-practices)
{% endcontent-ref %}

## FAQ

{% content-ref url="/pages/FCuK0NjxrcnJ2nT4Uqb9" %}
[FAQ](/cookie3-analytics/api/referral-systems/faq)
{% endcontent-ref %}


# Setup referral tracking

### Setting Up Referral Tracking

To track referrals, use URL parameters that identify each referrer. The most common parameters are `?ref=` and `?utm_source=`.

#### Using ?ref= Parameter

```
https://yourwebsite.com/?ref=uniqueReferrerID
```

#### Using ?utm\_source= Parameter

```
https://yourwebsite.com/?utm_source=referrerName&utm_medium=referral&utm_campaign=referralProgram
```

## Implementing Conversion Tracking

To measure the effectiveness of your referral program, you need to track conversions resulting from referrals.

### Tracking Custom Events

You can track custom events, such as account creations, by triggering events from your frontend code.

#### Example: Tracking Account Creation

```javascript
window.cookie3.trackEvent({
 category: "account",
 action: "new account creation"
});
```

### Setting Up Conversion Events in Cookie3

1. Access the Conversion Events Tab in your Cookie3 dashboard
2. Click on "Add Conversion Event"
3. Define the Conversion Criteria:
   * Category: Set to "account"
   * Action: Set to "new account creation"
4. Save the Conversion Event


# Accessing leaderboard and user data

To retrieve the Leaderboard metrics, make a `POST` request to:

```url
https://wa.api.gateway.cookie3.co/acquisition/getGroupedMetrics
```

#### Sample Request Body

{% hint style="info" %}
To find out your Conversion Event's ID head over to [this article](/cookie3-analytics/features/conversion-events/retrieving-your-conversion-event-unique-id).
{% endhint %}

```json
{
  "filter": {
    "dateFrom": "2024-10-01T00:00:00.000Z",
    "dateTo": "2024-10-31T23:59:59.999Z",
    "sites": ["<YOUR_SITE_ID>"]
  },
  "primaryGroupingDimension": "CustomReferrer",
  "goalIds": ["yourConversionEventId"]
}
```

### Parameters Explained

* **Filter:**
  * `dateFrom` and `dateTo`: Specify the time frame in ISO datetime format
  * `sites`: An array of siteIds
* **Primary grouping dimension:** Groups data by primary dimension (e.g., **CustomReferrer**)
* **goalIds:** An array of your Conversion Event IDs

## Retrieving Data for a Particular User

{% hint style="info" %}
To find out your Conversion Event's ID head over to [this article](/cookie3-analytics/features/conversion-events/retrieving-your-conversion-event-unique-id).
{% endhint %}

To retrieve data for a specific user, add the `customFilters` object to your request body:

```json
{
  "filter": {
    "dateFrom": "2024-10-01T00:00:00.000Z",
    "dateTo": "2024-10-31T23:59:59.999Z",
    "sites": ["<YOUR_SITE_ID>"]
  },
  "customFilters": {
    "equalFilterCustomReferrer": [
      "cookie-monster"
    ]
  },
  "primaryGroupingDimension": "CustomReferrer",
  "goalIds": ["yourConversionEventId"]
}
```


# API Response schema

### Interpreting the API Response

```json
[
  {
    "primaryDimension": "Referral",
    "secondaryDimension": "uniqueReferrerID",
    "totalVisitsCount": 150,
    "totalVisitorsCount": 140,
    "newVisitorsCount": 100,
    "uniqueWalletsCount": 80,
    "web3VisitorsCount": 70,
    "engagedVisitsCount": 120,
    "engagementRate": 0.8,
    "engagedVisitsRate": 0.75,
    "averageNumberOfPagesPerVisit": 3,
    "averageVisitDurationSeconds": 180,
    "totalEventsCount": 200,
    "conversionsCount": 50,
    "visitorsWithConversionCount": 45,
    "averageConversionsCountByVisitor": 1.1,
    "conversionsUsdValue": 5000
  }
]
```

### Metrics Explained:

* **`totalVisitsCount`**: Total number of visits from the referrer.
* **`newVisitorsCount`**: Number of first-time visitors.
* **`engagementRate`**: Proportion of engaged visits
* **`conversionsCount`**: Total number of conversions
* **`conversionsUsdValue`**: Monetary value of conversions

## Utilizing the Data

Use this data to:

* Identify top-performing referrers.&#x20;
* Calculate conversion rates per referrer.&#x20;
* Optimize marketing strategies based on performance.


# Best practices

### Best Practices for Referral Programs

Implementing an effective referral program can significantly boost your user acquisition and engagement. Here are some best practices to maximize the impact of your referral system:

#### 1. Set Clear and Attractive Incentives

* Offer rewards that are valuable to both the referrer and the referee
* Consider tiered rewards for multiple successful referrals
* Ensure the reward aligns with your product or service

Example: "Refer a friend and both get a 20% discount on your next purchase!"

#### 2. Make Sharing Easy

* Provide pre-written messages for social media and email sharing
* Create unique, short URLs for each referrer
* Implement one-click sharing buttons for popular platforms

#### 3. Create Compelling Messaging

* Clearly communicate the benefits of your product or service
* Highlight the rewards for successful referrals
* Use persuasive language that encourages action

Example: "Love our product? Share the joy with friends and earn rewards!"

#### 4. Track and Analyze Performance

* Regularly review your referral metrics using the Cookie3 dashboard
* Identify top performers and analyze their success factors
* A/B test different incentives and messaging to optimize conversion rates

#### 5. Personalize the Referral Experience

* Use the referrer's name in the invitation message
* Customize landing pages for referred users
* Send personalized follow-ups to both referrers and referees

#### 6. Ensure Compliance and Transparency

* Clearly disclose the terms of your referral program
* Comply with relevant regulations (e.g., FTC guidelines in the US)
* Be transparent about how personal data is used and shared

#### 7. Integrate with Your Overall Marketing Strategy

* Promote your referral program across all marketing channels
* Use email marketing to remind users about the referral program
* Highlight successful referrals and testimonials in your marketing materials

By following these best practices, you can create a referral program that not only attracts new users but also enhances loyalty among your existing customer base


# FAQ

### FAQs

Here are answers to some frequently asked questions about the Cookie3 Referral System:

#### Q: How is referral attribution handled?

A: Cookie3 uses a last-non-direct-click attribution model. The most recent referrer gets credit for the conversion, with a 30-day attribution window by default. [Read more about it here.](/cookie3-analytics/features/conversion-events/how-our-attribution-works)

#### Q: What happens if a user comes through multiple referral links?

A: The first recent referral link takes precedence.

#### Q: How long are referrals tracked?

A: By default, referrals are tracked for 30 days.&#x20;

#### Q: Can I customize the referral link parameters?

A: Yes, you can use custom parameters beyond the standard `ref` and `utm_source`. Contact our support team for assistance in setting up custom parameters.

#### Q: How do I ensure my referral program complies with privacy regulations?

A: Cookie3 is designed with privacy in mind. Ensure you have proper consent mechanisms in place and clearly disclose your data collection practices in your privacy policy. [Read more about them here.](/cookie3-analytics/setup-your-site-or-app/setting-up-consent-management)

#### Q: Can I A/B test different referral rewards?

A: Yes, you can create multiple referral campaigns with different rewards and compare their performance using our analytics dashboard by setting up multiple [conversion events](/cookie3-analytics/features/conversion-events) and [filtering your leaderboard data by particular conversion event IDs](/cookie3-analytics/api/referral-systems/accessing-leaderboard-and-user-data).

#### Q: How often is the referral data updated?

A: Referral data is updated every 15 minutes.