> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md).

# アセットを一括アップロード

アセットを個別にアップロードする代わりに、一括アップロードツールを使ってCSVファイルから複数のアセットを一度にアップロードできます。情報フィールドは、情報の入力先を整理するのに役立つ [広告オブジェクト](https://integrations.impact.com/brand-api-reference/reference/ads) と似ています。

**広告を一括アップロードするには、次の2つのファイルが必要です。**

* アセットのメタデータファイル（CSV）
* クリエイティブファイル（画像や動画など）

{% stepper %}
{% step %}
**ステップ1：アセットのメタデータファイルを準備する**

アップロードするCSVファイルには、必須フィールドと使用可能な値があります。アセットはファイルの内容どおりに表示されるため、スペース、句読点、特殊文字を使用した場合は、そのまま反映されます。まず、以下に表示されているCSVテンプレートをコピーしてスプレッドシートアプリケーションに貼り付けるか、![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media)[こちらからダウンロード](https://res.cloudinary.com/product-enablement/raw/upload/v1765961581/CSVs/Assets/Bulk_upload_ads_template_-_Sheet1.csv) して直接インポートしてください。

```csv
操作,広告ID,状態,名前,説明,プログラムID,広告タイプ,ホスト先,クリエイティブ,IAB広告ユニット,第三者配信可能な広告クリエイティブの高さ,第三者配信可能な広告クリエイティブの幅,ラベル,ディープリンクを許可,カスタムプロモーションコードを許可,カスタマイズ料金,画像の代替テキスト,ランディングページ,iOSモバイルのフォールバックアプリID,AndroidモバイルのフォールバックアプリID,言語,期間限定開始日,期間限定終了日,フォールバック広告,HTMLコードの取得タイプ,シーズン,トップセラー,リンクテキスト,第三者インプレッションピクセル,パートナー限定,グループ限定,メタデータ,ディールID,ディール名,ディールタイプ,ディール範囲,ディールの説明,ディール対象商品,ディール対象カテゴリー,ディールのデフォルト割引コード,ディールのランディングページ,ディールのメタデータ,ディールでディープリンクを許可,ディールの割引タイプ,ディールの割引額,ディールの割引率,ディールの開始割引率,ディールの終了割引率,ディールの最大割引率,ディールのギフト,ディールのリベート,ディールの最低購入金額,ディールの最高購入金額,ディールのBOGO購入上限,ディールのBOGO購入数量,ディールのBOGO購入タイプ,ディールのBOGO購入名,ディールのBOGO獲得数量,ディールのBOGO獲得タイプ,ディールのBOGO獲得名,ディールのBOGO獲得割引タイプ,ディールのBOGO獲得割引額,ディールのBOGO獲得割引率,ディールのプロモーションコードと広告を同期

```

{% hint style="info" %}
**ヒント:** アップロード前に入力内容を確認するには、 *ファイル形式* の詳細を [*一括アップロード*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) 画面で確認することをおすすめします。
{% endhint %}

メタデータファイルを使用してアセットを作成または更新する前に、部分更新に関する次の重要な点にご注意ください。

* 部分更新がサポートされています。セルを空欄にすると、そのフィールドは無視され、既存の値は変更されません。
* 値をクリアまたは削除するには、明示的に入力してください `$CLEAR$` そのセルに入力します。これにより、そのフィールドに以前保存されていた値が削除されます。

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

```

* 「 `CREATE` 」の行は、新しいバナー素材を示しています。
* 「 `UPDATE` この行は部分更新を示しており、値が入力されているフィールドのみが更新されます。
* 値をクリアする場合（例： `Labels`を削除する場合）は、 `$CLEAR$` をその列に指定します。

フィールドをクリアする例（CSV）：

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

{% endstep %}

{% step %}
**手順 2：アセットのメタデータファイルをアップロードする**

1. 左側のナビゲーションバーで、 ![\[Engage\] v2](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-aa671735ec2b65af79961eaf59ab60af.svg) **\[エンゲージ]** → **コンテンツ** → [**広告**](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml)**.**
2. 右上隅で、 **一括アップロード**.
3. 選択  **ファイルを選択**、一括アップロード用ファイルをアップロードし、 **開く**.
   * 選択  **ファイル形式の詳細を表示／非表示** を選択すると、必須列やその説明、受け付け可能な値、および必須項目かどうかを *広告ヘッダー列* および *取引ヘッダー列* の以下の参照情報で確認できます。

{% hint style="success" icon="memo" %}
**注意：** ファイルにエラーがある場合、impact.com から通知されます。
{% endhint %}

4. 選択 **次へ**.

<details>

<summary>広告ヘッダーの列</summary>

| 列名                                                                                 | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>操作</em> (文字列)</p><p>必須 - 常に。</p>                                            | <p>指定されたアセットの詳細に対して実行する操作。</p><p>使用可能な値：</p><p><code>CREATE</code>, <code>UPDATE</code>, <code>DELETE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>ProgramId</em> (整数)</p><p>必須 - 常に。</p>                                      | アセットが属する impact.com プログラムの一意の ID。この値は更新できません。また、一括アップロードを実行するプログラムと一致している必要があります。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>AdID</em> (文字列)</p><p>必須 - 既存のアセットに対して操作を実行する場合。</p>                        | アセットの一意の impact.com 識別子。新しいアセットを作成する場合は空欄にします。次の場合に必須： *操作* = `UPDATE`, `DELETE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>状態</em> (文字列)</p><p>必須 - いいえ。</p>                                           | <p>アセットの状態。</p><p>使用可能な値：</p><p><code>ACTIVE</code>, <code>PENDING</code>, <code>EXPIRED</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>名前</em> (文字列)</p><p>必須 - アセットを作成する場合。</p>                                   | *アセット名*。次の場合に必須： *操作* = `CREATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>AdType</em> (文字列)</p><p>必須 - アセットを作成する場合。</p>                               | <p>既存の広告を更新する場合、広告タイプは変更できません。</p><p>次の場合に必須： <em>操作</em> = <code>CREATE</code>.</p><p>使用可能な値：</p><p><code>IMAGE</code>, <code>TEXT\_LINK</code>, <code>COUPON</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>HostedBy</em> (文字列)</p><p>必須 - 画像アセットを作成する場合。</p>                           | <p>アセットのクリエイティブがホストされている場所。次の場合に必須：</p><p><em>操作</em> = <code>CREATE</code> および <em>広告タイプ</em> = <code>IMAGE</code>.</p><p>使用可能な値：</p><p><code>IR</code>, <code>URL</code>, <code>HTML</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>クリエイティブ</em> (文字列)</p><p>必須 - 画像アセットを作成する場合。</p>                            | <p>アップロードするクリエイティブファイルの名前。</p><p><em>操作</em> = <code>CREATE</code> および <em>広告タイプ</em> = <code>IMAGE</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>IAB標準アセットサイズ。次の場合に必須</em> (文字列)</p><p>必須 - 画像アセットを作成する場合。</p>               | <p>IAB標準アセットサイズ。次の場合に必須 <em>操作</em> =</p><p><code>CREATE</code> および <em>広告タイプ</em> = <code>IMAGE</code> および <em>ホスト元</em> != <code>IR</code>.</p><p>指定可能な値: <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> (整数)</p><p>必須 - 画像アセットを作成する場合。</p>  | <p>第三者配信可能な広告クリエイティブの画像の高さ（ピクセル単位）。</p><p>次の場合に必須 <em>操作</em> = <code>CREATE</code> および <em>IAB標準アセットサイズ</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>ThirdPartyServableAdCreativeWidth</em> (整数)</p><p>必須 - 画像アセットを作成する場合。</p>   | <p>サードパーティが配信可能な画像の幅（ピクセル単位）。</p><p>次の場合に必須 <em>操作</em> = <code>CREATE</code> および <em>IAB標準アセットサイズ</em> =</p><p><code>CUSTOM</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>言語</em> （文字列）</p><p>必須 - アセットを作成する場合。</p>                                   | <p>使用可能な値：</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> （日付）</p><p>必須 - LimitedTimeStartDate が指定されている場合</p> | ISO 8601 形式の日付です。形式の例： `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>リンクテキスト</em> （文字列）</p><p>必須 — テキストリンクまたはクーポンアセットを作成する場合。</p>                | リンクに表示される実際のテキスト。次の場合に必須： *操作* = `CREATE` および *広告タイプ* = `TEXT_LINK` または `COUPON`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>説明</em></p><p>必須 - いいえ。</p>                                                 | アセットの説明。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>ラベル</em> （CSV文字列）</p><p>必須 - いいえ。</p>                                       | アセットのラベル。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>ディープリンクを許可</em> （ブール値）</p><p>必須 - いいえ。</p>                                  | <p>広告主サイト内のより深い階層のページへのリンクを許可するかどうかを指定します。</p><p>デフォルト値： <code>true</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>カスタムプロモーションコードを許可</em> （ブール値）</p><p>必須 - いいえ。</p>                           | <p>パートナーがこのプロモーション専用のプロモーションコードをリクエストできるようにします。</p><p>デフォルト値： <code>false</code>.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>カスタマイズ料金</em> （小数 10.2）</p><p>必須 - いいえ。</p>                                 | アセットのカスタマイズ料金。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>画像代替テキスト</em> （文字列）</p><p>必須 - いいえ。</p>                                     | 画像アセットのコードで使用する代替テキスト。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>ランディングページ</em> （文字列）</p><p>必須 - いいえ。</p>                                    | <p>ランディングページのURL。URLプロトコルを含める必要があります。</p><p>アセットの作成時に指定されていない場合は、プログラムのデフォルトのランディングページが設定されます。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>iOSモバイルフォールバックアプリID</em> （文字列）</p><p>必須 - いいえ。</p>                          | アプリが検出されない場合に、モバイルトラフィックをiOSアプリのランディングページにフォールバックさせるかどうかを指定します。アプリIDはシステムアプリIDと一致する必要があります。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>AndroidモバイルフォールバックアプリID</em> （文字列）</p><p>必須 - いいえ。</p>                      | アプリが検出されない場合に、モバイルトラフィックをAndroidアプリのランディングページにフォールバックさせるかどうかを指定します。アプリIDはシステムアプリIDと一致する必要があります。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>期間限定開始日</em> （文字列）</p><p>必須 - いいえ。</p>                                      | ISO 8601 形式の日付です。形式の例： `2013-06-30T00:00:00-07:00`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p><em>フォールバック広告</em> （文字列）</p><p>必須 - いいえ。</p>                                    | フォールバックアセットIDを指定します。次の場合にのみ適用されます： `IMAGE` アセット。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>HTMLコード取得タイプ</em> （文字列）</p><p>必須 - いいえ。</p>                                 | 許可される値： `IFRAME_ONLY`, `HTML_AND_IFRAME`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><em>シーズン</em> （文字列）</p><p>必須 - いいえ。</p>                                         | <p>使用可能な値：</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>トップセラー</em> （ブール値）</p><p>必須 - いいえ。</p>                                      | トップセラー。デフォルト値は `false`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>サードパーティのインプレッションピクセル</em> （文字列）</p><p>必須 - いいえ。</p>                         | このアセットで使用するサードパーティのインプレッションピクセルHTML。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>パートナー限定</em> （CSV文字列）</p><p>必須 - いいえ。</p>                                   | このアセットへのアクセスを許可するパートナーID（カンマ区切り）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>グループ限定</em> （CSV文字列）</p><p>必須 - いいえ。</p>                                    | このアセットへのアクセスを許可するパートナーグループIDをカンマ区切りで指定します。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <p><em>メタデータ</em> （CSV文字列）</p><p>必須 - いいえ。</p>                                     | トラッキングURLに追加するクエリ文字列パラメーターをカンマ区切りで指定します。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

</details>

<details>

<summary>取引のヘッダー列</summary>

| 列名                                                                                 | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><em>取引名</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                                 | 作成してアセットにリンクする取引の名前。 *取引ID* が指定されていない場合は必須です。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>取引タイプ</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                               | <p>作成する取引のタイプ。 <em>取引ID</em> が指定されておらず、取引名が指定されている場合は必須です。</p><p>使用可能な値：</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>取引対象範囲</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                              | <p>必須条件： <em>取引ID</em> が指定されておらず、 <em>取引名</em> が指定され、 <em>取引タイプ</em> がBOGO以外の場合。</p><p>使用可能な値：</p><p><code>ENTIRE\_STORE</code>, <code>CATEGORY</code>, <code>PRODUCT</code>, <code>PRODUCTS</code>.</p>                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>取引商品</em> （CSV文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                             | <p>取引商品。次の場合に必須です： <em>取引ID</em> が指定されておらず、 <em>取引名</em> が指定され、 <em>取引対象範囲</em> = <code>がPRODUCT</code>.</p><p>使用可能な値：</p><p>オプション1：商品名のリスト（例） <code>"Product1, Product2"</code>.</p><p>オプション2：商品値のペアのリスト（例） <code>"name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;"</code> 複数の商品はカンマで区切り、各商品のフィールドはセミコロンで区切ります。</p><p>有効なフィールド： <code>name</code> - 商品名、 <code>image</code> - 一括アップロードの手順2でアップロードするファイルの商品画像ファイル名、 <code>limit</code> - 許可される数量、 <code>regularPrice</code> - 割引前の価格、 <code>dealPrice</code> - 割引後の価格。</p> |
| <p><em>DealCategories</em> （CSV文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                   | セールカテゴリー。 *DealId* が指定されておらず、 *DealName* が指定され、 *DealScope* = `CATEGORY`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>DealLandingPage（文字列）</em><br>必須 - いいえ</p>                                   | このセールのランディングページ URL。新しいセールを作成する際に空欄の場合、プログラムのデフォルトのランディングページが使用されます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>DealMetadata（CSV文字列）</em><br>必須 - いいえ</p>                                   | セールのトラッキングリンクに付加する、カンマ区切りのクエリ文字列パラメーター。空欄の場合、追加のパラメーターは付加されません。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealAllowDeepLinking（ブール値）</em><br>必須 - いいえ</p>                             | セールのランディングページでディープリンクを許可するかどうかを指定します。空欄の場合、デフォルトで FALSE になります。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>DealDiscountType</em> （CSV文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                 | <p>次の場合に必須： <em>DealId</em> が指定されておらず、 <em>DealName</em> が指定され、 <em>DealType</em> = GENERAL\_SALE。</p><p>使用可能な値：</p><p><code>FIXED</code>, <code>PERCENT</code>, <code>PERCENT\_RANGE</code>, <code>PERCENT\_MAXIMUM</code>.</p>                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealDiscountAmount</em> （小数 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>              | セールの割引額。 *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `GENERAL_SALE`、および *DealDiscountType* = `FIXED`.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><em>DealDiscountPercent</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>        | セール割引率。次の場合に必須です： *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `GENERAL_SALE`で、 *DealDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <p><em>DealDiscountStartPercent</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>   | 割引範囲の開始率。次の場合に必須です： *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `GENERAL_SALE`で、 *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealDiscountEndPercent</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>     | 割引範囲の開始率。次の場合に必須です： *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `GENERAL_SALE`で、 *DealDiscountType* = `PERCENT_RANGE`.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealDiscountMaximumPercent</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p> | 割引率の上限。次の場合に必須です： *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `GENERAL_SALE`で、 *DealDiscountType* = `PERCENT_MAXIMUM`.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <p><em>DealGift</em> （String）</p><p>必須 - 新しい取引を作成する場合。</p>                         | ギフトの詳細。次の場合に必須です： *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `GIFT_WITH_PURCHASE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><em>DealRebate</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>                 | リベート額。次の場合に必須： *DealId* が指定されておらず、 *DealName* が指定されていて、 *DealType* = `REBATE`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>DealMinimumPurchaseAmount</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>  | 取引の最低購入金額。次の場合に必須： *DealId* が指定されておらず、 *DealName* が指定されていて、 *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealMaximumSavingsAmount</em> （Decimal 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>   | 取引の最大割引額。次の場合に必須： *DealId* が指定されておらず、 *DealName* が指定されていて、 *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealBogoPurchaseLimit</em> （Integer）</p><p>必須 - 新しい取引を作成する場合。</p>           | この価格で購入できる商品の最大数量。次の場合に必須： *DealId* が指定されておらず、 *DealName* が指定されていて、 *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><em>DealBogoBuyQty</em> （Integer）</p><p>必須 - 新しい取引を作成する場合。</p>                  | BOGOの購入数量。次の場合に必須： *DealId* が指定されておらず、 *DealName* が指定されていて、 *DealType* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><em>DealBogoBuyType</em> （String）</p><p>必須 - 新しい取引を作成する場合。</p>                  | <p>BOGOの購入対象商品の種類。次の場合に必須： <em>DealId</em> が指定されていない場合、 <em>取引名</em> であり、かつ <em>取引タイプ</em> = <code>BOGO</code>.</p><p>使用可能な値：</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                        |
| <p><em>購入する商品の名前またはカテゴリ名</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                   | 購入する商品またはカテゴリの名前。次の場合に必須です: *取引ID* が指定されていない場合、 *取引名* であり、かつ *取引タイプ* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>BOGOの受け取り数量</em> （整数）</p><p>必須 - 新しい取引を作成する場合。</p>                          | BOGOの受け取り数量。次の場合に必須です: *取引ID* が指定されていない場合、 *取引名* であり、かつ *取引タイプ* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><em>BOGOの受け取りアイテムタイプ</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                    | <p>BOGOの受け取りアイテムのタイプ。次の場合に必須です: <em>取引ID</em> が指定されていない場合、 <em>取引名</em> であり、かつ <em>取引タイプ</em> = <code>BOGO</code>.</p><p>使用可能な値：</p><p><code>PRODUCT</code>, <code>CATEGORY</code>.</p>                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>受け取る商品の名前またはカテゴリ名</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                   | 受け取る商品またはカテゴリの名前。次の場合に必須です: *取引ID* が指定されていない場合、 *取引名* であり、かつ *取引タイプ* = `BOGO`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>BOGO取引の割引タイプ</em> （文字列）</p><p>必須 - 新しい取引を作成する場合。</p>                        | <p>BOGO取引の割引タイプ。次の場合に必須です: <em>取引ID</em> が指定されていない場合、 <em>取引名</em> であり、かつ <em>取引タイプ</em> = <code>BOGO</code>.</p><p>使用可能な値：</p><p><code>FREE</code>, <code>AMOUNT</code>, <code>PERCENT</code>.</p>                                                                                                                                                                                                                                                                                                                                                         |
| <p><em>DealBogoGetDiscountAmount</em> （小数 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>       | BOGO取引の割引額。次の場合に必須です *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `BOGO`かつ *DealBogoGetDiscountType* = `AMOUNT`.                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p><em>DealBogoGetDiscountPercent</em> （小数 10.2）</p><p>必須 - 新しい取引を作成する場合。</p>      | BOGO取引の割引率。次の場合に必須です *DealId* が指定されておらず、 *DealName* が指定され、 *DealType* = `BOGO`かつ *DealBogoGetDiscountType* = `PERCENT`.                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><em>DealId</em> （文字列）</p><p>必須 - いいえ。</p>                                       | アセットが関連付けられる取引のimpact.com固有識別子。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><em>DealDefaultDiscountCode</em> （文字列）</p><p>必須 - いいえ。</p>                      | 取引のデフォルト割引コード。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <p><em>DealSyncAdsPromoCodes</em> （ブール値）</p><p>必須 - いいえ。</p>                       | この取引に関連付けられた広告とプロモーションコードを同期します。同期は、期間限定の日付、パートナーのアクセス制限、およびステータスに適用されます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

</details>
{% endstep %}

{% step %}
**ステップ3：アセットのクリエイティブファイルをアップロードする**

次に、アップロードできるよう、アセットのクリエイティブファイルを準備してください。

1. ［ *画像を指定* ］ページで、 **［ファイルを選択］** を選択して、アセットのクリエイティブファイルを一括アップロードします。アップロードするファイル名は、メタデータファイルのクリエイティブフィールドに記載された名前と完全に一致している必要があります（例：クリエイティブフィールドに `Example.jpg`と記載されている場合、アップロードするアセットのクリエイティブファイル名も `Example.jpg`).
   * を押したままにします **Command ⌘** macOSでは、または **Ctrlキー** を押しながらクリックすると、複数のアセットクリエイティブファイルを一度に選択してアップロードできます。
2. 選択 **承認して広告を作成**。すべてのアセットのアップロードが完了すると、 [*広告*](https://app.impact.com/secure/advertiser/engage/ads/manage-all-ads-flow.ihtml) ページに表示されます。
   {% endstep %}
   {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/ads/manage-ads/bulk-upload-assets.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
