/
[Error messages] Xandr

[Error messages] Xandr

Owned by Pascal Clausen
Last updated: 2024-10-29 by Daniel Yañez
7 min read

Challenge

While using our Xandr integration with features like checking availability or submitting, an error message appears that is coming directly from the Xandr API. What does an error from the API mean and what are the best ways to handle this?

Solution: 

 

When submitting data from ADvendio to external platforms, there are always two platforms involved. ADvendio is the system that sends data and the external platform (e.g. the AdServer) receives data.

This can have different reasons, for example, a problem with the authentication against the external system, a missing setting in ADvendio, or you are trying something which is generally not allowed (like changing the start date of an already running position). Following we are looking at the most common error messages returned from our Xandr integration, what they mean and how to prevent them.

What are the most common error cases?

 

With the below information, you'll be equipped with a clear understanding of FreeWheel error messages, the reasons behind them, and the necessary steps to troubleshoot and overcome integration challenges you may encounter:

  1. Error Message: You'll see a list of different error messages, each with its own type and wording.

  2. Reason: We provide explanations to help you understand what caused the error message. This will give you insights into why the issue occurred.

  3. Solution: For each error message, we offer troubleshooting steps to resolve the problem. These steps guide you towards finding a solution and getting past the error.

Error Message

Reason

Solution

Error Message

Reason

Solution

Id: SYNTAX, Code: INVALID_COUNTRY_ACTION, Message: country_action must be set to exclude when country_targets are empty

You are trying to submit an Item of type Augmented, without any geo targeting set. Please be aware that Xandr requires at least one selected geo targeting criteria when using Augmented line items.

You can use our geo targeting features in the Media Configuration to change this or enhance your AdSpec definition, to automatically use certain geo targeting for each Campaign Item related to that product.

See also our wiki for more information: 7.3.8.3 Augmented Line Items

"Id: SYNTAX, Message: revenue_value must be between 0 and 999 (in USD), inclusively"

The Revenue Value you are trying to set for your Item is either too high or low. The revenue value in Xandr represents, the price charged per sold unit (for example a CPM rate) and can be used to prioritize delivery. In ADvendio we use to map Campaign Item prices or specific fields to map this information.

Please check the pricing information on your Campaign Item. The revenue value we send to Xandr either is calculated based on the Amount N2 or Amount N3 of your Campaign Item OR there is a specific field: AdServer Price used for this.

Please see the configuration on your connection record to find out what is used.

More information can be found here: 7.3.1.2 Submit Prices to the AdServer

Id: SYNTAX, Code: ALI_CREATIVE_AD_TYPE_MISMATCH, Message: Creative cannot be associated to a line item with a different value for 'ad_type'

 

Id: SYNTAX, Code: CREATIVE_LI_AD_TYPE_MISMATCH, Message: The 'ad_type' for the Line Item and Creative must match"

Each Xandr Item has Line Item Ad Type, like Banner, Video, Native, ect. . This steers what kind of creatives you can assign to this item.

When you get this error during Submit to AdServer, most likely the type you set up in ADvendio is not matching with what is set in Xandr and your item in Xandr already is assigned to Creatives.

This usually happens when you manually assign creatives within Xandr and thus change your Line Item Ad Type.

You are able to set the AdType in Xandr, by using the field Product Type in ADvendio, which can be found on the Campaign Item and Ad Type object.

[Configure Ad Type Formats] for Xandr products

4.2.5.6 How to overwrite Item Type and Goal settings from your Ad Type on Campaign Items(Ad Type, Goal Type, Goal Percent / Quantity)

Please make sure the value in ADvendio matches your setting in Xandr.

Id: SYNTAX, Code: INVALID_TYPE, Message: field 'type' is required

For Guaranteed Augmented Line Item (GDALI) bookings into Xandr Mandatory

To define in the Ad Type > AdServer information > Delivery Type field if they have an Impression or Share of Voice (Exclusive) goal. This is usually referred to as Type in Xandr.

If this setting is missing or invalid in ADvendio, you can receive such a error message.

To fix this problem, please check your Delivery Type settings on the