# Bulk Upload Assets Use the bulk uploads tool to upload multiple assets at once using a CSV file, rather than uploading assets individually. The information fields are similar to the [Ads object](https://integrations.impact.com/impact-brand/reference/ads-overview) to help you coordinate what information goes where. **You'll need two files to perform a bulk ad upload:** * An asset metadata file (CSV) * Creative files (e.g., images or videos) {% stepper %} {% step %} #### Step 1: Prepare the asset metadata file There are required fields and accepted values for the CSV file that you upload. Your assets will appear exactly like your file, so any space, punctuation marks, or special characters will be present if they are used. To get started, either copy the CSV template displayed below and paste it into a spreadsheet application or![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media)[download it here](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.csv) and import it directly. ```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 ``` {% hint style="info" %} **Tip:** We recommend using the *File format* details available on the [*Bulk Upload*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) screen to check your inputs before you upload! {% endhint %} Before you create or update assets using a metadata file, note the following important points about partial updates: * Partial updates are supported. If you leave a cell empty, that field will be ignored and its existing value will remain unchanged. * To clear or erase a value, explicitly enter `$CLEAR$` in that cell. This removes any previously stored value for that field. ```csv 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,,,,,,,,,,,,,,,,,,, ``` * The `CREATE` row shows a new banner asset. * The `UPDATE` row demonstrates a partial update — only populated fields will be updated. * If you wanted to clear a value (e.g., remove `Labels`), you’d use `$CLEAR$` in that column. Example clearing fields (CSV): ```csv UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,, ``` {% endstep %} {% step %} #### Step 2: Upload the asset metadata file 1. From the left navigation bar, select ![\[Engage\] v2](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-aa671735ec2b65af79961eaf59ab60af.svg) **\[Engage]** → **Content** → [**Ads**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.** 2. In the top-right corner, select **Bulk Upload**. 3. Select  **Choose File**, upload your bulk file, and select **Open**. * Select  **Show/hide file format details** to view information about required columns, their descriptions, accepted values, and whether they are mandatory in the *Ad header columns* and *Deal header columns* references below. {% hint style="success" icon="memo" %} **Note:** impact.com will alert you if there are any errors in the file. {% endhint %} 4. Select **Next**.
Ad header columns | Column Name | Description | | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Operation (String)

Required - Always.

|

Operation to execute over the provided asset details.

Allowed values:

CREATE, UPDATE, DELETE.

| |

ProgramId (Integer)

Required - Always.

| The unique impact.com Program ID to which the asset belongs. This value cannot be updated and must match the program in which the bulk upload is being executed. | |

AdID (String)

Required - When executing operation over an existing asset.

| Unique impact.com identifier for the asset. Leave empty when creating a new asset. Required if *Operation* = `UPDATE`, `DELETE`. | |

State (String)

Required - No.

|

The state of the asset.

Allowed values:

ACTIVE, PENDING, EXPIRED.

| |

Name (String)

Required - When creating an asset.

| *Asset name*. Required if *Operation* = `CREATE`. | |

AdType (String)

Required - When creating an asset.

|

When updating an existing ad, the ad type may not change.

Required if Operation = CREATE.

Allowed values:

IMAGE, TEXT\_LINK, COUPON.

| |

HostedBy (String)

Required - When creating an asset.

|

Where the asset creative is hosted. Required if

Operation = CREATE and AdType = IMAGE.

Allowed values:

IR, URL, HTML.

| |

Creative (String)

Required - When creating an image asset.

|

Name of creative file to be uploaded. Required if

Operation = CREATE and AdType = IMAGE.

| |

IabAdUnit (String)

Required - When creating an image asset.

|

IAB standard asset size. Required if Operation =

CREATE and AdType = IMAGE and HostedBy != IR.

Allowed values: 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 (Integer)

Required - When creating an image asset.

|

Third party servable image height, pixels.

Required if Operation = CREATE and IabAdUnit =

CUSTOM.

| |

ThirdPartyServableAdCreativeWidth (Integer)

Required - When creating an image asset.

|

Third party servable image width, in pixels.

Required if Operation = CREATE and IabAdUnit =

CUSTOM.

| |

Language (String)

Required - When creating an asset.

|

Allowed values:

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 (Date)

Required - If LimitedTimeStartDate is supplied

