# 一括変更と取り消しのリファレンス

アクションデータを一括で修正または取り消す場合は、まず impact.com が提供するテンプレートファイルのいずれかをダウンロードし、サンプルデータを自分のデータに置き換えてください。独自のデータを追加する際は、ファイル送信が正しくフォーマットされるよう、関連する参照表のガイドラインに必ず従ってください。送信ファイルの準備ができたら、以下を使って再開できます [一括修正／取り消しの送信](/brand/ja/nitsuitebitaidesuka/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/submit-batch-modifications-and-reversals.md#submit-your-data-file-0-1) ファイル。

{% hint style="info" %}
この参考記事には、一括修正および取り消しで最もよく使用されるフィールドが含まれています。フィールドの説明を含む完全で詳細な参照を確認するには、以下を参照してください [アクション & コンバージョン フィールド参照](https://integrations.impact.com/impact-brand/reference/action-conversion-field-references).
{% endhint %}

**以下の参照を使用して、次のことを行ってください。**

* FTP/SMTP の一括修正または取り消しで使用するフィールドを確認する
* プレースホルダーのサンプルデータ付きテンプレートファイルをダウンロードする
* どの理由コードをいつ適用するかを理解する

#### 注文レベルの修正

これは、商品レベルではなく注文レベルでアクションデータを一括更新したい場合に使用します。例: 複数の注文の注文金額を変更する。

<details>

<summary>受け入れられるパラメータ</summary>

| フィールド             | 必須？      | 編集可能？ | 注記                                                     |
| ----------------- | -------- | ----- | ------------------------------------------------------ |
| `ActionID`        | 条件付き必須\* | 編集不可  | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。                         |
| `Oid / OrderId`   | 条件付き必須\* | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*.        |
| `ActionTrackerID` | 条件付き必須\* | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*.            |
| `Amount`          | 任意       | 編集可能  | 注文の新しい合計金額を設定します。                                      |
| `currencyCode`    | 任意       | 編集可能  | アクションの収益通貨を設定します。指定しない場合、デフォルトは impact.com アカウントの通貨です。 |
| `CustomerStatus`  | 任意       | 編集可能  | コンバージョン時点での顧客のステータスを設定します。例: NEW / EXISTING。           |
| `Reason`          | 必須       | 編集可能  | 修正のための有効な理由コードを指定してください。                               |

\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (\*OrderId/Oid \*+ *ActionTrackerId*)

</details>

<details>

<summary>テンプレートファイル</summary>

* [注文レベル修正テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_modifications_template.csv)
* [注文レベル承認テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_approvals_template.csv)

</details>

#### 注文レベルの取り消し

これは、商品レベルではなく注文レベルで、パートナー起点のアクションを一括で取り消したい場合に使用します。例: 複数の注文を取り消す。

<details>

<summary>受け入れられるパラメータ</summary>

| フィールド             | 必須？        | 編集可能？ | 注記                                              |
| ----------------- | ---------- | ----- | ----------------------------------------------- |
| `ActionID`        | 条件付き必須\*   | 編集不可  | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。                  |
| `Oid / OrderId`   | 条件付き必須\*   | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*. |
| `ActionTrackerID` | 条件付き必須\*   | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*.     |
| `Amount`          | 条件付き必須\*\* | 編集可能  | 次のように設定 **0** 注文を取り消します。ただし、元の金額 = 0 の場合は除く\*\* |
| `Reason`          | 必須         | 編集可能  | 取り消しのための有効な理由コードを指定してください。                      |

\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*元の *Amount = 0*の場合は、 *Amount* 変更しないままにして、修正として誤分類されるのを避けてください。

</details>

<details>

<summary>テンプレートファイル</summary>

* [注文レベルの取り消しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Order-level_reversals_template.csv)

</details>

#### 商品レベルの修正

これは、注文レベルではなく商品レベルでアクションデータを一括更新したい場合に使用します。例: 注文内の複数商品の Amount を変更する。

<details>

<summary>受け入れられるパラメータ</summary>

| フィールド             | 必須？      | 編集可能？ | 注記                                                            |
| ----------------- | -------- | ----- | ------------------------------------------------------------- |
| `ActionID`        | 条件付き必須\* | 編集不可  | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。                                |
| `Oid / OrderId`   | 条件付き必須\* | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*.               |
| `ActionTrackerID` | 条件付き必須\* | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*.                   |
| `SKU`\*\*         | 必須       | 編集不可  | 修正したい商品の SKU 値を指定してください。                                      |
| `Amount`\*\*      | 条件付き必須   | 編集可能  | 新しい商品金額、つまり price\*quantity を設定します。数量を変更する場合、このフィールドも変更が必要です。 |
| `Quantity`\*\*    | 任意       | 編集可能  | 注文内の商品の新しい数量を設定します。                                           |
| `Category`\*\*    | 任意       | 編集可能  | 商品のカテゴリを設定します。                                                |
| `Reason`\*\*      | 必須       | 編集可能  | 取り消しのための有効な理由コードを指定してください。                                    |

\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*これらのフィールドは、修正する各商品に含める必要があります。識別子フィールドは注文ごとに 1 回のみ含めます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [商品レベル修正テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_modifications_template.csv)
* [商品レベル承認テンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768295823/CSVs/Batch%20Action%20Processing/Item-level_approvals_template.csv)

</details>

#### 商品レベルの取り消し

これは、注文レベルではなく商品レベルでアクションデータを一括で取り消したい場合に使用します。例: 注文内の複数商品を取り消す。

<details>

<summary>受け入れられるパラメータ</summary>

| フィールド             | 必須？      | 編集可能？ | 注記                                                            |
| ----------------- | -------- | ----- | ------------------------------------------------------------- |
| `ActionID`        | 条件付き必須\* | 編集不可  | 重複排除ウィンドウが短い場合、この識別子の提供を推奨します。                                |
| `Oid / OrderId`   | 条件付き必須\* | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *ActionTrackerId*.               |
| `ActionTrackerID` | 条件付き必須\* | 編集不可  | この識別子の提供が必要になるのは、以下を使用する場合です *OrderId/Oid*.                   |
| `SKU`\*\*         | 必須       | 編集不可  | 修正したい商品の SKU 値を指定してください。                                      |
| `Amount`\*\*      | 条件付き必須   | 編集可能  | 新しい商品金額、つまり price\*quantity を設定します。数量を変更する場合、このフィールドも変更が必要です。 |
| `Quantity`\*\*    | 任意       | 編集可能  | 注文内の商品の新しい数量を設定します。                                           |
| `Reason`\*\*      | 必須       | 編集可能  | 修正のための有効な理由コードを指定してください。                                      |

\*少なくとも 1 つの識別子パスを指定する必要があります。つまり、以下のいずれかです *ActionId* **または** (*OrderId/Oid* + *ActionTrackerId*)

\*\*これらのフィールドは、修正する各商品に含める必要があります。識別子フィールドは注文ごとに 1 回のみ含めます。

</details>

<details>

<summary>テンプレートファイル</summary>

* [商品レベルの取り消しテンプレート](https://res.cloudinary.com/product-enablement/raw/upload/v1768298926/CSVs/Batch%20Action%20Processing/Item-level_reversals_template.csv)

この例で SKU O7427540 が 2 回表示されているのは、1 行が取り消し（Amount=0）、もう 1 行が修正（Amount=15）だからです。

</details>

{% hint style="info" %}
**注:** 重複する *OrderIds* があると予想され、以下の組み合わせを使用する場合 *OrderId + ActionTrackerId*、impact.com はデフォルトで更新を最新の *ActionId* に適用します。古い *ActionId* に更新を適用したい場合は、古い *ActionId*.
{% endhint %}

#### 理由コード

アクションデータを修正または取り消すたびに、理由を指定する必要があります。アクションが更新される理由を説明するために、以下の該当する理由コードを使用してください。

{% hint style="warning" %}
**警告:** 受け入れられない値を渡すと、そのエントリは処理されず、代わりにエラーが返されます。カスタムの理由コードが必要な場合は、CSM または [**サポートに連絡してください**](https://app.impact.com/support/portal.ihtml?createTicket=true&) **に連絡して、処分コードについて相談してください**.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.