exchange

Documentation

Index

• Constants
• func BuildAdapters(client *http.Client, cfg *config.Configuration, infos config.BidderInfos, ...) (map[openrtb_ext.BidderName]AdaptedBidder, []error)
• func GetActiveBidders(infos config.BidderInfos) map[string]openrtb_ext.BidderName
• func GetDisabledBiddersErrorMessages(infos config.BidderInfos) map[string]string
• func GetPriceBucket(cpm float64, config openrtb_ext.PriceGranularity) string
• func GetValidBidders(aliases map[string]string) map[string]struct{}
• func IsDebugOverrideEnabled(debugHeader, configOverrideToken string) bool
• func JLogf(msg string, obj interface{})
• func WrapJSONInData(data []byte) []byte
• type AdaptedBidder
  • func AdaptBidder(bidder adapters.Bidder, client *http.Client, cfg *config.Configuration, ...) AdaptedBidder
• type AuctionRequest
• type BidIDGenerator
• type BidderRequest
• type DebugData
• type DebugLog
  • func (d *DebugLog) BuildCacheString()
  • func (d *DebugLog) PutDebugLogError(cache prebid_cache_client.Client, timeout int, errors []error) error
• type Exchange
  • func NewExchange(adapters map[openrtb_ext.BidderName]AdaptedBidder, ...) Exchange
• type IdFetcher
• type ImpExtInfo
• type RejectedBid

Constants

const (
	DebugOverrideHeader string = "x-pbs-debug-override"
)

const (
	Gzip string = "GZIP"
)

Possible values of compression types Prebid Server can support for bidder compression

const ImpIdReqBody = "Stored bid response for impression id: "

const MaxKeyLength = 20

Functions

func BuildAdapters

func BuildAdapters(client *http.Client, cfg *config.Configuration, infos config.BidderInfos, me metrics.MetricsEngine) (map[openrtb_ext.BidderName]AdaptedBidder, []error)

func GetActiveBidders

func GetActiveBidders(infos config.BidderInfos) map[string]openrtb_ext.BidderName

GetActiveBidders returns a map of all active bidder names.

func GetDisabledBiddersErrorMessages

func GetDisabledBiddersErrorMessages(infos config.BidderInfos) map[string]string

GetDisabledBiddersErrorMessages returns a map of error messages for disabled bidders.

func GetPriceBucket

func GetPriceBucket(cpm float64, config openrtb_ext.PriceGranularity) string

GetPriceBucket is the externally facing function for computing CPM buckets

func GetValidBidders

func GetValidBidders(aliases map[string]string) map[string]struct{}

func IsDebugOverrideEnabled

func IsDebugOverrideEnabled(debugHeader, configOverrideToken string) bool

func JLogf

func JLogf(msg string, obj interface{})

func WrapJSONInData

func WrapJSONInData(data []byte) []byte

Types

type AdaptedBidder

type AdaptedBidder interface {
	// contains filtered or unexported methods
}

AdaptedBidder defines the contract needed to participate in an Auction within an Exchange.

This interface exists to help segregate core auction logic.

Any logic which can be done _within a single Seat_ goes inside one of these. Any logic which _requires responses from all Seats_ goes inside the Exchange.

This interface differs from adapters.Bidder to help minimize code duplication across the adapters.Bidder implementations.

func AdaptBidder

func AdaptBidder(bidder adapters.Bidder, client *http.Client, cfg *config.Configuration, me metrics.MetricsEngine, name openrtb_ext.BidderName, debugInfo *config.DebugInfo, endpointCompression string) AdaptedBidder

AdaptBidder converts an adapters.Bidder into an exchange.AdaptedBidder.

The name refers to the "Adapter" architecture pattern, and should not be confused with a Prebid "Adapter" (which is being phased out and replaced by Bidder for OpenRTB auctions)

type AuctionRequest

