> 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/de/what-would-you-like-to-learn-about/platform-features/submit-and-modify-conversion-data/submit-conversion-data/batch-submit-conversion-data.md).

# Conversion-Daten stapelweise senden

Sie können die Stapelverarbeitung nutzen, um Conversion-Daten direkt an impact.com zu übermitteln, wenn Ihre Conversion-Daten nicht automatisch erfasst werden – unabhängig davon, ob Sie sie serverseitig erfassen oder Cookies verwenden. Möglicherweise müssen Sie auch [Conversion-Daten nachträglich übermitteln](https://help.impact.com/brand/de/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) zum Beispiel, wenn ein Kunde den Aktionscode eines Partners nicht angibt. Durch die Übermittlung dieser Daten stellen Sie sicher, dass die richtigen Partner die Gutschrift erhalten, Ihre Berichte korrekt bleiben und Sie Aktionen bei Bedarf ändern oder rückgängig machen können, bevor sie gesperrt werden.

* 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 %}

### Datendatei vorbereiten

Folgen Sie den nachstehenden Anweisungen, um eine Vorlagendatei aufzurufen, Ihre Conversion-Daten hinzuzufügen und die Datei im .csv-Format zu speichern. Welche Vorlage Sie benötigen, hängt davon ab, ob Sie Conversions auf *Artikelebene* (d. h. einschließlich SKU, Menge usw. für jeden Artikel einer Bestellung) oder auf *Bestellebene* (d. h. nur die Bestellungen selbst und nicht die darin enthaltenen Artikel) erfassen. Sie können auch Daten zu [verketteten Aktionen](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/actions/track-your-conversion-funnel-using-chained-actions.md) übermitteln.

{% hint style="warning" %}
**Warnung:** Wir raten dringend davon ab, Aktionen zu übermitteln, die älter als 88 Tage sind, da impact.com derzeit keine per FTP übermittelten Conversions mit Ereignisdaten verarbeitet, die außerhalb dieses Zeitraums liegen. Conversions von bis zu 398 Tagen können verarbeitet werden, jedoch nur, wenn die Attribution mit `MediaId`.
{% endhint %}

1. Wählen Sie einen der folgenden Links aus, um die .csv-Vorlage aufzurufen, die der Ebene entspricht, auf der Sie Aktionen erfassen.
   * [Vorlage für Aktions-/Conversion-Daten auf Artikelebene](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/item-level-template)
   * [Vorlage für Aktions-/Conversion-Daten auf Bestellebene](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/order-level-template)
   * [Vorlage für Conversion-Daten verketteter Aktionen](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references/chained-actions-template)
2. Fügen Sie Ihre Conversion-Daten zur Datei hinzu.
   * Weitere Beispiele finden Sie im Dokument [Referenz zu Aktions- und Conversion-Daten von impact.com](https://integrations.impact.com/integration-guides/for-brands/action-and-conversion-field-references) und verwenden Sie diese Datei als Referenz für zulässige Parameter. Wenden Sie sich an Ihren CSM, um zu erfahren, welche Parameter sich am besten für Ihre Conversion-Datenvorlage eignen.
3. Fügen Sie alle optionalen Parameter, die Sie melden möchten, als neue Spalten in Ihre Datei ein.
4. Speichern Sie Ihre Datei im .CSV-Format mit einem aussagekräftigen Namen und Datum (z. B. `2020-01-01_ActionData.csv`).

{% hint style="success" %}
**Hinweis:** Bei Stapeldateien auf Artikelebene müssen Bestell-IDs mit mehreren zugehörigen SKUs fortlaufend aufgeführt werden. Gruppieren Sie alle Positionen mit derselben Bestell-ID und unterschiedlichen SKUs, andernfalls kann für weiter unten in der Datei aufgeführte SKUs ein Fehler `OID_DUPLICATE` auftreten.
{% endhint %}
{% endstep %}

{% step %}

### Übermittlungsmethode auswählen

Sie können Ihre Daten formatieren und per FTP/SFTP oder E-Mail übermitteln. Wählen Sie die Methode, die sich am besten für Ihr Vorhaben eignet.

| 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 %}

### Datendatei übermitteln

