New Advertiser
POST {{campaign_url}}/accounts/:accountId/advertisers
Create a new advertiser
You can create a new advertiser by sending this POST request. To define settings for your advertiser, open the body tab and edit the JSON object.
For DTO fields thirdPartyAdServer, thirdPartyAttributionProvider, and viewabilityProviders, see the corresponding DTO tables below to customize the data.
Request Body (Definitions)
*Optional element
| JSON Object Key | Description | Type |
|---|---|---|
| name | Name of this advertiser. | string |
| primaryUrl | Website URL for this advertiser. | string |
| currency | Currency for bids and other transactions. Allowed values | string |
| language | Language used by this advertiser. Allowed values | string |
| *externalAdvertiserId | ID associated with a third-party external advertiser. | string |
| iabCategory | IAB-defined web content category associated with this advertiser (for targeting purposes). Allowed values | string |
| identityPlatformVendor | Integrated identity partner for person/household-based targeting purposes. Allowed values | string |
| nielsenCampaignOptIn | Indicates if this advertiser opts in to Nielsen campaign. | boolean |
| status | Play status of this advertiser. Allowed values: play, pause, stop, archived | string |
| *thirdPartyAdServer (DTO) | Third-party ad serving platform for this advertiser. | DTO |
| *thirdPartyAttributionProvider (DTO) | Third-party provider responsible for action attribution (i.e., crediting ads within this advertiser for user actions). | DTO |
| viewabilityProviders (DTO) | Display, video, and mobile viewability providers for this advertiser. | DTO |
thirdPartyAdServer DTO
| Key | Description | Type |
|---|---|---|
| provider | Name of third-party ad serving platform provider. Allowed values: doubleClick, atlas | string |
| advertiserName | Name of advertiser within third-party provider system. | string |
thirdPartyAttributionProvider DTO
| Key | Description | Type |
|---|---|---|
| service | Name of third-party attribution service provider. Allowed values: adometryMta, doubleClickLta, visualIqMta, clearSaleingMta, atlasLta | string |
| advertiserName | Name of advertiser within third-party provider system. | string |
viewabilityProviders DTO
| Key | Allowed Values | Type |
|---|---|---|
| display | moat, doubleVerify, ias | string |
| video | moat, doubleVerify, ias | string |
| mobile | doubleVerify | string |
Request Body
{"name"=>"doc team test", "primaryUrl"=>"http://amobee.com", "currency"=>"usd", "language"=>"en", "iabCategory"=>"iab2-1", "identityPlatformVendor"=>"LiveRamp Identity Link", "nielsenCampaignOptIn"=>false, "status"=>"play", "thirdPartyAdServer"=>{"provider"=>"doubleClick", "advertiserName"=>"Amobee"}, "thirdPartyAttributionProvider"=>{"service"=>"visualIqMta", "advertiserName"=>"Amobee"}, "viewabilityProviders"=>{"display"=>"doubleVerify", "video"=>"moat", "mobile"=>"doubleVerify"}}
RESPONSES
status: Created
{"data":[{"id":"1608792487","marketId":"1","resourceType":"advertiser","status":"play","accountId":"0123456","createdAt":"2022-09-01T05:47:34Z","updatedAt":"2022-09-01T05:47:34Z","name":"doc team test","primaryUrl":"http://amobee.com","language":"en","iabCategory":"iab2-1","currency":"usd","thirdPartyAdServer":{"provider":"doubleClick","advertiserName":"Amobee"},"viewabilityProviders":{"display":"doubleVerify","video":"moat","mobile":"doubleVerify"},"nielsenCampaignOptIn":false,"thirdPartyAttributionProvider":{"service":"visualIqMta","advertiserName":"Amobee"},"identityPlatformVendor":"Probabilistic"}],"errors":[]}