批量上传资源

使用批量上传工具通过 CSV 文件一次上传多个素材，而不是单个上传素材。信息字段与 广告对象 类似，以帮助您协调哪些信息放在哪里。

执行批量广告上传需要两个文件：

• 素材元数据文件（CSV）

• 创意文件（例如图像或视频）

1

步骤 1：准备素材元数据文件

您上传的 CSV 文件有必填字段和可接受的值。您的素材将完全按照文件中显示的内容出现，因此如果使用了空格、标点符号或特殊字符，它们将会存在。要开始，请复制下面显示的 CSV 模板并粘贴到电子表格应用中，或在此下载 并直接导入。

Operation,AdID,State,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes

提示： 我们建议使用 文件格式 详细信息可在 批量上传 屏幕上查看，以在上传前检查您的输入！

在使用元数据文件创建或更新素材之前，请注意有关部分更新的以下重要点：

• 支持部分更新。如果您留空某个单元格，该字段将被忽略，其现有值将保持不变。

• 要清除或删除某个值，请在该单元格中明确输入 $CLEAR$ 这将删除该字段之前存储的任何值。

Operation,AdID,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,LimitedTimeZone,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes
CREATE,,Banner Example,This is an example of a new banner ad you would upload.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NewBanner",TRUE,,,,,,,ENGLISH,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,FRAME_ONLY,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

• 该 CREATE 行显示一个新的横幅素材。

• 该 UPDATE 行演示部分更新——只有有值的字段会被更新。

• 如果您想清除一个值（例如，移除 标签），您将在该列中使用 $CLEAR$ 。

示例清除字段（CSV）：

UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

2

步骤 2：上传素材元数据文件

1. 从左侧导航栏，选择 [参与] → 内容 → 广告.

2. 在右上角，选择 批量上传.

3. 选择  选择文件，上传您的批量文件，然后选择 打开.

   • 选择  显示/隐藏文件格式详细信息 以查看有关必需列、它们的说明、可接受值以及在以下引用中是否为必填项的信息， 广告头列 和 优惠头列 参考文档。

注意： impact.com 会在文件有任何错误时提醒您。

1. 选择 下一步.

广告头列

