Botads-api NPM

Bot-Ads

Bot-Ads is a library that allows you to share your projects and/or earn money by displaying ads in your Discord bot. With Bot-Ads you can generate advertisement links, create attractive ad embeds, and track ad clicks using unique codes.

Installation

Install the package via npm:

npm install botads-api

Usage

Below is an example of how to integrate Bot-Ads into your Discord bot:

const { Client, GatewayIntentBits } = require('discord.js');
const BotAds = require('botads-api');

// Initialize BotAds with the user ID that will receive the ad revenue.
// Optionally, enable debug mode by passing 'true' as the second parameter.
const adSystem = new BotAds("123456789", true);

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent
  ]
});

client.once('ready', () => {
  console.log(`✅ Logged in as ${client.user.tag}`);
});

client.on('messageCreate', async (message) => {
  // Ignore bot messages and messages outside servers.
  if (message.author.bot || !message.guild) return;

  // Command to retrieve an ad link.
  if (message.content.toLowerCase() === '!ad-link') {
    const adLinkData = await adSystem.getAdLink('uniqueCode');
    if (adLinkData && adLinkData.success) {
      message.channel.send(`🔗 Ad Link: ${adLinkData.redirect_url}`);
    } else {
      message.channel.send(":x: Unable to retrieve an ad link at the moment.");
    }
  }

  // Command to generate an ad embed.
  if (message.content.toLowerCase() === '!ad-embed') {
    const adEmbedData = await adSystem.generateAdEmbed(0x0099FF, 'uniqueCode');
    if (adEmbedData && adEmbedData.success) {
      message.channel.send({ embeds: [adEmbedData.embed] });
    } else {
      message.channel.send(":x: Unable to generate an ad embed at the moment.");
    }
  }

  // Command to check if the ad has been clicked.
  if (message.content.toLowerCase() === '!check-ad') {
    const checkData = await adSystem.checkCode('uniqueCode');
    if (checkData && checkData.success) {
      if (checkData.clicked) {
        message.channel.send("✅ The ad has been clicked!");
      } else {
        message.channel.send("ℹ️ The ad has not been clicked yet.");
      }
    } else {
      message.channel.send(":x: Unable to verify the ad click status at the moment.");
    }
  }
});

client.login('YOUR_BOT_TOKEN');

API Methods

`getAdLink(code?: string): Promise<AdLinkResponse | null>`

Retrieves an advertisement link from the Bot-Ads API.

Parameters:
- code (optional): A tracking code to associate with the advertisement.

Returns:

On success:

{ 
  success: true, 
  ad_id?: string, 
  description?: string, 
  redirect_url?: string 
}

On failure: null

`generateAdEmbed(color?: number, code?: string): Promise<AdEmbedResponse>`

Generates an embed containing the advertisement.

Parameters:
- color (optional): The embed color as a hexadecimal number (default is 0x0099FF).
- code (optional): A tracking code to associate with the advertisement.

Returns:

On success:

{ 
  success: true, 
  link?: string, 
  embed?: object 
}

On failure:

{ 
  success: false, 
  message: "Error message" 
}

`checkCode(code: string): Promise<CheckCodeResponse | null>`

Checks if a user has clicked on the advertisement associated with the provided tracking code.

Parameters:
- code: The tracking code to verify.

Returns:

On success:

{ 
  success: true, 
  clicked?: boolean 
}

On failure: null

`setDebug(value: boolean): void`

Enables or disables debug mode.

Parameters:
- value: true to enable debug mode, false to disable it.

`getUserId(): string`

Returns the user ID that was used to initialize BotAds.

Complete Example

Below is a complete example demonstrating all available functions of Bot-Ads:

const { Client, GatewayIntentBits } = require('discord.js');
const BotAds = require('botads-api');

// Initialize the Discord client with necessary intents.
const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent
  ]
});

// Initialize BotAds with the user ID that will receive the revenue and enable debug mode.
const adSystem = new BotAds("123456789", true);

client.once('ready', () => {
  console.log(`✅ Logged in as ${client.user.tag}`);
});

client.on('messageCreate', async (message) => {
  // Ignore bot messages and messages outside a server.
  if (message.author.bot || !message.guild) return;

  // Command to retrieve an ad link.
  if (message.content.toLowerCase() === '!ad-link') {
    try {
      const adLinkData = await adSystem.getAdLink('uniqueCode');
      if (adLinkData && adLinkData.success) {
        message.channel.send(`🔗 Ad Link: ${adLinkData.redirect_url}`);
      } else {
        message.channel.send(":x: Unable to retrieve an ad link at the moment.");
      }
    } catch (error) {
      console.error("Error with getAdLink:", error);
      message.channel.send(":x: An error occurred while retrieving the ad link.");
    }
  }

  // Command to generate an ad embed.
  if (message.content.toLowerCase() === '!ad-embed') {
    try {
      const adEmbedData = await adSystem.generateAdEmbed(0x0099FF, 'uniqueCode');
      if (adEmbedData && adEmbedData.success) {
        message.channel.send({ embeds: [adEmbedData.embed] });
      } else {
        message.channel.send(":x: Unable to generate an ad embed at the moment.");
      }
    } catch (error) {
      console.error("Error with generateAdEmbed:", error);
      message.channel.send(":x: An error occurred while generating the ad embed.");
    }
  }

  // Command to check if the ad has been clicked.
  if (message.content.toLowerCase() === '!check-ad') {
    try {
      const checkData = await adSystem.checkCode('uniqueCode');
      if (checkData && checkData.success) {
        if (checkData.clicked) {
          message.channel.send("✅ The ad has been clicked!");
        } else {
          message.channel.send("ℹ️ The ad has not been clicked yet.");
        }
      } else {
        message.channel.send(":x: Unable to verify the ad click status at the moment.");
      }
    } catch (error) {
      console.error("Error with checkCode:", error);
      message.channel.send(":x: An error occurred while checking the ad click.");
    }
  }
});

client.login('YOUR_BOT_TOKEN');

Important Notices

User ID: Replace "123456789" with the actual user ID that will receive the ad revenue. If the user ID is incorrect, please contact support.
Tracking Codes: Use unique tracking codes (e.g., uniqueCode) to monitor user interactions with your ads.
Embed Color: You can specify the embed color as a hexadecimal number (e.g., 0x0099FF). A default value of 0x0099FF is used if no color is provided.
Debug Mode: Enable debug mode for more detailed error logging by passing true as the second argument when creating a new instance of BotAds.