| This is an ISO8601 Date. Example format: `2013-06-30T00:00:00-07:00`. | |

LinkText (String)

Required - When creating a text link or coupon asset.

| Actual text displayed for the link. Required if *Operation* = `CREATE` and *AdType* = `TEXT_LINK` or `COUPON`. | |

Description

Required - No.

| Asset description. | |

Labels (CSV string)

Required - No.

| Asset labels. | |

AllowDeepLinking (Boolean)

Required - No.

|

Determines whether linking to a page deeper within the advertiser site will be allowed.

Defaults to true.

| |

AllowCustomPromoCode (Boolean)

Required - No.

|

Allow Partner to request their own unique promo code for this promotion.

Defaults to false.

| |

CustomisationCharge (Decimal 10.2)

Required - No.

| Asset customisation charge amount. | |

ImageAlternativeTag (String)

Required - No.

| Alternative tag to use in the image asset code. | |

LandingPage (String)

Required - No.

|

The landing page URL. It must contain the URL protocol.

Defaults to program default landing page when creating an asset and not provided.

| |

iOSMobileFallbackAppId (String)

Required - No.

| Specify if mobile traffic should fallback to your iOS app landing page if no app is detected. App id must match system app id. | |

AndroidMobileFallbackAppId (String)

Required - No.

| Specify if mobile traffic should fallback to your Android app landing page if no app is detected. App id must match system app ID. | |

LimitedTimeStartDate (String)

Required - No.

| This is an ISO8601 Date. Example format: `2013-06-30T00:00:00-07:00`. | |

FallbackAd (String)

Required - No.

| Specify a fallback asset ID, only applicable to `IMAGE` assets. | |

GetHtmlCodeType (String)

Required - No.

| Allowed values: `IFRAME_ONLY`, `HTML_AND_IFRAME`. | |

Season (String)

Required - No.

|

Allowed values:

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 (Boolean)

Required - No.

| Top Seller. Defaults to `false`. | |

ThirdPartyImpressionPixel (String)

Required - No.

| Third party impression pixel HTML to use with this asset. | |

RestrictedToPartners (CSV string)

Required - No.

| Comma separated Partner Ids that should have access to this asset. | |

RestrictedToGroups (CSV string)

Required - No.

| Comma separated Partner Group Ids that should have access to this asset. | |

Metadata (CSV string)

Required - No.

| Comma separated query string parameters that will be appended to the tracking url. |
Deal header columns | Column Name | Description | | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

DealName (String)

Required - When creating a new deal.

| Name of deal to create and link to asset. Required if *DealId* is not provided. | |

DealType (String)

Required - When creating a new deal.

|

Type of deal to create. Required if DealId is not provided and DealName is.

Allowed values:

GENERAL\_SALE,FREE\_SHIPPING, GIFT\_WITH\_PURCHASE, REBATE, BOGO, PRODUCT\_LAUNCH.

| |

DealScope (String)

Required - When creating a new deal.

|

Required if DealId is not provided, DealName is, and DealType != BOGO.

Allowed values:

ENTIRE\_STORE, CATEGORY, PRODUCT, PRODUCTS.

| |

DealProducts (CSV string)

Required - When creating a new deal.

|

Deal products. Required if DealId is not provided, DealName is, and DealScope = PRODUCT.

Allowed values:

Option 1: Product names list eg. "Product1, Product2".

Option 2: Product value pair list eg. "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" where the multiple products are separated by comma and the various product fields are separated by semicolon.

Valid fields: name - product name, image - product image filename of the file which you intend to upload in step two of the bulk upload, limit - quantity allowed, regularPrice - before discount price, dealPrice - after discount price.

| |

DealCategories (CSV string)

Required - When creating a new deal.

| Deal categories. Required if *DealId* is not provided, *DealName* is, and *DealScope* = `CATEGORY`. | |

DealLandingPage (String)
Required - No

| The landing page URL for this deal. If left blank when creating a new deal, the program's default landing page will be used. | |

DealMetadata (CSV String)
Required - No

| Comma-separated query string parameters for the deal's tracking link. If left blank, no extra parameters will be added. | |

DealAllowDeepLinking (Boolean)
Required - No

| Determines if deeplinking is allowed for the deal landing page. If left blank, this will default to FALSE. | |

DealDiscountType (CSV string)

Required - When creating a new deal.

|