type AuctionRequest struct {
	BidRequestWrapper          *openrtb_ext.RequestWrapper
	ResolvedBidRequest         json.RawMessage
	UpdatedBidRequest          json.RawMessage
	Account                    config.Account
	UserSyncs                  IdFetcher
	RequestType                metrics.RequestType
	StartTime                  time.Time
	Warnings                   []error
	GlobalPrivacyControlHeader string
	ImpExtInfoMap              map[string]ImpExtInfo

	// LegacyLabels is included here for temporary compatibility with cleanOpenRTBRequests
	// in HoldAuction until we get to factoring it away. Do not use for anything new.
	LegacyLabels   metrics.Labels
	FirstPartyData map[openrtb_ext.BidderName]*firstpartydata.ResolvedFirstPartyData
	// map of imp id to stored response
	StoredAuctionResponses stored_responses.ImpsWithBidResponses
	// map of imp id to bidder to stored response
	StoredBidResponses    stored_responses.ImpBidderStoredResp
	BidderImpReplaceImpID stored_responses.BidderImpReplaceImpID
	PubID                 string
}

AuctionRequest holds the bid request for the auction and all other information needed to process that request

type BidIDGenerator

type BidIDGenerator interface {
	New() (string, error)
	Enabled() bool
}

type BidderRequest

type BidderRequest struct {
	BidRequest            *openrtb2.BidRequest
	BidderName            openrtb_ext.BidderName
	BidderCoreName        openrtb_ext.BidderName
	BidderLabels          metrics.AdapterLabels
	BidderStoredResponses map[string]json.RawMessage
	ImpReplaceImpId       map[string]bool
}

BidderRequest holds the bidder specific request and all other information needed to process that bidder request.

type DebugData

type DebugData struct {
	Request  string
	Headers  string
	Response string
}

type DebugLog

type DebugLog struct {
	Enabled       bool
	CacheType     prebid_cache_client.PayloadType
	Data          DebugData
	TTL           int64
	CacheKey      string
	CacheString   string
	Regexp        *regexp.Regexp
	DebugOverride bool
	//little optimization, it stores value of debugLog.Enabled || debugLog.DebugOverride
	DebugEnabledOrOverridden bool
}

func (*DebugLog) BuildCacheString

func (d *DebugLog) BuildCacheString()

func (*DebugLog) PutDebugLogError

func (d *DebugLog) PutDebugLogError(cache prebid_cache_client.Client, timeout int, errors []error) error

type Exchange

type Exchange interface {
	// HoldAuction executes an OpenRTB v2.5 Auction.
	HoldAuction(ctx context.Context, r AuctionRequest, debugLog *DebugLog) (*openrtb2.BidResponse, error)
}

Exchange runs Auctions. Implementations must be threadsafe, and will be shared across many goroutines.

func NewExchange

func NewExchange(adapters map[openrtb_ext.BidderName]AdaptedBidder, cache prebid_cache_client.Client, cfg *config.Configuration, syncersByBidder map[string]usersync.Syncer, metricsEngine metrics.MetricsEngine, infos config.BidderInfos, gdprPermsBuilder gdpr.PermissionsBuilder, tcf2CfgBuilder gdpr.TCF2ConfigBuilder, currencyConverter *currency.RateConverter, categoriesFetcher stored_requests.CategoryFetcher, adsCertSigner adscert.Signer) Exchange

type IdFetcher

type IdFetcher interface {
	GetUID(key string) (uid string, exists bool, notExpired bool)
	HasAnyLiveSyncs() bool
}

IdFetcher can find the user's ID for a specific Bidder.

type ImpExtInfo

type ImpExtInfo struct {
	EchoVideoAttrs bool
	StoredImp      []byte
	Passthrough    json.RawMessage
}

type RejectedBid

type RejectedBid struct {
	Bid             *openrtb2.Bid `json:"bid,omitempty"`
	RejectionReason int           `json:"rejectreason,omitempty"`
	BidderName      string        `json:"biddername,omitempty"`
}

RejectedBid defines the contract for bid rejection errors due to floors enforcement