Załóżmy, że chcesz uzyskać informacje o produktach dostępnych obecnie na Twoim koncie. Chcesz w szczególności wiedzieć, czy któreś z Twoich produktów mają problemy, które wymagają rozwiązania. Wiesz, jak uzyskać te informacje z Merchant Center, ale wolisz skonfigurować automatyczny system alertów za pomocą Content API. W tym przewodniku wyjaśnimy, jak informacje o stopniu ważności problemu w interfejsie Content API są powiązane z priorytetami problemów w raportach diagnostycznych w Merchant Center.
Przykład z Content API
Aby uzyskać informacje o problemach wpływających na Twoje produkty, możesz uruchomić
accountstatuses.get
na swoim koncie. Oto skrócony przykład zwróconego zasobu:
{
"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"
}
]
},
...
}
W sekcji accountLevelIssues[].severity zobaczysz poziom ważności błędów na koncie Merchant Center. Błędy Critical spowodują zawieszenie konta, co uniemożliwi Ci wyświetlanie produktów.
W sekcji itemLevelIssues możesz zobaczyć błędy produktów, które mogą prowadzić do odrzucenia produktów. Zwróć uwagę, że symbol itemLevelIssues[].numItems informuje, że 2 produkty na Twoim koncie mają uszkodzony link do zdjęcia, a 5 produktów ma błąd strony docelowej.
W sekcji itemLevelIssues[].servability możesz sprawdzić, czy błąd powoduje odrzucenie produktów, których dotyczy. Pamiętaj, że zarówno uszkodzony link do obrazu, jak i błąd strony docelowej powodują odrzucenie produktów.
Aby znaleźć wszystkie produkty, których dotyczy problem, wywołaj funkcję
Productstatuses.list
i uzyskaj pełną listę problemów dotyczących poszczególnych produktów. Zwraca ona wpisy podobne do tych:
{
"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"
}
],
...
},
...
]
}
Masz teraz informacje o problemach dotyczących wszystkich produktów na Twoim koncie, ale nie wiesz, jak ważne jest ich rozwiązanie.
W naszym productstatuses przykładzie możesz użyć itemLevelIssues[].servability
aby sprawdzić, czy błąd uniemożliwia wyświetlanie produktu w usłudze
Kup w Google, reklamach produktowych lub przestrzeniach Google.
Jeśli itemLevelIssues[].servability jest unaffected, np. błąd ambiguous_gtin, nie uniemożliwi to wyświetlania produktu.
Jeśli jednak itemLevelIssues[].servability ma wartość disapproved, np. błąd mobile_landing_page_crawling_not_allowed, jest to znacznie poważniejszy błąd, ponieważ nie możesz wyświetlać produktu, dopóki nie zostanie on naprawiony.
W naszym accountstatusesprzykładzie w sekcji accountLevelIssues[].severityDiagnostyka w Merchant Center określono priorytety problemów i ich znaczenie.
Najpierw przyjrzyj się raportowi:
Jak wszystkie informacje uzyskane z Content API for Shopping mają się do tego, co widzisz w sekcji Diagnostyka? Które wpisy oznaczają problemy, które musisz jak najszybciej rozwiązać, a które warto rozwiązać, ale nie jest to konieczne? Które problemy uniemożliwią wyświetlanie produktów w reklamach, jeśli nie zostaną rozwiązane?
Jak widać na tych przykładach, sekcja Diagnostyka zawiera informacje o poziomie ważności problemów dotyczących konta i produktów na tym koncie, a Content API (za pomocą usługi Accountstatuses) podaje informacje o poziomie ważności wyłącznie w przypadku problemów accountLevel.
Każde źródło dzieli problemy na 3 kategorie w zależności od ich wagi. Zrozumienie, jak oceniać ważność problemów zwracanych przez usługi związane ze stanem, może pomóc szybko określić, które z nich są najważniejsze i które można bezpiecznie zignorować.
Priorytety
W sekcji Diagnostyka priorytetyzacja problemów opisuje ich ważność na 3 poziomach: błędy, ostrzeżenia i powiadomienia. W tabelach raportów, takich jak powyższa, te poziomy są reprezentowane przez obrazy, które pojawiają się w pierwszej kolumnie: 
w przypadku błędów, 
w przypadku ostrzeżeń i 
w przypadku powiadomień.
Błędy spowodowały zawieszenie konta lub odrzucenie produktu. Należy je jak najszybciej rozwiązać, aby produkty mogły ponownie wyświetlać się w wynikach.
Ostrzeżenia mogą negatywnie wpłynąć na skuteczność Twoich reklam i prawdopodobnie doprowadzą w przyszłości do zawieszenia produktu lub konta, jeśli nie rozwiążesz problemu.
Powiadomienia to sugerowane optymalizacje, które zwiększają jakość danych. Rozwiązanie tych problemów jest zalecane, ale nie wymagane.
Nie musimy jednak odwiedzać Merchant Center, aby dowiedzieć się, które błędy są które.
W Content API pole accountLevelIssues[].severity w obiektach zasobów accountstatuses zawiera te same informacje o ważności problemu. Pola te mogą zawierać jedną z 3 wartości: critical, error i suggestion.
Wartości te są powiązane z określaniem priorytetów problemów na karcie Diagnostyka:
| Poziom ważności problemu z jakością danych (API) | Priorytety |
|---|---|
critical |
Błąd () |
error |
Ostrzeżenie () |
suggestion |
Powiadomienie () |
W naszym accountstatuses przykładzie missing_ad_words_link problem informuje, że do wyświetlania reklam musisz połączyć konto Google Ads, ale nie wpłynie to na zatwierdzenie produktu w bazie danych Merchant Center.
Z kolei editorial_and_professional_standards_destination_url_down_policy to poważniejszy błąd, który powoduje zawieszenie konta. Jeśli uczestniczysz w programie Kup w Google lub Miejsca docelowe w Google albo masz połączone konto Google Ads, błąd critical natychmiast uniemożliwi wyświetlanie Twoich produktów w programach Kup w Google, Miejsca docelowe w Google i reklamach produktowych.
Dzięki tym informacjom możesz napisać oprogramowanie do alertów, które natychmiast zwróci Twoją uwagę na ważne problemy, a mniej poważne kwestie będzie gromadzić do późniejszego rozwiązania. Nie musisz w tym celu odwiedzać Merchant Center, aby odróżnić jedne od drugich.