🚀 Start Here

See SDK for installation instructions

The purpose of this attribution tool is to acquire more users at lower customer acquisition cost. And retain those users so that the average lifetime revenue per user increases as your company grows and scales.

In order to do this, you will need an attribution system. This documentation server is written both for advanced users who have used attribution and retargetting systems before, and also new startup founders or CMO's or Sales Executives that want a step by step walkthrough.

How businesses interface with our product

The businesses we serve typically sell products, technology products. They are typically B2C. Examples include

  • Exchanges

  • L1's

  • L2's

  • DeFi

  • SocialFi

  • GameFi and Traditional Web 2 Gaming

  • AI companies and SaaS

  • Media Companies such as CoinDesk

If you are a business, any business really, your goal is to sell a product, and monetize your users. You spend money on marketing. This can be in the form of paid ads or social and/or organic. However, at the end of the day there is no free lunch.

Even if you are posting organic content and doing social media, you are still paying for it.

In summary what we do

We give businesses the decision making accuracy to get the best ROI on any type of marketing spend. Specifically we serve web3 customers, but we serve all businesses no matter what their domain as long as they are generating revenue and have a good product to sell.

🙋‍♀️ Frequently Asked Questions

If there are any questions that haven't been answered yet, please ask them in our Telegram Group

What is Lucia Attribution

Lucia Attribution is the name of our ad-tech platform. Lucia Atribution is a way for a company to be accountable on their marketing spend. The platform is hosted on our website


Do you support organic/non-paid advertising

Absolutely! Many projects in crypto, AI, and even traditional tech focus heavily on social media, short form, long form video based advertising. Our product is designed 100% to be an all-in-one solution for social/organic/non-paid advertising of all forms.


What problem e are trying to solve

Many businesses struggle to effectively target and engage potential customers due to a lack of advanced tools and analytics, or they use analytics products but due to inaccuracies make the wrong decision.

If you use tools such as Google Analytics or Mixpanel, you'll often find that you get analytics results in a lump sum format. This information isn't actually meaningful because you have no idea of knowing if your business is becoming more or less profitable on the unit basis. As in, on a per-customer basis, is your company acquiring customers for lower and lower costs, and if your company on a per-customer basis realizing more and more revenue from each customer averaged over the lifetime tenure of that person being a customer of your product!


What type of insights your product will give

Our Ad Attribution System provides a comprehensive suite of insights derived from SDK, designed to enhance your understanding of user engagement and conversion metrics. Here's what our system offers:

  • Daily Clicks Analysis: We provide a detailed graph showing the number of clicks your ads or organic content receive each day, allowing you to track engagement trends over time.

  • Unique Wallet Address and Device Tracking: Our system identifies the number of unique devices accessing your website, which decodes the lump sum of your marketing data, and groups it by actual identity.

  • Page Visit Insights: We track page visits to give you a detailed understanding of which pages attract the most attention and how users navigate through your site.

  • Acquisition Information: If you're struggling to grow your product - let's say you just launched and your twitter is growing at low rate of 10 followers a week, and your DApp/mobile app is growing at an abysmal 3 daily active users a day, this product is perfect for you. You'll be able to test out a large range of marketing strategies that companies similar to yours have done, which allowed them to grow from 0 daily active users to well over 100,000. Why our product is so crucial is it allows you to measure out of the 5 different acquisition strategies, which strategies are the most cost efficient so you do not run out of run way before you company hits a meaningful scale.

  • Conversion Information: For users who convert, such as by providing an email ID and username to access a paper or other resources, we capture and report these conversion events. This data helps you understand what drives users to take action.


Tokenomics

You can look at our tokenomics here

Data Driven Marketing

Why all startups need this product

Consider these 2 scenarios

One startup founded by Alice collects all sorts of customer data at scale. The types of link they click on. The IP address of its users, Even things like timezone, locale, language.