列名	说明
操作 （字符串） 必填 - 始终。	要对所提供素材详情执行的操作。 允许的值： CREATE, UPDATE, 删除.
ProgramId （整数） 必填 - 始终。	素材所属的唯一 impact.com 项目 ID。该值不可更新，且必须与执行批量上传的项目匹配。
AdID （字符串） 必填 - 在对现有素材执行操作时。	素材的唯一 impact.com 标识符。创建新素材时请留空。如果 操作 = UPDATE, 删除.
State （字符串） 必填 - 否。	素材的状态。 允许的值： 激活, 待定, 已过期.
名称 （字符串） 必填 - 创建素材时。	素材名称。如果 操作 = CREATE.
AdType （字符串） 必填 - 创建素材时。	更新现有广告时，广告类型可能无法更改。 必填如果 操作 = CREATE. 允许的值： 图片, 文本链接, 优惠券.
HostedBy （字符串） 必填 - 创建素材时。	素材创意托管位置。若 操作 = CREATE 和 AdType = 图片. 允许的值： IR, URL, HTML.
创意 （字符串） 必填 - 创建图像素材时。	要上传的创意文件名。若 操作 = CREATE 和 AdType = 图片.
IabAdUnit （字符串） 必填 - 创建图像素材时。	IAB 标准素材尺寸。若 操作 = CREATE 和 AdType = 图片 和 HostedBy != IR. 允许的值： 未知, 中等矩形, 方形弹出, 垂直矩形, 大矩形, 矩形, 矩形 3:1, 弹出底部，全横幅, 半横幅，微型横幅, 按钮 1, 按钮 2, 垂直横幅, 方形按钮, 排行榜横幅, 宽摩天楼, 摩天楼, 半页广告, 自定义.
ThirdPartyServableAdCreativeHeight （整数） 必填 - 创建图像素材时。	第三方可提供的图像高度，像素。 必填如果 操作 = CREATE 和 IabAdUnit = 自定义.
ThirdPartyServableAdCreativeWidth （整数） 必填 - 创建图像素材时。	第三方可提供的图像宽度，像素。 必填如果 操作 = CREATE 和 IabAdUnit = 自定义.
语言 （字符串） 必填 - 创建素材时。	允许的值： 南非荷兰语, 阿拉伯语, 保加利亚语, 中文, 繁体中文, 捷克语, 丹麦语, 荷兰语, 英语, 英国英语, 澳大利亚英语, 加拿大英语, 新西兰英语, 南非英语, 爱沙尼亚语, 菲律宾语, 芬兰语, 法语, 加拿大法语, 德语, 希伯来语, 印地语, 印尼语, 意大利语, 日语, 韩语, 拉脱维亚语, 立陶宛语, 马来语, 马耳他语, 挪威语, 葡萄牙语, 巴西葡萄牙语, 波兰语, 俄语, 斯洛文尼亚语, 西班牙语, 墨西哥西班牙语, 瑞典语, 泰语, 土耳其语, 越南语.
LimitedTimeEndDate （日期） 必填 - 如果提供了 LimitedTimeStartDate	这是一个 ISO8601 日期。示例格式： 2013-06-30T00:00:00-07:00.
链接文本 （字符串） 必填 - 创建文本链接或优惠券素材时。	链接显示的实际文本。如果 操作 = CREATE 和 AdType = 文本链接 或 优惠券.
说明 必填 - 否。	素材描述。
标签 （CSV 字符串） 必填 - 否。	素材标签。
允许深度链接 （布尔值） 必填 - 否。	确定是否允许链接到广告主网站内更深的页面。 默认值为 true.
允许自定义促销码 （布尔值） 必填 - 否。	允许合作伙伴为此促销请求其自己的唯一促销码。 默认值为 false.
定制费用 （十进制 10.2） 必填 - 否。	素材定制费用金额。
图片替代标签 （字符串） 必填 - 否。	在图像素材代码中使用的替代标签。
登陆页面 （字符串） 必填 - 否。	落地页 URL。必须包含 URL 协议。 创建素材且未提供时，默认使用项目默认落地页。
iOS 移动回退应用 ID （字符串） 必填 - 否。	如果在未检测到应用时希望移动流量回退到您的 iOS 应用落地页，请指定。应用 ID 必须与系统应用 ID 匹配。
Android 移动回退应用 ID （字符串） 必填 - 否。	如果在未检测到应用时希望移动流量回退到您的 Android 应用落地页，请指定。应用 ID 必须与系统应用 ID 匹配。
LimitedTimeStartDate （字符串） 必填 - 否。	这是一个 ISO8601 日期。示例格式： 2013-06-30T00:00:00-07:00.
回退素材 （字符串） 必填 - 否。	指定回退素材 ID，仅适用于 图片 素材。
获取 HTML 代码类型 （字符串） 必填 - 否。	允许的值： 仅 IFRAME, HTML 和 IFRAME.
季节 （字符串） 必填 - 否。	允许的值： 冬季, 春季, 夏季, 秋季, 新年, 总统日, 情人节, 圣帕特里克节, 复活节, 母亲节, 阵亡将士纪念日, 父亲节, 独立日, 返校季, 劳动节, 万圣节, 感恩节, 黑色星期五, 网络星期一, 光明节, 圣诞节, 家庭日, 耶稣受难日, 维多利亚日, 加拿大日, 八月公民假日, 纪念日, 节礼日, 澳大利亚日, 澳新军团日, 女王生日, 财政年度结束, 怀唐伊日, 其他.
畅销商品 （布尔值） 必填 - 否。	畅销商品。默认值为 false.
第三方展示像素 （字符串） 必填 - 否。	与此素材一起使用的第三方展示像素 HTML。
限制合作伙伴访问 （CSV 字符串） 必填 - 否。	应有权访问此素材的逗号分隔的合作伙伴 ID 列表。
限制分组访问 （CSV 字符串） 必填 - 否。	应有权访问此素材的逗号分隔的合作伙伴组 ID 列表。
元数据 （CSV 字符串） 必填 - 否。	将附加到跟踪 URL 的逗号分隔的查询字符串参数。

优惠头列

