AdGroup CRUD APIs/Targeting Update APIs Error Codes

Error CodeError Description
INVALID_FIELD_START_OR_END_DATEInvalid start or end date
ADGROUP_ALREADY_EXIST_WITH_GIVEN_NAMEAd group already exists with the given name
INVALID_KEYWORD_TARGETING_TYPEInvalid match type for keywords (e.g., Broad type is not allowed for negative keywords)
INVALID_CONTEXTUAL_TARGETINGInvalid node passed in inclusions/exclusions (e.g., disabled node is not supported in targeting JSON)
INVALID_GEO_TARGETINGInvalid geo targeting structure
INVALID_KEYWORD_TARGETINGInvalid keyword targeting structure
AD_GROUP_START_END_DATE_NOT_ALLOWEDStart and end date should not be present when ad group setting is enabled
AD_GROUP_END_DATE_CANNOT_BE_NULLEnd date cannot be null if schedule and budget are defined at ad group level
END_DATE_MUSTBE_LATER_THAN_START_DATEEnd date must be later than start date
START_DATE_SHOULD_BE_WITHIN_YEARStart date should be within one year from the current date
AD_GROUP_START_DATE_CANNOT_BE_NULLStart date cannot be null
EITHER_DAILY_OR_TOTAL_BUDGET_CAN_BE_SETEither daily or total budget can be set for an ad group
INVALID_TARGETING_COMBINATIONOnly geo targeting can be combined with other targeting types
ADGROUP_INVALID_NAME_SIZEAd group name length must be between 4 and 1024 characters
ADGROUP_START_AND_END_DATE_SHOULD_BE_NULLStart and end date should be null if schedule and budget are defined at campaign level
ROS_ADGROUP_CANNOT_HAVE_TARGETING_DETAILS_SETRun-of-site ad group cannot have targeting details set
MORE_THAN_ONE_TARGETING_CANNOT_BE_SELECTEDMore than one targeting tactic cannot be selected
START_DATE_CANNOT_BE_NULLStart date cannot be null if schedule and budget are defined at ad group level
BUDGET_FIELD_CANNOT_BE_NEGATIVEBudget must be greater than or equal to 0
DAILY_CAP_CANNOT_BE_GREATER_THAN_WEEKLY_CAPDaily cap cannot be greater than weekly cap
DAILY_CAP_CANNOT_BE_GREATER_THAN_MONTHLY_CAPDaily cap cannot be greater than monthly cap
WEEKLY_CAP_CANNOT_BE_GREATER_THAN_MONTHLY_CAPWeekly cap cannot be greater than monthly cap
FRONTLOADED_NOT_ALLOWED_FOR_DAILY_BUDGET_TYPEFrontloaded delivery type is not allowed for daily budget
UNSUPPORTED_POST_FLIGHT_UPDATEOnly end date, budget, or bidding can be changed post-flight
TOTAL_AND_DAILY_BUDGET_NOT_ALLOWED_TOGETHERTotal and daily budget cannot be provided together
INVALID_GEO_LOCATION_IDGeo IDs provided in targeting request are invalid
INVALID_CONTEXTUAL_TARGETING_IDSContextual targeting IDs provided in targeting request are invalid
INVALID_AUDIENCE_IDAudience ID provided in targeting request is invalid
INVALID_TARGETING_EXPRESSIONTargeting expression provided is invalid
TARGETING_CONVERSION_FAILEDInvalid input expression for targeting
UNABLE_TO_FETCH_ADGROUP_DETAILAd group details not found
INVALID_GEO_TARGET_TYPEInvalid geo target type (supported values: STATE, CITY, DMA, COUNTRY)
ADGROUP_START_OR_END_DATE_CANNOT_BE_IN_PAST_DURING_PRE_FLIGHTAd group start or end date cannot be in the past during pre-flight
ADGROUP_END_DATE_ONLY_UNLIMITED_FOR_DRAFT_ADGROUPEnd date cannot be unlimited except for draft ad groups
END_DATE_CANNOT_BE_UNLIMITED_FOR_CAMPAIGN_IF_IT_DEFINED_AT_ADGROUP_LEVELEnd date cannot be set at campaign level if schedule is defined at ad group level
ADGROUP_UPDATE_FAILEDAd group update failed
KEYWORD_MATCH_TYPE_CANNOT_BE_EMPTYKeyword match type cannot be empty
INVALID_KEYWORD_MATCH_TYPEInvalid keyword match type
AUDIENCE_TYPE_CANNOT_BE_EMPTYAudience type cannot be empty
AUDIENCE_TYPE_AND_ATTRIBUTE_SHOULD_BE_SAME_ACROSS_ALL_NODEAudience type and attribute must be consistent across all nodes in a request
DAILY_BUDGET_NOT_HAVE_EXPECTED_VALUEDaily budget is less than the expected value
TOTAL_BUDGET_NOT_HAVE_EXPECTED_VALUETotal budget is less than the expected value
END_DATE_TOO_FAR_START_DATEEnd date is not after start date
MAX_BID_LESS_THAN_EXPECTED_VALUEMax bid is less than expected value
BASE_BID_LESS_THAN_EXPECTED_VALUEBase bid is less than expected value
INVALID_FREQUENCY_CAP_WEEKLY_LIMITInvalid weekly frequency cap
INVALID_FREQUENCY_CAP_MONTHLY_LIMITInvalid monthly frequency cap
INVALID_FREQUENCY_CAP_DAILY_LIMITInvalid daily frequency cap
INVALID_FREQUENCY_CAPInvalid frequency cap
ROS_LINEITEM_CANNOT_HAVE_TARGETING_DETAILS_MARK_EITHER_ONE_OF_THEM_AS_NULLRun-of-site line item cannot have targeting details set; mark one as null
MORE_THAN_ONE_TARGETING_TACTIC_IS_SELECTEDMore than one targeting tactic is selected
MID_FLIGHT_CHANGES_NOT_SUPPORTEDAd group targeting cannot be updated during mid-flight
START_DATE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_STATEStart 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_STATEBudget 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_STATEBidding 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_STATEDelivery profile cannot be changed during mid-flight, scheduled, paused, or completed state
TARGETING_TYPE_CANNOT_BE_CHANGED_DURING_MID_FLIGHT_OR_SCHEDULED_OR_PAUSED_STATETargeting 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_STATEAt 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_BUDGETBase bid must be less than or equal to daily or total budget
MAX_BID_SHOULD_BE_LESSER_THAN_OR_EQUAL_TO_DAILY_OR_TOTAL_BUDGETMax bid must be less than or equal to daily or total budget
BASE_BID_CANNOT_BE_GREATER_THAN_MAX_BIDBase bid must be less than or equal to max bid
ADGROUP_NOT_FOUNDNo ad group exists for the given adGroupId
NO_VALID_ADGROUPSNone of the provided adGroupIds are valid
INVALID_RATE_TYPEInvalid rate type passed for ad group
ADGROUP_LIMIT_REACHED_FOR_CAMPAIGNMaximum number of ad groups for the campaign has been reached
KEYWORD_TEXT_CANNOT_BE_EMPTY_OR_NULLKeyword text cannot be empty or null
AUDIENCE_ID_CANNOT_BE_EMPTY_OR_NULLAudience ID cannot be empty or null
CONTEXTUAL_TARGETING_ID_CANNOT_BE_EMPTY_OR_NULLContextual targeting ID cannot be empty or null
GEO_LOCATION_ID_CANNOT_BE_EMPTY_OR_NULLGeo location ID and zip code cannot both be empty or null
INVALID_CONTEXTUAL_TARGETING_TIERInvalid contextual targeting tier
NO_AUDIENCE_DETAIL_FETCHED_FOR_GIVEN_AUDIENCE_TYPE_AND_ATTRIBUTENo audience detail found for the given audience type and attribute
DIFFERENCE_BETWEEN_START_DATE_AND_END_DATE_CROSSED_LIMITDifference between start date and end date exceeded allowed limit
DUPLICATE_ADGROUP_REQUESTDuplicate ad group identifiers are not allowed in a single request
CREATE_ADGROUP_NOT_ALLOWED_IF_CAMPAIGN_STATUS_IS_ARCHIVEDAd group creation is not allowed when the campaign is archived
UPDATE_ADGROUP_NOT_ALLOWED_IF_ADGROUP_STATUS_IS_ARCHIVEDAd group update is not allowed when the ad group is archived
INVALID_ADGROUP_CAMPAIGN_IDAd group does not belong to the provided campaign ID
PROVIDE_EITHER_GEO_LOCATION_ID_OR_ZIP_CODEEither geo location ID or zip code must be provided
INVALID_GEO_LOCATION_ZIP_CODEInvalid geo location zip code
OTHER_GEO_TARGET_TYPE_NOT_ALLOWED_WITH_ZIPCODEGeo targeting cannot mix zip code with region or DMA
END_DATE_MUST_BE_AFTER_NOONEnd date must be after 12:00 PM EST
UNSUPPORTED_TARGETING_FOR_GIVEN_MEDIATYPEKeyword targeting is not supported for ad groups in video campaigns