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
SendoperatorFees with save_campaign, on create or update:
A campaign has at most one operator fee. To remove it, send an empty array:
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: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.
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.