列名	说明
优惠名称 （字符串） 必填 - 创建新优惠时。	要创建并链接到素材的优惠名称。如果 优惠 ID 未提供，则必填。
优惠类型 （字符串） 必填 - 创建新优惠时。	要创建的优惠类型。如果 优惠 ID 未提供且提供了优惠名称，则必填。 允许的值： 通用促销,免运费, 购买赠礼, 返利, 买一赠一, 产品发布.
优惠范围 （字符串） 必填 - 创建新优惠时。	必填如果 优惠 ID 未提供， 优惠名称 是，且 优惠类型 != 买一赠一。 允许的值： 全店, 分类, 产品, 多个产品.
优惠产品 （CSV 字符串） 必填 - 创建新优惠时。	优惠产品。若 优惠 ID 未提供， 优惠名称 是，且 优惠范围 = 产品. 允许的值： 选项 1：产品名称列表，例如： "Product1, Product2". 选项 2：产品键值对列表，例如： "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" 其中多个产品以逗号分隔，各产品字段以分号分隔。 有效字段： name - 产品名称， image - 在批量上传步骤二中您打算上传的产品图片文件名， limit - 允许数量， regularPrice - 折扣前价格， dealPrice - 折扣后价格。
优惠类别 （CSV 字符串） 必填 - 创建新优惠时。	优惠类别。若 优惠 ID 未提供， 优惠名称 是，且 优惠范围 = 分类.
优惠落地页（字符串） 必填 - 否	此优惠的落地页 URL。创建新优惠时若留空，将使用项目的默认落地页。
优惠元数据（CSV 字符串） 必填 - 否	用于优惠跟踪链接的逗号分隔查询字符串参数。若留空，则不会添加额外参数。
优惠允许深度链接（布尔值） 必填 - 否	确定是否允许对优惠落地页进行深度链接。若留空，默认值为 FALSE。
优惠折扣类型 （CSV 字符串） 必填 - 创建新优惠时。	必填如果 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 通用促销。 允许的值： 固定金额, 百分比, 百分比范围, 百分比上限.
优惠折扣金额 （十进制 10.2） 必填 - 创建新优惠时。	销售折扣金额。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 通用促销，且 优惠折扣类型 = 固定金额.
优惠折扣百分比 （十进制 10.2） 必填 - 创建新优惠时。	销售折扣百分比。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 通用促销，且 优惠折扣类型 = 百分比.
优惠折扣开始百分比 （十进制 10.2） 必填 - 创建新优惠时。	优惠折扣范围开始百分比。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 通用促销，且 优惠折扣类型 = 百分比范围.
优惠折扣结束百分比 （十进制 10.2） 必填 - 创建新优惠时。	优惠折扣范围开始百分比。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 通用促销，且 优惠折扣类型 = 百分比范围.
优惠折扣最大百分比 （十进制 10.2） 必填 - 创建新优惠时。	优惠最大折扣百分比。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 通用促销，且 优惠折扣类型 = 百分比上限.
优惠赠品 （十进制 10.2） 必填 - 创建新优惠时。	赠品详情。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 购买赠礼.
优惠返利 （十进制 10.2） 必填 - 创建新优惠时。	返利金额。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 返利.
优惠最低购买金额 （十进制 10.2） 必填 - 创建新优惠时。	优惠最低购买金额。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
优惠最高节省金额 （十进制 10.2） 必填 - 创建新优惠时。	优惠最高节省金额。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
买一赠一购买限制 （整数） 必填 - 创建新优惠时。	该价格允许的最大商品数量。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
买一赠一购买数量 （整数） 必填 - 创建新优惠时。	买一赠一购买数量。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
买一赠一购买类型 （字符串） 必填 - 创建新优惠时。	买一赠一购买商品类型。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一. 允许的值： 产品, 分类.
买一赠一购买名称 （字符串） 必填 - 创建新优惠时。	购买商品或类别的名称。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
买一赠一获赠数量 （整数） 必填 - 创建新优惠时。	买一赠一获赠数量。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
买一赠一获赠类型 （字符串） 必填 - 创建新优惠时。	买一赠一获赠商品类型。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一. 允许的值： 产品, 分类.
买一赠一获赠名称 （字符串） 必填 - 创建新优惠时。	获赠商品或类别的名称。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一.
买一赠一获赠折扣类型 （字符串） 必填 - 创建新优惠时。	买一赠一优惠折扣类型。若 优惠 ID 未提供， 优惠名称 是，且 优惠类型 = 买一赠一. 允许的值： 免费, 金额, 百分比.
买一赠一获赠折扣金额 （十进制 10.2） 必填 - 创建新优惠时。	买一赠一优惠折扣金额。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 买一赠一，且 买一赠一获赠折扣类型 = 金额.
买一赠一获赠折扣百分比 （十进制 10.2） 必填 - 创建新优惠时。	买一赠一优惠折扣百分比。若 优惠 ID 未提供， 优惠名称 是， 优惠类型 = 买一赠一，且 买一赠一获赠折扣类型 = 百分比.
优惠 ID （字符串） 必填 - 否。	素材将链接到的优惠的唯一 impact.com 标识符。
优惠默认折扣码 （字符串） 必填 - 否。	默认的优惠折扣码。
同步广告促销码与优惠 （布尔值） 必填 - 否。	保持关联的广告和促销码与此优惠同步。同步适用于限时日期、限制合作伙伴访问和状态。

3

步骤 3：上传素材创意文件

接下来，您需要准备好素材创意文件以便上传。

1. 在 指定图像 页面，选择 选择文件 以批量上传素材创意文件。您上传的文件名必须与元数据文件中 creative 字段的名称完全匹配（例如，如果 creative 字段包含 Example.jpg，则您上传的素材创意文件也应命名为 Example.jpg).

   • 按住 Command ⌘ 在 macOS 上或 CTRL 在 PC 上以选择多个要一次上传的素材创意文件。

2. 选择 接受并创建广告。一旦所有素材都上传完成，它们将出现在 广告 页面。