AdGroup CRUD APIs/Targeting Update APIs Error Codes
| Error Response Code | Error Description |
|---|---|
| INVALID_FIELD_START_OR_END_DATE | Invalid start or end date |
| ADGROUP_ALREADY_EXIST_WITH_GIVEN_NAME | Ad group already exists with the given name |
| INVALID_KEYWORD_TARGETING_TYPE | Invalid match type for keywords E.g.: Broad Type is not allowed for negative keywords |
| INVALID_CONTEXTUAL_TARGETING | Invalid node passed in inclusions/exclusions E.g.: Disabled node is not supported in the targeting Json |
| AD_GROUP_START_END_DATE_NOT_ALLOWED | Start-end date should not be present with ad group setting enabled |
| AD_GROUP_END_DATE_CANNOT_BE_NULL | End date cannot be null if the schedule and budget are defined at ad group level |
| END_DATE_MUSTBE_LATER_THAN_START_DATE | End Date must be later than Start Date |
| START_DATE_SHOULD_BE_WITHIN_YEAR | Start date should be within an year from the current date |
| AD_GROUP_START_DATE_CANNOT_BE_NULL | Start Date cannot be null |
| EITHER_DAILY_OR_TOTAL_BUDGET_CAN_BE_SET | Either DAILY or TOTAL BUDGET can be set for an adgroup |
| INVALID_TARGETING_COMBINATION Only GEO_TARGETING | can be combined with any other targetings |
| ADGROUP_INVALID_NAME_SIZE | Ad group name length must be between 4 to 1024 characters |
| ADGROUP_START_AND_END_DATE_SHOULD_BE_NULL | Start and end date should be null if the schedule and budget are defined at campaign level |
| ROS_ADGROUP_CANNOT_HAVE_TARGETING_DETAILS_SET | Run of site ad group cannot have targeting details set |
| MORE_THAN_ONE_TARGETING_CANNOT_BE_SELECTED | More than one targeting tactic cannot be selected |
| START_DATE_CANNOT_BE_NULL | Start date cannot be null if the schedule and budget are defined at ad group level |
| BUDGET_FIELD_CANNOT_BE_NEGATIVE | budget must be greater than or equal to 0 |
| DAILY_CAP_CANNOT_BE_GREATER_THAN_WEEKLY_CAP | Daily cap can't be greater than weekly cap |
| DAILY_CAP_CANNOT_BE_GREATER_THAN_MONTHLY_CAP | Daily cap can't be greater than monthly cap |
| WEEKLY_CAP_CANNOT_BE_GREATER_THAN_MONTHLY_CAP | Weekly cap can't be greater than monthly cap |
| FRONTLOADED_NOT_ALLOWED_FOR_DAILY_BUDGET_TYPE | Frontloaded delivery type is not allowed for daily budget type |
| UNSUPPORTED_POST_FLIGHT_UPDATE | Only end date can be changed post flight |
| TOTAL_AND_DAILY_BUDGET_NOT_ALLOWED_TOGETHER | Total budget and Daily budget fields are not allowed together in the same request |
| INVALID_GEO_LOCATION_ID | GEOIDS provided in targeting request is invalid |
| INVALID_CONTEXTUAL_TARGETING_IDS | Contextual targeting IDs provided in targeting request are invalid |
| INVALID_AUDIENCE_ID | Audience ID provided in targeting request is invalid |
| INVALID_TARGETING_EXPRESSION | Targeting expression provided is invalid |
| TARGETING_CONVERSION_FAILED | Failed to convert targeting expression |
| UNABLE_TO_FETCH_ADGROUP_DETAIL | Ad group details not found |
| INVALID_GEO_TARGET_TYPE | Invalid Geo Target type value. Supported values are [STATE, CITY, DMA, COUNTRY] |
| ADGROUP_START_OR_END_DATE_CANNOT_BE_IN_PAST_DURING_PRE_FLIGHT | Ad Group start date/end date can't be in past, during pre-flight |
| ADGROUP_END_DATE_ONLY_UNLIMITED_FOR_DRAFT_ADGROUP | End date can be set to indefinite only if ad group is in draft state |
| END_DATE_CANNOT_BE_UNLIMITED_FOR_CAMPAIGN_IF_IT_DEFINED_AT_ADGROUP_LEVEL | End date cannot be indefinite for campaign if scheduling defined at Ad Group level |
| ADGROUP_UPDATE_FAILED | Ad group update failed |
| KEYWORD_MATCH_TYPE_CANNOT_BE_EMPTY | Keyword match type cannot be empty |
| INVALID_KEYWORD_MATCH_TYPE | Invalid keyword match type |
| AUDIENCE_TYPE_CANNOT_BE_EMPTY | Audience type cannot be empty |
| AUDIENCE_TYPE_AND_ATTRIBUTE_SHOULD_BE_SAME_ACROSS_ALL_NODE | Audience type and attribute combination should be same across all nodes in a single request |
| DAILY_BUDGET_NOT_HAVE_EXPECTED_VALUE | Daily budget should not be less than expected value |
| TOTAL_BUDGET_NOT_HAVE_EXPECTED_VALUE | Total budget should not be less than expected value |
| END_DATE_TOO_FAR_START_DATE | End date not after Start Date |
| MAX_BID_LESS_THAN_EXPECTED_VALUE | Max bid less than expected value |
| BASE_BID_LESS_THAN_EXPECTED_VALUE | Base bid less than expected value |
| INVALID_FREQUENCY_CAP_WEEKLY_LIMIT | Invalid frequency cap limit INVALID_FREQUENCY_CAP Invalid frequency cap |
| ROS_LINEITEM_CANNOT_HAVE_TARGETING_DETAILS_MARK_EITHER_ONE_OF_THEM_AS_NULL | Run of site line item cannot have targeting details set. Mark either one of them as null |
| MORE_THAN_ONE_TARGETING_TACTIC_IS_SELECTED | More than one targeting tactic is selected |
| MID_FLIGHT_CHANGES_NOT_SUPPORTED | Ad group targeting cannot be updated during mid flight |
| START_DATE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_STATE | Start date cannot be changed when adGroup is in mid flight, scheduled or paused state |
| BUDGET_TYPE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_OR_COMPLETED_STATE | Budget type cannot be changed when adGroup is in mid flight, scheduled or paused or completed state |
| BIDDING_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_OR_COMPLETED_STATE | Bidding cannot be changed when adGroup is in mid flight, scheduled or paused or completed state |
| DELIVERY_PROFILE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_OR_COMPLETED_STATE | Delivery profile cannot be changed when adGroup is in mid flight, scheduled or paused or completed state |
| TARGETING_TYPE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_STATE | Targeting type cannot be changed when adGroup is in mid flight, scheduled or paused state |
| AT_LEAST_ONE_APPROVED_KEYWORD_SHOULD_BE_PRESENT_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_STATE | At least one approved keyword should be present while updating keywords when adGroup is in mid flight, scheduled or paused state |
| BASE_BID_SHOULD_BE_LESSER_THAN_OR_EQUAL_TO_DAILY_OR_TOTAL_BUDGET | Base Bid should be less than or equal to the daily or total budget present in the adGroup or given in the request |
| MAX_BID_SHOULD_BE_LESSER_THAN_OR_EQUAL_TO_DAILY_OR_TOTAL_BUDGET | Max Bid should be less than or equal to the daily or total budget present in the adGroup or given in the request |
| BASE_BID_CANNOT_BE_GREATER_THAN_MAX_BID | Base bid should be lesser than or equal to max bid |
| ADGROUP_NOT_FOUND | There is no adGroup present with given adGroupId |
| NO_VALID_ADGROUPS | None of the adGroupIds passed in the request are valid |
| INVALID_RATE_TYPE | Invalid rate type passed for adGroup |
| ADGROUP_LIMIT_REACHED_FOR_CAMPAIGN | Maximum number of adGroups per campaign is reached, cannot create anymore adGroups for this campaign |
| UNABLE_TO_FETCH_ADGROUP_DETAIL | Unable to fetch adGroup detail for the given adGroupId, either it's not present or does not belong to the advertiser |
| KEYWORD_TEXT_CANNOT_BE_EMPTY_OR_NULL | Keyword text cannot be empty or null |
| AUDIENCE_ID_CANNOT_BE_EMPTY_OR_NULL | Audience id cannot be empty or null |
| CONTEXTUAL_TARGETING_ID_CANNOT_BE_EMPTY_OR_NULL | Contextual targeting id cannot be empty or null |
| GEO_LOCATION_ID_CANNOT_BE_EMPTY_OR_NULL | Geo location id /zipCode both cannot be empty or null |
| INVALID_CONTEXTUAL_TARGETING_TIER | Invalid contextual targeting tier |
| NO_AUDIENCE_DETAIL_FETCHED_FOR_GIVEN_AUDIENCE_TYPE_AND_ATTRIBUTE | No audience detail fetched for given audience type and attribute |
| DIFFERENCE_BETWEEN_START_DATE_AND_END_DATE_CROSSED_LIMIT | Difference between start date and end date crossed limit |
| DUPLICATE_ADGROUP_REQUEST | Two or more entries with same adgroup identifer are not allowed in a request |
| CREATE_ADGROUP_NOT_ALLOWED_IF_CAMPAIGN_STATUS_IS_ARCHIVED | AdGroup creation is not allowed if the campaign is in archived state |
| UPDATE_ADGROUP_NOT_ALLOWED_IF_ADGROUP_STATUS_IS_ARCHIVED | AdGroup updation is not allowed if the given adgroup is in archived state |
| INVALID_ADGROUP_CAMPAIGN_ID | AdGroup does not belong to the campaign id passed in the adgroup create/update request |
| PROVIDE_EITHER_GEO_LOCATION_ID_OR_ZIP_CODE | Either geo location id or zipCode is allowed |
| INVALID_GEO_LOCATION_ZIP_CODE | Invalid geo location zipCode provided |
| OTHER_GEO_TARGET_TYPE_NOT_ALLOWED_WITH_ZIPCODE | Geo Targeting should contain either zip code or regions/DMA, not both |
| END_DATE_MUST_BE_AFTER_NOON | End Date is less than 12 noon EST. It should be greater than 12 Noon EST. |
Updated about 8 hours ago