Fehlerbehandlung deines Daten-Feeds

Verwende diese Lösungen und Richtlinien für Daten-Feed-Probleme, die unter Umständen auftreten.

Vorgeschlagene Regeln anzeigen

Um alle Regeln aufzulisten, die mit einem Daten-Feed verknüpft sind, sende einen HTTP GET-Aufruf an:

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/rules

Einzelheiten findest du unter Product Data Feed Rules API, Referenz.

Du kannst die vorgeschlagenen Regeln von Meta verwenden, um Fehler in deinem Datenfeed zu beheben. Für Vorschläge für deine Upload-Sitzung, befolge diese Schritte:

Schritt 1: Upload-Sitzungen abrufen:

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/uploads

Schritt 2: Fehler für Upload-Sitzung abrufen:

https://graph.facebook.com/<API_VERSION>/<UPLOAD_SESSION_ID>/errors

Schritt 3: Vorgeschlagene Regeln für Upload-Fehler abrufen:

curl -i -X GET 
 "https://graph.facebook.com/<API_VERSION>/<UPLOAD_ERROR_ID>/suggested_rules?access_token={ACCESS_TOKEN}

Beispielantwort

"data": [
  
    "attribute": "description",
    "type": "letter_case_rule",
    "params": [
      
        "key": "type",
        "value": "capitalize_first"
      
    ]
  
]

Einzelheiten findest du unter Suggested Rules API, Referenz.

Regeln auf Daten-Feeds anwenden

Für die Anwendung von Regeln auf einen Datenfeed ist es erforderlich, die Regel dem Daten-Feed zuordnen.

Sende einen HTTP POST-Aufruf an:

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_ID>/rules?attribute={ATTRIBUTE}&amp;rule_type={RULE_TYPE}&amp;params={PARAMS}

Beispiel

curl -i -X POST 
  -d "attribute=google_product_category" 
  -d "rule_type=mapping_rule" 
  -d "params=%7B'map_from'%3A%20'gcategory'%7D" 
  -d "access_token={ACCESS_TOKEN}" 
  "https://graph.facebook.com/<API_VERSION>/{PRODUCT_FEED_ID}/rules" 

Beispielantwort

"id": "{RULE_ID}"

Formatiere params wie folgt:

Einzelheiten findest du unter Product Data Feed Rules API, Referenz.

Feed-Upload-Fehler mit Regeln beheben

Behebe und verhindere fortlaufende Upload-Fehler bei Daten-Feed-Dateien mit Regeln. Du kannst Regeln festlegen, die Meta für jeden Daten-Feed-Upload anwendet. Gib Regeln nach dem Attribut (Spalte), auf das sie angewendet werden sollen, nach dem Regeltyp und nach Parametern an. Du kannst aktuell keine Regeln mit der Batch API verwenden. Du kannst diese Regeltypen angeben:

• Zuordnungsregel: Ordnet Attribute (Spaltennamen) in einer Daten-Feed-Datei Attributen zu, die wir erkennen können.
• Wertzuordnungsregel: Ordnet Felder (Spaltenwerte) in einer Daten-Feed-Datei Feldern zu, die wir erkennen können.
• Regel zur Groß-/Kleinschreibung : Ändert die Groß-/Kleinschreibung von Wörtern in einem Feld. Ändere beispielsweise alle Beschreibungen mit Großbuchstaben in Kleinbuchstaben.

Du kannst beispielsweise folgende Probleme mit der Zuordnungs- und Wertzuordnungsregel beheben:

• Attribut-Tippfehler von gavailability zu availability ändern
• Nicht erkannte InStock-Enums in in stock ändern
• Preisformat von 45$ zu 45.00 USD ändern
• Übersetzte Bedingung Neu unter New

Du kannst die Regel für Groß-/Kleinschreibung verwenden, um folgende Arten von Problemen zu beheben:

• Beschreibungen in Großbuchstaben BRAND NEW WITH LEATHER DETAIL... in Brand new with leather detail... ändern
• Titel in Großbuchstaben FACEBOOK T-SHIRT in Facebook T-shirt ändern

Regeln aktualisieren und löschen

Um eine mit einem Daten-Feed verknüpfte Regel zu ändern, führe einen HTTP POST-Aufruf durch, um alle Parameter zu aktualisieren und HTTP DELETE, um sie zu löschen. Du kannst nur Parameter aktualisieren. Wenn du attribute oder rule_type ändern möchtest, musst du die Regel löschen und neu erstellen.

https://graph.facebook.com/<API_VERSION>/<PRODUCT_FEED_RULE_ID>?params={PARAMS}

Einzelheiten findest du unter Product Data Feed Rule API, Referenz.

Fehlende Artikel zu einem Katalog hinzufügen

Wenn der Commerce Manager meldet, dass einige Artikel in deinem Katalog fehlen oder nicht zu finden sind, solltest du überprüfen, ob dein Meta-Pixel oder deine App richtig eingerichtet sind. Dieser Fehler kann auftreten, wenn:

