Skip to main content
An operator is an organization that runs campaigns for its clients’ accounts, such as an agency buying media for each client from that client’s own account. An operator fee is a percentage the operator keeps from the client’s gross budget on every media buy, beside Apostra’s own fee. The seller never sees it: it receives a smaller media budget, and nothing else changes for it.

Before you start

You can set an operator fee on a campaign when all of these hold:
  • Operator fees are switched on for your organization.
  • The campaign’s account is one of your organization’s accounts, and its media is invoiced to your organization. A client account under your organization is invoiced to your organization by default. If the account’s media is invoiced to anyone else, the fee is refused.
  • The campaign has a budget. The fee is a percentage of it.
  • You act for your organization: you are signed in to it, working in the client’s account through it, or a member of your organization with write or admin access there, signed in to the client’s account with a membership of your own. A read-only member of your organization sees the fee in a client’s account but cannot change it. Buyer agents cannot set an operator fee.

Set the fee

Send operatorFees with save_campaign, on create or update:
The entry uses AdCP’s price-adjustment field names: A campaign has at most one operator fee. To remove it, send an empty array:
You can remove a fee even after operator fees are switched off for your organization. The v2 REST campaign requests take the same operatorFees field: see Create campaign and Update campaign.

When the fee applies

The fee locks onto each media buy when the buy is created, beside Apostra’s own fee terms. Media buys that already exist keep the terms they locked, so a change to the campaign’s fee applies only to media buys created afterwards. Both fees are percentages of the gross budget, and the rest buys media:
Apostra’s standard terms take no percentage of media, so Apostra’s rate is 0%. Apostra earns its revenue from Intelligence Units (IUs), which are a separate charge on a separate bill (see What you pay as a buyer). For example, a $1,000 media buy with a 2% operator fee gives the operator $20, Apostra $0, and the seller a $980 media budget. Only an agreement from before the standard terms can still carry a percentage Apostra fee. Under one at 3%, the same $1,000 media buy gives Apostra $30, the operator $20, and the seller a $950 media budget. A media buy that carries a percentage Apostra fee above 0% is not charged an IU. Read the rates in force for your organization with get kind: "billing" and include: ["pricing"] (see Platform fee rates). Budget changes on a live media buy split again at its locked rates. See Budgets and fees for how gross budgets work. A media buy is refused, with operatorFees named as the field, if the account’s media is no longer invoiced to your organization when the buy is created. Remove the fee from the campaign, or ask your Apostra contact about the account’s invoicing.

Who pays whom

You invoice your client and keep your fee: it is never charged through Apostra. Apostra records the fee against your organization in its own books so that its statements reconcile with the media buy. Apostra invoicing your client directly is not available yet. Who invoices the media itself depends on the media buy’s billing party, and the examples above split the gross budget the same way in every case:
  • Consolidated billing. The seller sends its invoice to Apostra, and Apostra puts it on your consolidated media bill, collects your payment and passes it to the seller. Apostra is a billing agent here: it does not guarantee the seller’s payment or take credit risk on the media, so it is not clearing the media.
  • Seller-billed. The seller or its platform invoices the operator or the advertiser directly, and no media money passes through Apostra.
In both cases Apostra’s IU charges are a separate fee invoice. See Choose a billing route.

Who sees the fee

The fee is visible according to whose side the caller is on, not their role: On a campaign read, operatorFees is present only for a caller who may see the split; for everyone else it is absent, not zero. operatorFeeEditable: true says that the caller may set or remove the fee on that campaign. On a media buy, the v2 budget_breakdown carries the fee as its own operator_fees line with its amount and beneficiary. A caller who sees the total cost only receives no budget_breakdown for that buy, and no seller price: the packages and line items of that buy carry no bid price, in V3 and v2 alike, because the gross budget less the seller’s price would show the fee.