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, Import über integrierten Warenkorb, impact.com-FTP-Server, impact.com-SFTP-Server oder Direkter Upload. Wenn Sie nicht sicher sind, welche Methode Ihr Katalog verwendet, bearbeiten Sie den Katalog und überprüfen Sie unter Upload-Methode die Einstellungen.
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.
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.
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 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 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-Zugriffstokensein, das mit
shpat_(odershap_) beginnt. Du findest es in deinem Shopify-Adminbereich unter Apps → API-Anmeldedaten → Admin-API-Zugriffstoken.Wenn du das Admin-API-Zugriffstokennicht siehst, wähle in Shopify App installieren , um es zu generieren.
Vergewissere dich, dass der App die Berechtigung (Scope)
read_productsgewährt wurde. Andernfalls gibt Shopify eine Fehlermeldung zurück, dass für die Aktion eine Genehmigung des Händlers für den Scoperead_productserforderlich 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.
Amazon (empfohlen)
Die Integration des Amazon-Warenkorbs ist ausschließlich Marken mit Verkäufer-Abonnements 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.
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.
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.
Shoplazza
Ihre private Shoplazza-App benötigt Lesezugriff auf die folgenden Ressourcen: product, collectionund shop.
Eine Anleitung zur Einrichtung finden Sie im Shoplazza-Leitfaden zum Erstellen privater Apps.
FTP-Server von impact.com
Die meisten FTP-Probleme hängen mit den Verbindungseinstellungen oder Zugangsdaten zusammen.
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.
SFTP-Server von impact.com
Der SFTP-Server von impact.com ist eine spezielle Upload-Methode, die bestimmten Integrationen vorbehalten ist.
Ihre Feed-Plattform kann keine Verbindung herstellen
Vergewissern Sie sich, dass Ihre Plattform eine Verbindung zum Host products.impact.com über Port 22herstellt 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)
Wähle im linken Navigationsmenü
[Engage] → Inhalte → Produkte → Produktkataloge.
Bewege den Mauszeiger über deinen bestehenden Katalog und wähle dann Bearbeiten.
Wähle im Abschnitt Upload Method die Option Pull From URL.
Wähle das Format aus, das zu deiner Feed-Datei passt.
Gib deinen Upload File Nameein. Achte darauf, dass der Dateiname exakt übereinstimmt, einschließlich der Dateiendung.
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.
Wähle deine Fetch Frequency, Fetch Timeund Time Zone.
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.
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.
Zuletzt aktualisiert
War das hilfreich?

