Start Monetizing with Specify

Welcome to Specify! This guide will walk you through the easy steps of integrating our SDK into your application, allowing you to start earning revenue from relevant, native ads.

Getting Started

Specify is designed with both publishers and users in mind. Our approach focuses on:

• Quality over quantity: We have no minimum traffic requirements

• Native ad experiences: Create organic, non-disruptive ad placements

• User-first design: Ads that add value rather than interrupt

• Simple implementation: Get up and running in just 10 minutes

• Hands-on support: Our team works directly with you at every step

Need assistance? Don't hesitate to reach out at any point via the built-in support chat or Telegram, where we can also arrange a call if needed.

Organization Setup

Creating or Importing Your Organization

1. Log in to your Specify account

2. Search for your existing project OR click "Don't see your organization on the list?" to create a new one

Note: All organizations go through a review process before campaigns can go live. However, you can test using development keys while your organization is under review.

Implementation Process

Step 1: Install the Specify SDK

Run the following command to install the Specify client SDK:

# Using npm
npm install @specify-sh/sdk

# Using yarn
yarn add @specify-sh/sdk

# Using pnpm

Step 2: Initialize the Specify SDK

Set up the Specify SDK by entering your publisher key:

// lib/specify.js
import Specify from "@specify-sh/sdk";

const specify = new Specify({
  // This is your secret development API key
  publisherKey: "spk_xxxxxxxxxxxxxxxxxxx"
});

export default specify;

Important notes about keys:

• The key shown above is a development key for testing

• Publisher keys are safe to use publicly and don't require secure handling

• You can find your development key in the Publisher Keys section of your dashboard

• For production use, you'll generate a production key after testing is complete

Payment Rates: Before moving to production, reach out to our team to discuss your CPM payment rate. We offer competitive rates based on your audience quality and ad placement strategy.

Step 3: Serve Ads

Obtain an advertisement to show by providing a user wallet address:

// In your app
import specify from "lib/specify";

const ad = await specify.serve(userWallet);
console.log(ad);

// Show the ad to your users by accessing:
// ad.headline
// ad.content
// ad.imageUrl
// ad.ctaUrl
// ad.ctaLabel

Implementation Best Practices

Native Ad Placement

We recommend integrating ads naturally within your app's interface, while ensuring users can clearly recognize promotional content:

• Feed/Timeline Integration: Place ads between regular content items

• Feature Highlights: Position ads in areas where users look for new features or content

• Contextual Relevance: Display ads in sections related to the ad content

• Consistent Styling: Maintain your UI design while clearly marking sponsored content

Testing & Going Live

1. Development Phase:

   • Install and initialize the SDK with your development key

   • Implement the ad serving functionality in your interface

   • Test the integration in your development environment

   • Our system will detect requests from your development key

2. Review Process:

   • Once you're satisfied with your implementation, contact us

   • We'll review your integration and discuss:

     • Ad placement and styling

     • CPM payment rates

     • Any specific ad categories you wish to exclude

     • Publisher-specific requirements

3. Production Launch:

   • Generate your production key in the Publisher Keys section

   • Replace your development key with the production key

   • Deploy your changes to production

   • Start earning revenue!

Publisher Payment Rates

Important: Contact us to discuss your CPM rate

Your publisher payment rate is individually determined based on several factors:

• Audience quality and engagement metrics

• Ad placement and visibility

• User wallet demographics

• Content vertical and relevance

We pride ourselves on offering competitive rates that reflect the true value of your audience. Unlike other ad networks with fixed rates, we work with each publisher to establish fair compensation based on their unique value proposition.

Pro Tip: Publishers should reach out to our team during the integration process to discuss payment rates before moving to production. This conversation helps us understand your goals and structure a payment model that aligns with your business objectives.

Support & Optimization

We're committed to your success as a publisher and provide hands-on support throughout your journey:

• Dedicated Integration Support: Our engineering team works directly with your developers

• Technical Troubleshooting: Quick resolution of any implementation challenges

• Placement Consultation: Expert guidance on optimal ad positioning for your specific UI

• Revenue Optimization: Ongoing partnership to continuously improve your earnings

• Ad Quality Control: Regular check-ins to ensure you're happy with the ads being served

• Custom Development: Assistance with unique integration requirements

We view our publisher relationships as true partnerships. Your success is our success, which is why we invest time and resources to ensure your integration is as smooth and profitable as possible.

Contact Us

Have questions or need assistance?

• Email: contact@specify.io

• In-app chat: Available during business hours

• Schedule a call: Use our calendar link to book time with our team

Ready to get started? Log in to Specify →