Angenommen, Sie möchten Informationen zu den Produkten erhalten, 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 bereits, wie Sie diese Informationen im Merchant Center abrufen, möchten aber lieber ein automatisches Benachrichtigungssystem mithilfe der Content API einrichten. In diesem Leitfaden wird erläutert, wie die Angaben zum Schweregrad des Problems in der Content API der Problempriorisierung in den Diagnoseberichten im Merchant Center zugeordnet werden.
Beispiel mit Content API
Um die Probleme mit Ihren Produkten zu erhalten, können Sie accountstatuses.get für Ihr Konto ausführen. Hier ein verkürztes Beispiel für die Ressource, die du erhältst:
{
"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 ist der Schweregrad der Fehler im Merchant Center-Konto angegeben. Fehler des Typs Critical führen zu einer Kontosperrung. Sie können dann Ihre Produkte nicht mehr präsentieren.
Unter itemLevelIssues sehen Sie die Produktfehler, die zu Produktablehnungen führen können. Hinweis: itemLevelIssues[].numItems teilt Ihnen mit, dass zwei Artikel in Ihrem Konto von einem fehlerhaften Bildlink betroffen sind und bei fünf Artikeln ein Landingpagefehler aufgetreten ist.
Unter itemLevelIssues[].servability können Sie sehen, ob der Fehler dazu führt, dass die betroffenen Produkte abgelehnt werden. Beachten Sie, dass sowohl der fehlerhafte Bildlink als auch der Landingpage-Fehler dazu führen, dass Produkte abgelehnt werden.
Wenn Sie alle betroffenen Produkte ermitteln möchten, rufen Sie Productstatuses.list auf, um eine vollständige Liste der Probleme für jedes Produkt abzurufen. Sie gibt Einträge wie die folgenden zurück:
{
"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 für alle Produkte in Ihrem Konto, aber es ist unklar, wie wichtig es ist, sie zu beheben.
In unserem productstatuses-Beispiel kannst du itemLevelIssues[].servability verwenden, um festzustellen, ob es aufgrund eines Fehlers nicht möglich ist, 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, dass Ihr Produkt bereitgestellt wird.
Wenn itemLevelIssues[].servability jedoch disapproved ist wie der Fehler mobile_landing_page_crawling_not_allowed, ist dies ein viel schwerwiegenderer Fehler, da Sie das Produkt erst ausliefern können, wenn der Fehler behoben wurde.
In unserem accountstatuses-Beispiel unter accountLevelIssues[].severity wird im Abschnitt „Diagnose“ im Merchant Center die Problempriorisierung und die Bedeutung der verschiedenen Prioritäten genau definiert.
Werfen Sie zuerst einen Blick auf den Bericht:
Wie hängen die Informationen, die Sie über die Content API for Shopping erhalten, mit den Informationen im Bereich „Diagnose“ zusammen? Bei welchen Einträgen muss es sich um ein Problem handeln, das Sie so schnell wie möglich beheben müssen, und welche wären nett, aber nicht unbedingt zu beheben? Welche Probleme verhindern, dass Ihre Produkte in Ihren Anzeigen präsentiert werden, wenn Sie das Problem nicht beheben?
Wie in diesen Beispielen gezeigt, enthält der Abschnitt „Diagnose“ Informationen zu Schweregraden von Problemen mit dem Konto und den Produkten in diesem Konto. Die Content API (über den Accountstatuses-Dienst) liefert ausschließlich Informationen zu Schweregraden für accountLevel-Probleme.
Jede Quelle teilt Probleme je nach Schweregrad in drei Kategorien ein. Wenn Sie wissen, wie der Schweregrad der von den statusbezogenen Diensten zurückgegebenen Probleme beurteilt wird, können Sie schnell ermitteln, welche Probleme am wichtigsten sind und welche Probleme bedenkenlos ignoriert werden können.
Priorisierung von Problemen
Im Abschnitt „Diagnose“ wird durch die Problempriorisierung der Schweregrad des Problems auf einer von drei Ebenen beschrieben: Fehler, Warnungen und Benachrichtigungen. In Berichtstabellen wie oben werden diese Ebenen durch Bilder in der ersten Spalte dargestellt: 
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 Ergebnissen angezeigt werden können.
Warnungen können sich negativ auf die Leistung Ihrer Anzeigen auswirken und führen wahrscheinlich zu einer Artikel- oder Kontosperrung, wenn das Problem nicht behoben wird.
Benachrichtigungen sind Optimierungsvorschläge zur Verbesserung der Datenqualität. Die Behebung dieser Probleme wird empfohlen, ist aber nicht zwingend erforderlich.
Wir müssen jedoch nicht im Merchant Center nachsehen, welche Fehler aufgetreten sind.
In der Content API enthält 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 entsprechen genau der Problempriorisierung auf dem Tab „Diagnose“:
| Schweregrad von Problemen mit der Datenqualität (API) | Priorisierung von Problemen |
|---|---|
critical |
Fehler () |
error |
Warnung () |
suggestion |
Benachrichtigung () |
In unserem Beispiel accountstatuses gibt das Problem missing_ad_words_link an, dass Sie ein Google Ads-Konto verknüpfen müssen, um Anzeigen auszuliefern. Es hat jedoch keinen Einfluss auf die Genehmigung des Produkts in Ihrer Merchant Center-Datenbank.
Der editorial_and_professional_standards_destination_url_down_policy-Fehler ist hingegen ein schwerwiegenderer Fehler, der dazu führt, dass Ihr Konto gesperrt wird. Wenn Sie Buy on Google, Plattformen auf Google nutzen oder ein verknüpftes Google Ads-Konto hatten, verhindert der Fehler critical, dass Ihre Produkte sofort in Buy on Google, Plattformen auf Google und Shopping-Anzeigen präsentiert werden.
Ausgerüstet mit diesen Informationen können Sie nun Benachrichtigungssoftware erstellen, die Sie auf wichtige Probleme sofort aufmerksam macht und weniger schwerwiegende Probleme zur anschließenden Behebung erfasst, ohne das Merchant Center aufrufen zu müssen.