• das im Pixel oder App-Event enthaltene Wert content_id nicht mit der ID im Daten-Feed des Katalogs übereinstimmt.
• das Pixel oder die App nicht mit dem Katalog verknüpft ist.
• der Artikel im Katalog nicht vorhanden ist.

Mehr dazu findest du hier.

Erfahre mehr über die Fehlerbehandlung deines Feeds mit Blueprint.

Fehlerbericht zum Daten-Feed-Upload anfragen

Advantage+ Catalog Ads

Du kannst die Data Feed Upload Error Report API verwenden, um einen vollständigen Fehlerbericht für jede Feed-Upload-Sitzung anzufragen. Wenn wir die Anfrage erhalten, führen wir einen Hintergrundjob aus, um diese Fehler vorzubereiten und sie in einer CSV-Datei zu speichern.

Verwende POST /{upload_session_id}/error_report, um einen vollständigen Fehlerbericht anzufragen.

Der Bericht enthält Informationen über:

• Händler-ID des Artikels mit dem Fehler
• Fehlermeldung
• Fehlerschweregrad (FATAL wenn der Fehler verursacht, dass der Artikel abgelehnt wurde, WARNING wenn der Artikel mit einem Fehler hochgeladen wurde)
• Name des Feldes, für die die Fehlermeldung gilt
• Funktionen, die von diesem Fehler betroffen sind; zum Beispiel Fehler, die Advantage+ Catalog Ads betreffen, die 'da' in dieser Spalte enthalten sind
• Wenn der Fehler die Funktion blockiert (true/false); zum Beispiel, wenn der Fehler verhindert, dass das Element auf dieser Oberfläche angezeigt wird

Anfrage

curl -i -X POST \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.intern.facebook.com/<API_VERSION>/<upload session ID>/error_report

Antwort: Die Antwort gibt an, ob die Anfrage erfolgreich war oder nicht:

{
  "success": bool,
}

Handel

Oft reicht es aus, eine Auswahl von Fehlern und Warnungen zu erhalten, um die meisten Probleme beim Hochladen von Produkt-Feeds zu beheben. Möglicherweise benötigst du jedoch die vollständige Liste der Fehler, um eine tiefergehende Analyse durchführen zu können. Um eine vollständige Liste der Fehler und Warnungen herunterzuladen, musst du zunächst die letzte Upload-Sitzung abfragen (siehe Abschnitt oben).

Du kannst die Erstellung des vollständigen Fehlerberichts für eine bestimmte Upload-Sitzungs-ID anfordern.

Anfrage

POST https://graph.facebook.com/vX.X/{upload-session-id}/error_report

Antwort

{
  "success": true
}

Falls der Bericht nicht fertig ist, wiederhole den letzten Aufruf nach ein paar Sekunden. Anschließend kannst du den Bericht selbst herunterladen.

Anfrage

GET https://graph.facebook.com/vX.X/{upload-session-id}/?fields=error_report

Antwort

{
  "error_report": {
    "report_status": "WRITE_FINISHED",
    "file_handle": "{link-to-the-file-location}"
  },
  "id": "493476498092860"
}

Du solltest eine URL sehen, die du herunterladen kannst (z. B. mit „wget“, „curl“ usw.). Die heruntergeladene Datei enthält den vollständigen Fehlerbericht.

Wenn du diese Fehlermeldung erhältst: „Cannot access an object not managed by the business owning this app“, stelle bitte sicher, dass die von dir verwendete App zum Unternehmen gehört (Unternehmenseinstellungen > Konto > Apps).

Fehlerberichtstatus abrufen

Sobald ein Bericht angefordert wurde, nutze GET /{upload_session_id}?fields=error_report um den Status des Fehlerberichts abzurufen.

Beispiel

curl -i -X GET \
 https://graph.intern.facebook.com/<API_VERSION>/<upload session ID>?fields=error_report&access_token=ACCESS_TOKEN

Antwort

{
  "error_report": {
    "report_status": string,
    "file_handle": string, // if available
  }
  "id": "332552650711532 (https://developers.intern.facebook.com/tools/explorer/690422434302374?method=GET&path=332552650711532%3Ffields%3Derror_report&version=v3.2#)"
}

Mögliche Werte – Zurückgegebener Status

Hinweis: Eine CDN-URL, die diesen Fehlerbericht verwendet, kann heruntergeladen werden und wird als „file_handle“ zurückgegeben, wenn der Status des error_reportWRITE_FINISHED lautet.

Fehler beim Produkt-Feed-Upload behandeln

Advantage+ Catalog Ads

Lies die Dokumentation zu Fehlern beim Produkt-Feed-Upload. Siehe auch Behandlung von Fehlern beim Produkt-Feed-Upload, Handelsplattform.

Anfrage

Um Fehler und Warnungen aus einem Upload-Feed zu erhalten, musst du zunächst Abfragen nach aktuellen Upload-Sitzungen tätigen.

GET https://graph.facebook.com/vX.X/{product-feed-id}/uploads
Token: PAGE_ACCESS_TOKEN

Dann verwendest du die upload_session_id, um Fehler und Warnungen abzurufen.

GET https://graph.facebook.com/vX.X/{upload-session-id}/errors
Token: PAGE_ACCESS_TOKEN

