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

# コンバージョンデータを一括送信

コンバージョンデータが自動的にトラッキングされない場合は、バッチ処理を使ってデータをimpact.comに直接送信できます。データをサーバー側で収集している場合も、Cookieを利用している場合も同様です。また、たとえば顧客がパートナーのプロモーションコードを使い忘れた場合など、 [コンバージョンデータを遡って送信](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md) する必要が生じることもあります。このデータを送信することで、適切なパートナーに成果を正しく帰属させ、レポートの精度を保てます。また、アクションが確定する前であれば、必要に応じて変更または取り消すこともできます。

* If you need help collecting conversion data with non-pixel tracking, reach out to your CSM or [contact support](https://app.impact.com/support/portal.ihtml?createTicket=true). To learn more about your tracking method and integration, we recommend consulting the original Technical Integration Plan provided to you by our Technical Services team.
* If you have *Connections* turned on for your account, setting up a conversion data pipeline will look different for you. Learn how to [create a Connection](https://help.impact.com/brand/what-would-you-like-to-learn-about/account-administration/account-settings/send-data-to-impactcom/data-connections-overview.md).
* The required parameters for web actions and mobile app actions are different. See [Mobile-Specific Parameters](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/mobile-specific-parameters-for-ftp-or-email-conversion-reporting.md) for more information on submitting mobile app conversions.

{% stepper %}
{% step %}

### データファイルを準備する

以下の手順に従ってテンプレートファイルを表示し、コンバージョンデータを入力して、.csv形式で保存します。必要なテンプレートは、コンバージョンを *商品レベル* （注文内の各商品のSKUや数量などを含める）でトラッキングするか、 *注文レベル* （注文自体のみをトラッキングし、注文内の商品は対象にしない）でトラッキングするかによって異なります。また、 [連鎖アクション](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions.md) データを送信することもできます。

{% hint style="warning" %}
**警告：** イベント日が88日を超えて過去のコンバージョンは、impact.comが現在FTP経由で送信されたデータを処理できないため、送信しないことを強くおすすめします。398日以内のコンバージョンは処理できますが、アトリビューションに `MediaId`.
{% endhint %}

1. 以下のリンクから、アクションをトラッキングするレベルに合った.csvファイルのテンプレートを表示してください。
   * [商品レベルのアクション／コンバージョンデータテンプレート](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
   * [注文レベルのアクション／コンバージョンデータテンプレート](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
   * [連鎖アクションのコンバージョンデータテンプレート](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. ファイルにコンバージョンデータを追加します。
   * 例については、 [impact.comのアクションおよびコンバージョンデータリファレンス](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) ドキュメントを参照し、このファイルを使用して使用可能なパラメーターを確認してください。コンバージョンデータのテンプレートに含めるとよいパラメーターについては、担当のCSMにお問い合わせください。
3. レポートに含めたい任意のパラメーターは、新しい列としてファイルに追加します。
4. 識別しやすいタイトルと日付を付けて、ファイルを.CSV形式で保存します（例： `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**注：** 商品レベルのバッチファイルでは、複数のSKUが関連付けられた注文IDを連続して記載する必要があります。同じ注文IDでSKUが異なる明細行をまとめてください。そうしないと、ファイル内で後に記載されたSKUに対して `OID_DUPLICATE` エラーが発生する場合があります。
{% endhint %}
{% endstep %}

{% step %}

### 送信方法を選択する

データは、FTP/SFTPまたはメールでフォーマットして送信できます。目的に合った方法を選択してください。

| If you want to...                             | Use this method...                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Submit a manual, one-time file with no coding | ​[Email](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/submit-conversion-data-via-ftp-or-email.md) batch processing or [upload file via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md)​                                                                                                                       |
| Set up automated conversion reporting         | ​[Conversions API](https://integrations.impact.com/integration-guides/for-brands/tracking-integrations/api-online-sale/implementation), [push file via FTP](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md), or [pull file via FTP​](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md) |
| {% endstep %}                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

{% step %}

### データファイルを送信する

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/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://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FbTqEWPIFtSUGlMvxsfbw%2FScreenshot_2026-03-27_at_8_36_19%E2%80%AFAM.png?alt=media&amp;token=eeaa8a95-fe91-427a-9db7-7b55def0db1b" alt="" width="446"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}

### ファイルの送信内容を確認する

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/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. この表では、impact.com が受信した最近のファイル送信と、現在の処理状況を確認できます。
   * 以下では、ファイル送信を確認する際に発生する可能性のあるさまざまなエラーと、その解決のために実行できる操作を確認できます。

<details>

<summary>Submission troubleshooting reference</summary>

| Issue                                              | Action to take                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Records column shows 0                             | Make sure the file extension is . CSV or .XML.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `NO_CHANGE`                                        | There is no change made to the action. Please ensure you enter the final amount into the *Amount* column (e.g., enter 0 if you want to reverse actions).                                                                                                                                                                                                                                                                                                                                                                           |
| `BAD_DISPOSITION`                                  | <p>The reason code you provided is not valid. Please use one of the standard <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/batch-modify-conversion-data/batch-modifications-and-reversals-reference.md">reason codes</a>.</p><p>Alternatively, you can set up a <a href="https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/manage-disposition-codes.md">custom disposition code</a>.</p> |
| `ALREADY_LOCKED`                                   | The action locking period has already passed. The action can no longer undergo modifications or reversals.                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ActionTrackerld:ActionTrackerld value is invalid` | This should correspond to the [Event Type ID](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md) entered.                                                                                                                                                                                                                                                                                                                                          |
| `ACTION_NOT_FOUND`                                 | The `OID` you provided is incorrect. Please provide a correct `OID`.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `ALREADY_REVERSED`                                 | The action has already been reversed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `ALREADY_APPROVED`                                 | The action has already been 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/submit-conversion-data/batch-submit-conversion-data.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.
