> 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/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md).

# Fehlerbehebung bei Produktkatalog-Uploads und Verbindungen

Bevor impact.com einen Produktkatalog verarbeiten kann, muss die Katalogdatei erfolgreich empfangen werden. Diese Anleitung ist nach Upload-Methode gegliedert. Wechseln Sie zum Abschnitt für die Methode, die Ihr Katalog verwendet: [*Von URL abrufen*](#pull-from-url-recommended), [*Import über integrierten Warenkorb*](#integrated-shopping-cart-import-recommended), [*impact.com-FTP-Server*](#impact.com-ftp-server), [*impact.com-SFTP-Server*](#impact.com-sftp-server) oder [*Direkter Upload*](#direct-upload). Wenn Sie nicht sicher sind, welche Methode Ihr Katalog verwendet, bearbeiten Sie den Katalog und überprüfen Sie unter [*Upload-Methode* die Einstellungen](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md#upload-your-product-catalog).

impact.com empfiehlt *Von URL abrufen* oder *Import über integrierten Warenkorb*, da impact.com steuert, wann Ihr Katalog abgerufen und wie oft er aktualisiert wird. Wenn Sie den impact.com-FTP-Server, den impact.com-SFTP-Server oder *Direkter Upload* verwenden, sind Sie dafür verantwortlich, regelmäßig aktualisierte Katalogdaten bereitzustellen, vorzugsweise täglich. Eine wöchentliche Aktualisierung ist ebenfalls möglich.

Wenn impact.com Ihre Datei empfangen hat, Ihr Katalog aber Fehler oder Warnungen anzeigt, lesen Sie [Fehler und Warnungen im Produktkatalog beheben](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

## Von URL abrufen (empfohlen)

Unterstützte Protokolle für *Von URL abrufen* sind `http://`, `https://`, `ftp://` und `sftp://`. Wenn Ihr Katalog nicht korrekt geladen, aktualisiert oder verarbeitet wird, nutzen Sie die folgende Tabelle, um das Problem zu identifizieren und zu beheben.

| Problem                                                        | Was zu prüfen ist                                                                                                                                                                                                                                                                                                                                                                       | So beheben Sie das Problem                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| URL ist kein direkter Download-Link                            | Öffnen Sie Ihre URL in einem Browser. Wenn sie zu einer Anmeldeseite oder einer Cloud-Speicher-Zielseite weiterleitet oder einen 404- oder 403-Fehler zurückgibt, ist die URL kein direkter Download-Link.                                                                                                                                                                              | Ersetzen Sie die URL durch eine, die die Datei direkt herunterlädt oder sie beim Öffnen in einem Browser als Rohdaten anzeigt.                                                                                                                                                                                                                                                            |
| Dateiname stimmt nicht überein                                 | Der *Name der Upload-Datei* in Ihren Katalogeinstellungen muss einschließlich der Erweiterung exakt mit dem tatsächlichen Dateinamen an der URL übereinstimmen (`.csv`, `.xml`, `.txt`, `.gz`).                                                                                                                                                                                         | Passen Sie den *Namen der Upload-Datei* exakt an Ihren Dateinamen an. Schon eine kleine Abweichung führt zum Fehler *No catalog found for the request* .                                                                                                                                                                                                                                  |
| Format oder Trennzeichen stimmt nicht überein                  | Prüfen Sie, ob das ausgewählte Format (CSV, TXT, XML, GMC) mit Ihrer Datei übereinstimmt. Wenn Sie eine Datei mit Trennzeichen verwenden, prüfen Sie, ob das Trennzeichen (Komma, Tabulator, Pipe) mit dem konfigurierten Trennzeichen übereinstimmt.                                                                                                                                   | Korrigieren Sie das Format oder Trennzeichen in Ihren Katalogeinstellungen. Eine Abweichung verursacht *Keine gültigen Datensätze gefunden* Fehler.                                                                                                                                                                                                                                       |
| FTP/SFTP: ungültige Anmeldedaten oder ungültiger Pfad          | Prüfen Sie, ob Ihre URL das folgende Format hat: `sftp://{username}:{password}@{host}/{file_path}`. Der Pfad muss auf die genaue Datei und nicht nur auf ein Verzeichnis verweisen. Sonderzeichen in den Anmeldedaten müssen URL-kodiert sein (zum Beispiel `@` wird zu `%40`).                                                                                                         | Testen Sie Ihre Anmeldedaten mit einem FTP-Client wie FileZilla. Aktualisieren Sie die URL mit den korrigierten Anmeldedaten und dem vollständigen Dateipfad.                                                                                                                                                                                                                             |
| Abruf läuft in ein Timeout oder die Verbindung schlägt fehl    | Möglicherweise blockiert die Firewall Ihres Servers Anfragen von impact.com.                                                                                                                                                                                                                                                                                                            | Wenden Sie sich an Ihren Hostinganbieter oder Ihr IT-Team, damit die IP-Adressbereiche von impact.com zugelassen werden.                                                                                                                                                                                                                                                                  |
| URL erfordert Authentifizierung                                | Diese Upload-Methode unterstützt keine sitzungs- oder cookie-basierte Authentifizierung.                                                                                                                                                                                                                                                                                                | Verwenden Sie eine öffentlich zugängliche direkte Download-URL, HTTP-Basisauthentifizierung in der URL (`https://user:pass@host/path`) oder FTP/SFTP mit Anmeldedaten in der URL. Wenn für Ihren Feed eine browserbasierte Anmeldung erforderlich ist, wechseln Sie bei Ihrem Katalog zu einer anderen Upload-Methode, zum Beispiel *Direkt-Upload* oder dem *FTP-Server von impact.com*. |
| URL überschreitet 2.048 Zeichen                                | Signierte URLs für Cloud-Speicher können die Begrenzung auf 2.048 Zeichen überschreiten und dadurch abgeschnitten werden.                                                                                                                                                                                                                                                               | Verwenden Sie einen URL-Kürzungsdienst, der den direkten Download beibehält, oder hosten Sie die Datei unter einer kürzeren URL.                                                                                                                                                                                                                                                          |
| Katalog bleibt bei „Wird verarbeitet“ oder „Ausstehend“ hängen | Prüfen Sie, ob die Datei unter der URL weiterhin verfügbar ist und ob ihre Größe für die Abrufhäufigkeit ungewöhnlich groß ist.                                                                                                                                                                                                                                                         | Prüfen Sie, ob die Datei verfügbar ist. Wenn der Katalog weiterhin den Status *Wird verarbeitet* oder *Ausstehend*, [hat, wenden Sie sich an den Support](https://app.impact.com/support/portal.ihtml) und bitten Sie um eine manuelle erneute Verarbeitung.                                                                                                                              |
| Katalog wird nicht mehr automatisch aktualisiert               | Prüfen Sie, ob die Datei unter derselben URL weiterhin verfügbar ist und ob sich Dateiname, Format oder Serverzugriffseinstellungen geändert haben.                                                                                                                                                                                                                                     | Stellen Sie die Datei unter der ursprünglichen URL wieder bereit oder aktualisieren Sie Ihre Katalogeinstellungen entsprechend der neuen URL oder des neuen Dateinamens. Bei großen Katalogen (1.000.000+ Artikel) sollten Sie die Abrufhäufigkeit verringern, um Timeouts zu vermeiden.                                                                                                  |
| Felder oder Daten fehlen nach dem Upload                       | Vergewissern Sie sich, dass die Feldnamen der Spezifikation des ausgewählten Formats entsprechen, zum Beispiel den [Google Merchant Center-Feldern](https://support.google.com/merchants/answer/7052112) für das GMC-Format. Ordnen Sie benutzerdefinierte Felder außerhalb der Standardspezifikation den benutzerdefinierten Feldplätzen von impact.com zu (`Numeric1`, `Text1` usw.). | Laden Sie Ihren hochgeladenen Katalog von impact.com herunter und vergleichen Sie ihn mit der Quelldatei, um festzustellen, an welcher Stelle Daten verloren gehen. Aktualisieren Sie bei Bedarf Feldnamen oder Zuordnungen und laden Sie die Datei anschließend erneut hoch.                                                                                                             |

## Import über integrierten Warenkorb (empfohlen)

Bei dieser Methode wird Ihr Katalog von einer bestehenden E-Commerce-Plattform abgerufen. Die meisten Verbindungsprobleme sind auf falsche Anmeldedaten oder fehlende Leseberechtigungen zurückzuführen. Wählen Sie unten Ihre Plattform aus.

### Shopify (empfohlen)

Wenn ein Fehler wie *Unsuccessful HTTP status code when connecting to Shopify: 401* oder *No valid records were found in the catalog file*, liegt die Ursache meistens bei den Authentifizierungsdaten oder Berechtigungen.

* Dein Passwort muss der **Admin-API-Zugriffstoken**sein, das mit `shpat_` (oder `shap_`) beginnt. Du findest es in deinem Shopify-Adminbereich unter **Apps** **→** **API-Anmeldedaten** **→** **Admin-API-Zugriffstoken**.
* Wenn du das **Admin-API-Zugriffstoken**nicht siehst, wähle in Shopify **App installieren** , um es zu generieren.
* Vergewissere dich, dass der App die Berechtigung (Scope) `read_products` gewährt wurde. Andernfalls gibt Shopify eine Fehlermeldung zurück, dass für die Aktion eine Genehmigung des Händlers für den Scope `read_products` erforderlich ist.
* Um die ID einer Kollektion zu finden, gehe in deinem Shopify-Adminbereich zu **Produkte** **→** **Kollektionen**. Wähle die Kollektion aus. Ihre ID steht am Ende der Seiten-URL.

Die vollständigen Einrichtungsschritte findest du im [Leitfaden zur Integration des Shopify-Produktkatalogs](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog).

### Amazon (empfohlen)

Die Integration des Amazon-Warenkorbs ist ausschließlich Marken mit [Verkäufer-Abonnements](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) vorbehalten und keine Self-Service-Funktion. Der automatische Katalogimport von Amazon ist aufgrund von Einschränkungen der Amazon-API auf 1.000 Produkte begrenzt. Wenn dein Verkäuferkatalog mehr als 1.000 Produkte enthält, verwende stattdessen eine Methode zum Hochladen von Dateien, etwa *Von URL abrufen*.

Die Einrichtungsschritte findest du im [Leitfaden zur Amazon-Integration](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-amazon).

### BigCommerce

Zum Verbinden mit BigCommerce sind zwei Werte und die passenden Nur-Lese-Berechtigungen erforderlich.

* Gib deinen **Store-Hash** und dein **Zugriffstoken** in der impact.com-Benutzeroberfläche ein. Dein Store-Hash ist die Kennung in deinem API-Pfad des Shops.
* Setze beim Erstellen des API-Kontos in BigCommerce die Berechtigungen für **Produkte** und **Informationen und Einstellungen** auf Nur-Lesezugriff.

Weitere Informationen findest du in der BigCommerce-Anleitung zum [Erstellen von API-Tokens](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token).

### WooCommerce

Wenn du Folgendes siehst *Die Verbindung zu WooCommerce ist fehlgeschlagen. Bitte versuchen Sie es erneut*, überprüfen Sie Ihre Zugangsdaten und API-Einstellungen.

* Ihr **API-Benutzername** ist Ihr WooCommerce- *Consumer Key*, und Ihr **API-Passwort** ist Ihr *Consumer Secret*.
* Aktivieren Sie die Legacy-REST-API in WooCommerce: **WooCommerce** **→** **Einstellungen** **→** **Erweitert** **→** **Legacy-API**, und aktivieren Sie dann das Kontrollkästchen.

Weitere Informationen finden Sie in der [WooCommerce-REST-API-Dokumentation](https://woocommerce.com/document/woocommerce-rest-api/).

### Shoplazza

Ihre private Shoplazza-App benötigt Lesezugriff auf die folgenden Ressourcen: `product`, `collection`und `shop`.

Eine Anleitung zur Einrichtung finden Sie im Shoplazza-Leitfaden zum [Erstellen privater Apps](https://www.shoplazza.dev/reference/quick-construction-of-private-apps).

## FTP-Server von impact.com

Die meisten FTP-Probleme hängen mit den Verbindungseinstellungen oder Zugangsdaten zusammen.

| Problem                             | Was zu prüfen ist                                                                                               | So beheben Sie das Problem                                                                                                                                                                                                                                        |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Keine Verbindung zum Server möglich | Vergewissern Sie sich, dass Sie eine Verbindung zum Host `products.impact.com` über Port `21`.                  | Aktualisieren Sie Ihren FTP-Client mit dem richtigen Host und Port und stellen Sie die Verbindung erneut her.                                                                                                                                                     |
| FTP-Zugangsdaten fehlen             | Für die Verbindung benötigen Sie den für Ihr Konto ausgestellten FTP-Benutzernamen und das zugehörige Passwort. | Suchen Sie Ihre Zugangsdaten für das *FTP-Produktdatensystem* in den technischen Konfigurationseinstellungen Ihres Kontos. Wenn Sie sie nicht finden oder darauf zugreifen können, [wenden Sie sich an den Support](https://app.impact.com/support/portal.ihtml). |

## SFTP-Server von impact.com

Der SFTP-Server von impact.com ist eine spezielle Upload-Methode, die bestimmten Integrationen vorbehalten ist.

| Problem                                              | Was zu prüfen ist                                                                                                                                                                           | So beheben Sie das Problem                                                                                                                                                                                                                                                           |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Ihre Feed-Plattform kann keine Verbindung herstellen | Vergewissern Sie sich, dass Ihre Plattform eine Verbindung zum Host `products.impact.com` über Port `22`herstellt und dass es sich um die für Ihr Konto ausgestellten Zugangsdaten handelt. | Testen Sie dieselben Zugangsdaten mit einem herkömmlichen SFTP-Client wie FileZilla oder Cyberduck. Wenn der Client eine Verbindung herstellen kann, Ihre Feed-Plattform jedoch nicht, stellen Sie den Katalog auf *Von URL abrufen* um, indem Sie die folgenden Schritte ausführen. |

### Von Push auf Pull umstellen

impact.com empfiehlt, deinen Feed abzurufen, statt ihn zu übertragen. Wenn impact.com den Feed direkt vom SFTP-Server deiner Feed-Plattform (z. B. SFTPGo) abruft, bestimmt impact.com, wann und wie oft dein Katalog aktualisiert wird. Außerdem bist du dann nicht mehr auf den SFTP-Server von impact.com angewiesen. Durch die Umstellung auf Pull werden auch Verbindungsfehler behoben, die bei deiner Feed-Plattform (z. B. Feedonomics) auftreten können, wenn sie Dateien auf den SFTP-Server von impact.com überträgt.

Bevor du umstellst, bitte deine Feed-Plattform (z. B. Feedonomics), einen ausgehenden SFTP-Speicherort für deinen Feed einzurichten und dir Folgendes mitzuteilen:

* SFTP-/FTP-Host und Port (z. B. sftpgo.feedonomics.com:22)
* Benutzername und Passwort
* Dateipfad (z. B. incoming/catalog\_feed.txt.gz)

{% hint style="warning" %}
**Warnung:** Aktualisiere deinen bestehenden Katalog, anstatt einen neuen zu erstellen. Ein neuer Katalog mit demselben *Upload File Name* führt zu einem *File name already in use* -Fehler. Außerdem kann dein bestehender Katalog bereits von anderen Programmen verwendet werden.
{% endhint %}

1. Wähle im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Inhalte** **→** **Produkte** **→** [**Produktkataloge**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Bewege den Mauszeiger über deinen bestehenden Katalog und wähle dann **Bearbeiten**.
3. Wähle im Abschnitt *Upload Method* die Option **Pull From URL**.
4. Wähle das **Format** aus, das zu deiner Feed-Datei passt.
5. Gib deinen **Upload File Name**ein. Achte darauf, dass der Dateiname exakt übereinstimmt, einschließlich der Dateiendung.
6. Gib deine **Pull URL** im folgenden Format ein: `sftp://[username]:[password]@[host]:22/[path/to/file]`.
   * URL-codiere Sonderzeichen in deinen Anmeldedaten. Zum Beispiel wird `@` zu `%40`.
7. Wähle deine **Fetch Frequency**, **Fetch Time**und **Time Zone**.
8. Wähle **Speichern**.

## Direkter Upload

Probleme beim direkten Upload beruhen meist auf einem falschen Format, einem abweichenden Dateinamen oder darauf, dass die Datei das Limit von 1 GB überschreitet.

| Problem                                   | Was zu prüfen ist                                                                                                                                                                                      | So beheben Sie das Problem                                                                                                                                                              |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Falsches Format ausgewählt                | Das ausgewählte Format (z. B. TXT) stimmt nicht mit dem Format der hochgeladenen Datei (z. B. XML) überein.                                                                                            | Lade die Datei erneut hoch und wähle das passende Format aus. XML-Dateien haben die Dateiendung `.xml` , CSV-Dateien verwenden `.csv`, und tabulatorgetrennte Dateien verwenden `.txt`. |
| Dateiname stimmt nicht überein            | Der Name der hochgeladenen Datei muss exakt mit dem *Upload-Dateinamen* in Ihren Katalogeinstellungen übereinstimmen, einschließlich der Dateiendung.                                                  | Benennen Sie Ihre Datei um oder aktualisieren Sie den *Upload-Dateinamen* so, dass beide exakt übereinstimmen.                                                                          |
| Komprimierte Datei wird nicht verarbeitet | impact.com unterstützt Dateien im gzip- und standardmäßigen ZIP-Format. Eine komprimierte Datei kann eine zweite Dateiendung haben, die auf die Komprimierung hinweist, zum Beispiel `catalog.xml.gz`. | Vergewissern Sie sich, dass der Komprimierungstyp gzip oder ZIP ist und die Datei die richtigen Dateiendungen für Format und Komprimierung verwendet.                                   |


---

# 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/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.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.
