Wallets in Console

For media owner admins: create, fund and refund wallets, see each wallet's balance history, move a Campaign to another wallet, find Campaigns by wallet, and see how advertisers book with one.

A wallet caps how much an advertiser can spend with you. It is a spending limit on credit: the advertiser spends against the limit, and you fund the wallet to give them more room. Console has two views of wallets. Media owners create and manage every advertiser’s wallets. Advertisers see their own wallets in read-only form, choose one when they book on a placement that requires it, and can move a campaign to another of their wallets later. In the Campaigns list, both can see which wallet each campaign uses and filter by it.

🚧

Availability

The Wallets menu item appears only where Kevel has turned wallets on for your business manager. Kevel turns it on separately for media owner users and for advertiser users. A placement asks for a wallet only where Kevel has set it up that way. Contact your Kevel representative to turn wallets on or to change which placements need one.

How it works

Each wallet has three numbers.

NumberWhat it is
Credit LimitThe most the wallet can spend. A limit of 0 means spend is allowed only once the wallet is funded.
AvailableThe Credit Limit minus what has been spent. It can go negative.
Amount OwedWhat has been spent beyond what you have funded, never below zero.

Funding a wallet does not add money. It lowers the balance, which gives the wallet more room, so Available goes up by the amount. A refund does the opposite. For example, a wallet with a limit of 0 that you fund with 5,000 has 5,000 available and nothing owed. After 5,200 of spend it has 200 owed, and Available is -200.

A wallet shows one of four statuses.

StatusWhen
ActiveThe wallet is on and has room to spend
LowThe wallet has a Notification threshold, and Available is at or below it
CappedSpend has reached the Credit Limit. A new wallet with a limit of 0 reads Capped until you fund it
DeactivatedThe wallet is switched off, whatever its balance
The Wallets page for a media owner. The Wallets overview list shows four wallets with Active, Low, Capped and Deactivated statuses, with the Status column highlighted. Each row ends with a chart icon and a menu.

Campaigns that use a wallet stop when the wallet is capped, and a campaign can run a little past the limit, because limits are enforced in cycles rather than on every ad. Funding a wallet, or raising its limit, lets campaigns serve again after the next cycle.

Media owner and advertiser views

Media ownersAdvertisers
Wallets they seeEvery advertiser’s walletsTheir own wallets
Create, edit, fund, refund, deactivateYes, with the Admin roleNo
Balance history and adjustmentsOne wallet at a time, from the chart icon on each rowOne chart and one Adjustments table under the list, for the wallets on the current page
Wallet field when bookingYes, on placements that need a walletYes, on placements that need a wallet
Change a campaign’s wallet from its detailsYes, and the change applies straight awayYes. Where the placement reviews wallet changes, the change waits for approval
Wallet column and filter in CampaignsEvery advertiser’s wallets, each labeled with its advertiserTheir own wallets

Before you start

Where it applies. The Wallets page in each view, the Wallet field on the booking flow for placements that need one, and the Wallet column, filter and campaign details in the Campaigns list.

What you need. The Admin role to create, edit, fund or refund a wallet. Enter whole numbers for the limit and the threshold.

What it does not do.

  • It does not check the balance when an advertiser books. An advertiser can book a campaign on a wallet that has no room left, and the wallet then caps its spend. To stop a wallet being used, deactivate it.
  • It does not delete wallets. Deactivate a wallet to take it out of use. Deactivated wallets do not appear in the booking flow.
  • It does not change currency. A wallet’s currency is fixed when you create it. To use another currency, create a new wallet.
  • It does not work with flat-rate Flights. A Campaign that is linked to a wallet cannot have a flat-rate Flight. A wallet cannot be linked to a Campaign that has one. Console offers only CPC and CPM, so this affects Flights created in the Ad Server UI or the API. See Flat-rate Flights.

Media owner view

Media owners see every advertiser’s wallets on the Wallets page and manage them there.

Create a wallet

Only media owner users with the Admin role can create a wallet. Advertisers cannot create their own: they choose from the wallets you create for them. The wallet belongs to one advertiser, and you choose which when you create it.

  1. Open Wallets. Select Wallets in the sidebar, then select Create new wallet.
  2. Choose the advertiser. Search by name or ID. The wallet fields appear after you choose one.
  3. Fill in the details. Use the fields in the table below.
  4. Select Create new wallet. Console confirms with a message such as Wallet “Spring credit” created.
FieldWhat to enter
Wallet nameRequired. Up to 255 characters
LimitRequired. Zero or more. Zero allows spend only once you fund the wallet
Notification threshold (optional)The available amount at which Console warns about a low balance. Leave it empty for no alert
External ID (optional)A reference such as a purchase order number
CurrencyChoose from the currencies of the advertiser’s campaign templates
The Create new wallet dialog with Brightfield Foods chosen as the advertiser and the Wallet name, Limit, Notification threshold, External ID and Currency fields filled in.

