> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md). # 批量上传素材 使用批量上传工具，可通过 CSV 文件一次上传多个素材，而不是逐个上传素材。信息字段与 [广告对象](https://integrations.impact.com/brand-api-reference/reference/ads) 类似，以帮助你协调哪些信息放在哪儿。 **进行批量广告上传时，你需要两个文件：** * 素材元数据文件（CSV） * 创意文件（例如图片或视频） {% stepper %} {% step %} **第 1 步：准备素材元数据文件** 你上传的 CSV 文件有必填字段和可接受值。你的素材将完全按照文件中的样子显示，因此如果使用了空格、标点符号或特殊字符，它们都会保留。开始使用时，可以复制下方显示的 CSV 模板并将其粘贴到电子表格应用程序中，或者![](/files/36f8f38d9db0794ea02128e6788ef17fca46bd12)[在此下载](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.csv) 并直接导入。 ```csv 操作,广告ID,状态,名称,描述,项目ID,广告类型,托管方,创意素材,IAB广告单元,第三方可投放广告创意高度,第三方可投放广告创意宽度,标签,允许深度链接,允许自定义促销码,定制费用,图片替代标签,落地页,iOS移动回退应用ID,Android移动回退应用ID,语言,限时开始日期,限时结束日期,回退广告,获取HTML代码类型,季节,热销商品,链接文本,第三方展示像素,仅限合作伙伴,仅限组,元数据,交易ID,交易名称,交易类型,交易范围,交易描述,交易商品,交易类别,交易默认折扣码,交易落地页,交易元数据,交易允许深度链接,交易折扣类型,交易折扣金额,交易折扣百分比,交易折扣起始百分比,交易折扣结束百分比,交易最大折扣百分比,交易赠品,交易返利,交易最低购买金额,交易最高购买金额,交易买赠购买限制,交易买赠购买数量,交易买赠购买类型,交易买赠购买名称,交易买赠获赠数量,交易买赠获赠类型,交易买赠获赠名称,交易买赠获赠折扣类型,交易买赠获赠折扣金额,交易买赠获赠折扣百分比,交易同步广告促销码 ``` {% hint style="info" %} **提示：** 我们建议使用 *文件格式* 中提供的详细信息来检查你的输入， [*批量上传*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) 然后再上传！ {% endhint %} 在使用元数据文件创建或更新素材之前，请注意以下关于部分更新的重要事项： * 支持部分更新。如果你将某个单元格留空，该字段将被忽略，其现有值将保持不变。 * 要清除或删除某个值，请在该单元格中明确输入 `$CLEAR$` 。这会移除该字段之前存储的任何值。 ```csv 操作,广告ID,名称,描述,项目ID,广告类型,托管方,创意素材,IAB广告单元,第三方可投放广告创意高度,第三方可投放广告创意宽度,标签,允许深度链接,允许自定义促销码,定制费用,图片替代标签,落地页,iOS移动回退应用ID,Android移动回退应用ID,语言,限时开始日期,限时结束日期,限时时区,回退广告,获取HTML代码类型,季节,热销商品,链接文本,第三方展示像素,仅限合作伙伴,仅限组,元数据,交易ID,交易名称,交易类型,交易范围,交易描述,交易商品,交易类别,交易默认折扣码,交易落地页,交易元数据,交易允许深度链接,交易折扣类型,交易折扣金额,交易折扣百分比,交易折扣起始百分比,交易折扣结束百分比,交易最大折扣百分比,交易赠品,交易返利,交易最低购买金额,交易最高购买金额,交易买赠购买限制,交易买赠购买数量,交易买赠购买类型,交易买赠购买名称,交易买赠获赠数量,交易买赠获赠类型,交易买赠获赠名称,交易买赠获赠折扣类型,交易买赠获赠折扣金额,交易买赠获赠折扣百分比,交易同步广告促销码 创建,,横幅示例,这是一个你会上传的新横幅广告示例。,12345,横幅,IR,Banner_Creative1,,,,"横幅, 新横幅",TRUE,,,,,,,英语,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,仅框架,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,, 更新,123456,文本链接示例,这是一个更新文本链接广告的示例。,34567,文本链接,,,,,,"有趣文本, 美好日子",FALSE,,,,,https://alwayslovewhatyoudo.com,,,英语（英国）,,,,,,,,点击此处查看更多！,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,, ``` * 该 `创建` 行显示一个新的横幅素材。 * 该 `更新` 行演示了部分更新——只有已填写的字段会被更新。 * 如果你想清除某个值（例如移除 `标签`），你可以使用 `$CLEAR$` 该列中的 清除字段示例（CSV）： ```csv 更新,123456,文本链接示例,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,, ``` {% endstep %} {% step %} **第 2 步：上传素材元数据文件** 1. 从左侧导航栏中，选择 ![\[Engage\] v2](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-aa671735ec2b65af79961eaf59ab60af.svg) **\[互动]** → **内容** → [**广告**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.** 2. 在右上角，选择 **批量上传**. 3. 选择  **选择文件**，上传你的批量文件，并选择 **打开**. * 选择  **显示/隐藏文件格式详情** 以查看有关必填列、其说明、可接受值以及它们是否在 *广告标题列* 和 *交易标题列* 中显示的下方参考信息。 {% hint style="success" icon="memo" %} **注意：** 如果文件中有任何错误，impact.com 会提醒你。 {% endhint %} 4. 选择 **下一步**.
广告标题列 | 列名称 | 说明 | | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

