批量上传素材

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

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

• 素材元数据文件

• 素材的创意文件，通常是图像

1

步骤 1：准备 广告元数据文件

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

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

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

2

步骤 2：示例元数据文件

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

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

• 要清除或抹去一个值，请在该单元格中明确输入 $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,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",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

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

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

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

示例清除字段（CSV）：

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

3

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

1. 在左侧导航栏中，选择 [Engage] → 内容 → 广告.

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

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

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

     重要： impact.com 会在文件中有任何错误时提醒您。

广告头列

列名	说明
操作 （字符串） 必填 - 始终。	要对所提供素材详细信息执行的操作。 允许的值： CREATE, UPDATE, DELETE.
ProgramId （整数） 必填 - 始终。	素材所属的唯一 impact.com 程序 ID。此值无法更新，且必须与执行批量上传的程序匹配。
AdID （字符串） 必填 - 在对现有素材执行操作时。	素材的唯一 impact.com 标识符。创建新素材时留空。如果 操作 = UPDATE, DELETE.
State （字符串） 必填 - 否。	素材的状态。 允许的值： ACTIVE, PENDING, EXPIRED.
名称 （字符串） 必填 - 创建素材时。	素材名称。如果 操作 = CREATE.
AdType （字符串） 必填 - 创建素材时。	在更新现有广告时，广告类型不得更改。 如果 操作 = CREATE. 允许的值： IMAGE, TEXT_LINK, COUPON.
HostedBy （字符串） 必填 - 创建素材时。	素材创意托管位置。如果 操作 = CREATE 和 AdType = IMAGE. 允许的值： IR, URL, HTML.
Creative （字符串） 必填 - 创建图像素材时。	要上传的创意文件名称。如果 操作 = CREATE 和 AdType = IMAGE.
IabAdUnit （字符串） 必填 - 创建图像素材时。	IAB 标准素材尺寸。如果 操作 = 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 （整数） 必填 - 创建图像素材时。	第三方可服务图像高度，像素。 如果 操作 = CREATE 和 IabAdUnit = CUSTOM.
ThirdPartyServableAdCreativeWidth （整数） 必填 - 创建图像素材时。	第三方可服务图像宽度，像素。 如果 操作 = 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 （字符串） 必填 - 创建文本链接或优惠券素材时。	链接显示的实际文本。如果 操作 = CREATE 和 AdType = TEXT_LINK 或 COUPON.
说明 必填 - 否。	素材描述。
Labels （CSV 字符串） 必填 - 否。	素材标签。
AllowDeepLinking （布尔） 必填 - 否。	确定是否允许链接到广告主站点内更深层的页面。 默认值为 true.
AllowCustomPromoCode （布尔） 必填 - 否。	允许合作伙伴为该促销请求其自己的唯一促销代码。 默认值为 false.
CustomisationCharge （十进制 10.2） 必填 - 否。	素材定制费用金额。
ImageAlternativeTag （字符串） 必填 - 否。	在图像素材代码中使用的替代标签。
LandingPage （字符串） 必填 - 否。	落地页 URL。它必须包含 URL 协议。 创建素材且未提供时，默认使用程序默认落地页。
iOSMobileFallbackAppId （字符串） 必填 - 否。	指定当未检测到应用时，移动流量是否应回退到您的 iOS 应用落地页。应用 ID 必须与系统应用 ID 匹配。
AndroidMobileFallbackAppId （字符串） 必填 - 否。	指定当未检测到应用时，移动流量是否应回退到您的 Android 应用落地页。应用 ID 必须与系统应用 ID 匹配。
LimitedTimeStartDate （字符串） 必填 - 否。	这是一个 ISO8601 日期。示例格式： 2013-06-30T00:00:00-07:00.
FallbackAd （字符串） 必填 - 否。	指定回退素材 ID，仅适用于 IMAGE 素材。
GetHtmlCodeType （字符串） 必填 - 否。	允许的值： IFRAME_ONLY, HTML_AND_IFRAME.
季节 （字符串） 必填 - 否。	允许的值： 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 列表。
Metadata （CSV 字符串） 必填 - 否。	将附加到跟踪 URL 的以逗号分隔的查询字符串参数。

