# Cargar activos en lote

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 API](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 assets metadata file
* The assets' creative files, which are typically images

{% stepper %}
{% step %}

#### Step 1: Prepare the Ads 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 [download it here](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.csv) and import it directly.

```programlisting
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
```

{% hint style="warning" %}
**Important:** 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 %}
{% endstep %}

{% step %}

#### Step 2: Example Metadata File

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.

```
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!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
```

* 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):

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

{% endstep %}

{% step %}

#### Step 3: 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.

     <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Important:</strong> impact.com will alert you if there are any errors in the file.</p></div>

<details>

<summary>Ad header columns</summary>

| Column Name                                                                                                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>Operation</em> (String)</p><p>Required - Always.</p>                                                 | <p>Operation to execute over the provided asset details.</p><p>Allowed values:</p><p><code>CREATE</code>, <code>UPDATE</code>, <code>DELETE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>ProgramId</em> (Integer)</p><p>Required - Always.</p>                                                | 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>AdID</em> (String)</p><p>Required - When executing operation over an existing asset.</p>             | Unique impact.com identifier for the asset. Leave empty when creating a new asset. Required if *Operation* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>State</em> (String)</p><p>Required - No.</p>                                                         | <p>The state of the asset.</p><p>Allowed values:</p><p><code>ACTIVE</code>, <code>PENDING</code>, <code>EXPIRED</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>Name</em> (String)</p><p>Required - When creating an asset.</p>                                      | *Asset name*. Required if *Operation* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>AdType</em> (String)</p><p>Required - When creating an asset.</p>                                    | <p>When updating an existing ad, the ad type may not change.</p><p>Required if <em>Operation</em> = <code>CREATE</code>.</p><p>Allowed values:</p><p><code>IMAGE</code>, <code>TEXT\_LINK</code>, <code>COUPON</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>HostedBy</em> (String)</p><p>Required - When creating an asset.</p>                                  | <p>Where the asset creative is hosted. Required if</p><p><em>Operation</em> = <code>CREATE</code> and <em>AdType</em> = <code>IMAGE</code>.</p><p>Allowed values:</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Creative</em> (String)</p><p>Required - When creating an image asset.</p>                            | <p>Name of creative file to be uploaded. Required if</p><p><em>Operation</em> = <code>CREATE</code> and <em>AdType</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>IabAdUnit</em> (String)</p><p>Required - When creating an image asset.</p>                           | <p>IAB standard asset size. Required if <em>Operation</em> =</p><p><code>CREATE</code> and <em>AdType</em> = <code>IMAGE</code> and <em>HostedBy</em> != <code>IR</code>.</p><p>Allowed values: <code>UNKNOWN</code>, <code>MEDIUM\_RECTANGLE</code>, <code>SQUARE\_POP\_UP</code>, <code>VERTICAL\_RECTANGLE</code>, <code>LARGE\_RECTANGLE</code>, <code>RECTANGLE</code>, <code>RECTANGLE\_3\_1\_</code>, <code>POP\_UNDER, FULL\_BANNER</code>, <code>HALF\_BANNER, MICRO\_BANNER</code>, <code>BUTTON\_1</code>, <code>BUTTON\_2</code>, <code>VERTICAL\_BANNER</code>, <code>SQUARE\_BUTTON</code>, <code>LEADERBOARD</code>, <code>WIDE\_SKYSCRAPER</code>, <code>SKYSCRAPER</code>, <code>HALF\_PAGE\_AD</code>, <code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                           |
| <p><em>ThirdPartyServableAdCreativeHeight</em> (Integer)</p><p>Required - When creating an image asset.</p> | <p>Third party servable image height, pixels.</p><p>Required if <em>Operation</em> = <code>CREATE</code> and <em>IabAdUnit</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>ThirdPartyServableAdCreativeWidth</em> (Integer)</p><p>Required - When creating an image asset.</p>  | <p>Third party servable image width, in pixels.</p><p>Required if <em>Operation</em> = <code>CREATE</code> and <em>IabAdUnit</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Language</em> (String)</p><p>Required - When creating an asset.</p>                                  | <p>Allowed values:</p><p><code>AFRIKAANS</code>, <code>ARABIC</code>, <code>BULGARIAN</code>, <code>CHINESE</code>, <code>CHINESE\_TRADITIONAL</code>, <code>CZECH</code>, <code>DANISH</code>, <code>DUTCH</code>, <code>ENGLISH</code>, <code>ENGLISH\_GB</code>, <code>ENGLISH\_AU</code>, <code>ENGLISH\_CA</code>, <code>ENGLISH\_NZ</code>, <code>ENGLISH\_ZA</code>, <code>ESTONIAN</code>, <code>FILIPINO</code>, <code>FINISH</code>, <code>FRENCH</code>, <code>FRENCH\_CA</code>, <code>GERMAN</code>, <code>HEBREW</code>, <code>HINDI</code>, <code>INDONESIAN</code>, <code>ITALIAN</code>, <code>JAPANESE</code>, <code>KOREAN</code>, <code>LATVIAN</code>, <code>LITHUANIAN</code>, <code>MALAY</code>, <code>MALTESE</code>, <code>NORWEGIAN</code>, <code>PORTUGUESE</code>, <code>PORTUGUESE\_BR</code>, <code>POLISH</code>, <code>RUSSIAN</code>, <code>SLOVENIAN</code>, <code>SPANISH</code>, <code>SPANISH\_MX</code>, <code>SWEDISH</code>, <code>THAI</code>, <code>TURKISH</code>, <code>VIETNAMESE</code>.</p> |
| <p><em>LimitedTimeEndDate</em> (Date)</p><p>Required - If LimitedTimeStartDate is supplied</p>              | This is an ISO8601 Date. Example format: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>LinkText</em> (String)</p><p>Required - When creating a text link or coupon asset.</p>               | Actual text displayed for the link. Required if *Operation* = `CREATE` and *AdType* = `TEXT_LINK` or `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>Description</em></p><p>Required - No.</p>                                                            | Asset description.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>Labels</em> (CSV string)</p><p>Required - No.</p>                                                    | Asset labels.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>AllowDeepLinking</em> (Boolean)</p><p>Required - No.</p>                                             | <p>Determines whether linking to a page deeper within the advertiser site will be allowed.</p><p>Defaults to <code>true</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>AllowCustomPromoCode</em> (Boolean)</p><p>Required - No.</p>                                         | <p>Allow Partner to request their own unique promo code for this promotion.</p><p>Defaults to <code>false</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>CustomisationCharge</em> (Decimal 10.2)</p><p>Required - No.</p>                                     | Asset customisation charge amount.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>ImageAlternativeTag</em> (String)</p><p>Required - No.</p>                                           | Alternative tag to use in the image asset code.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>LandingPage</em> (String)</p><p>Required - No.</p>                                                   | <p>The landing page URL. It must contain the URL protocol.</p><p>Defaults to program default landing page when creating an asset and not provided.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>iOSMobileFallbackAppId</em> (String)</p><p>Required - No.</p>                                        | Specify if mobile traffic should fallback to your iOS app landing page if no app is detected. App id must match system app id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>AndroidMobileFallbackAppId</em> (String)</p><p>Required - No.</p>                                    | Specify if mobile traffic should fallback to your Android app landing page if no app is detected. App id must match system app ID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>LimitedTimeStartDate</em> (String)</p><p>Required - No.</p>                                          | This is an ISO8601 Date. Example format: `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>FallbackAd</em> (String)</p><p>Required - No.</p>                                                    | Specify a fallback asset ID, only applicable to `IMAGE` assets.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>GetHtmlCodeType</em> (String)</p><p>Required - No.</p>                                               | Allowed values: `IFRAME_ONLY`, `HTML_AND_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>Season</em> (String)</p><p>Required - No.</p>                                                        | <p>Allowed values:</p><p><code>WINTER</code>, <code>SPRING</code>, <code>SUMMER</code>, <code>FALL</code>, <code>NEW\_YEAR</code>, <code>PRESIDENTS\_DAY</code>, <code>VALENTINES\_DAY</code>, <code>ST\_PATRICKS\_DAY</code>, <code>EASTER</code>, <code>MOTHERS\_DAY</code>, <code>MEMORIAL\_DAY</code>, <code>FATHERS\_DAY</code>, <code>INDEPENDANCE\_DAY</code>, <code>BACK\_TO\_SCHOOL</code>, <code>LABOR\_DAY</code>, <code>HALLOWEEN</code>, <code>THANKSGIVING</code>, <code>BLACK\_FRIDAY</code>, <code>CYBER\_MONDAY</code>, <code>HANUKKAH</code>, <code>CHRISTMAS</code>, <code>FAMILY\_DAY</code>, <code>GOOD\_FRIDAY</code>, <code>VICTORIA\_DAY</code>, <code>CANADA\_DAY</code>, <code>AUGUST\_CIVIC\_HOLIDAY</code>, <code>REMEMBRANCE\_DAY</code>, <code>BOXING\_DAY</code>, <code>AUSTRALIA\_DAY</code>, <code>ANZAC\_DAY</code>, <code>QUEENS\_BIRTHDAY</code>, <code>END\_OF\_FINANCIAL\_YEAR</code>, <code>WAITANGI\_DAY</code>, <code>OTHER</code>.</p>                                                            |
| <p><em>TopSeller</em> (Boolean)</p><p>Required - No.</p>                                                    | Top Seller. Defaults to `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>ThirdPartyImpressionPixel</em> (String)</p><p>Required - No.</p>                                     | Third party impression pixel HTML to use with this asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>RestrictedToPartners</em> (CSV string)</p><p>Required - No.</p>                                      | Comma separated Partner Ids that should have access to this asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>RestrictedToGroups</em> (CSV string)</p><p>Required - No.</p>                                        | Comma separated Partner Group Ids that should have access to this asset.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>Metadata</em> (CSV string)</p><p>Required - No.</p>                                                  | Comma separated query string parameters that will be appended to the tracking url.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |

</details>

<details>

<summary>Deal header columns</summary>

| Column Name                                                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>DealName</em> (String)</p><p>Required - When creating a new deal.</p>                         | Name of deal to create and link to asset. Required if *DealId* is not provided.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealType</em> (String)</p><p>Required - When creating a new deal.</p>                         | <p>Type of deal to create. Required if <em>DealId</em> is not provided and DealName is.</p><p>Allowed values:</p><p><code>GENERAL\_SALE</code>,<code>FREE\_SHIPPING</code>, <code>GIFT\_WITH\_PURCHASE</code>, <code>REBATE</code>, <code>BOGO</code>, <code>PRODUCT\_LAUNCH</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealScope</em> (String)</p><p>Required - When creating a new deal.</p>                        | <p>Required if <em>DealId</em> is not provided, <em>DealName</em> is, and <em>DealType</em> != BOGO.</p><p>Allowed values:</p><p><code>ENTIRE\_STORE</code>, <code>CATEGORY</code>, <code>PRODUCT</code>, <code>PRODUCTS</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealProducts</em> (CVS string)</p><p>Required - When creating a new deal.</p>                 | <p>Deal products. Required if <em>DealId</em> is not provided, <em>DealName</em> is, and <em>DealScope</em> = <code>PRODUCT</code>.</p><p>Allowed values:</p><p>Option 1: Product names list eg. <code>"Product1, Product2"</code>.</p><p>Option 2: Product value pair list eg. <code>"name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;"</code> where the multiple products are separated by comma and the various product fields are separated by semicolon.</p><p>Valid fields: <code>name</code> - product name, <code>image</code> - product image filename of the file which you intend to upload in step two of the bulk upload, <code>limit</code> - quantity allowed, <code>regularPrice</code> - before discount price, <code>dealPrice</code> - after discount price.</p> |
| <p><em>DealCategories</em> (CSV string)</p><p>Required - When creating a new deal.</p>               | Deal categories. Required is *DealId* is not provided, *DealName* is, and *DealScope* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>DealDiscountType</em> (CSV string)</p><p>Required - When creating a new deal.</p>             | <p>Required if <em>DealId</em> is not provided, <em>DealName</em> is, and <em>DealType</em> = GENERAL\_SALE.</p><p>Allowed values:</p><p><code>FIXED</code>, <code>PERCENT</code>, <code>PERCENT\_RANGE</code>, <code>PERCENT\_MAXIMUM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealDiscountAmount</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>         | Sale discount amount. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealDiscountPercent</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>        | Sale discount percent. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealDiscountStartPercent</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>   | Deal discount range start percent. Required is *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealDiscountEndPercent</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>     | Deal discount range start percent. Required is *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealDiscountMaximumPercent</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p> | Deal maximum percent discount. Required if *DealId* is not provided, *DealName* is, *DealType* = `GENERAL_SALE`, and *DealDiscountType* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealGift</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>                   | Gift details. Required if *DealId* is not provided, *DealName* is, and *DealType* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>DealRebate</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>                 | Rebate amount. Required if *DealId* is not provided, *DealName* is, and *DealType* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealMinimumPurchaseAmount</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>  | Deal minimum purchase amount. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>DealMaximumSavingsAmount</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>   | Deal maximum savings amount. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>DealBogoPurchaseLimit</em> (Integer)</p><p>Required - When creating a new deal.</p>           | Maximum quantity of allowed items at this price. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoBuyQty</em> (Integer)</p><p>Required - When creating a new deal.</p>                  | BOGO buy quantity. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealBogoBuyType</em> (String)</p><p>Required - When creating a new deal.</p>                  | <p>BOGO buy item type. Required if <em>DealId</em> is not provided, <em>DealName</em> is, and <em>DealType</em> = <code>BOGO</code>.</p><p>Allowed values:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealBogoBuyName</em> (String)</p><p>Required - When creating a new deal.</p>                  | Name of buy product or category. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoGetQty</em> (Integer)</p><p>Required - When creating a new deal.</p>                  | BOGO get quantity. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealBogoGetType</em> (String)</p><p>Required - When creating a new deal.</p>                  | <p>BOGO get item type. Required if <em>DealId</em> is not provided, <em>DealName</em> is, and <em>DealType</em> = <code>BOGO</code>.</p><p>Allowed values:</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealBogoGetName</em> (String)</p><p>Required - When creating a new deal.</p>                  | Name of get product or category. Required if *DealId* is not provided, *DealName* is, and *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoGetDiscountType</em> (String)</p><p>Required - When creating a new deal.</p>          | <p>BOGO deal discount type. Required if <em>DealId</em> is not provided, <em>DealName</em> is, and <em>DealType</em> = <code>BOGO</code>.</p><p>Allowed values:</p><p><code>FREE</code>, <code>AMOUNT</code>, <code>PERCENT</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealBogoGetDiscountAmount</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p>  | BOGO deal discount amount. Required if *DealId* is not provided, *DealName* is, *DealType* = `BOGO`, and *DealBogoGetDiscountType* = `AMOUNT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoGetDiscountPercent</em> (Decimal 10.2)</p><p>Required - When creating a new deal.</p> | BOGO deal discount percent. Required if *DealId* is not provided, *DealName* is, *DealType* = `BOGO`, and *DealBogoGetDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealId</em> (String)</p><p>Required - No.</p>                                                 | Unique impact.com identifier for deal the asset will be linked to.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealDefaultDiscountCode</em> (String)</p><p>Required - No.</p>                                | Default deal discount code.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>DealSyncAdsPromoCodes</em> (Boolean)</p><p>Required - No.</p>                                 | Keep associated ads and promo codes in sync with this deal. Syncronization applies to limited time dates, restricted partner access, and state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

</details>

4. Select **Next**.
   {% endstep %}

{% step %}

#### Step 4: 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 ad creative files to upload at once.
2. Select **Accept & Create Ads**. Once all of the ads 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 %}
