Operation （字符串）
必填 - 始终必填。
|要对提供的素材详情执行的操作。
允许值：
CREATE, UPDATE, DELETE.
ProgramId （整数）
必填 - 始终必填。
| 该素材在 impact.com 中的唯一 Program ID。此值无法更新，且必须与执行批量上传的程序匹配。 | |AdID （字符串）
必填 - 当对现有素材执行操作时。
| 该素材的 impact.com 唯一标识。创建新素材时留空。如果 *Operation* = `UPDATE`, `DELETE`. | |州 （字符串）
必填 - 否。
|素材状态。
允许值：
ACTIVE, PENDING, EXPIRED.
名称 （字符串）
必填 - 创建素材时必填。
| *素材名称*。如果 *Operation* = `CREATE`. | |AdType （字符串）
必填 - 创建素材时必填。
|更新现有广告时，广告类型可能不会更改。
如果 Operation = CREATE.
允许值：
IMAGE, TEXT\_LINK, COUPON.
HostedBy （字符串）
必填 - 创建素材时必填。
|素材创意托管位置。如果
Operation = CREATE 和 AdType = IMAGE.
允许值：
IR, URL, HTML.
Creative （字符串）
必填 - 创建图片素材时必填。
|要上传的创意文件名称。如果
Operation = CREATE 和 AdType = IMAGE.
IabAdUnit （字符串）
必填 - 创建图片素材时必填。
|IAB 标准素材尺寸。如果 Operation =
CREATE 和 AdType = IMAGE 和 HostedBy != IR.
允许值： UNKNOWN, MEDIUM\_RECTANGLE, SQUARE\_POP\_UP, VERTICAL\_RECTANGLE, LARGE\_RECTANGLE, RECTANGLE, RECTANGLE\_3\_1\_, POP\_UNDER, FULL\_BANNER, HALF\_BANNER, MICRO\_BANNER, BUTTON\_1, BUTTON\_2, VERTICAL\_BANNER, SQUARE\_BUTTON, LEADERBOARD, WIDE\_SKYSCRAPER, SKYSCRAPER, HALF\_PAGE\_AD, CUSTOM.
ThirdPartyServableAdCreativeHeight （整数）
必填 - 创建图片素材时必填。
|第三方可投放图片高度，像素。
如果 Operation = CREATE 和 IabAdUnit =
CUSTOM.
ThirdPartyServableAdCreativeWidth （整数）
必填 - 创建图片素材时必填。
|第三方可投放图片宽度，单位为像素。
如果 Operation = CREATE 和 IabAdUnit =
CUSTOM.
语言 （字符串）
必填 - 创建素材时必填。
|允许值：
AFRIKAANS, ARABIC, BULGARIAN, CHINESE, CHINESE\_TRADITIONAL, CZECH, DANISH, DUTCH, ENGLISH, ENGLISH\_GB, ENGLISH\_AU, ENGLISH\_CA, ENGLISH\_NZ, ENGLISH\_ZA, ESTONIAN, FILIPINO, FINISH, FRENCH, FRENCH\_CA, GERMAN, HEBREW, HINDI, INDONESIAN, ITALIAN, JAPANESE, KOREAN, LATVIAN, LITHUANIAN, MALAY, MALTESE, NORWEGIAN, PORTUGUESE, PORTUGUESE\_BR, POLISH, RUSSIAN, SLOVENIAN, SPANISH, SPANISH\_MX, SWEDISH, THAI, TURKISH, VIETNAMESE.
LimitedTimeEndDate （日期）
必填 - 如果提供了 LimitedTimeStartDate
| 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`. | |LinkText （字符串）
必填 - 创建文本链接或优惠券素材时必填。
| 链接实际显示的文本。如果 *Operation* = `CREATE` 和 *AdType* = `TEXT_LINK` 或 `COUPON`. | |描述
必填 - 否。
| 素材描述。 | |标签 （CSV 字符串）
必填 - 否。
| 素材标签。 | |AllowDeepLinking （布尔值）
必填 - 否。
|决定是否允许链接到广告主网站更深层的页面。
默认为 true.
AllowCustomPromoCode （布尔值）
必填 - 否。
|允许合作伙伴为此促销请求其自己的唯一促销代码。
默认为 false.
CustomisationCharge （十进制 10.2）
必填 - 否。
| 素材定制费用金额。 | |ImageAlternativeTag （字符串）
必填 - 否。
| 在图片素材代码中使用的替代标签。 | |LandingPage （字符串）
必填 - 否。
|落地页 URL。必须包含 URL 协议。
创建素材时如果未提供，则默认为程序默认落地页。
| |iOSMobileFallbackAppId （字符串）
必填 - 否。
| 指定当未检测到应用时，移动流量是否应回退到你的 iOS 应用落地页。App id 必须与系统 app id 匹配。 | |AndroidMobileFallbackAppId （字符串）
必填 - 否。
| 指定当未检测到应用时，移动流量是否应回退到你的 Android 应用落地页。App id 必须与系统 app ID 匹配。 | |LimitedTimeStartDate （字符串）
必填 - 否。
| 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`. | |FallbackAd （字符串）
必填 - 否。
| 指定一个回退素材 ID，仅适用于 `IMAGE` 素材。 | |GetHtmlCodeType （字符串）
必填 - 否。
| 允许值： `IFRAME_ONLY`, `HTML_AND_IFRAME`. | |Season （字符串）
必填 - 否。
|允许值：
WINTER, SPRING, SUMMER, FALL, NEW\_YEAR, PRESIDENTS\_DAY, VALENTINES\_DAY, ST\_PATRICKS\_DAY, EASTER, MOTHERS\_DAY, MEMORIAL\_DAY, FATHERS\_DAY, INDEPENDANCE\_DAY, BACK\_TO\_SCHOOL, LABOR\_DAY, HALLOWEEN, THANKSGIVING, BLACK\_FRIDAY, CYBER\_MONDAY, HANUKKAH, CHRISTMAS, FAMILY\_DAY, GOOD\_FRIDAY, VICTORIA\_DAY, CANADA\_DAY, AUGUST\_CIVIC\_HOLIDAY, REMEMBRANCE\_DAY, BOXING\_DAY, AUSTRALIA\_DAY, ANZAC\_DAY, QUEENS\_BIRTHDAY, END\_OF\_FINANCIAL\_YEAR, WAITANGI\_DAY, OTHER.
TopSeller （布尔值）
必填 - 否。
| 畅销商品。默认值为 `false`. | |ThirdPartyImpressionPixel （字符串）
必填 - 否。
| 与此素材一起使用的第三方展示像素 HTML。 | |RestrictedToPartners （CSV 字符串）
必填 - 否。
| 应有权访问此素材的合作伙伴 ID，以逗号分隔。 | |RestrictedToGroups （CSV 字符串）
必填 - 否。
| 应有权访问此素材的合作伙伴组 ID，以逗号分隔。 | |元数据 （CSV 字符串）
必填 - 否。
| 将追加到跟踪 URL 的以逗号分隔的查询字符串参数。 |DealName （字符串）
必填 - 创建新优惠时必填。
| 要创建并链接到素材的优惠名称。如果 *DealId* 未提供。 | |DealType （字符串）
必填 - 创建新优惠时必填。
|要创建的优惠类型。如果 DealId 未提供且 DealName 已提供。
允许值：
GENERAL\_SALE,FREE\_SHIPPING, GIFT\_WITH\_PURCHASE, REBATE, 买一送一, PRODUCT\_LAUNCH.
DealScope （字符串）
必填 - 创建新优惠时必填。
|如果 DealId 未提供， DealName 且 DealType != BOGO。
允许值：
ENTIRE\_STORE, CATEGORY, PRODUCT, PRODUCTS.
DealProducts （CSV 字符串）
必填 - 创建新优惠时必填。
|优惠商品。如果 DealId 未提供， DealName 且 DealScope = PRODUCT.
允许值：
选项 1：商品名称列表示例，例如 "Product1, Product2".
选项 2：商品键值对列表示例，例如 "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" 其中多个商品之间用逗号分隔，各商品字段之间用分号分隔。
有效字段： 名称 - 商品名称， image - 你打算在批量上传第二步中上传的文件的商品图片文件名， limit - 允许的数量， regularPrice - 折前价格， dealPrice - 折后价格。
DealCategories （CSV 字符串）
必填 - 创建新优惠时必填。
| 优惠类别。如果 *DealId* 未提供， *DealName* 且 *DealScope* = `CATEGORY`. | |DealLandingPage（字符串）
必填 - 否
DealMetadata（CSV 字符串）
必填 - 否
DealAllowDeepLinking（布尔值）
必填 - 否
DealDiscountType （CSV 字符串）
必填 - 创建新优惠时必填。
|如果 DealId 未提供， DealName 且 DealType = GENERAL\_SALE。
允许值：
FIXED, PERCENT, PERCENT\_RANGE, PERCENT\_MAXIMUM.
DealDiscountAmount （十进制 10.2）
必填 - 创建新优惠时必填。
| 销售折扣金额。如果 *DealId* 未提供， *DealName* 是， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `FIXED`. | |DealDiscountPercent （十进制 10.2）
必填 - 创建新优惠时必填。
| 销售折扣百分比。如果 *DealId* 未提供， *DealName* 是， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT`. | |DealDiscountStartPercent （十进制 10.2）
必填 - 创建新优惠时必填。
| 优惠折扣区间起始百分比。如果 *DealId* 未提供， *DealName* 是， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT_RANGE`. | |DealDiscountEndPercent （十进制 10.2）
必填 - 创建新优惠时必填。
| 优惠折扣区间起始百分比。如果 *DealId* 未提供， *DealName* 是， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT_RANGE`. | |DealDiscountMaximumPercent （十进制 10.2）
必填 - 创建新优惠时必填。
| 优惠最大折扣百分比。如果 *DealId* 未提供， *DealName* 是， *DealType* = `GENERAL_SALE`，以及 *DealDiscountType* = `PERCENT_MAXIMUM`. | |DealGift （十进制 10.2）
必填 - 创建新优惠时必填。
| 赠品详情。如果 *DealId* 未提供， *DealName* 且 *DealType* = `GIFT_WITH_PURCHASE`. | |DealRebate （十进制 10.2）
必填 - 创建新优惠时必填。
| 返利金额。如果 *DealId* 未提供， *DealName* 且 *DealType* = `REBATE`. | |DealMinimumPurchaseAmount （十进制 10.2）
必填 - 创建新优惠时必填。
| 优惠最低购买金额。如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealMaximumSavingsAmount （十进制 10.2）
必填 - 创建新优惠时必填。
| 优惠最高节省金额。如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealBogoPurchaseLimit （整数）
必填 - 创建新优惠时必填。
| 此价格允许的商品最大数量。如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealBogoBuyQty （整数）
必填 - 创建新优惠时必填。
| BOGO 购买数量。如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealBogoBuyType （字符串）
必填 - 创建新优惠时必填。
|BOGO 购买商品类型。如果 DealId 未提供， DealName 且 DealType = 买一送一.
允许值：
PRODUCT, CATEGORY.
DealBogoBuyName （字符串）
必填 - 创建新优惠时必填。
| 购买商品或类别的名称。如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealBogoGetQty （整数）
必填 - 创建新优惠时必填。
| BOGO 获赠数量。如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealBogoGetType （字符串）
必填 - 创建新优惠时必填。
|BOGO 获赠商品类型。如果 DealId 未提供， DealName 且 DealType = 买一送一.
允许值：
PRODUCT, CATEGORY.
DealBogoGetName （字符串）
必填 - 创建新优惠时必填。
| 获取的产品或分类名称。必填，如果 *DealId* 未提供， *DealName* 且 *DealType* = `买一送一`. | |DealBogoGetDiscountType （字符串）
必填 - 创建新优惠时必填。
|买一赠一促销折扣类型。必填，如果 DealId 未提供， DealName 且 DealType = 买一送一.
允许值：
免费, 金额, PERCENT.
DealBogoGetDiscountAmount （十进制 10.2）
必填 - 创建新优惠时必填。
| 买一赠一促销折扣金额。必填，如果 *DealId* 未提供， *DealName* 是， *DealType* = `买一送一`，以及 *DealBogoGetDiscountType* = `金额`. | |DealBogoGetDiscountPercent （十进制 10.2）
必填 - 创建新优惠时必填。
| 买一赠一促销折扣百分比。必填，如果 *DealId* 未提供， *DealName* 是， *DealType* = `买一送一`，以及 *DealBogoGetDiscountType* = `PERCENT`. | |DealId （字符串）
必填 - 否。
| 用于将素材链接到的促销唯一 impact.com 标识符。 | |DealDefaultDiscountCode （字符串）
必填 - 否。
| 默认促销折扣代码。 | |DealSyncAdsPromoCodes （布尔值）
必填 - 否。
| 使关联的广告和促销代码与此促销保持同步。同步适用于限时日期、受限合作伙伴访问权限和州/地区。 |