Załóżmy, że chcesz uzyskać informacje o produktach dostępnych obecnie na Twoim koncie. Interesuje Cię w szczególności, czy któryś z Twoich produktów ma problemy, które trzeba rozwiązać. Wiesz, jak uzyskać te informacje z Merchant Center, ale wolisz skonfigurować automatyczny system alertów za pomocą Content API. W tym przewodniku omówimy, w jaki sposób informacje o wadze problemu w Content API są mapowane na priorytet problemu widoczny w raportach Diagnostyka w Merchant Center.
Przykład w Content API
Aby uzyskać informacje o problemach, które wpływają na produkty, możesz uruchomić na swoim koncie usługę accountstatuses.get. Oto przykład skróconego zasobu, który możesz odzyskać:
{
"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 wagę błędów konta Merchant Center. Critical błędu spowoduje zawieszenie konta i przerwanie wyświetlania produktów.
W sekcji itemLevelIssues znajdziesz błędy dotyczące produktów, które mogą doprowadzić do odrzucenia produktów. Pamiętaj, że itemLevelIssues[].numItems informuje, że uszkodzony link do zdjęcia dotyczy 2 produktów na Twoim koncie, 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 problem. Pamiętaj, że zarówno uszkodzony link do zdjęcia, jak i błąd strony docelowej powodują odrzucenie produktów.
Aby znaleźć wszystkie produkty, których dotyczy problem, wywołaj metodę Productstatuses.list, aby uzyskać pełną listę problemów poszczególnych produktów. Zwraca takie informacje:
{
"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 już informacje o problemach związanych ze wszystkimi produktami na Twoim koncie, ale nie wiesz, jak ważne jest ich rozwiązanie.
W naszym przykładzie productstatuses możesz użyć itemLevelIssues[].servability, aby sprawdzić, czy błąd uniemożliwia wyświetlanie produktu w Kup przez Google, reklamach produktowych lub przestrzeni Google.
Jeśli itemLevelIssues[].servability ma wartość unaffected jak błąd ambiguous_gtin, błąd nie uniemożliwi wyświetlania produktu.
Jeśli jednak itemLevelIssues[].servability to disapproved jak błąd mobile_landing_page_crawling_not_allowed, jest to znacznie poważniejszy błąd, ponieważ nie możesz wyświetlać produktu, dopóki błąd nie zostanie naprawiony.
W przykładzie accountstatuses w sekcji accountLevelIssues[].severity sekcja Diagnostyka w Merchant Center definiuje priorytety problemów i precyzyjnie, co oznaczają poszczególne priorytety.
Najpierw spójrz na raport:
W jaki sposób wszystkie informacje, które otrzymujesz z Content API for Shopping, są powiązane z danymi w sekcji Diagnostyka? Które wpisy to problemy, które trzeba szybko rozwiązać, a które można by rozwiązać, ale nie są niezbędne? Które z tych problemów uniemożliwią wyświetlanie reklam produktów, jeśli ich nie rozwiążesz?
Jak pokazano w tych przykładach, sekcja Diagnostyka zawiera informacje o wadze problemów związanych z kontem i produktami na tym koncie, a Content API (za pomocą usługi Accountstatuses) udostępnia informacje o wadze wyłącznie w przypadku problemów ze stanem accountLevel.
Każde źródło dzieli problemy na 3 kategorie w zależności od wagi problemu. Wiedza o tym, jak ocenić wagę problemów zwracanych z usług związanych ze stanem, może pomóc w szybkim określeniu, które problemy są najważniejsze, a które można bezpiecznie zignorować.
Priorytety
W sekcji Diagnostyka priorytety mogą być podzielone na 3 poziomy: błędy, ostrzeżenia lub powiadomienia. W tabelach raportu podobnych do przedstawionych powyżej poziomy reprezentowane są przez obrazy pojawiające się w pierwszej kolumnie: 
– błędy, 
– ostrzeżenia i 
– powiadomienia.
Błędy spowodowały zawieszenie konta lub odrzucenie produktu. Aby produkty mogły znów wyświetlać się w wynikach wyszukiwania, trzeba je jak najszybciej rozwiązać.
Ostrzeżenia mogą niekorzystnie wpływać na skuteczność reklam i prawdopodobnie doprowadzą w przyszłości do zawieszenia produktu lub konta, jeśli problem nie zostanie rozwiązany.
Powiadomienia to sugerowane optymalizacje pozwalające poprawić jakość danych. Zalecamy rozwiązanie tych problemów, ale nie jest to wymagane.
Nie musimy 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 wadze problemu. Te pola mogą zawierać jedną z 3 wartości: critical, error i suggestion.
Wartości te mają bezpośredni związek z ustalaniem priorytetów problemów na karcie Diagnostyka:
| Waga problemu z jakością danych (API) | Priorytety problemów |
|---|---|
critical |
Błąd () |
error |
Ostrzeżenie () |
suggestion |
Powiadomienie () |
Zatem w naszym przykładzie z accountstatuses problem z missing_ad_words_link informuje, że aby wyświetlać reklamy, musisz połączyć konto Google Ads, ale nie wpłynie to na zatwierdzenie produktu w bazie danych Merchant Center.
Z drugiej strony editorial_and_professional_standards_destination_url_down_policy to poważniejszy błąd, który powoduje zawieszenie konta. Jeśli korzystasz z usługi Kup przez Google lub przestrzeni Google albo masz połączone konto Google Ads, błąd critical spowoduje natychmiastowe zatrzymanie wyświetlania Twoich produktów w programach Kup przez Google, przestrzeni Google i reklam produktowych.
Dzięki tym informacjom możesz teraz tworzyć oprogramowanie do tworzenia alertów, które natychmiast zwróci Twoją uwagę na ważne problemy, a jednocześnie zbierze mniej poważne problemy do ostatecznego ich usunięcia bez konieczności odwiedzania Merchant Center, aby rozróżnić, które z nich.