> 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).

### どの送信方法が適していますか？

| 次のことをしたい場合...               | この方法を使用してください...                                                                                                                                                                                                                                                                             |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| コーディングなしで、手動の一回限りのファイルを送信する | [メール](#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のままにすると修正として登録され、アクションは取消されません。

{% stepper %}
{% step %}

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

1. 用途に適したテンプレートファイルを特定します。
   * こちらをご覧ください [一括修正と取消のリファレンス](/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）またはテキストエディタ（例：Notepad）に貼り付けます。
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/メールのバッチ処理でよく使用されるフィールドの一覧については、 [一括修正と取消のリファレンス](/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. 次を選択します **name** 一括修正を送信したい Event Type の。
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. 次を選択します **返品処理を自動化する（高度）**&#x3092;選択し、次に **一括アップロード**.
6. ファイルを送信するには、以下のFTPまたはメール関連の方法のいずれかを選択してください：

<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. 任意のメールクライアントを使用し、一括修正ファイルを添付して専用アドレス宛にメールを送信してください。
   * メール内には、該当イベントタイプの専用メールアドレスのみを *To:* フィールドに含めてください。このファイルを他の宛先にも送る必要がある場合は、それらを *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：ファイル送信を確認する

.CSVまたは.XMLファイルをimpact.comに送信したら、処理されたかどうかステータスを確認できます。

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="/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="/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 の値が無効です` | これは次のものに対応するはずです： [イベントタイプID](/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.
