Introduction

An advertiser is the entity for which an advertisement speaks and which originates the payment for an advertisement.

The Advertiser API manages advertisers in your network. Version 3 of the Advertiser API enables you to execute the following operations on advertisers and their related attributes:

• Obtain a high-level view of active campaigns, divided by advertiser
• View a list of information about a specific advertiser, such as its contact information or financial information
• Return a list of advertisers when you are de-duplicating, consolidating, or reconciling an advertiser list
• Create an advertiser
• Edit an advertiser
• Set parent agency and brand relationships
• Add new campaigns to an advertiser

Related Documentation

Refer to the following documentation for more information about FreeWheel products and APIs:

• Getting Started with the FreeWheel APIs
• Advertisers - MRM User Guide

Before You Begin

Set up your agency/advertiser relationships before you create a campaign.

How to Create a New Advertiser

You can find instructions for creating and approving a new advertiser here.

In MRM, an advertiser has two required fields:

1. Name
2. Industry Assignment

You can also include other metadata such as contact details.

Resources

URI(s)

The Agency API v3 identifies two Uniform Resource Identifiers (URIs) as identified in the following table:

Advertiser Attributes

Basic Attributes

This attribute set identifies and defines an advertiser. Basic attributes describe fundamental properties of an advertiser.

Contacts Attributes

This attribute set identifies contacts for an advertiser. Contacts attributes identify various contacts for the advertiser, including ID, type of contact, name, title, address, email address, phone, and website. Use code similar to the Contacts POST example when you want to add a contact to the advertiser. You can add multiple contacts to each advertiser, as necessary.

All of the parameters below are included in the basic GET.

Assignment Attributes

This attribute set identifies an assignment and user role/group for the advertiser. Assignment attributes define the assigned users for this advertiser in combination with the Assigned User attributes set below.

Assigned User Attributes - Child Attributes of Assignment Attributes

This attribute set assigns a user for this advertiser. Assigned User attributes define a user ID, name, and relates to the primary user role for an advertiser.

All of the parameters below are included in the basic GET.

Address Attributes

This attribute set identifies an address for the advertiser. Address attributes define the Advertiser's address. This attribute set is unrelated to the contacts' address fields.

All of the parameters below are included in the basic GET.