com.enremmeta.rtb.proto.pubmatic

Class PubmaticAdapter

java.lang.Object

com.enremmeta.rtb.proto.spotxchange.ExchangeAdapterImpl<OpenRtbRequest,OpenRtbResponse>

com.enremmeta.rtb.proto.pubmatic.PubmaticAdapter

All Implemented Interfaces:

ExchangeAdapter<OpenRtbRequest,OpenRtbResponse>

public class PubmaticAdapter
extends ExchangeAdapterImpl<OpenRtbRequest,OpenRtbResponse>

Adapter for Pubmatic exchange.

Author:

Gregory Golberg (grisha@alum.mit.edu)

Copyright © Enremmeta LLC 2015. All Rights Reserved.

Nested Class Summary

Nested classes/interfaces inherited from interface com.enremmeta.rtb.proto.ExchangeAdapter

ExchangeAdapter.BidChoiceAlgorithm

Field Summary

Fields

Modifier and Type	Field and Description
private PubmaticConfig	config
static String	RESPONSE_MEDIA_TYPE
private String	vcode

Constructor Summary

Constructors

Constructor and Description
PubmaticAdapter()

Method Summary

Modifier and Type	Method and Description
OpenRtbRequest	convertRequest(OpenRtbRequest req)
OpenRtbResponse	convertResponse(OpenRtbRequest req, OpenRtbResponse resp)
String	getClickEncMacro()
String	getClickMacro()
long	getDefaultTimeout() What is the default timeout, in milliseconds (default, because timeout can also be provided dynamically as OpenRtbRequest.getTmax() on each request, which takes precedence).
String	getName()
javax.ws.rs.core.Response.ResponseBuilder	getOptoutBuilder(OpenRtbRequest req) Default behavior is not OK here in case of private deal IDs.
String	getPartnerInitiatedSyncUrl(String myUserId)
String	getResponseMediaType()
String	getSeat(Ad ad)
String	getWinningPriceMacro() Winning price macro.
boolean	localUserMapping() Whether the mapping of our user ID to exchange ID is stored by us.
ParsedPriceInfo	parse(String winningPriceString, long bidMicros)
private void	parseWinLossInfo(OpenRtbRequest req)
boolean	trueWinOnNurlOrImpression() Whether the true win is known by the winning price, gotten either during the call of NUrl or out of band.
List<String>	validateAd(Ad ad) Specific requirements (from communications with Pubmatic): adomain must include only ONE domain iurl is required

Methods inherited from class com.enremmeta.rtb.proto.spotxchange.ExchangeAdapterImpl

toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.enremmeta.rtb.proto.ExchangeAdapter

checkExchangeTargeting, debug, error, error, fillPlatformInfoFromUa, getBidChoiceAlgorithm, getSampleWinningPrice, getWinTimeout, info, isAggregator, isMacrosInNurl, isNurlRequired, makeExchangeSpecificInstructionsMap, massageBid, parseUserId, setHeaders, trace

Field Detail

config

private final PubmaticConfig config

vcode

private final String vcode

RESPONSE_MEDIA_TYPE

public static final String RESPONSE_MEDIA_TYPE

See Also:

Constant Field Values

Constructor Detail

PubmaticAdapter

public PubmaticAdapter()
                throws Lot49Exception

Throws:

Lot49Exception

Method Detail

getPartnerInitiatedSyncUrl

public String getPartnerInitiatedSyncUrl(String myUserId)

getDefaultTimeout

public long getDefaultTimeout()

Description copied from interface: ExchangeAdapter

What is the default timeout, in milliseconds (default, because timeout can also be provided dynamically as OpenRtbRequest.getTmax() on each request, which takes precedence).

getWinningPriceMacro

public String getWinningPriceMacro()

Description copied from interface: ExchangeAdapter

Winning price macro.

See Also:

ExchangeAdapter.parse(String, long)

localUserMapping

public boolean localUserMapping()

Description copied from interface: ExchangeAdapter

Whether the mapping of our user ID to exchange ID is stored by us.

trueWinOnNurlOrImpression

public boolean trueWinOnNurlOrImpression()

Description copied from interface: ExchangeAdapter

Whether the true win is known by the winning price, gotten either during the call of NUrl or out of band. For example, OpenX does the latter, and so a true Win should be registered in StatsSvc.resultsOpenX(javax.ws.rs.core.UriInfo, String, com.enremmeta.rtb.proto.openx.AuctionResultMessage, String, javax.servlet.http.HttpServletRequest, String, javax.ws.rs.core.HttpHeaders)

See Also:

StatsSvc#nurl(javax.ws.rs.core.UriInfo, String, String, String, String, String, String, String, String, String, String, long, String, String, String, String, String, String, javax.servlet.http.HttpServletRequest, String, String, String, String, String), LogUtils.logWin(String, String, String, String, String, String, String, double, long, long, long, String, String, String, String, String, javax.servlet.http.HttpServletRequest, String, Long, String, java.net.URI, boolean, String, String, String, String, String, String, boolean, boolean, String), StatsSvc.impression(javax.ws.rs.core.UriInfo, String, String, String, String, String, String, String, String, String, long, String, int, String, String, String, String, String, String, String, javax.servlet.http.HttpServletRequest, String, javax.ws.rs.core.HttpHeaders, String, String)

convertRequest

public OpenRtbRequest convertRequest(OpenRtbRequest req)
                              throws Throwable

Throws:

Throwable

parseWinLossInfo

private void parseWinLossInfo(OpenRtbRequest req)

getClickMacro

public String getClickMacro()

getClickEncMacro

public String getClickEncMacro()

convertResponse

public OpenRtbResponse convertResponse(OpenRtbRequest req,
                                       OpenRtbResponse resp)
                                throws Throwable

Throws:

Throwable

parse

public ParsedPriceInfo parse(String winningPriceString,
                             long bidMicros)
                      throws Throwable

Throws:

Throwable

See Also:

ExchangeAdapter.getWinningPriceMacro()

getSeat

public final String getSeat(Ad ad)

getName

public String getName()

validateAd

public List<String> validateAd(Ad ad)

Specific requirements (from communications with Pubmatic):

• adomain must include only ONE domain
• iurl is required

getResponseMediaType

public String getResponseMediaType()

getOptoutBuilder

public javax.ws.rs.core.Response.ResponseBuilder getOptoutBuilder(OpenRtbRequest req)

Default behavior is not OK here in case of private deal IDs.