Apply Daily Budget Recommendations
Apply one or more daily budget recommendations, updating the campaign’s daily budget to the suggested amount.
URL
POST https://api.ads.apple.com/v1/recommendations/daily-budgets/applyHeader Parameters
| Name | Type | Description |
|---|---|---|
X-Ap-Context Required | string |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | RecommendationApplyDailyBudgetResponse | |
| 400 | Bad Request Content-Type: application/json | RecommendationResponseBody | |
| 401 | Unauthorized Content-Type: application/json | RecommendationResponseBody | |
| 403 | Forbidden Content-Type: application/json | RecommendationResponseBody | |
| 404 | Not Found Content-Type: application/json | RecommendationResponseBody | |
| 429 | Too Many Requests Content-Type: application/json | RecommendationResponseBody | |
| 500 | Internal Server Error Content-Type: application/json | RecommendationResponseBody |
Discussion
Applying a daily budget recommendation updates the campaign’s dailyBudget to the recommendation’s suggestedDailyBudgetAmount, and moves the recommendation to APPLIED state. You can override the suggested amount by passing appliedDailyBudget in the request. The response is a history record with both the suggested and applied amounts, plus the performance context behind the recommendation.
Payload Examples
This example applies a daily budget recommendation, raising the campaign’s daily budget to the suggested $500.00. The response confirms the recommendation is now APPLIED.
HTTP Body
Send an array of ApplyDailyCapRecommendation objects, one per recommendation you want to apply. All items must share the same promotedObjectId, and each item needs id, promotedObjectId, and promotedObjectType. appliedDailyBudget is optional, use it to override the suggested amount.