Loss notifications

Unity Exchange provides real-time loss notifications which communicate the reason why the participating bid lost in the auction. Advertising partners can leverage real-time information to inform their bidding strategies effectively across Unity’s inventory.

Integration

To receive loss notifications, include an optional lurl (loss URL) attribute in your response's bid object. This allows Unity to populate the loss reason code within the bid response.

AttributeTypeExampleDescription
lurlstring"lurl": "http://example.com/?bid=123456&loss=${AUCTION_LOSS}"Loss notice URL called by the exchange when a bid loses in auction.

The loss reason code is returned within the ${AUCTION_LOSS} macro.

Loss reason codes

The following table details the loss reason codes that Unity can return. Note that codes lower than 1001 are custom loss reasons that are not defined in the OpenRTB 2.5 spec.

CodeReasonDescription
1Internal errorA Unity internal error.
2Impression opportunity expiredThe impression took too long to show, such that the impression tracker was no longer valid.
3Invalid bid responseThe partner responded with no fill, did not respond at all, or failed in Unity’s OpenRTB validator.
4Invalid Deal IDThe deal ID in the bid response does not match the deal(s) in the bid request.
5Invalid auction IDThe ID in the bid request is not same as the ID in the bid response.
6Invalid (malformed) advertiser domainThe adomain (ad domain) attribute field in the bid response is an invalid format.
7Missing ad markupThe adm (ad markup) attribute field in the bid response is empty.
8Missing creative IDThe crid (creative ID) attribute field in the bid response is empty.
9Missing bid priceThe price (bid price) attribute field in the bid response is empty.
101Bid was below deal floorThe bid price was below the bid floor set in the request.
102Lost to higher bidThe bid lost the auction because to a higher bid price.
104Buyer seat blockedThe publisher has blocked the buyer or partner.
200Creative filtered (reason unknown)A catch-all for creatives that were filtered when the reason is unknown.
201Creative filtered (pending approval)The creative’s status is pending approval for the exchange.
202Creative filtered (approval denied)The creative was disapproved by Unity’s exchange review.
203Creative filtered (invalid size)The width and height of the creative does not match the dimensions defined in the request.
205Creative filtered (advertiser exclusions)The publisher has excluded the advertiser.
206Creative filtered (app bundle exclusions)The publisher has blocked the app bundle.
209Creative filtered (category exclusions)The publisher has blocked the advertising content category.
212Creative filtered (video length)The video length exceeds 30 seconds.
213Creative filtered (not allowed in PMP deal)Respondent creative is not included in the deal.
1000Failed Unity validatorThe bid failed validation due to compliance with Unity’s OpenRTB standards described in the request-response integration guides.
1001Invalid JSON formatThe bid response is a malformed JSON.
1002General marketplace rule blockA catch-all error for marketplace blocks that occur in Unity Exchange.
1003Max age rating exceededThe publisher blocked the bid due to the advertised app's age rating.
1004Missing crtype in bid extensionThe bid extension did not include a crtype when responding to a consolidated bid request.
1005Invalid crtype in bid extensionThe crtype ID was invalid or did not match any of the ad types sent in the consolidated bid request.
1006Region blockPublisher region block.
1007Platform blockPublisher platform block (iOS or Android).
1008Sensitive attribute blockPublisher block on demand containing sensitive attributes (for example: real money gambling).
1009Unity subcategory blockPublisher block on specified Unity subcategory.
1010IAB category blockPublisher block on specified IAB category.
1011invalidBURLorImpTrackingBid is missing burl or ext.imptrackers. Refer to Bid responses.
1012Bid Request TimeoutBid request has timed out.
1200Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1201Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1202Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1203Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1204Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1205Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1206Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1207Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1208Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user security-related issue.*
1209Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to the creative only containing a blank image or serving a 1x1 pixel image (blanks).*
1210Creative filtered (approval denied - performance issue)The creative was disapproved by Unity’s exchange review due to a performance issue.*
1211Creative filtered (approval denied - performance issue)The creative was disapproved by Unity’s exchange review due to a performance issue.*
1212Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a missing media file.*
1213Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1214Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1215Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1216Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1217Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1218Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1219Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1220Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1221Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1222Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1223Creative filtered (approval denied - performance issue)The creative was disapproved by Unity’s exchange review due to a performance issue.
1224Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1225Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1226Creative filtered (approval denied - offensive content)The creative was disapproved by Unity’s exchange review due to offensive content.
1227Creative filtered (approval denied - user security)The creative was disapproved by Unity’s exchange review due to a user-security related issue.
1228Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.
1229Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.
1230Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.
1231Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.
1232Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.
1233Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.
1234Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue.*
1235Creative filtered (approval denied - creative quality)The creative was disapproved by Unity’s exchange review due to a creative quality-related issue. The creative was moderated by Unity’s review. For more information, contact your Unity Ads representative.

* This decision was made with the use of automation. For more information on how Unity Ads uses automation, refer to the Unity Advertising Services Content Policy. If you have further questions about how Unity uses automation in moderation decisions, contact your Unity Ads representative.

As noted by the code in the preceding table, restrictions might be due to an asset containing content that violates the Unity content policy. For additional information, contact your Unity Ads representative. You can find your additional redress options in the Unity Advertising Services Content Policy.