Required if DealId is not provided, DealName is, and DealType = GENERAL\_SALE.

Allowed values:

FIXED, PERCENT, PERCENT\_RANGE, PERCENT\_MAXIMUM.

| |

DealDiscountAmount (Decimal 10.2)

Required - When creating a new deal.

| Sale discount amount. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `FIXED`. | |

DealDiscountPercent (Decimal 10.2)

Required - When creating a new deal.

| Sale discount percent. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT`. | |

DealDiscountStartPercent (Decimal 10.2)

Required - When creating a new deal.

| Deal discount range start percent. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT_RANGE`. | |

DealDiscountEndPercent (Decimal 10.2)

Required - When creating a new deal.

| Deal discount range start percent. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT_RANGE`. | |

DealDiscountMaximumPercent (Decimal 10.2)

Required - When creating a new deal.

| Deal maximum percent discount. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT_MAXIMUM`. | |

DealGift (Decimal 10.2)

Required - When creating a new deal.

| Gift details. Required if *DealId* is not provided, *DealName* is, and *DealType* = `GIFT_WITH_PURCHASE`. | |

DealRebate (Decimal 10.2)

Required - When creating a new deal.

| Rebate amount. Required if *DealId* is not provided, *DealName* is, and *DealType* = `REBATE`. | |

DealMinimumPurchaseAmount (Decimal 10.2)

Required - When creating a new deal.

| Deal minimum purchase amount. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealMaximumSavingsAmount (Decimal 10.2)

Required - When creating a new deal.

| Deal maximum savings amount. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealBogoPurchaseLimit (Integer)

Required - When creating a new deal.

| Maximum quantity of allowed items at this price. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealBogoBuyQty (Integer)

Required - When creating a new deal.

| BOGO buy quantity. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealBogoBuyType (String)

Required - When creating a new deal.

|

BOGO buy item type. Required if DealId is not provided, DealName is, and DealType = BOGO.

Allowed values:

PRODUCT, CATEGORY.

| |

DealBogoBuyName (String)

Required - When creating a new deal.

| Name of buy product or category. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealBogoGetQty (Integer)

Required - When creating a new deal.

| BOGO get quantity. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealBogoGetType (String)

Required - When creating a new deal.

|

BOGO get item type. Required if DealId is not provided, DealName is, and DealType = BOGO.

Allowed values:

PRODUCT, CATEGORY.

| |

DealBogoGetName (String)

Required - When creating a new deal.

| Name of get product or category. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`. | |

DealBogoGetDiscountType (String)

Required - When creating a new deal.

|

BOGO deal discount type. Required if DealId is not provided, DealName is, and DealType = BOGO.

Allowed values:

FREE, AMOUNT, PERCENT.

| |

DealBogoGetDiscountAmount (Decimal 10.2)

Required - When creating a new deal.

| BOGO deal discount amount. Required if *DealId* is not provided, *DealName* is, *DealType* = `BOGO`, and *DealBogoGetDiscountType* = `AMOUNT`. | |

DealBogoGetDiscountPercent (Decimal 10.2)

Required - When creating a new deal.

| BOGO deal discount percent. Required if *DealId* is not provided, *DealName* is, *DealType* = `BOGO`, and *DealBogoGetDiscountType* = `PERCENT`. | |

DealId (String)

Required - No.

| Unique impact.com identifier for deal the asset will be linked to. | |

DealDefaultDiscountCode (String)

Required - No.

| Default deal discount code. | |

DealSyncAdsPromoCodes (Boolean)

Required - No.

| Keep associated ads and promo codes in sync with this deal. Syncronization applies to limited time dates, restricted partner access, and state. |
{% endstep %} {% step %} #### Step 3: Upload the asset creative files Next, you'll need your asset creative files ready so they can be uploaded. 1. On the *Specify images* page, select **Choose Files** to bulk upload the asset creative files. Your uploaded file names must match the names in the creative field in your metadata file exactly (e.g., if the creative field contains `Example.jpg`, the asset creative file you upload should also be named `Example.jpg`). * Hold down **Command ⌘** on macOS or **CTRL** on PC to select multiple asset creative files to upload at once. 2. Select **Accept & Create Ads**. Once all of the assets have been uploaded, they will appear in the [*Ads*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) page. {% endstep %} {% endstepper %} --- # Agent Instructions: 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: ``` GET https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.