> 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/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md).

# 一括変更と取り消しを送信

パートナーが販売などのコンバージョンを発生させた後、そのアクションのロック期間がまだ終了していない場合、修正または取り消しを送信して、誤ったアクションデータを修正できます。これにより、ロック期間の終了時にパートナーへ正しく報酬が支払われます。

通常、顧客が注文を返品した場合、チェックアウト時に誤りがあった場合、または商品の在庫がない場合に、アクションを修正または取り消します。

修正や取り消しは、API経由、またはこの記事で説明するFTP／メール経由で一括送信できます。FTP／メールで送信する場合に必要なテンプレートは、注文単位でトラッキングしているか、商品単位でトラッキングしているかによって異なり、それぞれ必要なフィールドが異なります。どのファイルを使えばよいかわからない場合は、担当のCSMに問い合わせるか、 [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml).

### 適切な送信方法を選ぶには

| 次のことを行いたい場合は…               | 次の方法を使用します…                                                                                                                                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| コーディングせずに、手動で1回限りのファイルを送信する | ​[メール](#step-2-submit-your-data-file) 一括処理、または [FTP経由でファイルをアップロード](#step-2-submit-your-data-file)​                                                                                                                                                                                         |
| コンバージョンレポートを自動化する           | ​[コンバージョン](https://integrations.impact.com/brand-api-reference/reference/conversions/conversions) / [アクション](https://integrations.impact.com/brand-api-reference/reference/actions) API、 [FTP経由でファイルを送信](#step-2-submit-your-data-file)、または [FTP経由でファイルを取得​](#step-2-submit-your-data-file) |

### 留意点：

* **対応しているファイル形式を使用する** — 送信するファイルは .CSV または .XML 形式である必要があります。
* **新しいデータ項目を追加しない** — トランザクションに新しいフィールドを追加することはできません。既存のフィールドのみ更新できます。
* **重複排除の処理を理解する** — 複数のアクションが同じ *Oid/OrderId*を持つ場合、impact.comは最新の *ActionId*に更新を適用します。これを上書きするには、対象の *ActionId*.
* **を指定します。&#x20;*****Amount*****&#x20;取り消し時に正しく使用する** — アクションを取り消すには、 *Amount = 0*に設定します。ただし、元の *Amount = 0*が0の場合、0のままにすると修正として登録され、アクションは取り消されません。

{% stepper %}
{% step %}

#### ステップ1：データファイルを準備する

1. 用途に合ったテンプレートファイルを確認します。
   * テンプレートファイルとデータ例については、 [一括修正・取り消しリファレンス](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md) をご覧ください。
2. テンプレートの内容を、表計算アプリケーション（Microsoft Excelなど）またはテキストエディター（メモ帳など）に貼り付けます。
3. ヘッダー行の下に、修正後のアクションデータを追加します。

   * テキストエディターを使用する場合は、各データ項目をカンマで区切ります。
   * 表計算ソフトを使用する場合は、各データ項目を別々のセルに入力します。

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>注：</strong> 値が誤って省略されないよう、スプレッドシートのセルの形式を「プレーンテキスト」または「テキスト」にして編集してください。</p></div>
4. 次のような、内容を識別しやすい名前を付けてファイルを保存します。 `Batch_Mods/Reversals_2025_02_12.csv`
   * FTP／メールでの一括処理でよく使われるフィールドについては、 [一括修正・取り消しリファレンス](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md)をご覧ください。また、 [アクションとコンバージョンのフィールドリファレンス](https://integrations.impact.com/brand-api-reference/reference/action-and-conversion-field-references) サポートされているフィールドの一覧については、こちらをご覧ください。
     {% endstep %}

{% step %}

#### ステップ 2：データファイルを送信する

impact.comでは、1回の操作につき最大1,000件まで変更できます。それ以降にさらに変更を行う必要がある場合は、 [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml).

1. 上部のナビゲーションバーで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[ユーザープロフィール] → 設定**.
2. 右側の列で、 *トラッキング*の下にある [**イベントタイプ**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. 対象の **名前** のイベントタイプを選択して、一括変更を送信します。
4. 「 *返品処理*」の横にある ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[編集]**.
5. ［ **返品処理を自動化（上級者向け）**］を選択し、次に［ **一括アップロード**.
6. ファイルを送信するには、次のFTPまたはメール関連の方法から1つ選択してください。

<details>

<summary>システムのFTPサーバーにファイルをアップロード</summary>

{% hint style="info" %}
FTP/SFTPファイルは、1ファイルあたりのエントリー数が10,000件未満になるように分割することをおすすめします。
{% endhint %}

1. 選択 **システムのFTPサーバーにファイルをアップロードします。**
2. 選択 **FTPのユーザー名とパスワードをメールで送信** して **保存**.
3. FTP認証情報をメールで受け取ったら、次の情報を使ってFTPクライアントからimpact.comに接続します。

   |           | FTP                                   | SFTP                                   |
   | --------- | ------------------------------------- | -------------------------------------- |
   | **サーバー**  | batch.impact.com                      | sftp\://batch.impact.com               |
   | **ポート**   | 21                                    | 22                                     |
   | **ユーザー名** | （impact.comのFTPユーザー名。大文字と小文字が区別されます。） | （impact.comのSFTPユーザー名。大文字と小文字が区別されます。） |
   | **パスワード** | （impact.comのFTPパスワード。大文字と小文字が区別されます。） | （impact.comのSFTPパスワード。大文字と小文字が区別されます。） |
4. 接続したら、ファイルをサーバーのメインディレクトリにアップロードします。
   * FTP認証情報のメールが届いていない場合は、impact.comアカウントを作成した担当者にお問い合わせください。または、 [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>独自のFTPサーバーからファイルを取得</summary>

{% hint style="info" %}
FTP/SFTPファイルは、1ファイルあたりのエントリー数が10,000件未満になるように分割することをおすすめします。
{% endhint %}

1. 選択 **独自のFTPサーバーからファイルを取得**.
2. 次を入力します。 **サーバーURL**, **ポート**と **ディレクトリ** FTPサーバー上の一括変更ファイルへのパスを入力します。次に、 **ユーザー名** と **パスワード** を入力します。impact.comはこれらを使用してFTPサーバーに接続します。
3. 選択 **保存** して続行します。
4. ファイルを次の場所にアップロードします。 *ディレクトリ* 上記で指定した
   * impact.com は24時間ごとにFTPサーバーへの接続とファイルのダウンロードを試みます。そのため、アップロード後、ファイルの処理に最大24時間かかる場合があります。

</details>

<details>

<summary>ファイルをシステムのSMTPサーバーにメールで送信</summary>

1. 選択 **ファイルをシステムのSMTPサーバーにメールで送信します。**
2. 選択した方法のすぐ下に、固有のメールアドレスが表示されます。このメールアドレスをコピーしてください。
3. 任意のメールクライアントを使用して、バッチ変更ファイルを添付し、その固有のアドレス宛てにメールを送信してください。
   * 「宛先」には、イベントタイプに対応する専用メールアドレスのみを入力します。 *宛先:* このファイルをほかの人にも送信する場合は、「CC」欄に追加します。 *CC:* 欄。
4. 件名と本文は空欄のままでかまいません。
   * 以下にメールアドレスの例を示します（実際のアドレスは多少異なります）。

<div data-with-frame="true"><figure><img src="https://1651675991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpVKEIcehMut8QKRmaUZu%2Fuploads%2F4KrGuAmvXvwqwYUxauT0%2FScreenshot%202026-10-07%20at%2023.37.54.png?alt=media&amp;token=5835d762-9ad4-41c3-9715-d79be84c5af9" alt="" width="563"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

#### ステップ 3：ファイルの送信状況を確認する

impact.com に .CSV または .XML ファイルを送信したら、処理状況を確認できます。

1. 上部のナビゲーションバーで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[ユーザープロフィール] → 設定**.
2. 左側の列で、 *技術* セクションまでスクロールし、［ [**ファイル送信**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. テーブルで、impact.com が受信した最近のファイル送信と現在の処理状況を確認できます。
   * 送信したファイルは10～15分以内に表示されますが、通常のレポート更新には2時間以上かかることがあります。
   * ファイル送信の確認時に発生する可能性のある問題と、そのトラブルシューティング方法を以下に示します。

<details>

<summary>送信のトラブルシューティングリファレンス</summary>

| 問題                                                 | 対処方法                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Records列に0と表示される                                   | ファイルの拡張子が .CSV または .XML であることを確認してください。                                                                                                                                                                                                                                                                                                                                                                                           |
| `NO_CHANGE`                                        | アクションに変更がありません。最終金額を *Amount* 列に入力してください（アクションを取り消す場合は、0を入力します）。                                                                                                                                                                                                                                                                                                                                                                  |
| `BAD_DISPOSITION`                                  | <p>指定した理由コードは無効です。標準の <a href="https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md">理由コード</a>.</p><p>または、 <a href="https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">カスタム処理コード</a>.</p> |
| `ALREADY_LOCKED`                                   | アクションのロック期間はすでに終了しています。このアクションは変更も取り消しもできません。                                                                                                                                                                                                                                                                                                                                                                                     |
| `ActionTrackerld:ActionTrackerld value is invalid` | これは、入力した [イベントタイプID](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) に対応している必要があります。                                                                                                                                                                                                                                                        |
| `ACTION_NOT_FOUND`                                 | 指定した `OID` が正しくありません。正しい値を入力してください。 `OID`.                                                                                                                                                                                                                                                                                                                                                                                        |
| `ALREADY_REVERSED`                                 | このアクションはすでに取り消されています。                                                                                                                                                                                                                                                                                                                                                                                                             |
| `ALREADY_APPROVED`                                 | このアクションはすでに承認されています。                                                                                                                                                                                                                                                                                                                                                                                                              |

</details>
{% 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/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.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.
