Description
Category
When you purchase a specified number of items you
receive some number of the same items for free. For
example, for every six dozen eggs you buy you get a
dozen eggs free.
ForEachQuantityXGetQuantityFreeX
The item is shipped free of charge.
BuyAmountXGetSimpleShippingFreeX
For a specified dollar amount you receive a discount off
another item. For example, buy three balls and get 25%
off of a baseball glove.
BuyAmountXGetAmountOffX
These promotional categories are returned by the response element:
• Category, in
PromotionSummary
responses
Benefit and Eligible Items
Items returned by one of the promotions response groups are related to the promotion in one of the
following ways:
• Benefit—The item is part of the promotional reward
For example, in a buy one camera and get a camera case free promotion, the camera case is the
benefit item
• Eligible—The item is what the customer must purchase to qualify for the promotion
For example, in a buy one camera and get a camera case free promotion, the camera is the eligible
item
• Both—It is possible for an item to be both the benefit and eligible item
For example, in a buy two shirts get the third shirt half off promotion, the shirt is both the benefit and
the eligible item
The promotions response groups specify whether an item is the benefit or eligible item by using the
elements
IsInBenefitSet
and
IsInEligibilitySet
.
<IsInBenefitSet>true</IsInBenefitSet>
<IsInEligibilityRequirementSet>true</IsInEligibilityRequirementSet>
The value type for both of these elements is boolean. When "true," the item is part of that set. For example,
if
IsInBenefitSet
is "true," the item is one of the benefits of the promotion.
If
IsInBenefitSet
is "true," the response also contains the element "BenefitDescription," which describes
the benefit item, as shown.
<BenefitDescription>Save $25.00 when you spend $125.00 or more on Kitchen &
Housewares or Bed & Bath products offered by Amazon.com. Enter code AUGSAVER
at checkout.</BenefitDescription>
If IsInEligibilitySet is "true," the response will contain the element, "EligibilityDescription," which describes
the eligible item.
API Version 2011-08-01
107
Product Advertising API Developer Guide
Promotions