操作 （字符串）

必填 - 始终如此。

|

对所提供素材详情执行的操作。

允许的值：

创建, 更新, 删除.

| |

项目ID （整数）

必填 - 始终如此。

| 该素材所属的唯一 impact.com 项目ID。此值不能更新，且必须与执行批量上传的项目匹配。 | |

广告ID （字符串）

必填 - 在对现有素材执行操作时。

| 该素材在 impact.com 中的唯一标识符。创建新素材时留空。若 *操作* = `更新`, `删除`. | |

状态 （字符串）

必填 - 否。

|

素材状态。

允许的值：

活跃, PENDING, 已过期.

| |

名称 （字符串）

必填 - 创建素材时。

| *素材名称*。若 *操作* = `创建`. | |

AdType （字符串）

必填 - 创建素材时。

|

更新现有广告时，广告类型不得更改。

若 操作 = 创建.

允许的值：

图片, 文本链接, 优惠券.

| |

托管方 （字符串）

必填 - 创建素材时。

|

素材创意托管的位置。若

操作 = 创建 和 AdType = 图片.

允许的值：

IR, URL, HTML.

| |

创意素材 （字符串）

必填 - 创建图片素材时。

|

待上传创意文件的名称。若

操作 = 创建 和 AdType = 图片.

| |

IAB广告单元 （字符串）

必填 - 创建图片素材时。

|

IAB 标准素材尺寸。若 操作 =

创建 和 AdType = 图片 和 托管方 != IR.

允许的值： 未知, 中型矩形, 方形弹出, 竖向矩形, 大型矩形, 矩形, 3:1 矩形, 弹出下层，完整横幅, 半幅横幅，微型横幅, 按钮 1, 按钮 2, 竖向横幅, 方形按钮, 排行榜横幅, 宽幅摩天楼广告, 摩天楼广告, 半页广告, 自定义.

| |

第三方可投放广告创意高度 （整数）

必填 - 创建图片素材时。

|

第三方可投放图片高度，单位为像素。

若 操作 = 创建 和 IAB广告单元 =

自定义.

| |

第三方可投放广告创意宽度 （整数）

必填 - 创建图片素材时。

|

第三方可投放图片宽度，单位为像素。

若 操作 = 创建 和 IAB广告单元 =

自定义.

| |

语言 （字符串）

必填 - 创建素材时。

|

允许的值：

