Get all ad orders for a campaign

Returns details about all the ad orders under a specified campaign.

Request

GET /adorder/getAdOrdersByCampaign?id=<campaign ID>

Response

JSON Fields Type Description
messagesObject ArrayAn array of any error messages.
messages[].levelStringError level.
messages[].codeStringError code.
messages[].messageStringError message.
entityObject ArrayAn array of ad order objects.
entity[].idNumberAd order ID.
entity[].nameStringAd order name.
entity[].campaignIdNumberCampaign ID associated with the ad order.
entity[].startDateNumberStart date of the ad order, passed as Unix time in milliseconds.
entity[].endDateNumberEnd date of the ad order, passed as Unix time in milliseconds.
entity[].optimizationGoalString Optimization goal for the ad order --
  • CPM
  • CPC
  • CPA
entity[].lifetimeBudgetNumberThe total lifetime budget for the ad order in USD.
entity[].frequencyCapObjectA frequency cap settings object.
entity[].frequencyCap.limitNumber The maximum number of impressions a user is exposed to per frequency cap time period duration.

See frequencyCap.duration and frequencyCap.timePeriod.
entity[].frequencyCap.durationNumberThe number of given frequencyCap.timePeriod.
entity[].frequencyCap.timePeriodString
  • MINUTE
  • HOUR
  • DAY
entity[].channelsV2String Array (channelV2 account)
Null (channelV1 account)
Channels the Ad Order will be capable of serving on:
  • Display
  • Video
  • Native
  • Audio
  • DOOH
  • CTV
  • LTV
  • LTV Wide Orbit
entity[].audienceWeightsEnabledBooleanControls whether audience weights are enabled.
entity[].costOptimizationEnabledBooleanControls whether cost optimization is enabled. Available only if the feature is enabled on the Account.
entity[].audiencesObject ArrayAn array of audience objects targeted by the ad order.
entity[].audiences[].idNumberAudience ID.
entity[].audiences[].nameStringAudience name.
entity[].audiences[].weightIntegerAudience weight.
entity[].audiences[].pmpDealsNumber ArrayAn array of any targeted PMP deals IDs, where the IDs are the internal Viant IDs.
entity[].audiences[].exchangesObjectIf this object is not present, the audience will not modify exchange targeting criteria.
entity[].audiences[].exchanges.includeNumber ArrayAn array of any targeted exchange IDs.
entity[].audiences[].exchanges.excludeNumber ArrayAn array of any excluded exchange IDs.
entity[].audiences[].siteListsObjectIf this object is not present, the audience will not modify site list targeting criteria.
entity[].audiences[].siteLists.includeNumber ArrayAn array of any targeted site list IDs.
entity[].audiences[].siteLists.excludeNumber ArrayAn array of any excluded site list IDs.
entity[].goalModeString Sets goal prioritization. Can be set to:
  • PERFORMANCE
  • SPEND
entity[].hourlyPacingModeString
  • ASAP
  • SPEND_EVENLY
entity[].hourlyFrontloadNumberPercentage frontload between 0.00 and 100.00. Null if hourlyPacingMode is ASAP

Example

Request

curl -u <user>:<password> https://sandbox-api.viant.com/v1/adorder/getAdOrdersByCampaign?id=90

Response

{
  "messages": [],
  "entity": [
    {
      "id": 9991,
      "name": "Mobile Web",
      "campaignId": 90,
      "startDate": 1464739200000,
      "endDate": 1483228800000,
      "optimizationGoal": "CPM",
      "lifetimeBudget": 10000,
      "frequencyCap": {
        "limit": 5,
        "duration": 3,
        "timePeriod": "DAY"
      },
      	"channelsV2": null,
      "audiences": [
        {
          "id": 9800,
          "name": "Default Audience",
          "weight": 1,
          "pmpDeals": null,
          "siteLists": {
            "include": [
              100,
              101
            ],
            "exclude": []
          },
          "exchanges": {
            "include": [],
            "exclude": [
              96
            ]
          }
        }
      ],
      "audienceWeightsEnabled": false,
      "goalMode": "PERFORMANCE",
      "hourlyPacingMode": "ASAP",
      "hourlyFrontload": null
    }
  ]
}
Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!