AdGroup CRUD APIs/Targeting Update APIs Error Codes
| Error 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 targeting JSON) |
| INVALID_GEO_TARGETING | Invalid geo targeting structure |
| INVALID_KEYWORD_TARGETING | Invalid keyword targeting structure |
| AD_GROUP_START_END_DATE_NOT_ALLOWED | Start and end date should not be present when ad group setting is enabled |
| AD_GROUP_END_DATE_CANNOT_BE_NULL | End date cannot be null if 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 one 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 ad group |
| INVALID_TARGETING_COMBINATION | Only geo targeting can be combined with other targeting types |
| ADGROUP_INVALID_NAME_SIZE | Ad group name length must be between 4 and 1024 characters |
| ADGROUP_START_AND_END_DATE_SHOULD_BE_NULL | Start and end date should be null if 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 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 cannot be greater than weekly cap |
| DAILY_CAP_CANNOT_BE_GREATER_THAN_MONTHLY_CAP | Daily cap cannot be greater than monthly cap |
| WEEKLY_CAP_CANNOT_BE_GREATER_THAN_MONTHLY_CAP | Weekly cap cannot be greater than monthly cap |
| FRONTLOADED_NOT_ALLOWED_FOR_DAILY_BUDGET_TYPE | Frontloaded delivery type is not allowed for daily budget |
| UNSUPPORTED_POST_FLIGHT_UPDATE | Only end date, budget, or bidding can be changed post-flight |
| TOTAL_AND_DAILY_BUDGET_NOT_ALLOWED_TOGETHER | Total and daily budget cannot be provided together |
| INVALID_GEO_LOCATION_ID | Geo IDs provided in targeting request are 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 | Invalid input expression for targeting |
| UNABLE_TO_FETCH_ADGROUP_DETAIL | Ad group details not found |
| INVALID_GEO_TARGET_TYPE | Invalid geo target type (supported values: STATE, CITY, DMA, COUNTRY) |
| ADGROUP_START_OR_END_DATE_CANNOT_BE_IN_PAST_DURING_PRE_FLIGHT | Ad group start or end date cannot be in the past during pre-flight |
| ADGROUP_END_DATE_ONLY_UNLIMITED_FOR_DRAFT_ADGROUP | End date cannot be unlimited except for draft ad groups |
| END_DATE_CANNOT_BE_UNLIMITED_FOR_CAMPAIGN_IF_IT_DEFINED_AT_ADGROUP_LEVEL | End date cannot be set at campaign level if schedule is 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 must be consistent across all nodes in a request |
| DAILY_BUDGET_NOT_HAVE_EXPECTED_VALUE | Daily budget is less than the expected value |
| TOTAL_BUDGET_NOT_HAVE_EXPECTED_VALUE | Total budget is less than the expected value |
| END_DATE_TOO_FAR_START_DATE | End date is not after start date |
| MAX_BID_LESS_THAN_EXPECTED_VALUE | Max bid is less than expected value |
| BASE_BID_LESS_THAN_EXPECTED_VALUE | Base bid is less than expected value |
| INVALID_FREQUENCY_CAP_WEEKLY_LIMIT | Invalid weekly frequency cap |
| INVALID_FREQUENCY_CAP_MONTHLY_LIMIT | Invalid monthly frequency cap |
| INVALID_FREQUENCY_CAP_DAILY_LIMIT | Invalid daily frequency cap |
| 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 one 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 during 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 during mid-flight, scheduled, paused, or completed state |
| BIDDING_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_OR_COMPLETED_STATE | Bidding cannot be changed during mid-flight, scheduled, paused, or completed state |
| DELIVERY_PROFILE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_OR_COMPLETED_STATE | Delivery profile cannot be changed during mid-flight, scheduled, paused, or completed state |
| TARGETING_TYPE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_STATE | Targeting type cannot be changed during 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 must be present when updating keywords during mid-flight, scheduled, or paused state |
| BASE_BID_SHOULD_BE_LESSER_THAN_OR_EQUAL_TO_DAILY_OR_TOTAL_BUDGET | Base bid must be less than or equal to daily or total budget |
| MAX_BID_SHOULD_BE_LESSER_THAN_OR_EQUAL_TO_DAILY_OR_TOTAL_BUDGET | Max bid must be less than or equal to daily or total budget |
| BASE_BID_CANNOT_BE_GREATER_THAN_MAX_BID | Base bid must be less than or equal to max bid |
| ADGROUP_NOT_FOUND | No ad group exists for the given adGroupId |
| NO_VALID_ADGROUPS | None of the provided adGroupIds are valid |
| INVALID_RATE_TYPE | Invalid rate type passed for ad group |
| ADGROUP_LIMIT_REACHED_FOR_CAMPAIGN | Maximum number of ad groups for the campaign has been reached |
| 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 and zip code cannot both 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 found for the given audience type and attribute |
| DIFFERENCE_BETWEEN_START_DATE_AND_END_DATE_CROSSED_LIMIT | Difference between start date and end date exceeded allowed limit |
| DUPLICATE_ADGROUP_REQUEST | Duplicate ad group identifiers are not allowed in a single request |
| CREATE_ADGROUP_NOT_ALLOWED_IF_CAMPAIGN_STATUS_IS_ARCHIVED | Ad group creation is not allowed when the campaign is archived |
| UPDATE_ADGROUP_NOT_ALLOWED_IF_ADGROUP_STATUS_IS_ARCHIVED | Ad group update is not allowed when the ad group is archived |
| INVALID_ADGROUP_CAMPAIGN_ID | Ad group does not belong to the provided campaign ID |
| PROVIDE_EITHER_GEO_LOCATION_ID_OR_ZIP_CODE | Either geo location ID or zip code must be provided |
| INVALID_GEO_LOCATION_ZIP_CODE | Invalid geo location zip code |
| OTHER_GEO_TARGET_TYPE_NOT_ALLOWED_WITH_ZIPCODE | Geo targeting cannot mix zip code with region or DMA |
| END_DATE_MUST_BE_AFTER_NOON | End date must be after 12:00 PM EST |
| UNSUPPORTED_TARGETING_FOR_GIVEN_MEDIATYPE | Keyword targeting is not supported for ad groups in video campaigns |
Updated 10 days ago
