TargetCpaRecommendation

A target CPA recommendation for a campaign using a Maximize Conversions bid strategy.

Declaration

object TargetCpaRecommendation

Properties

Name	Type	Description
`id`	string	Unique identifier for the recommendation. Read-only.
`recommendationType`	`RecommendationCategory`	The recommendation category. Value: `TCPA`. 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.
`recommendedTargetCPA`	`RecommendationMoney`	The suggested new target CPA. See Money. Read-only.
`bidStrategy`	`RecommendationBidStrategy`	The campaign’s current bid strategy. See RecommendationBidStrategy. Read-only.
`averageCPT`	`RecommendationMoney`	Historical average cost per tap. See Money. Read-only.
`averageCPA`	`RecommendationMoney`	Historical average cost per acquisition. See Money. Read-only.
`expectedTaps`	int64	Expected taps if recommendation is applied. 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.
`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.
`impression`	int64	Historical impression count. Read-only.
`installs`	int64	Historical install count. Read-only.
`spend`	`RecommendationMoney`	Historical spend. See Money. Read-only.
`taps`	int64	Historical tap count. Read-only.
`ttr`	double	Historical tap-through rate. 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

For campaigns using a Maximize Conversions bid strategy, TargetCpaRecommendation provides a system-calculated recommendedTargetCPA derived from historical averageCPA and projected performance. To evaluate the suggested adjustment, compare recommendedTargetCPA against averageCPA. Once actioned, the system creates a TargetCpaRecommendationHistory record.

Example

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

TargetCpaRecommendation

Declaration

Properties

Discussion

Example

See Also