Inventory Feeds

A fundamental piece of an ads program is an inventory feed (also called product or entity feed) that corresponds to eligible products that can be configured in ad campaigns. The IDs correspond to what is used in the Koddi API integration. As part of the integration process, Koddi will ask for a sample feed.

Koddi can provide you with a template to help you get started.

Feed Requirements

There are two fields that MUST be included in every inventory feed:

–Entity ID
There must be a key ID that is the smallest level of granularity for items included in the product feed. This is generally something like a product ID, a hotel ID, or vehicle VIN. The Koddi system has no requirement for the data type of this ID (for example, it can be a string, integer, or floating point number), but it is generally the thing that is being bid on (the entity in the campaign structure).

–Entity Name
The name of thing must also be included.

–Site ID
If you have a multi-site program, you must also include a Site ID. We ask that you send us a separate file feed per site.

All other data points are configurable, but how they are configured for category filtering and targeting is explored below.

Feeds should be uploaded to the feed ingestion API

📘

During the implementation phase, a one time feed is enough.

To keep on track with feed configuration, a one time feed is enough in the beginning. A fully automated feed does not need to be in place until launch (or shortly thereafter).

Feed Limits

There is currently no hard limit the number of products in the feed or the number of attributes you can include. Your Koddi team will work with you if limits are required.

Using the Feed for Pricing and Availability

Koddi does not recommend using the Koddi feeds system for pricing and availability. Our ad delivery flow describes our approach to pricing and availability.

📘

Categories vs Targets

A category is generally feature of the entity/product itself (such as brand). It is used for filtering and generally NOT a biddable characteristic.

A target is the thing the entity is being targeted to (such as new shopper). It IS a biddable characteristic.

More on this here.

Using Feed Attributes for Category Filtering

Product attributes in the feed can be used for category filtering. The column name in the feed must match the parameter name in the winning ads API call EXACTLY (including case) to work.

Using Feed Attributes for Ad Targeting

Product attributes in the feed can be used for targeting. The column name in the feed must match the parameter name in the targeting configuration EXACTLY (including case) to work.

Sizes and Colors in Retail Use Cases

We recommend that your product feed be at the level at which you expect your advertisers prefer to bid. In our experience, suppliers generally do not bid differently on product variations such as size or color, so we generally don't include that grain in the feed. It makes life easier on everyone.