Beispielantwort

Ein Schweregrad von fatal bedeutet, dass das Element von Meta nicht verarbeitet werden kann; ein Schweregrad von warning bedeutet, dass einige empfohlene Attribute fehlen oder fehlerhaft sind.

{
  "data": [
    {
      "id": 1510567479166488,
      "summary": "A required field is missing: price.",
      "description": "Products need to have prices to run in ads. Include a price for each product in your data feed file and upload it again. Prices must include cost and an ISO currency code (for example: 10 USD instead of $10 for American dollars).",
      "severity": "fatal",
      "samples": {
        "data": [
          {
            "row_number": 2,
            "retailer_id": "yj9bpbpub5t8t22kgbq6",
            "id": "1677559492523068"
          },
          {
            "row_number": 5,
            "retailer_id": "ujn33tvbyv2vmdpo7ecb",
            "id": "1529743440653137"
          }
        ]
      }
    },
    {
      "id": 275241589314958,
      "summary": "GTIN is incorrectly formatted",
      "description": "Check that the GTIN (Global Trade Identification Number) for each of your products is in the correct format. Accepted types include UPC, EAN, JAN, and ISBN.",
      "severity": "warning",
      "samples": {
        "data": [
          {
            "row_number": 4,
            "retailer_id": "bxwb1pho9o43uxjxikcg",
            "id": "538700559625644"
          }
        ]
      }
    }
  ]
}

Handel

Lies die Dokumentation zu Fehlern beim Produkt-Feed-Upload. Siehe auch Behandlung von Fehlern beim Produkt-Feed-Upload, Advantage+ Catalog Ads.

Wir empfehlen, dass du nach jeder Upload-Sitzung Fehler und Warnungen beim Katalog-Upload überprüfst. Du kannst dies erreichen, indem du zum Abschnitt Diagnose deines Commerce Managers gehst oder die Feed API verwendest, um eine Auswahl von Fehlern und Warnungen anzufordern. Beginne mit der Abfrage der aktuellen Upload-Sitzungen.

Erfahre mehr über das Beheben von Diagnosewarnungen und -fehlern im Commerce Manager mit Blueprint.

Anfrage

GET https://graph.facebook.com/vX.X/{product-feed-id}/uploads

Beispielantwort

{
  "data": [
    {
      "id": "493476498092860",
      "start_time": "2019-07-15T12:38:36+0000",
      "end_time": "2019-07-15T12:38:47+0000"
    }
  ]
}

Verwende anschließend den im id-Feld zurückgegebenen Wert, um eine Auswahl von Fehlern und Warnungen abzurufen.

Anfrage

GET https://graph.facebook.com/vX.X/{upload-session-id}/errors

Beispielantwort

Ein Schweregrad von fatal bedeutet, dass das Element von Meta nicht verarbeitet werden kann; ein Schweregrad von warning bedeutet, dass einige empfohlene Attribute fehlen oder fehlerhaft sind.

{
  "data": [
    {
      "id": 1510567479166488,
      "summary": "A required field is missing: price.",
      "description": "Products need to have prices to run in ads. Include a price for each product in your data feed file and upload it again. Prices must include cost and an ISO currency code (for example: 10 USD instead of $10 for American dollars).",
      "severity": "fatal",
      "samples": {
        "data": [
          {
            "row_number": 2,
            "retailer_id": "yj9bpbpub5t8t22kgbq6",
            "id": "1677559492523068"
          },
          {
            "row_number": 5,
            "retailer_id": "ujn33tvbyv2vmdpo7ecb",
            "id": "1529743440653137"
          }
        ]
      }
    },
    {
      "id": 275241589314958,
      "summary": "GTIN is incorrectly formatted",
      "description": "Check that the GTIN (Global Trade Identification Number) for each of your products is in the correct format. Accepted types include UPC, EAN, JAN, and ISBN.",
      "severity": "warning",
      "samples": {
        "data": [
          {
            "row_number": 4,
            "retailer_id": "bxwb1pho9o43uxjxikcg",
            "id": "538700559625644"
          }
        ]
      }
    }
  ]
}

Mehr erfahren

• Fehlerbehebung bei Daten-Feeds, Hilfebereich für Anzeigen
• Katalog- und Signalqualität
• Daten-Feed-Feldvorgaben für Kataloge, Hilfebereich für Anzeigen
• Katalog- und Signalqualität
• Catalog Batch API, Advantage+ Catalog Ads
• Catalog Batch API, Handel
• Daten-Feed, Referenz
• Daten-Feeds im Katalog, Referenz
• Referenz zur Feed API
• Geplanter Daten-Feed-Abruf, Referenz
• Filterregeln, Referenz
• Produktkatalog-Batch, Referenz
• Produktkatalog-Objekte-Batch, Referenz
• Status von Batch-Anfragen für Produktkatalog prüfen, Referenz
• Produkt-Feed-Plan, Referenz
• Produkt-Feed-Upload, Referenz
• Produktartikel, Referenz
• Produktsuche im Katalog, Referenz
• Live-Schulung zu Katalogen, Blueprint