Angenommen, Sie möchten Informationen zu den Produkten abrufen, die derzeit in Ihrem Konto verfügbar sind. Insbesondere möchten Sie wissen, ob es bei einem Ihrer Produkte Probleme gibt, die behoben werden müssen. Sie wissen, wie Sie diese Informationen aus dem Merchant Center beziehen, möchten aber lieber ein automatisches Benachrichtigungssystem mithilfe der Content API einrichten. In diesem Leitfaden wird erläutert, wie die Informationen zum Schweregrad des Problems in der Content API der Problempriorisierung in den Diagnoseberichten im Merchant Center zugeordnet werden.
Beispiel mit der Content API
Um die Probleme zu ermitteln, die sich auf Ihre Produkte auswirken, können Sie accountstatuses.get für Ihr Konto ausführen. Hier ist ein Beispiel für die zurückgegebene Ressource:
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
Unter accountLevelIssues[].severity wird der Schweregrad der Merchant Center-Kontofehler angezeigt. Critical-Fehler führen zu einer Kontosperrung. Sie können Ihre Produkte dann nicht mehr präsentieren.
Unter itemLevelIssues sehen Sie die Produktfehler, die zu Produktablehnungen führen können. itemLevelIssues[].numItems teilt Ihnen mit, dass 2 Elemente in Ihrem Konto von einem fehlerhaften Bildlink betroffen sind und 5 Elemente einen Landingpage-Fehler haben.
Unter itemLevelIssues[].servability können Sie sehen, ob der Fehler zur Ablehnung der betroffenen Produkte führt. Beachten Sie, dass sowohl der fehlerhafte Bildlink als auch der Landingpage-Fehler dazu führen, dass die Produkte abgelehnt werden.
Rufen Sie Productstatuses.list auf, um eine vollständige Liste der Probleme für jedes Produkt zu erhalten. Es werden Einträge wie die folgenden zurückgegeben:
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
Jetzt haben Sie Informationen zu den Problemen mit allen Produkten in Ihrem Konto, aber es ist unklar, wie wichtig es ist, diese Probleme zu beheben.
In unserem productstatuses-Beispiel können Sie itemLevelIssues[].servability verwenden, um festzustellen, ob ein Fehler Sie daran hindert, das Produkt in Buy on Google, Shopping-Anzeigen oder Plattformen auf Google zu präsentieren.
Wenn itemLevelIssues[].servability wie der Fehler ambiguous_gtin unaffected ist, verhindert der Fehler nicht die Bereitstellung Ihres Produkts.
Wenn itemLevelIssues[].servability jedoch disapproved wie der Fehler mobile_landing_page_crawling_not_allowed ist, ist dies ein viel schwerwiegenderer Fehler, da Sie Ihr Produkt erst dann bereitstellen können, wenn der Fehler behoben wurde.
In unserem accountstatuses-Beispiel werden unter accountLevelIssues[].severity im Abschnitt „Diagnose“ im Merchant Center die Problempriorisierung und die genaue Bedeutung der verschiedenen Prioritäten definiert.
Werfen Sie zuerst einen Blick auf den Bericht:
Wie hängen die Informationen, die Sie von der Content API for Shopping erhalten, mit den Informationen im Abschnitt „Diagnose“ zusammen? Welche Einträge müssen Sie so schnell wie möglich beheben, und welche davon wären schön zu beheben, müssen aber nicht unbedingt behoben werden? Welche Probleme verhindern, dass Ihre Produkte in Ihren Anzeigen präsentiert werden, wenn sie nicht behoben werden?
Wie in diesen Beispielen gezeigt, enthält der Abschnitt „Diagnose“ Informationen zu Schweregraden für das Konto und die Produkte in diesem Konto, während die Content API (über den Dienst Accountstatuses) nur Informationen zu Schweregraden für Probleme vom Typ accountLevel bereitstellt.
Bei jeder Quelle werden Probleme je nach Schweregrad in drei Kategorien unterteilt. Wenn Sie wissen, wie Sie den Schweregrad der von den statusbezogenen Diensten zurückgegebenen Problemen beurteilen können, können Sie schnell erkennen, welche Probleme am wichtigsten sind und welche ignoriert werden können.
Priorisierung von Problemen
Im Abschnitt „Diagnose“ wird in der Priorisierung der Problemschweregrad als eine von drei Ebenen beschrieben: Fehler, Warnungen und Benachrichtigungen. In Berichtstabellen wie der obigen werden diese Ebenen durch Bilder dargestellt, die in der ersten Spalte angezeigt werden: 
für Fehler, 
für Warnungen und 
für Benachrichtigungen.
Fehler haben entweder zu einer Kontosperrung oder einer Artikelablehnung geführt. Sie sollten so schnell wie möglich behoben werden, damit die Elemente wieder in den Suchergebnissen angezeigt werden können.
Warnungen können sich negativ auf die Leistung Ihrer Anzeigen auswirken und voraussichtlich in Zukunft zu einer Artikel- oder Kontosperrung führen, wenn das Problem nicht behoben wird.
Benachrichtigungen enthalten Optimierungsvorschläge zur Verbesserung der Datenqualität. Die Behebung dieser Probleme wird empfohlen, ist aber nicht zwingend erforderlich.
Wir brauchen das Merchant Center jedoch nicht aufzurufen, um herauszufinden, welche Fehler es sind.
In der Content API liefert das Feld accountLevelIssues[].severity in den Ressourcenobjekten accountstatuses dieselben Informationen zum Schweregrad des Problems. Diese Felder können einen von drei Werten enthalten: critical, error und suggestion.
Diese Werte stimmen genau mit der Problempriorisierung auf dem Tab „Diagnose“ überein:
| Schweregrad des Problems mit der Datenqualität (API) | Priorisierung von Problemen |
|---|---|
critical |
Fehler () |
error |
Warnung () |
suggestion |
Benachrichtigung () |
In unserem accountstatuses-Beispiel bedeutet das Problem missing_ad_words_link, dass Sie ein Google Ads-Konto verknüpfen müssen, um Anzeigen auszuliefern. Dies hat jedoch keinen Einfluss auf die Genehmigung des Produkts in der Merchant Center-Datenbank.
Andererseits ist editorial_and_professional_standards_destination_url_down_policy ein schwerwiegenderer Fehler, durch den Ihr Konto gesperrt wird. Wenn Sie an Buy on Google oder Google-Plattformen teilnehmen oder ein verknüpftes Google Ads-Konto haben, werden Ihre Produkte durch den Fehler critical nicht mehr in den Programmen Buy on Google, Plattformen auf Google und Shopping-Anzeigen präsentiert.
Auf Grundlage dieser Informationen können Sie jetzt Benachrichtigungssoftware erstellen, die Sie sofort auf wichtige Probleme aufmerksam macht und weniger schwerwiegende Probleme für eine deren Behebung aufzeichnet, ohne das Merchant Center aufrufen zu müssen, um festzustellen, welches das ist.