👋 Introduction

Welcome to GrowthMate Docs!

Here, you will learn more about our product and how it can help you serve hyper-targeted ads.

About

When we started GrowthMate, we discovered several exciting opportunities in the web3 space. Traditional web2 advertising methods often depend on collecting browsing history, cookies, and likes. In contrast, web3 allows us to utilize more robust data, such as transaction history, wallet balances, or even the time between transactions.

Leveraging this valuable data along with our expertise, we developed a machine learning algorithm that can analyze and predict future events related to users' wallets. For instance, our algorithm can predict the next possible action of a specific user with over 80% accuracy. This powerful insight can be used to make decisions based on wallet activity.

In the advertising sector, this advantage can significantly improve targeting, increase conversion rates, and achieve higher Return On Ad Spend (ROAS). This not only benefits advertisers but also helps publishers present higher-quality ads.

We believe that our model offers substantial benefits to the industry, and we are excited to have you here. Explore our platform and discover how we can transform your advertising efforts and elevate your earnings.

Note

If you still have any questions after going through the documentation, please don't hesitate to contact us at contact@growthmate.xyz.

✨ How to create account

  1. Go to https://app.growthmate.xyz/login
  2. Choose the prefered way to create an account.
  3. Currently we provide Google, X and GitHub as options for our users to login.

Note

Our login options may be changed in the future.

Screenshot 2024-07-23 at 15.07.56

  1. Once you are logged in, you will automatically be redirected to the advertiser's dashboard. If you are a publisher, you can switch to your dashboard by clicking on the top right corner.

ezgif.com-animated-gif-maker

  1. You will find a button there, that will lead you to the coresponding dashboard.

📢 Advertisers

If you are a publisher, please proceed to the Publisher's Section

Note

If you don't know how to switch to Publisher's view read again Account's Creation section.

🛠️ Advertiser's Dashboard

Screenshot 2024-07-22 at 14.44.15

Let's go through the main components:

  1. Each campaign has a status bar that indicates its state:

    Screenshot 2024-07-23 at 10.35.26

  • Running - Indicates all currently live campaigns
  • Ended - Shows all past campaigns that are no longer active
  • Stopped - Lists all campaigns that have been paused
  • PendingReview Displays campaigns that have been created and await our approval
  • PendingPayment Appears when a campaign is created but the deposit hasn't been received yet (processing time may vary depending on the payment method selected)
  1. Next to the status bar, you see the campaign name: Example Campaign
  2. Below, you will find detailed information about your campaign Screenshot 2024-07-23 at 10.51.32
  • 24,530 shows the total number of impressions for your campaign
  • 67 shows the number of times viewers have clicked on your ad campaign
  1. Each running campaign has also a remaining balance, where spendings are tracked Screenshot 2024-07-23 at 10.55.44

  2. Once the campaign has been ended, we can see its performance by clicking on Statistics. If you are satisfied with the results, you can Renew it Screenshot 2024-07-23 at 11.04.38

  3. To delete a past campaign, click on the 🗑️

Create a new campaign:

To create a new campaign, you can either hover over the box next to your exisitng campaigns or simply click the top right. Screenshot 2024-07-23 at 11.11.43

Screenshot 2024-07-22 at 14.44.15

Instructions how to create a new campaign can be found in Studio

📘 Advertiser's Studio

Here you will find step-by-step explanation how to create your first campaign.

New Campaign:

Creating a new campaign is easy, just follow the steps:

  1. Enter the name of your selected campaign.
  2. Provide the URL link to your ad campaign. This link is crucial as it directs viewers to your campaign whenever they click on the ad.

Screenshot 2024-07-23 at 11.42.44

3.Choose the desired format Screenshot 2024-07-23 at 11.53.27

  • Currently we support 3 types:

    Large Square 250px x 250px

    Small Square 200px x 200px

    Banner 320px x 50px

Note

Please note that these sizes may vary over time.

  1. The next step is to upload the ad image.

Screenshot 2024-07-23 at 12.06.54

Note

Please ensure that you upload an image with the correct size. If the image size is incorrect, you won't be able to proceed to the next step.

  1. Next is selecting the target audience

Screenshot 2024-07-23 at 12.17.58

Currently, we offer two main options for running your campaign:

  • Reach This option will serve the ads to everyone

Example

It's ideal for brand awareness campaigns, as it maximizes the reach of your ad to a wide audience. This approach is great for introducing new products or services and building a broad audience base.

  • Conversion uses our algorithm to target the most appropriate users, maximizing engagement and conversions.

Example

It aims to drive higher engagement and conversion rates. It is perfect for campaigns that have specific goals such as sales, sign-ups, or other user interactions, ensuring that your ad budget is spent more effectively.

Additionally, you can target viewers based on their net worth. For example, if you want your ad to be seen only by users with a wallet balance between $100 and $100,000, adjust the slider to reflect these values.

Lastly, you can choose from various campaign tags in order to filter users based on their interests in specific categories.

Screenshot 2024-07-23 at 13.19.06

  1. We are almost ready. Now, select the budget for your campaign.

Screenshot 2024-07-23 at 13.28.58

  1. Once you are ready, review the campaign. If everything looks good, submit it to create your new campaign.

Screenshot 2024-07-23 at 13.29.52

  1. Congrats! Your campaign was created. Now you will be proceeded to the Campaign Payment

Ad Campaign Selection System

This document outlines how our ad serving system selects which campaigns to show. The system aims to balance multiple factors to ensure optimal campaign performance while maintaining fairness in the auction process.