Fund or refund a wallet

  1. Open the row menu. In the Wallets overview list, open the actions menu for the wallet.
  2. Select Fund or Refund. The dialog shows the wallet, the advertiser and the current available balance.
  3. Enter the amount and an optional note. The amount must be greater than 0. Type it without thousands separators. The note is kept with the adjustment.
  4. Confirm. Select Fund or Refund in the dialog. Console confirms “Successfully funded wallet” or “Successfully refunded wallet”, with the wallet’s name.
The Fund Wallet dialog for the Spring credit wallet, with an amount of 5000 and a note entered.

A refund is blocked if it would take Available below zero. The message reads “Insufficient balance” and shows the most you can refund.

Edit, deactivate or find wallets

  • Edit. Open the row menu and select Edit. You can change the name, limit, threshold and external ID. Save changes turns on once you change a field. You cannot change the currency or the advertiser.
  • Deactivate or reactivate. Use the switch in the Active column. It takes effect straight away and stops all spend from the wallet.
  • Search and filter. Search by wallet name, or select Filters, choose a column and a value, then select Apply filters. You can filter by Wallet Name, External ID, Currency, Wallet ID, Credit Limit or Advertiser. Filters apply across every page.
  • Export. Select Export to download wallets.csv for every wallet that matches your search and filters. The Status column in the file uses different words from the screen: Active, Capped, RunningLow and Inactive stand for Active, Capped, Low and Deactivated.
The Edit wallet dialog for the Spring credit wallet, with Wallet name, Limit, Notification threshold and External ID fields and a Save changes button.
The Wallets overview list filtered to the advertiser Brightfield Foods, with the Search box, the Filters button and the Active column of on and off switches highlighted.

See a wallet’s balance history

In the media owner view, balance history and adjustments are shown one wallet at a time. Select the chart icon beside a wallet’s row menu to open its Balance history.

PartWhat it shows
Available balanceThe wallet’s available balance now
Date rangeThe dates for the chart and the table. The last 30 days by default
Available over timeHow the wallet’s available balance changed over those dates
AdjustmentsEach fund and refund in those dates, with its date, amount and note (the Memo column). Funds show as positive amounts and refunds as negative. Search or filter the table, or select Export to download adjustments.csv. Shown where adjustments are switched on for your business manager
The Balance history drawer for the Spring credit wallet, with its available balance, the date range highlighted, the Available over time chart and an Adjustments table with one fund.

Advertiser view

Advertisers see only their own wallets, in read-only form.

What advertisers see

  • Wallets overview. Their wallets, with the media owner columns except Advertiser and the Active switch. They can search, filter and export the list to CSV.
  • Date range. At the top of the page, the last 30 days by default. It sets the dates for the chart and the table.
  • Available over time. One line for each wallet on the current page of the list.
  • Adjustments. Each fund and refund for the wallets on the current page of the list, with the date, wallet name, wallet ID, amount and note. Shown where adjustments are switched on for your business manager. To see adjustments for a wallet further down the list, go to the page of the list that shows it.
The Wallets page for an advertiser, with the date range highlighted. The Wallets overview list shows two wallets, with one Available over time chart and one Adjustments table for both below it.

Book with a wallet

When an advertiser books on a placement that needs a wallet, the Campaign details step has a Wallet field. Each option shows the wallet’s name and its available balance. The step does not move on until a wallet is chosen. The Review campaign step shows the chosen wallet.

Advertisers canAdvertisers cannot
Choose one of their active wallets when they book a campaignCreate, edit, fund, refund or deactivate a wallet
Turn Campaign spending limit on or off, and set a campaign budget when it is onChange a wallet’s limit, notification threshold or currency
Swap the wallet on a live campaign, in the edit flow or from the campaign’s details, where the placement lets them. On placements that review wallet changes, the swap waits for approvalUse a deactivated wallet, or a wallet that belongs to another advertiser
See their wallets, balances, the Available over time chart and the adjustments, and export the list to CSVSee other advertisers’ wallets
Receive a Low wallet balance notification when a wallet reaches its threshold

The Campaign spending limit switch sits below the Wallet field and decides whether the campaign has its own budget. With it off, the campaign draws from the full wallet balance.

The Campaign details step of a campaign booking. The Wallet field shows the chosen wallet and its available balance, and the Campaign spending limit switch below it is off.

See Set up campaign review for which changes a placement reviews.

Wallets in the Campaigns list

Media owners and advertisers can see each campaign’s wallet in Campaigns, filter the list by wallet, and move a campaign to another wallet without editing the whole campaign. These appear only where Kevel has turned wallets on for your view of the business manager.

