--- title: DailyCapRecommendationHistory framework: Apple Ads Platform API role: symbol role_heading: Object platforms: [apple ads platform api 1.0+] path: apple-ads-platform-api/dailycaprecommendationhistory --- # DailyCapRecommendationHistory History record created when you apply or dismiss a daily budget recommendation. ## Declaration ```data object DailyCapRecommendationHistory ``` ## Properties recommendationId: The ID of the original recommendation. Read-only. recommendationType: The recommendation category. Value: DAILYCAP. Read-only. promotedObjectId: 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: The type of the promoted object. Read-only. campaignId: The campaign ID. Read-only. campaignName: Display name of the campaign. Read-only. state: Terminal state. Values: APPLIED, DISMISSED. Read-only. status: Operational status. Read-only. appliedDailyBudgetAmount: The daily budget that was applied. Null on dismiss. See Money. Read-only. suggestedDailyBudgetAmount: The originally suggested daily budget. See Money. Read-only. rank: Rank at time of action. Read-only. installs: Historical install count at time of action. Read-only. spend: Historical spend at time of action. See Money. Read-only. averageCPA: Historical average CPA at time of action. See Money. Read-only. averageCPT: Historical average CPT at time of action. See Money. Read-only. impression: Historical impression count. Read-only. taps: Historical tap count. Read-only. ttr: Historical tap-through rate. Read-only. expectedImpressions: Expected impressions from the original recommendation. Read-only. expectedImpressionsLow: Lower bound of the expected impressions confidence interval. Read-only. expectedImpressionsHigh: Upper bound of the expected impressions confidence interval. Read-only. expectedInstalls: Expected installs from the original recommendation. Read-only. expectedInstallsLow: Lower bound of the expected installs confidence interval. Read-only. expectedInstallsHigh: Upper bound of the expected installs confidence interval. Read-only. expectedSpend: Expected spend from the original recommendation. See Money. Read-only. expectedSpendLow: Lower bound of the expected spend confidence interval. See Money. Read-only. expectedSpendHigh: Upper bound of the expected spend confidence interval. See Money. Read-only. expectedTaps: Expected taps from the original recommendation. Read-only. expectedTapsLow: Lower bound of the expected taps confidence interval. Read-only. expectedTapsHigh: Upper bound of the expected taps confidence interval. Read-only. expectedCpa: Expected CPA from the original recommendation. See Money. Read-only. expectedCpaLow: Lower bound of the expected CPA confidence interval. See Money. Read-only. expectedCpaHigh: Upper bound of the expected CPA confidence interval. See Money. Read-only. creationTime: When the original recommendation was created. Read-only. modificationTime: When this history record was last modified. Read-only. appliedTime: When the action was taken. Read-only. expirationTime: When the original recommendation would have expired. Read-only. ## Discussion Discussion The DailyCapRecommendationHistory object is an immutable record created when you apply or dismiss a daily budget recommendation. The record preserves both suggestedDailyBudgetAmount and the appliedDailyBudgetAmount actually used, so you can check whether you overrode the suggestion. Example { "recommendationId": "123456789", "recommendationType": "DAILYCAP", "promotedObjectId": "987654321", "promotedObjectType": "APPSTORE_APP", "campaignId": 555666777, "campaignName": "AwayFinder - Search Campaign", "state": "APPLIED", "status": "ENABLED", "appliedDailyBudgetAmount": { "amount": "150.00", "currency": "USD" }, "suggestedDailyBudgetAmount": { "amount": "150.00", "currency": "USD" }, "rank": 1, "installs": 420, "spend": { "amount": "980.50", "currency": "USD" }, "averageCPA": { "amount": "2.33", "currency": "USD" }, "averageCPT": { "amount": "0.85", "currency": "USD" }, "impression": 154000, "taps": 3200, "ttr": 0.0208, "expectedImpressions": 220000, "expectedImpressionsLow": 190000, "expectedImpressionsHigh": 250000, "expectedInstalls": 600, "expectedInstallsLow": 520, "expectedInstallsHigh": 680, "expectedSpend": { "amount": "1400.00", "currency": "USD" }, "expectedSpendLow": { "amount": "1250.00", "currency": "USD" }, "expectedSpendHigh": { "amount": "1550.00", "currency": "USD" }, "expectedTaps": 4600, "expectedTapsLow": 4000, "expectedTapsHigh": 5200, "expectedCpa": { "amount": "2.33", "currency": "USD" }, "expectedCpaLow": { "amount": "2.05", "currency": "USD" }, "expectedCpaHigh": { "amount": "2.60", "currency": "USD" }, "creationTime": "2025-01-08T08:00:00.000", "modificationTime": "2025-01-10T08:00:00.000", "appliedTime": "2025-01-10T08:00:00.000", "expirationTime": "2025-01-15T08:00:00.000" } ## See Also - [TargetCpaRecommendation](apple-ads-platform-api/targetcparecommendation.md) - [TargetCpaRecommendationHistory](apple-ads-platform-api/targetcparecommendationhistory.md) - [DailyCapRecommendation](apple-ads-platform-api/dailycaprecommendation.md) - [ApplyTargetCpaRecommendation](apple-ads-platform-api/applytargetcparecommendation.md) - [ApplyDailyCapRecommendation](apple-ads-platform-api/applydailycaprecommendation.md) - [ResponseEnvelope](apple-ads-platform-api/recommendationresponsebody.md) - [ResponseError](apple-ads-platform-api/recommendationresponseerror.md) - [ResponseErrorDetail](apple-ads-platform-api/recommendationresponseerrordetail.md) - [ResponsePagination](apple-ads-platform-api/recommendationresponsepagination.md) - [Money](apple-ads-platform-api/recommendationmoney.md) - [RecommendationApplyDailyBudgetResponse](apple-ads-platform-api/recommendationapplydailybudgetresponse.md) - [RecommendationApplyTargetCpaResponse](apple-ads-platform-api/recommendationapplytargetcparesponse.md) - [RecommendationBidStrategy](apple-ads-platform-api/recommendationbidstrategy.md) - [RecommendationDismissDailyBudgetResponse](apple-ads-platform-api/recommendationdismissdailybudgetresponse.md) - [RecommendationDismissTargetCpaResponse](apple-ads-platform-api/recommendationdismisstargetcparesponse.md)