---
title: TargetCpaRecommendationHistory
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/targetcparecommendationhistory
---

# TargetCpaRecommendationHistory

History record created when a target CPA recommendation is applied or dismissed.

## Declaration

```data
object TargetCpaRecommendationHistory
```

## Properties

recommendationId: The ID of the original recommendation. Read-only. recommendationType: The recommendation category. Value: TCPA. 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. appliedTargetCPA: The target CPA that was applied. Null on dismiss. See Money. Read-only. recommendedTargetCPA: The originally recommended target CPA. See Money. Read-only. rank: Rank at time of action. Read-only. installs: Historical install count. Read-only. spend: Historical spend. See Money. Read-only. averageCPA: Historical average CPA. See Money. Read-only. averageCPT: Historical average CPT. See Money. Read-only. impression: Historical impression count. Read-only. taps: Historical tap count. Read-only. ttr: Historical tap-through rate. Read-only. expectedInstalls: Expected installs from the original recommendation. Read-only. expectedSpend: Expected spend from the original recommendation. See Money. Read-only. expectedTaps: Expected taps from the original recommendation. Read-only. expectedCPA: Expected CPA from the original recommendation. 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 TargetCpaRecommendationHistory object is an immutable record that the system creates when you apply or dismiss a target CPA recommendation. The record preserves both recommendedTargetCPA and appliedTargetCPA (the value actually used, which may differ if the advertiser supplied a custom override). Example {   "recommendationId": "123456789",   "recommendationType": "TCPA",   "promotedObjectId": "987654321",   "promotedObjectType": "APPSTORE_APP",   "campaignId": 555666777,   "campaignName": "AwayFinder - US - Search",   "state": "APPLIED",   "status": "ENABLED",   "appliedTargetCPA": {     "amount": "5.50",     "currency": "USD"   },   "recommendedTargetCPA": {     "amount": "6.00",     "currency": "USD"   },   "rank": 1,   "installs": 1240,   "spend": {     "amount": "6820.00",     "currency": "USD"   },   "averageCPA": {     "amount": "5.50",     "currency": "USD"   },   "averageCPT": {     "amount": "0.85",     "currency": "USD"   },   "impression": 980000,   "taps": 8025,   "ttr": 0.0082,   "expectedInstalls": 1400,   "expectedSpend": {     "amount": "8400.00",     "currency": "USD"   },   "expectedTaps": 9100,   "expectedCPA": {     "amount": "6.00",     "currency": "USD"   },   "creationTime": "2025-01-05T08:00:00.000",   "modificationTime": "2025-01-10T08:00:00.000",   "appliedTime": "2025-01-10T08:00:00.000",   "expirationTime": "2025-01-20T08:00:00.000" }

## See Also

- [TargetCpaRecommendation](apple-ads-platform-api/targetcparecommendation.md)
- [DailyCapRecommendation](apple-ads-platform-api/dailycaprecommendation.md)
- [DailyCapRecommendationHistory](apple-ads-platform-api/dailycaprecommendationhistory.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)