批量上传素材

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

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

  • 素材元数据文件

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

1

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

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

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
circle-exclamation
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] v2 [Engage]内容广告arrow-up-right.

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

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

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

      circle-exclamation
chevron-right广告头列hashtag
列名
说明

操作 (字符串)

必填 - 始终。

要对所提供素材详细信息执行的操作。

允许的值:

CREATE, UPDATE, DELETE.

ProgramId (整数)

必填 - 始终。

素材所属的唯一 impact.com 程序 ID。此值无法更新,且必须与执行批量上传的程序匹配。

AdID (字符串)

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

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

State (字符串)

必填 - 否。

素材的状态。

允许的值:

ACTIVE, PENDING, EXPIRED.

名称 (字符串)

必填 - 创建素材时。

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

AdType (字符串)

必填 - 创建素材时。

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

如果 操作 = CREATE.

允许的值:

IMAGE, TEXT_LINK, COUPON.

HostedBy (字符串)

必填 - 创建素材时。

素材创意托管位置。如果

操作 = CREATEAdType = IMAGE.

允许的值:

IR, URL, HTML.

Creative (字符串)

必填 - 创建图像素材时。

要上传的创意文件名称。如果

操作 = CREATEAdType = IMAGE.

IabAdUnit (字符串)

必填 - 创建图像素材时。

IAB 标准素材尺寸。如果 操作 =

CREATEAdType = IMAGEHostedBy != 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 (整数)

必填 - 创建图像素材时。

第三方可服务图像高度,像素。

如果 操作 = CREATEIabAdUnit =

CUSTOM.

ThirdPartyServableAdCreativeWidth (整数)

必填 - 创建图像素材时。

第三方可服务图像宽度,像素。

如果 操作 = CREATEIabAdUnit =

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 (字符串)

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

链接显示的实际文本。如果 操作 = CREATEAdType = TEXT_LINKCOUPON.

说明

必填 - 否。

素材描述。

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 的以逗号分隔的查询字符串参数。

chevron-right优惠头列hashtag
列名
说明

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. 选择 接受并创建广告。一旦所有广告都上传完毕,它们将出现在 广告arrow-up-right 页面。

最后更新于

这有帮助吗?