She uses machine learning to automate a lot of her marketing campaigns. These can include

  • Emails

  • In App Push Notifications

  • Messages from Telegram or Discord

  • X Paid Ads

Another startup founded by Bob is a crypto exchange. He likes to play things by gut feeling. When its a bull market, he does crazy marketing stunts, helicopters, Superbowl ads, and tries to hit a home run. The only problem...? Bob is ridiculously inconsistent. Over time, he loses accountability and each marketing dollar being spent does not result in more than a dollar back into the business. Ultimately his business folds.

Illustration

You can imagine why its important to collect data on your users.

By understanding when users are most impressionable, you get their attention with your ad, they are focused on your offer, have time to think about your product. And may make a purchasing decision later.

But if you are like Bob, shooting from the hips, you're never going to get your customer's attention because you don't realize you are advertising or marketing to him at the worst possible time ever (when he is the most busiest).

Apply this logic not just to 2 customers but to 2 million customers. The companies that figure out Peformance Marketing are the ones that take their companeis to over 100 million dollars in valuation.

Links

A Lucia Link is a way for you to collect attribution data across all customers.

Overview

Links are the lifeblood of the Lucia Attribution system. With them, you're able to see the analytics involved in the relationships between each of your assets. For a web3 company, we would define your assets as

  • Your DApp page or CEX page

  • Your landing page which may feature a blog

  • Your YouTube Channel and the X accounts your KOL's manage

  • Your Socials: Telegram/Discord/X/Farcaster/Medium

How to create a link on Lucia

Click on the New Link button in the center

OR

Click on the New Link button on the top right corner to start creating a new link

  • Click on the Link tab on the top to create a new Link.

  • Enter the Target Url you want your users to redirect to.

    Example : https://google.com

  • Click on Generate Link button.

Copy the link to share for your business or social media platforms.

Click on the Go to link dashboard button to view all your links and campaigns created.

3) 💻 Dashboard

All your links and campaigns created can be found in the dashboard

How to create a campaign on Lucia

Click on the New Campaign button in the center

OR

Click on the New Campaign button on the top right corner to start creating a new Campaign

1) ✏️ Enter Campaign Details

  • Click on the Campaign tab on the top to create a new Link.

  • Enter the Target Url you want your users to redirect to.

    Example : https://google.com

  • Choose a Platform you want to use this campaign for.

    Example : Facebook

  • You can also add some Description to give more details about this campaign

  • Click on Generate Link button

2) 🎉 Congrats. Your Campaign has now been created

Copy the link to share for your business or social media platforms.

Click on the Go to link dashboard button to view all your links and campaigns created.

3) 💻 Dashboard

All your links and campaigns created can be found in the dashboard

Installation and initialization for a browser environment using a Javascript SDK

For Single-Page Applications (React, Angular, Vue, Svelte, etc).

Install our sdk using

npm


npm install luciasdk-t3 

OR

yarn


yarn add luciasdk-t3

Add lucia.js in the root folder with the following:


app.js

import 'lucia.js';

page.js


import LuciaSDK from 'lucia-t3';

LuciaSDK.init({

  baseURL: 'https://api.clickinsights.xyz',

  // Get your API Key from https://ads.clickinsights.xyz
  api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 

});

For Mutli-Page Application


include the script


<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({
    
    baseURL: 'https://api.clickinsights.xyz',
    
    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

</script>

Track Specific Events


Page View

For Single-Page Applications (React, Angular, Vue, Svelte, etc).

import LuciaSDK from 'lucia-t3';

LuciaSDK.pageView('PAGE-NAME');

Example

import LuciaSDK from 'lucia-t3';

LuciaSDK.pageView('home');

For Mutli-Page Application

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

  LuciaSDK.pageView('PAGE-NAME');

</script>

Example

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

  LuciaSDK.pageView('home');
  
</script>

Track Conversion

For Single-Page Applications (React, Angular, Vue, Svelte, etc).

import LuciaSDK from 'lucia-t3';

LuciaSDK.trackConversion(
  event_tag, 
  amount, 
  event_details
);

Example

import LuciaSDK from 'lucia-t3';

LuciaSDK.trackConversion(
  "purchase", //event_tag
  500, //amount
  { 
    //event_details
    product_id: 'bag_123', 
    quantity: 1, 
    brand: 'Nike'
  }
);
 

For Mutli-Page Application

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });
  
  LuciaSDK.trackConversion(
  event_tag, 
  amount, 
  event_details
);

