The set of fields around delivery control that are interesting for a buyer to see but are non-negotiable. These are set by the publisher. This message is assigned an id of 100 since some day we would want to model this as a protobuf extension.

deals[].deliveryControl.creativeBlockingLevel

string

Acceptable values are:

"adxPolicyBlockingOnly"

"publisherBlockingRules"

"unknownCreativeBlockingLevel"

deals[].deliveryControl.deliveryRateType

string

Acceptable values are:

"asFastAsPossible"

"evenly"

"frontLoaded"

"unknownDeliveryRateType"

deals[].deliveryControl.frequencyCaps[]

list

deals[].deliveryControl.frequencyCaps[].maxImpressions

integer

deals[].deliveryControl.frequencyCaps[].numTimeUnits

integer

deals[].deliveryControl.frequencyCaps[].timeUnitType

string

Acceptable values are:

"day"

"hour"

"lifetime"

"minute"

"month"

"unknownTimeUnitType"

"week"

deals[].externalDealId

string

The external deal id assigned to this deal once the deal is finalized. This is the deal-id that shows up in serving/reporting etc. (readonly)

deals[].flightEndTimeMs

long

Proposed flight end time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)

deals[].flightStartTimeMs

long

Proposed flight start time of the deal (ms since epoch) This will generally be stored in a granularity of a second. (updatable)

deals[].inventoryDescription

string

Description for the deal terms. (buyer-readonly)

deals[].isRfpTemplate

boolean

Indicates whether the current deal is a RFP template. RFP template is created by buyer and not based on seller created products.

deals[].kind

string

Identifies what kind of resource this is. Value: the fixed string "adexchangebuyer#marketplaceDeal".

deals[].lastUpdateTimeMs

long

The time (ms since epoch) when the deal was last updated. (readonly)

deals[].name

string

The name of the deal. (updatable)

deals[].productId

string

The product-id from which this deal was created. (readonly, except on create)

deals[].productRevisionNumber

long

The revision number of the product that the deal was created from (readonly, except on create)

deals[].programmaticCreativeSource

string

Specifies the creative source for programmatic deals, PUBLISHER means creative is provided by seller and ADVERTISR means creative is provided by buyer. (buyer-readonly)

Acceptable values are:

"advertiser"

"publisher"

"unknownProgrammaticCreativeSource"

deals[].proposalId

string

deals[].sellerContacts[]

list

Optional Seller contact information for the deal (buyer-readonly)

deals[].sellerContacts[].email

string

Email address of the contact.

deals[].sellerContacts[].name

string

The name of the contact.

deals[].sharedTargetings[]

list

The shared targeting visible to buyers and sellers. Each shared targeting entity is AND'd together. (updatable)

deals[].sharedTargetings[].exclusions[]

list

The list of values to exclude from targeting. Each value is AND'd together.

The timestamp (in ms since epoch) when the original reservation price for the deal was first converted to DFP currency. This is used to convert the contracted price into advertiser's currency without discrepancy.

deals[].terms.guaranteedFixedPriceTerms.billingInfo.dfpLineItemId

long

The DFP line item id associated with this deal. For features like CPD, buyers can retrieve the DFP line item for billing reconciliation.

The original contracted quantity (# impressions) for this deal. To ensure delivery, sometimes the publisher will book the deal with a impression buffer, such that guaranteed_looks is greater than the contracted quantity. However clients are billed using the original contracted quantity.

deals[].terms.guaranteedFixedPriceTerms.billingInfo.price

nested object

The original reservation price for the deal, if the currency code is different from the one used in negotiation.