南非荷兰语, 阿拉伯语, 保加利亚语, 中文, 繁体中文, 捷克语, 丹麦语, 荷兰语, 英语, 英语（英国）, 英语（澳大利亚）, 英语（加拿大）, 英语（新西兰）, 英语（南非）, 爱沙尼亚语, 菲律宾语, 芬兰语, 法语, 法语（加拿大）, 德语, 希伯来语, 印地语, 印度尼西亚语, 意大利语, 日语, 韩语, 拉脱维亚语, 立陶宛语, 马来语, 马耳他语, 挪威语, 葡萄牙语, 葡萄牙语（巴西）, 波兰语, 俄语, 斯洛文尼亚语, 西班牙语, 西班牙语（墨西哥）, 瑞典语, 泰语, 土耳其语, 越南语.

| |

限时结束日期 （日期）

必填 - 如果提供了 LimitedTimeStartDate。

| 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`. | |

链接文本 （字符串）

必填 - 创建文本链接或优惠券素材时。

| 链接实际显示的文本。若 *操作* = `创建` 和 *AdType* = `文本链接` 或 `优惠券`. | |

说明

必填 - 否。

| 素材描述。 | |

标签 （CSV 字符串）

必填 - 否。

| 素材标签。 | |

允许深度链接 （布尔值）

必填 - 否。

|

确定是否允许链接到广告主网站中更深层的页面。

默认为 true.

| |

允许自定义促销码 （布尔值）

必填 - 否。

|

允许合作伙伴为此促销请求他们自己的唯一促销码。

默认为 false.

| |

定制费用 （10.2 位小数）

必填 - 否。

| 素材定制费用金额。 | |

图片替代标签 （字符串）

必填 - 否。

| 在图片素材代码中使用的替代标签。 | |

落地页 （字符串）

必填 - 否。

|

落地页 URL。必须包含 URL 协议。

创建素材且未提供时，默认为项目的默认落地页。

| |

iOS移动回退应用ID （字符串）

必填 - 否。

| 指定在未检测到应用时，移动流量是否应回退到你的 iOS 应用落地页。App ID 必须与系统 app ID 匹配。 | |

Android移动回退应用ID （字符串）

必填 - 否。

| 指定在未检测到应用时，移动流量是否应回退到你的 Android 应用落地页。App ID 必须与系统 app ID 匹配。 | |

限时开始日期 （字符串）

必填 - 否。

| 这是一个 ISO8601 日期。示例格式： `2013-06-30T00:00:00-07:00`. | |

回退广告 （字符串）

必填 - 否。

| 指定一个回退素材 ID，仅适用于 `图片` 素材。 | |

获取HTML代码类型 （字符串）

必填 - 否。

| 允许的值： `仅 IFRAME`, `HTML 和 IFRAME`. | |

季节 （字符串）

必填 - 否。

|

允许的值：

冬季, 春季, 夏季, 秋季, 新年, 总统日, 情人节, 圣帕特里克节, 复活节, 母亲节, 阵亡将士纪念日, 父亲节, 独立日, 开学季, 劳动节, 万圣节, 感恩节, 黑色星期五, 网络星期一, 光明节, 圣诞节, 家庭日, 耶稣受难日, 维多利亚日, 加拿大日, 八月公民假日, 纪念日, 节礼日, 澳大利亚日, 澳新军团日, 女王生日, 财年结束, 怀唐伊日, 其他.

| |

热销商品 （布尔值）

必填 - 否。

| 热销商品。默认为 `false`. | |

第三方展示像素 （字符串）

必填 - 否。

| 此素材使用的第三方展示像素 HTML。 | |

仅限合作伙伴 （CSV 字符串）

必填 - 否。

| 应有权访问此素材的、以逗号分隔的合作伙伴 ID。 | |

仅限组 （CSV 字符串）

必填 - 否。

| 应有权访问此素材的、以逗号分隔的合作伙伴组 ID。 | |

元数据 （CSV 字符串）

必填 - 否。

| 以逗号分隔的查询字符串参数，将追加到跟踪 URL。 |
交易标题列 | 列名称 | 说明 | | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |

交易名称 （字符串）

必填 - 创建新交易时。

| 要创建并链接到素材的交易名称。若 *交易ID* 未提供。 | |

交易类型 （字符串）

必填 - 创建新交易时。

|

要创建的交易类型。若 交易ID 未提供且 DealName 已提供。

允许的值：

普通促销,免运费, 购买赠礼, 返利, 买一赠一, 新品发布.

| |

交易范围 （字符串）

必填 - 创建新交易时。

|

若 交易ID 未提供， 交易名称 是，并且 交易类型 != BOGO。

允许的值：

全店, 类别, 商品, 商品.

| |

交易商品 （CSV 字符串）

必填 - 创建新交易时。

|

交易商品。若 交易ID 未提供， 交易名称 是，并且 交易范围 = 商品.

允许的值：

选项 1：商品名称列表，例如 "商品1, 商品2".

选项 2：商品键值对列表，例如 "name=商品1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=商品2;" 其中多个商品用逗号分隔，各商品字段用分号分隔。

有效字段： 名称 - 商品名称， 图片 - 你打算在批量上传第 2 步中上传的文件的商品图片文件名， 限制 - 允许数量， 原价 - 折扣前价格， 优惠价 - 折扣后价格。

| |

交易类别 （CSV 字符串）

必填 - 创建新交易时。

| 交易类别。若 *交易ID* 未提供， *交易名称* 是，并且 *交易范围* = `类别`. | |

交易落地页（字符串）
必填 - 否

| 此交易的落地页 URL。创建新交易时若留空，将使用项目的默认落地页。 | |

交易元数据（CSV 字符串）
必填 - 否

| 交易跟踪链接的逗号分隔查询字符串参数。若留空，则不会添加额外参数。 | |

交易允许深度链接（布尔值）
必填 - 否

| 确定是否允许该交易落地页进行深度链接。若留空，将默认为 FALSE。 | |

交易折扣类型 （CSV 字符串）

必填 - 创建新交易时。

|

若 交易ID 未提供， 交易名称 是，并且 交易类型 = GENERAL\_SALE。

允许的值：

固定, 百分比, 百分比区间, 最大百分比.

| |

交易折扣金额 （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 未提供， 交易名称 是，并且 交易类型 = 买一赠一.

允许的值：

商品, 类别.

| |

DealBogoGetName （字符串）

必填 - 创建新交易时。

| 获取商品或类别的名称。若……则必填 *交易ID* 未提供， *交易名称* 是，并且 *交易类型* = `买一赠一`. | |

DealBogoGetDiscountType （字符串）

必填 - 创建新交易时。

|

买一送一优惠活动折扣类型。若……则必填 交易ID 未提供， 交易名称 是，并且 交易类型 = 买一赠一.

允许的值：

免费, 金额, 百分比.

| |

DealBogoGetDiscountAmount （10.2 位小数）

必填 - 创建新交易时。

| 买一送一优惠活动折扣金额。若……则必填 *交易ID* 未提供， *交易名称* 是， *交易类型* = `买一赠一`，以及 *DealBogoGetDiscountType* = `金额`. | |

DealBogoGetDiscountPercent （10.2 位小数）

必填 - 创建新交易时。

| 买一送一优惠活动折扣百分比。若……则必填 *交易ID* 未提供， *交易名称* 是， *交易类型* = `买一赠一`，以及 *DealBogoGetDiscountType* = `百分比`. | |

交易ID （字符串）

必填 - 否。

| 资产将关联到的交易唯一 impact.com 标识符。 | |

DealDefaultDiscountCode （字符串）

必填 - 否。

| 默认优惠活动折扣代码。 | |

DealSyncAdsPromoCodes （布尔值）

必填 - 否。

| 将关联的广告和促销代码与此优惠活动保持同步。同步适用于限时日期、受限合作伙伴访问和状态。 |
{% endstep %} {% step %} **步骤 3：上传素材创意文件** 接下来，你需要先准备好素材创意文件，以便上传。 1. 在 *指定图片* 页面，选择 **选择文件** 以批量上传素材创意文件。你上传的文件名必须与元数据文件中创意字段的名称完全一致（例如，如果创意字段包含 `Example.jpg`，那么你上传的素材创意文件也应命名为 `Example.jpg`). * 按住 **Command ⌘** （在 macOS 上）或 **CTRL** （在 PC 上）可一次选择多个素材创意文件进行上传。 2. 选择 **接受并创建广告**。所有资产上传完成后，它们将显示在 [*广告*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) 页面。 {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.