Change a campaign’s wallet

Move a campaign to another wallet when a purchase order ends or a wallet runs out, without opening the full edit flow.

  1. Open the campaign’s details. In Campaigns, open the More menu on the campaign’s row and select Campaign details.
  2. Select the pencil next to Wallet. Its tooltip reads Change wallet, and it opens the Change wallet dialog.
  3. Pick the wallet. The Wallet list shows the active wallets of the campaign’s advertiser, with the current one marked (current). A wallet in a different currency from the campaign is listed but cannot be picked, and is marked Different currency. Deactivated wallets are not listed.
  4. Save the change. Select Save. If the change needs approval, the dialog says “This change needs approval. It takes effect once it is approved.” and the button reads Send for review.
The Change wallet dialog over a campaign’s details. The Wallet list shows the new wallet chosen, with a note that spend so far stays on the current wallet and new spend goes to the wallet you pick, and Cancel and Save buttons.

Validation. A change that applies straight away shows “Wallet changed to”, followed by the wallet’s name, and the campaign’s details show the new wallet. A change sent for review shows Awaiting approval in the campaign’s Approval status column, and the campaign stays on its current wallet until a reviewer approves it.

How the change behaves:

  • Spend. Spend so far stays on the current wallet, and new spend goes to the wallet you pick. To carry over what is left on the old wallet, see Move funding to a new wallet.
  • Approval. A media owner’s change applies straight away, because your own team’s changes are never reviewed. An advertiser’s change follows the same rule as a wallet change in the edit flow: it applies straight away unless the placement reviews wallet changes. See Set up campaign review.
  • Balance. If the chosen wallet has nothing left, or less than the campaign’s budget, the dialog warns that it has a low balance. You can still save, and the wallet then caps the campaign’s spend, as it does at booking.

The pencil appears only on a campaign that already has a wallet and can still be edited. For example, it does not appear on a Completed campaign, while a new campaign waits for approval, or after a campaign’s request is canceled or ends in an error. Read-only users do not see it.

Find campaigns by wallet

  1. Show the Wallet column. Select Columns and turn on Wallet. It is off by default, and Console remembers your choice in this browser. For media owners, each wallet name is followed by its advertiser in brackets.
  2. Filter by wallet. Select Filters, choose Wallet, and pick one or more wallets from the Wallets list. Each wallet you pick shows as a chip, and the cross on a chip removes it.
The Campaigns list for a media owner with the Wallet column shown and the Filters panel open. The Wallet filter uses Is any of, with two wallets chosen as chips, each wallet name followed by its advertiser in brackets.

Validation. The list shows only campaigns that use one of the wallets you picked. The wallet filter combines with your other filters, so a campaign has to match all of them.

Media owners can pick from every advertiser’s wallets, and advertisers from their own. Deactivated wallets are in the list too, because campaigns can still use them.

Troubleshooting

I cannot see Wallets in the sidebar. The menu item is off for your view of the business manager, or your user has a read-only role. Kevel turns it on separately for media owners and advertisers. Contact your Kevel representative.

A new wallet reads Capped. Its limit is 0 and it has not been funded. Fund it, or raise the limit.

There is no pencil next to Wallet in a campaign’s details. The campaign has no wallet, it is Completed, or a request on it locks editing. See Change a campaign’s wallet for when the pencil appears.

A wallet cannot be picked in the Change wallet dialog. It is marked Different currency: its currency differs from the campaign’s. Pick a wallet in the campaign’s currency, or create one for the advertiser.

The Wallet list in the Change wallet dialog shows only the current wallet. The advertiser has no other active wallet. Create one for them, or reactivate a deactivated one.

I cannot find the Wallet column or filter. Turn the column on from Columns. If Wallet is not listed there, wallets are not turned on for your view. Contact your Kevel representative.

Media owners

Fund, Refund, Edit, the Active switch or the chart icon is disabled for a wallet. The wallet’s advertiser cannot be matched to an advertiser in your business manager. Contact your Kevel representative with the wallet ID.

I cannot find an adjustment I made. Open the balance history of the wallet you funded or refunded, and widen the date range to include the day you made it.

Saving a wallet fails. Check that the limit and threshold are whole numbers, and that you have the Admin role. Console shows the error in a message at the top of the screen.

Advertisers

An advertiser sees “No wallets found” when booking. The advertiser has no active wallet. Create one for them, or reactivate a deactivated one.

The Campaign details step will not continue. The placement needs a wallet and none is chosen. Select a wallet in the Wallet field.

An advertiser cannot find an adjustment. The chart and the Adjustments table cover only the wallets on the current page of the list. Go to the page of the list that shows the wallet, and widen the date range.

Related