优惠头列

列名	说明
DealName （字符串） 必填 - 创建新优惠时。	要创建并链接到素材的优惠名称。如果 DealId 未提供，则为必填。
DealType （字符串） 必填 - 创建新优惠时。	要创建的优惠类型。如果 DealId 未提供且提供了 DealName，则为必填。 允许的值： GENERAL_SALE,FREE_SHIPPING, GIFT_WITH_PURCHASE, REBATE, BOGO, 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;" 其中多个产品用逗号分隔，各产品字段用分号分隔。 有效字段： name - 产品名称， image - 您打算在批量上传第二步中上传的产品图片文件名， limit - 允许的数量， regularPrice - 折扣前价格， dealPrice - 折扣后价格。
DealCategories （CSV 字符串） 必填 - 创建新优惠时。	优惠类别。如果 DealId 未提供， DealName 是，且 DealScope = CATEGORY.
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 = BOGO.
DealMaximumSavingsAmount （十进制 10.2） 必填 - 创建新优惠时。	优惠最高节省金额。如果 DealId 未提供， DealName 是，且 DealType = BOGO.
DealBogoPurchaseLimit （整数） 必填 - 创建新优惠时。	以该价格允许的最大商品数量。如果 DealId 未提供， DealName 是，且 DealType = BOGO.
DealBogoBuyQty （整数） 必填 - 创建新优惠时。	BOGO 购买数量。如果 DealId 未提供， DealName 是，且 DealType = BOGO.
DealBogoBuyType （字符串） 必填 - 创建新优惠时。	BOGO 购买商品类型。如果 DealId 未提供， DealName 是，且 DealType = BOGO. 允许的值： PRODUCT, CATEGORY.
DealBogoBuyName （字符串） 必填 - 创建新优惠时。	购买商品或类别的名称。如果 DealId 未提供， DealName 是，且 DealType = BOGO.
DealBogoGetQty （整数） 必填 - 创建新优惠时。	BOGO 获取数量。如果 DealId 未提供， DealName 是，且 DealType = BOGO.
DealBogoGetType （字符串） 必填 - 创建新优惠时。	BOGO 获取商品类型。如果 DealId 未提供， DealName 是，且 DealType = BOGO. 允许的值： PRODUCT, CATEGORY.
DealBogoGetName （字符串） 必填 - 创建新优惠时。	获取商品或类别的名称。如果 DealId 未提供， DealName 是，且 DealType = BOGO.
DealBogoGetDiscountType （字符串） 必填 - 创建新优惠时。	BOGO 优惠折扣类型。如果 DealId 未提供， DealName 是，且 DealType = BOGO. 允许的值： FREE, AMOUNT, PERCENT.
DealBogoGetDiscountAmount （十进制 10.2） 必填 - 创建新优惠时。	BOGO 优惠折扣金额。如果 DealId 未提供， DealName 是， DealType = BOGO，且 DealBogoGetDiscountType = AMOUNT.
DealBogoGetDiscountPercent （十进制 10.2） 必填 - 创建新优惠时。	BOGO 优惠折扣百分比。如果 DealId 未提供， DealName 是， DealType = BOGO，且 DealBogoGetDiscountType = PERCENT.
DealId （字符串） 必填 - 否。	素材将关联的优惠的唯一 impact.com 标识符。
DealDefaultDiscountCode （字符串） 必填 - 否。	默认优惠折扣代码。
DealSyncAdsPromoCodes （布尔） 必填 - 否。	保持关联广告和促销代码与此优惠同步。同步适用于限时日期、限制的合作伙伴访问和状态。

1. 选择 下一步.

4

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

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

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

   • 在 macOS 上按住 Command ⌘ 或在 PC 上按住 CTRL 以一次选择多个广告创意文件进行上传。

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