Error Codes for FreeWheel Ad Submissions
The error messages for failed ad submissions can come from either Advertising DSP or from FreeWheel. Error messages are shown in the API Response column in the Freewheel Status dialog.
Advertising DSP Internal Errors
Error Message
Description
Next Steps
Awaiting status response from FreeWheel
FreeWheel hasn鈥檛 yet responded that the submission was successful or failed.
Check the status again in 10 minutes.
The submitted ad does not have a clock number assigned.
FreeWheel doesn鈥檛 accept UK ads without assigned clock numbers.
Assign a clock number to the ad, and then resubmit the ad.
The ad you are attempting to submit has not yet finished transcoding. Please wait ten minutes then try again.
The transcoder hadn鈥檛 finished transcoding the ad when you attempted to submit the ad.
Wait ten minutes, and then resubmit the ad.
The deal id you input is not setup as a guaranteed feed. Please submit guaranteed deals only.
The submitted deal is not set up as a programmatic guaranteed deal. FreeWheel accepts only guaranteed deals.
Set up the deal ID as a programmatic guaranteed deal. The ad is automatically submitted to FreeWheel when you save the programmatic guaranteed default placement at the end of deal ID workflow.
Invalid external_deal_id: <deal_id>
The submitted deal ID either doesn鈥檛 exist or isn鈥檛 active on the 51黑料不打烊 end.
Make sure that the deal is active, and then resubmit the ad.
[public_id=]<deal> does not exist
The submitted deal id doesn鈥檛 exist on the FreeWheel end.
Contact your FreeWheel representative to confirm the deal ID.
Ad with identifier <ad name> was not found.
The submitted ad key either doesn鈥檛 exist or isn鈥檛 active on the 51黑料不打烊 end.
Find the correct ad key, and then resubmit the ad.
Pending Submission
The submission is still pending.
Refresh the page.
Freewheel API Errors
Code
Meaning
Description
Next Steps
401
Unauthorized
Incorrect, missing, or invalid access credentials.
Contact your 51黑料不打烊 Account Team.
403
Forbidden
The server understood the request but refuses to authorize it.
Contact your 51黑料不打烊 Account Team.
404
Not Found
The resource you requested is not available. If the Creative ID is not found in the PUT operation, a 404 is returned.
Contact your 51黑料不打烊 Account Team.
405
Method Not Allowed
A request was made of a resource using a request method not supported by that resource (for example, using GET on a method that requires data to be sent by POST, or using PUT on a read-only resource).
Contact your 51黑料不打烊 Account Team.
408
Request Timeout
A timeout occurred while this request was processing. Timeouts usually are caused by concurrent requests of exclusive access to certain resources.
Resubmit the request when you receive this status. If the issue persists, contact your 51黑料不打烊 Account Team.
422
Unprocessable Entity
Invalid resource. This error happens when the request body is invalid or the created/updated resource is invalid (for example, if the Deal ID was not found). See FreeWheel API 422 Errors for more information.
Contact your 51黑料不打烊 Account Team.
500
Internal Server Error
API system error.
Contact your 51黑料不打烊 Account Team.
Freewheel API 422 Errors freewheel-422-errors
Code
HTTP Code
Description
DATA_UNMARSHALL_FAILURE
422
The request data is invalid json format. Check the error message for details.
DATA_VALIDATION_FAILURE
422
The request data is missing required fields or has an invalid data type. Check the error message for details.
DATA_DEAL_INVALID
422
The deal is configured incorrectly or doesn鈥檛 exist. Check the error message for details.
DATA_DEAL_GET_FAILURE
422
The deal wasn鈥檛 found or its configuration has an issue. Check the error message for details.
DATA_CREATIVE_INGEST_FAILURE
422
The creative URL is invalid. Check the error message for details.
DATA_CREATIVE_LINK_FAILURE
422
The creative wasn鈥檛 linked to the ad unit nodes of the deal. Check the error message for details.
DATA_CREATIVE_UPDATE_FAILURE
422
The creative wasn鈥檛 updated. Check the error message for details.
DATA_DSP_GET_FAILURE
422
The DSP doesn鈥檛 exist within the system.
DATA_CREATIVE_UNLINK_FAILURE
422
The creative wasn鈥檛 unlinked from ad units.
DATA_CREATIVE_DELETE_FAILURE
422
The creative wasn鈥檛 deleted.
DATA_CREATIVE_DETECTION_FAILURE
422
The URL wasn鈥檛 detected.
DATA_ENTITY_NOT_FOUND
422
The creative doesn鈥檛 exist.
recommendation-more-help
9ff4800f-94be-45f0-a5bf-09d0d7e96baa