Ctrlk
Integration DocsContact SupportLog In

批量上传素材

使用批量上传工具，借助 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,这是你将要上传的新横幅广告示例。,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,这是更新文本链接广告的示例。,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,点击这里了解更多！,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

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

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

  • 如果你想清除某个值（例如移除 标签），你会在 $CLEAR$ 该列中使用

清除字段示例（CSV）：

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

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

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

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

  3. 选择  选择文件，上传你的批量文件，并选择 打开.

    • 选择  显示/隐藏文件格式详情 以查看有关必需列、其说明、可接受值以及它们是否在 广告表头列 和 交易表头列 参考下是否为必填。

注意： 如果文件中有任何错误，impact.com 会向你发出提醒。

  1. 选择 下一步.

广告表头列
列名
说明

操作 （字符串）

必填 - 始终必填。

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

允许的值：

CREATE, UPDATE, DELETE.

ProgramId （整数）

必填 - 始终必填。

素材所属的 impact.com Program ID 唯一标识。此值无法更新，且必须与执行批量上传的 program 一致。

AdID （字符串）

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

素材的 impact.com 唯一标识。创建新素材时留空。如果 操作 = UPDATE, DELETE.

状态 （字符串）

必填 - 否。

素材的状态。

允许的值：

ACTIVE, PENDING, EXPIRED.

名称 （字符串）

必填 - 创建素材时。

素材名称。如果 操作 = CREATE.

AdType （字符串）

必填 - 创建素材时。

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

如果 操作 = CREATE.

允许的值：

IMAGE, TEXT_LINK, COUPON.

HostedBy （字符串）

必填 - 创建素材时。

素材创意的托管位置。如果

操作 = CREATE 和 AdType = IMAGE.

允许的值：

IR, 网址, 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.

说明

必填 - 否。

素材描述。

标签 （CSV 字符串）

必填 - 否。

素材标签。

AllowDeepLinking （布尔值）

必填 - 否。

决定是否允许链接到广告主网站内更深层页面。

默认为 true.

AllowCustomPromoCode （布尔值）

必填 - 否。

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

默认为 false.

CustomisationCharge （十进制 10.2）

必填 - 否。

素材自定义收费金额。

ImageAlternativeTag （字符串）

必填 - 否。

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

LandingPage （字符串）

必填 - 否。

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

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

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（字符串） 必填 - 否

此交易的落地页 URL。若在创建新交易时留空，则将使用 program 的默认落地页。

DealMetadata（CSV 字符串） 必填 - 否

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

DealAllowDeepLinking（布尔值） 必填 - 否

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

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 （字符串）

必填 - 创建新交易时。

BOGO 交易折扣类型。如果 DealId 未提供， DealName 为，且 DealType = 买一送一.

允许的值：

FREE, AMOUNT, PERCENT.

DealBogoGetDiscountAmount （十进制 10.2）

必填 - 创建新交易时。

BOGO 交易折扣金额。如果 DealId 未提供， DealName 为， DealType = 买一送一，以及 DealBogoGetDiscountType = AMOUNT.

DealBogoGetDiscountPercent （十进制 10.2）

必填 - 创建新交易时。

BOGO 交易折扣百分比。如果 DealId 未提供， DealName 为， DealType = 买一送一，以及 DealBogoGetDiscountType = PERCENT.

DealId （字符串）

必填 - 否。

交易的 impact.com 唯一标识，素材将链接到该交易。

DealDefaultDiscountCode （字符串）

必填 - 否。

默认交易折扣码。

DealSyncAdsPromoCodes （布尔值）

必填 - 否。

使关联广告和促销代码与此交易保持同步。同步适用于限时日期、受限合作伙伴访问权限和状态。

3

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

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

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

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

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

上一页为素材添加标签下一页为素材创建深度链接

最后更新于

这有帮助吗？