DailyCapRecommendation

A daily budget recommendation for a campaign that’s frequently hitting its spending ceiling.

Declaration

object DailyCapRecommendation

Properties

Name	Type	Description
`id`	string	Unique identifier for the recommendation. Read-only.
`recommendationType`	`RecommendationCategory`	The recommendation category. Value: `DAILYCAP`. Read-only.
`promotedObjectId`	string	The ID of the promoted object. For `APPSTORE_APP`, this is the app Adam ID. For `BUSINESS_BRAND`, this is the brand ID. Read-only.
`promotedObjectType`	`PromotedObjectType`	The type of the promoted object. Read-only.
`campaignId`	int64	The campaign the recommendation is for. Read-only.
`campaignName`	string	Display name of the campaign. Read-only.
`state`	`RecommendationState`	Current state. Values: `AVAILABLE`, `APPLIED`, `DISMISSED`, `DELETE`. Read-only.
`status`	`RecommendationStatus`	Operational status. Read-only.
`suggestedDailyBudgetAmount`	`RecommendationMoney`	The recommended new daily budget. See Money. Read-only.
`dailyBudget`	`RecommendationMoney`	The campaign’s current daily budget. See Money. Read-only.
`bidStrategy`	`RecommendationBidStrategy`	The campaign’s current bid strategy. See BidStrategy. Read-only.
`installs`	int64	Historical install count. Read-only.
`spend`	`RecommendationMoney`	Historical spend. See Money. Read-only.
`averageCPA`	`RecommendationMoney`	Historical average cost per acquisition. See Money. Read-only.
`averageCPT`	`RecommendationMoney`	Historical average cost per tap. See Money. Read-only.
`impression`	int64	Historical impression count. Read-only.
`taps`	int64	Historical tap count. Read-only.
`ttr`	double	Historical tap-through rate. Read-only.
`expectedImpressions`	int64	The estimated impressions you could see over a seven-day period after applying a recommendation, based on historical data. Read-only.
`expectedInstalls`	int64	The estimated installs you could see over a seven-day period after applying a recommendation, based on historical data. Read-only.
`expectedSpend`	`RecommendationMoney`	The estimated amount you could spend over a seven-day period after applying a recommendation, based on historical data. See Money. Read-only.
`expectedTaps`	int64	The estimated taps you could see over a seven-day period after applying a recommendation, based on historical data. Read-only.
`expectedCpa`	`RecommendationMoney`	The estimated average cost-per-acquisition you could see over a seven-day period after applying a recommendation, based on historical data. See Money. Read-only.
`creationTime`	date-time	When the recommendation was created. Read-only.
`modificationTime`	date-time	When the recommendation was last modified. Read-only.
`expirationTime`	date-time	When the recommendation expires. Read-only.

Discussion

When a campaign frequently exhausts its daily budget, DailyCapRecommendation provides a system-calculated suggestedDailyBudgetAmount to unlock constrained growth. The expectedInstalls, expectedSpend, and expectedCpa fields provide projected seven-day performance estimates. Recommendations expire (expirationTime) and transition to APPLIED or DISMISSED once actioned.

Example

{
  "id": "rec-budget-001",
  "recommendationType": "DAILYCAP",
  "promotedObjectId": "123456789",
  "promotedObjectType": "APPSTORE_APP",
  "campaignId": 987654321,
  "campaignName": "AwayFinder Q1 Growth Campaign",
  "state": "AVAILABLE",
  "status": "ENABLED",
  "suggestedDailyBudgetAmount": {
    "amount": "500.00",
    "currency": "USD"
  },
  "dailyBudget": {
    "amount": "250.00",
    "currency": "USD"
  },
  "bidStrategy": {
    "bidStrategyType": "MAX_CONVERSIONS",
    "bidStrategyGoal": "INSTALL",
    "bidAmount": {
      "amount": "1.50",
      "currency": "USD"
    }
  },
  "installs": 500,
  "spend": {
    "amount": "2250.00",
    "currency": "USD"
  },
  "averageCPA": {
    "amount": "4.50",
    "currency": "USD"
  },
  "averageCPT": {
    "amount": "0.90",
    "currency": "USD"
  },
  "impression": 50000,
  "taps": 2500,
  "ttr": 0.05,
  "expectedImpressions": 60000,
  "expectedInstalls": 600,
  "expectedSpend": {
    "amount": "2700.00",
    "currency": "USD"
  },
  "expectedTaps": 3000,
  "expectedCpa": {
    "amount": "4.50",
    "currency": "USD"
  },
  "creationTime": "2025-01-10T08:00:00.000",
  "modificationTime": "2025-01-10T08:00:00.000",
  "expirationTime": "2025-02-10T08:00:00.000"
}

DailyCapRecommendation

Declaration

Properties

Discussion

Example

See Also