Management Model for Resellers

 

The reseller role is offered to a limited set of partners that offer search-marketing tools and services to a large number of advertisers. The reseller role allows partners to programmatically create new customer accounts. The reseller is billed by invoice for all advertising costs incurred by their customers. The advertiser does not sign up for Bing Ads credentials, and may pay a fee to the reseller. The following sections describe the entity model and credentials for resellers.

As described in Entity Hierarchy and Limits all advertising activity is organized by customer, which can have one or more accounts. Two or more customer entities play a role in the reseller model. The reseller customer is required, and then the reseller's aggregator user may programmatically create one or more managed customers with the SignupCustomer service operation. The aggregator user role is required for SignupCustomer, and is provided solely to resellers.

Upon initial provisioning the reseller customer does not have any accounts to manage. There is an empty customer shell and an Aggregator user. Every time SignupCustomer is called, the following entities are created outside of the reseller customer.

  • A managed customer is created
  • An account is created within the managed customer

For more information about creating reseller managed customers, see Adding Customers.

The following figure shows two child customers created and managed by a reseller. These are referred to as child customers because the billing rolls up to the reseller's payment instrument. The aggregator user can programmatically manage all accounts across multiple reseller-managed child customers.

Management Model Direct Reseller

The following are the header elements and the corresponding identifiers that a reseller would use.

System_CAPS_ICON_note.jpg Note

If you use the AuthenticationToken, the UserName and Password elements are ignored. For more information, see Authentication with OAuth.

Header ElementOwner
AuthenticationTokenThe OAuth access token corresponding to the aggregator's linked Microsoft Account.
UserNameThe reseller’s aggregator sign-in user name.

Note: As a best practice the reseller's aggregator user should always be used. If a unique business requirement is flagged, it is possible to create new users within the managed customers and join them with a multi-user token in calls to some service operations. For more information see Account Permissions and the Developer Token and User Roles and Available Service Operations within Customer Accounts.
PasswordThe sign-in password of the user specified in UserName.
DeveloperTokenThe reseller’s token.

Note: A single-user (SU) developer token is sufficient to authenticate with the corresponding user. For more information on token types, see Account Permissions and the Developer Token.
CustomerIdThe identifier of the customer that contains and owns the account. If you manage an account of another customer e.g. child customer created via SignupCustomer, you should use that customer ID instead of your own customer ID.
CustomerAccountIdA managed customer's account ID.

For more information about customer and account identifiers, see Getting Started With the Bing Ads API.

To request reseller API credentials, please contact your designated account management team for details about getting the API Reseller role. If you are not currently a reseller but would like to become one, see Become a Microsoft Advertising Authorized Reseller.

Customer Accounts
Getting Started With the Bing Ads API

Show: