Quickstart

This guide takes you from an empty workspace to live ads. Each step links to a page with the full detail.

1. Create your workspace

When you sign up, Revinel walks you through a short onboarding: name your workspace, pick a slug, and add your website URL. The slug shows up in your dashboard URLs; the website URL is used for the tier selector and favicon scraping. You can change all three later under Settings → General.

2. Connect Stripe

Advertisers pay you directly. Revinel uses Stripe Connect, so subscriptions live on your own Stripe account and Revinel takes a platform fee on top. Click Connect with Stripe during onboarding (or later under Settings → General) and finish Stripe’s setup. Your account has to be fully connected before anyone can pay. See Connect Stripe for the details.

3. Create a tier with a price

A tier is a plan an advertiser can buy. Give it a name, a weight (its share of impressions), and at least one price. Add a few feature bullets if you want them shown in the selector. Create your first tier under Tiers → New. See Tiers and pricing for weight, pricing, and feature syntax.

4. Define your custom fields

Every ad has a fixed name and websiteUrl. Everything else (a tagline, a banner image, a discount code) is a custom field you define. Advertisers fill these in when they submit their creative, and your renderer reads them back from the served ad. Add fields under Fields → New. See Custom fields for the field types and how slugs map to your code.

5. Add the tier selector to your site

The tier selector is the “Subscribe to advertise” widget. Drop it on any page so visitors can pick a plan and check out. Open the Install page in your dashboard to copy a ready-to-paste snippet with your real workspace ID. You can embed it inline, as a popup, or with a no-code script. See Tier selector for the formats and options.

6. Review and approve the first ad

When an advertiser pays and submits their creative, the ad lands in your queue as Pending. Open it, check the creative, and approve it. You can also request changes or reject it. See Reviewing ads for the statuses and decisions.

7. Render ads with the SDK

An approved ad with an active subscription is ready to serve. Fetch ads with @revinel/sdk (any JS runtime) or @revinel/react (hooks with built-in tracking), then draw them however your design calls for.

import { createRevinelClient } from "@revinel/sdk"

const revinel = createRevinelClient({ workspaceId: "your-workspace-id" })
const ad = await revinel.getAd({ weight: { gte: 2.5 } }) // a premium slot

See Serving ads for how selection, targeting, and tracking work.

Get started

Publishers

Advertisers

1. Create your workspace

2. Connect Stripe

3. Create a tier with a price

4. Define your custom fields

5. Add the tier selector to your site

6. Review and approve the first ad

7. Render ads with the SDK

​1. Create your workspace

​2. Connect Stripe

​3. Create a tier with a price

​4. Define your custom fields

​5. Add the tier selector to your site

​6. Review and approve the first ad

​7. Render ads with the SDK

1. Create your workspace

2. Connect Stripe

3. Create a tier with a price

4. Define your custom fields

5. Add the tier selector to your site

6. Review and approve the first ad

7. Render ads with the SDK