com.enremmeta.rtb.config

Class PacingServiceConfig

java.lang.Object

com.enremmeta.rtb.config.PacingServiceConfig

All Implemented Interfaces:

Config, Jsonable, Serializable

public class PacingServiceConfig
extends Object
implements Config

Config for pacing service. For actual information on the pacing algorithms, see AdCache.

Author:

Gregory Golberg (grisha@alum.mit.edu) Copyright © Enremmeta LLC 2014. All Rights Reserved.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	BUDGET_ALLOCATION_STRATEGY_NAIVE This strategy will allocate money to a current Ad as follows: Figure out how many refresh periods there are between now and end of Ad's flight. Divide total remaining budget in the pacing cache by this number, and also by the number of number of servers servicing this bid stream.
static String	BUDGET_ALLOCATION_STRATEGY_WIN_RATE_BASED This strategy will allocate the budget as BUDGET_ALLOCATION_STRATEGY_NAIVE first, and then calculate the win rate (wins/bids) and divide the budget by the win rate.
private String	budgetAllocationStrategy
static String	DEFAULT_BUDGET_ALLOCATION_STRATEGY
static long	DEFAULT_MESSAGE_TTL_MINUTES
private double	effectiveWinRateIfLessThanMin
private int	lockExpireSeconds
private long	messageTtlMinutes
private RedisServiceConfig	redis
private double	winRateMin
private long	winRateTtlMinutes

Constructor Summary

Constructors

Constructor and Description
PacingServiceConfig()

Method Summary

Modifier and Type	Method and Description
String	getBudgetAllocationStrategy() How to allocated money from budget.
double	getEffectiveWinRateIfLessThanMin()
int	getLockExpireSeconds()
long	getMessageTtlMinutes()
RedisServiceConfig	getRedis()
double	getWinRateMin()
long	getWinRateTtlMinutes()
void	setBudgetAllocationStrategy(String budgetAllocationStrategy)
void	setEffectiveWinRateIfLessThanMin(double effectiveWinRateIfLessThanMin)
void	setLockExpireSeconds(int lockExpireSeconds)
void	setMessageTtlMinutes(long messageTtlMinutes)
void	setRedis(RedisServiceConfig redis)
void	setWinRateMin(double winRateMin)
void	setWinRateTtlMinutes(long winRateTtlMinutes)

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.enremmeta.rtb.config.Config

handleUnknown

Methods inherited from interface com.enremmeta.util.Jsonable

normalize

Field Detail

winRateMin

private double winRateMin

effectiveWinRateIfLessThanMin

private double effectiveWinRateIfLessThanMin

redis

private RedisServiceConfig redis

DEFAULT_MESSAGE_TTL_MINUTES

public static final long DEFAULT_MESSAGE_TTL_MINUTES

See Also:

Constant Field Values

messageTtlMinutes

private long messageTtlMinutes

winRateTtlMinutes

private long winRateTtlMinutes

BUDGET_ALLOCATION_STRATEGY_NAIVE

public static final String BUDGET_ALLOCATION_STRATEGY_NAIVE

This strategy will allocate money to a current Ad as follows:

1. Figure out how many refresh periods there are between now and end of Ad's flight.
2. Divide total remaining budget in the pacing cache by this number, and also by the number of number of servers servicing this bid stream.

See Also:

Constant Field Values

BUDGET_ALLOCATION_STRATEGY_WIN_RATE_BASED

public static final String BUDGET_ALLOCATION_STRATEGY_WIN_RATE_BASED

This strategy will allocate the budget as BUDGET_ALLOCATION_STRATEGY_NAIVE first, and then calculate the win rate (wins/bids) and divide the budget by the win rate. In other words, if the naive strategy resulted in allocation of micro$ 10000 and the win rate is 20% (0.2), the new budget will be adjusted to 50000.

See Also:

Constant Field Values

DEFAULT_BUDGET_ALLOCATION_STRATEGY

public static final String DEFAULT_BUDGET_ALLOCATION_STRATEGY

See Also:

Constant Field Values

budgetAllocationStrategy

private String budgetAllocationStrategy

lockExpireSeconds

private int lockExpireSeconds

Constructor Detail

PacingServiceConfig

public PacingServiceConfig()

Method Detail

getWinRateMin

public double getWinRateMin()

setWinRateMin

public void setWinRateMin(double winRateMin)

getEffectiveWinRateIfLessThanMin

public double getEffectiveWinRateIfLessThanMin()

setEffectiveWinRateIfLessThanMin

public void setEffectiveWinRateIfLessThanMin(double effectiveWinRateIfLessThanMin)

getMessageTtlMinutes

public long getMessageTtlMinutes()

setMessageTtlMinutes

public void setMessageTtlMinutes(long messageTtlMinutes)

getWinRateTtlMinutes

public long getWinRateTtlMinutes()

setWinRateTtlMinutes

public void setWinRateTtlMinutes(long winRateTtlMinutes)

getBudgetAllocationStrategy

public String getBudgetAllocationStrategy()

How to allocated money from budget. Possible choices are:

1. naive
2. winRateBased

NOTE: This applies to allocating new money from the budget, and does not apply to what to do with money allocated previously that was unspent. For that, see getBudgetAllocationStrategy().

setBudgetAllocationStrategy

public void setBudgetAllocationStrategy(String budgetAllocationStrategy)

getRedis

public RedisServiceConfig getRedis()

setRedis

public void setRedis(RedisServiceConfig redis)

getLockExpireSeconds

public int getLockExpireSeconds()

setLockExpireSeconds

public void setLockExpireSeconds(int lockExpireSeconds)