1. Wählen Sie in der oberen Navigationsleiste  ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b527686787b925f477dff4feb9be3a63f51250a7%2Fdcf31aa89710c2f91d880b79ce8d8c18489cd8cad334e5cd91dd7ee0372a44fd.svg?alt=media) **\[Benutzerprofil] → Einstellungen**.
2. Wählen Sie in der rechten Spalte unter *Tracking*, die Option [**Ereignistypen**](https://app.impact.com/secure/advertiser/tracking-settings/actiontracker/view-actiontracker-flow.ihtml).
3. Wählen Sie den **Namen** des Ereignistyps aus, für den Sie Stapeländerungen übermitteln möchten.
4. Wählen Sie neben *Retourenverarbeitung*die Option ![](https://1698965099-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) **\[Bearbeiten]**.
5. Wählen Sie **Retourenverarbeitung automatisieren (erweitert)**.
6. Wählen Sie eine der folgenden FTP- oder E-Mail-Methoden aus, um Ihre Datei zu übermitteln:

<details>

<summary>Datei auf den FTP-Server des Systems hochladen</summary>

{% hint style="info" %}
Wir empfehlen, FTP-/SFTP-Dateien aufzuteilen, damit die maximale Anzahl von Einträgen pro Datei unter 10.000 bleibt.
{% endhint %}

1. Wählen Sie **Datei auf den FTP-Server des Systems hochladen.**
2. Auswählen **FTP-Benutzername und -Passwort per E-Mail senden** und **Speichern**.
3. Sobald Sie Ihre FTP-Zugangsdaten per E-Mail erhalten haben, verbinden Sie sich mit einem FTP-Client mit impact.com. Verwenden Sie dazu die folgenden Angaben:

   |                  | FTP                                                                    | SFTP                                                                    |
   | ---------------- | ---------------------------------------------------------------------- | ----------------------------------------------------------------------- |
   | **Server**       | batch.impact.com                                                       | sftp\://batch.impact.com                                                |
   | **Port**         | 21                                                                     | 22                                                                      |
   | **Benutzername** | (Ihr impact.com-FTP-Benutzername. Groß- und Kleinschreibung beachten.) | (Ihr impact.com-SFTP-Benutzername. Groß- und Kleinschreibung beachten.) |
   | **Passwort**     | (Ihr impact.com-FTP-Passwort. Groß- und Kleinschreibung beachten.)     | (Ihr impact.com-SFTP-Passwort. Groß- und Kleinschreibung beachten.)     |
4. Laden Sie die Datei nach dem Herstellen der Verbindung in das Hauptverzeichnis des Servers hoch.
   * Wenn Sie die E-Mail mit den FTP-Zugangsdaten nicht erhalten haben, wenden Sie sich an die Person, die Ihr impact.com-Konto erstellt hat. Alternativ können Sie [den Support kontaktieren](https://app.impact.com/support/portal.ihtml).

</details>

<details>

<summary>Datei von Ihrem eigenen FTP-Server abrufen</summary>

{% hint style="info" %}
Wir empfehlen, FTP-/SFTP-Dateien aufzuteilen, damit die maximale Anzahl von Einträgen pro Datei unter 10.000 bleibt.
{% endhint %}

1. Auswählen **Datei von Ihrem eigenen FTP-Server abrufen**.
2. Geben Sie die **Server-URL**, **Portnummer**und **Verzeichnis** den Pfad zur Batch-Änderungsdatei auf Ihrem FTP-Server ein. Geben Sie den **Benutzernamen** und **das Passwort** ein, die impact.com für die Verbindung zu Ihrem FTP-Server verwenden soll.
3. Wählen Sie **Speichern** und fahren Sie fort.
4. Laden Sie Ihre Datei in das oben angegebene *Verzeichnis* hoch.
   * impact.com versucht alle 24 Stunden, eine Verbindung zu Ihrem FTP-Server herzustellen und Dateien herunterzuladen. Daher kann es nach dem Hochladen bis zu 24 Stunden dauern, bis Ihre Datei verarbeitet wird.

</details>

<details>

<summary>Datei per E-Mail an den SMTP-Systemserver senden</summary>

1. Auswählen **Datei per E-Mail an den SMTP-Systemserver senden.**
2. Direkt unter der ausgewählten Methode wird Ihnen eine eindeutige E-Mail-Adresse angezeigt. Kopieren Sie diese Adresse.
3. Senden Sie mit einem beliebigen E-Mail-Programm eine E-Mail an diese eindeutige Adresse und fügen Sie Ihre Batch-Änderungsdatei als Anhang hinzu.
   * Geben Sie für den Ereignistyp nur die eindeutige E-Mail-Adresse in das Feld *An:* ein. Wenn Sie diese Datei an weitere Personen senden möchten, fügen Sie deren Adressen im Feld *CC:* hinzu.
4. Sie können das Betreff- und das Nachrichtentextfeld leer lassen.
   * Unten sehen Sie ein Beispiel für die E-Mail-Adresse (Ihre Adresse kann leicht abweichen):

<div data-with-frame="true"><figure><img src="https://1698965099-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 %}

### Überprüfen Sie Ihre Dateiübermittlung

1. Wählen Sie in der oberen Navigationsleiste  ![](https://1698965099-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) **\[Benutzerprofil] →** **Einstellungen**.
2. Wählen Sie in der linken Spalte unter dem *Bereich „Technisch“* die Option [**„Dateiübermittlungen“**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/ftp-file-submissions-flow.ihtml).
3. In der Tabelle können Sie die zuletzt von impact.com empfangenen Dateiübermittlungen und deren aktuellen Verarbeitungsstatus prüfen.
   * Im Folgenden finden Sie verschiedene Fehler, die bei der Prüfung von Dateiübermittlungen auftreten können, sowie Maßnahmen zu deren Behebung.

<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/de/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.