Campaign Selection Factors

Our system considers multiple aspects when choosing which ad to serve:

  1. Campaign Performance
    We evaluate how well each campaign matches the current context, including factors like relevance and predicted performance.

  2. Bidding System
    We use a modified perturbed-second-price auction system that:

  • Ensures advertisers never pay more than their maximum bid
  • Encourages honest bidding: Second-price auctions incentivize participant to bid their true value, as well as reduce winner's curse. Perturbations prevent some price manipulations, such as "spiteful-bidding".
  • Maintains a minimum floor price to ensure alignment with publishers.
  1. Campaign Progress
    The system monitors campaign progress to ensure delivery goals are met, considering:
  • Remaining budget
  • Campaign timeline
  • Targeting goals
  1. Fair Distribution
    To maintain a healthy advertising ecosystem, our system includes mechanisms to:
  • Prevent any single campaign from dominating the available inventory
  • Ensure fair competition between different types of campaigns
  • Balance delivery across all active campaigns

Best Practices for Advertisers

  1. Set Realistic Bids

    • Bid your true value
    • Our auction system reduces your chance to overpay
    • Consider using different bids for different audience segments based on their value to your campaign
  2. Campaign Setup

    • Clearly define your target audience
    • Set appropriate campaign durations based on your budget and goals.

    Tip

    We recommend to:

    • Create your campaign at least 24 hours before your expected start date
    • Minimum campaign duration of 1 week
    • Use relevant targeting criteria that align with your objectives
  3. Optimization Tips

    • Focus on improving ad relevance and quality rather than trying to game the system
    • Monitor performance metrics to understand what works best for your audience

Campaign Types

Our system supports different campaign optimization goals:

  • Conversion: For advertisers focusing on reaching only some specific and well-defined audience.
  • Reach: For advertisers aiming to reach the broadest relevant audience.

Each type has its own bidding considerations and best practices that our system automatically accounts for.

Tip

Our system excels at discovering untapped audiences for Reach campaigns, often finding valuable users at competitive prices. For advertisers looking to expand their audience efficiently, Reach campaigns can be particularly cost-effective.

📺 Publishers

If you are an advertiser, please proceed to the Advertiser's Section

Note

If you don't know how to switch to Advertiser's view read again Account's Creation section.

🛠️ Publisher's Dashboard

Screenshot 2024-07-24 at 22.23.37

Let's go through the main components:

  1. Each ad unit has a status bar that indicates its state:

    Screenshot 2024-07-24 at 22.27.32

  • Active - Indicates all currently live ad units
  • Archived - Shows all past ad units that are no longer active, but can be reactivated
  • PendingReview Displays all ad units that have been created and wait for our approval
  1. Next to the status bar, you see the ad unit name: Example Ad Unit
  2. Below, you will find detailed information like: Screenshot 2024-07-23 at 10.51.32
  • 24,530 shows the total number of impressions on your ad unit
  • 67 shows the number of times viewers have clicked on it
  1. Each ad unit earns you money, so below you can see your total unclaimed earnings Screenshot 2024-07-24 at 22.59.29

  2. Once an ad unit has been deactivated, we can still track its performance by selecting Statistics.

    Screenshot 2024-07-24 at 23.02.06

  3. To delete it, click on the 🗑️

Create a new campaign:

To create a new ad unit, you can either hover over the box next to your exisitng units or simply click the top right. Screenshot 2024-07-24 at 23.04.53

Screenshot 2024-07-24 at 23.05.36

Instructions how to create a new ad unit can be found in Studio.

📘 Publisher's Studio

Here you will find step-by-step explanation how to create your first ad unit.

New Unit:

  1. Enter the name of your ad unit.
  2. Provide the URL link to your host website. This is the website where you run the ads.

Screenshot 2024-07-26 at 13.36.36

3.Choose the desired format.

Screenshot 2024-07-26 at 13.40.06

  • Currently we support 3 types:

    Large Square 250px x 250px

    Small Square 200px x 200px

    Banner 320px x 50px

Note

Please note that these sizes may vary over time.

  1. The next step is to upload a back up link and banner.

Screenshot 2024-07-26 at 13.41.46

Note

We ensure that your visitors will always be served the appropriate content, even if any issues arise. Please make sure to upload an image with the correct size. If the image size is incorrect, you will not be able to proceed to the next step.

  1. Once you are ready, review the inputs. If everything looks good, you can confirm and comple it.

Screenshot 2024-07-26 at 21.00.20

  1. We are almost ready. You have successfully created the ad unit. Now it's time to embed it. You can choose to embed it using HTML.

Screenshot 2024-07-26 at 20.54.09

Note

We also support React + wallet-selector which is our base case.

Screenshot 2024-07-26 at 20.54.38

Screenshot 2024-07-26 at 20.54.28

💰 Payment

Welcome to the Payment Section

Note

If you encounter any payment issues that are not addressed in this documentation, please don't hesitate to contact us contact@growthmate.xyz.

💵 Campaign Payment

After successfully creating a campaign, you will see this view.

image2

  1. In this step, you will deposit money into your compaign budget.
  2. Currently, we accept stablecoins on NEAR and payments via Stripe.
  3. Let's say you choose to pay with stablecoins. Once you connect your wallet, you will see a menu with four options:

image

  1. Select the desired token and proceed with the payment.

Note

Ensure the balance of your wallet is sufficient, otherwise you won't be able to complete it.

image1

💵 Withdraw

Coming soon