DCS Error Codes, Messages, and Examples dcs-error-codes-messages-and-examples
Error codes and messages generated by the Data Collection Servers (DCS) listed in numeric order by code ID.
In the tables below, italics represents a variable placeholder.
System Error Codes system-error-codes
hostnamed_orgid value (could not find a config for this org id): IDIntegration Error Codes integration-error-codes
IDd_mid= key-value pair in the header string. Make sure you’re passing in the correct Experience Cloud ID and try the request again.IDd_uuid= key-value pair in the header string. Make sure you’re passing in the correct Audience Manager ID and try the request again.HTTP referer is not allowed for partner Partner IDHTTP referer header on the call is not allowed for the partner ID on the call. Check that the HTTP referer header is correct.IMS token receivedOpt-Out Error Codes opt-out-error-codes
IDBased on the IP address, the DCS blocks requests from the following countries:
- Cuba (CU)
- Iran (IR)
- North Korea (KP)
- Sudan (SD)
- Syria (SY)
Profile Retrieval Error Codes profile-retrieval-error-codes
IDIDIDIDID to ID, because profile read failed for IDIntegration Warning Codes integration-warning-codes
IDmaximum allowed. Found is maximum found.IDIDIDIDIDID was discarded because it exceeded the limit of declared customer ids per requestRelated to error 301. This error specifies which customer ID was discarded because the limit was exceeded.
For example, If there are 12 customer IDs declared on the DCS call, two of them will be discarded. In order to relay which ones were discarded, this error will appear twice in the response (once for each of discarded customer ID ).
ID, customer id is ID.This error code is returned if there are more than 3 customer IDs declared for the same namespace ( DPID) on a DCS call.
https://partner.demdex.net/event?d_rtbd=json&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one
In this sample DCS request, there are 4 ids declared for the same namespace (with the integration code one). One of the IDs is discarded and error 310 is returned.
The DCS returns this error code when at least one URL parameter is not properly encoded. In this case, the DCS disregards the entire request.
http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%esid!&d_creative=%ecid!&d_adgroup=%eaid!&d_placement=%epid!&d_campaign=%ebuy!&d_adsrc=48123
In the sample request above, the % sequence is incorrectly encoded. Consequently, the DCS will disregard it.
The correctly encoded sample should look like this:
http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%25esid!&d_creative=%25ecid!&d_adgroup=%25eaid!&d_placement=%25epid!&d_campaign=%25ebuy!&d_adsrc=48123
The DCS returns this error code when the request contains an invalid Global Device ID. DCS ignores the invalid ID and throws a 312 error along with the specific errors of the invalid ID. Refer to Global Data Sources and Index of IDs in Audience Manager for detailed information on the correct device advertising ID formats and corresponding global data sources.
Example of an incorrect call: "http://partner.demdex.net/event?d_rtbd=json&d_cid=20915%01a53cc5a2-6aa1-4210-8ded-a88b29b6212z"
Explanation: An IDFA (DPID 20915) must be an uppercase ID. The ID provided in the request is lowercase.
gdpr=1 and the IAB TC string is generated by a CMP ID that is not present in Audience Manager's cached version of the Global CMP List at the moment of evaluation, the Audience Manager Plug-in for IAB TCF discards the IAB TC string and process the request as usual. The IAB TCF v2.2 ${GDPR} macro is set to 0 and the ${GDPR_CONSENT_XXX} macro is empty.gdpr=1 and the IAB TC string is generated by a CMP that is marked as deleted in our cached version of the Global CMP List, the Audience Manager Plug-in for IAB TCF discards the TC string and processes the request as usual, if the evaluation time is past the deletion time from the Global CMP List. The IAB TCF v2.2 ${GDPR} macro is set to 0 and the ${GDPR_CONSENT_XXX} macro is empty.Sample Error Code Messages sample-error-codes
The DCS returns error codes and messages in a JSON object or in an X- header in the HTTP response string.
Sample DCS Error Code and Message
{
"errors":[
{
"code":101,
"msg":"Invalid Experience Cloud id passed in"
},
{
"code":102,
"msg":"Invalid aam id passed in request"
}
]
}
X-Error
Error codes captured by the X- header appear in the URL string like this, X-Error: 101,102.
Race Conditions and Error Handling