</script>

Example

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });
  
  LuciaSDK.trackConversion(
  "purchase", //event_tag
  500, //amount
  { 
    //event_details
    product_id: 'bag_123', 
    quantity: 1, 
    brand: 'Nike'
  }
);

</script>

User Information

For Single-Page Applications (React, Angular, Vue, Svelte, etc).

import LuciaSDK from 'lucia-t3';

LuciaSDK.userInfo(
  user, 
  userInfo
);

Example

import LuciaSDK from 'lucia-t3';

LuciaSDK.userInfo(
  "johndoe@email.com", 
  { 
    first_name : "John", 
    last_name: "Doe", 
    contact: "1234456722" 
  }
);

For Mutli-Page Application

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

  LuciaSDK.userInfo(
  user, 
  userInfo
);

</script>

Example

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

  LuciaSDK.userInfo(
  "johndoe@email.com", 
  { 
    first_name : "John", 
    last_name: "Doe", 
    contact: "1234456722" 
  }
);

</script>

Button Click

For Single-Page Applications (React, Angular, Vue, Svelte, etc).

import LuciaSDK from 'lucia-t3';

LuciaSDK.buttonClick('BUTTON-NAME');

Example

import LuciaSDK from 'lucia-t3';

LuciaSDK.buttonClick('add_to_cart');

For Mutli-Page Application

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

LuciaSDK.buttonClick('BUTTON-NAME');

</script>

Example

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

LuciaSDK.buttonClick('add_to_cart');
  
</script>

Wallet Information

For Single-Page Applications (React, Angular, Vue, Svelte, etc).

import LuciaSDK from 'lucia-t3';

LuciaSDK.sendWalletInfo('WALLET-ADDRESS', 'CHAIN-ID')

Example

import LuciaSDK from 'lucia-t3';

LuciaSDK.sendWalletInfo('0x21342HHJJHJHJhjh87812', 59141)

For Mutli-Page Application

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

LuciaSDK.sendWalletInfo('WALLET-ADDRESS', 'CHAIN-ID')

</script>

Example

<script src=" https://d1b2pxnugd0qwt.cloudfront.net/lucia-t3.min.js"></script>
<script>
  LuciaSDK.init({

    baseURL: 'https://api.clickinsights.xyz',

    // API Key from https://ads.clickinsights.xyz
    api_key: 'bb10bb08-a7298818-3265d018-e9a648ae-95371b44-d25e6c77-38069b79-1e4bd263', 
  
  });

LuciaSDK.sendWalletInfo('0x21342HHJJHJHJhjh87812', 59141)
  
</script>

Return on Marketing Investment

A common problem we see is startups may be making revenue, but they aren't growing quickly. They aren't generating enough revenue to continue to scale their teams.

At the same time, having a limited budget means they are apprehensive on spending money on marketing whether that's non-paid (organic/social) or paid advertising.

Our Dashboard Main Page for Customers

Our Dashboard Main Page for Customers

The top right panel is a graph showing Revenue vs Ad Spend

The area under the curve outlined with the Orange line represents revenue. The area under the curve outlined with the Blue line represents ad spend.

Organic Campaigns

Organic Campaigns usually stem from social media apps.

First after you login you'll see this page. If you're like most startups, you'll want to grow a strong organic community using Telegram, Discord, WhatsApp. In this section of the doc server we'll talk primarily about Telegram but the same concept applies for other chat platforms.

Case Studies

You can follow our Lucia Ad Attribution Case Studies for better insights