Załóżmy, że chcesz uzyskać informacje o produktach obecnie dostępnych na Twoim koncie. W szczególności chcesz wiedzieć, czy w przypadku którychś z Twoich produktów występują problemy, które trzeba rozwiązać. Wiesz, jak uzyskać te informacje z Merchant Center, ale wolisz skonfigurować system automatycznych 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 priorytety problemów widoczne w raportach Diagnostyka w Merchant Center.
Przykład z Content API
Aby rozwiązać problemy dotyczące produktów, możesz uruchomić na swoim koncie accountstatuses.get. Oto skrócony przykład odzyskanych zasobów:
{
"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 na koncie Merchant Center. Błędy (Critical) spowodują zawieszenie konta, co uniemożliwi Ci wyświetlanie produktów.
W sekcji itemLevelIssues zobaczysz błędy, które mogą doprowadzić do odrzucenia produktów. Pamiętaj, że itemLevelIssues[].numItems informuje, że w przypadku 2 produktów na Twoim koncie występuje uszkodzony link do zdjęcia, a w 5 – 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 powoduje odrzucenie produktów.
Aby znaleźć wszystkie produkty, których dotyczą te problemy, zadzwoń pod numer Productstatuses.list, aby uzyskać pełną listę problemów z poszczególnymi usługami. Zwraca 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 już informacje o problemach ze wszystkimi produktami na koncie, ale nie wiesz, jak ważne jest ich rozwiązanie.
W przykładzie productstatuses możesz użyć funkcji 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, czyli ambiguous_gtin, błąd nie uniemożliwi wyświetlania produktu.
Jeśli jednak itemLevelIssues[].servability ma wartość disapproved, tak jak błąd mobile_landing_page_crawling_not_allowed, jest to znacznie poważniejszy błąd, ponieważ nie możesz wyświetlać produktu do czasu jego naprawienia.
W naszym przykładzie (accountstatuses) w sekcji accountLevelIssues[].severity sekcja Diagnostyka w Merchant Center zawiera informacje o priorytetach poszczególnych problemów i ich znaczeniu.
Najpierw spójrz na raport:
Jak wszystkie informacje otrzymywane z interfejsu Content API for Shopping są powiązane z danymi w sekcji Diagnostyka? Które wpisy to problemy, które trzeba jak najszybciej rozwiązać, a które warto sobie z nimi radzić, ale nie jest niezbędna? Które problemy spowodują, że produkty nie będą się wyświetlać w reklamach, jeśli nie zostaną rozwiązane?
Jak widać w tych przykładach, sekcja Diagnostyka zawiera informacje o wadze problemów na koncie i na tym koncie, a interfejs Content API (za pomocą usługi Accountstatuses) podaje informacje o wadze tylko w przypadku accountLevel problemów.
Każde źródło dzieli problemy na 3 kategorie w zależności od wagi problemu. Znajomość metody oceny wagi problemów zwracanych z usług związanych ze stanem może pomóc w szybkim wskazaniu, które problemy należy rozwiązać, a które można bezpiecznie zignorować.
Priorytety
W sekcji Diagnostyka priorytet problemu określa wagę problemu na 1 z 3 poziomów: błędów, ostrzeżeń i powiadomień. W tabelach raportów, takich jak wspomniany wyżej, poziomy są reprezentowane przez obrazy widoczne w pierwszej kolumnie: 
– błędy, 
– ostrzeżenia, i 
– powiadomienia.
Błędy spowodowały zawieszenie konta lub odrzucenie produktu. Rozwiąż je jak najszybciej, aby produkty mogły znów być wyświetlane w wynikach.
Ostrzeżenia mogą negatywnie wpłynąć na skuteczność reklam i prawdopodobnie doprowadzą w przyszłości do zawieszenia produktu lub konta, chyba że problem 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 jednak odwiedzać konta Merchant Center, aby sprawdzić, które błędy są które.
W interfejsie 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.
Te wartości są powiązane z priorytetem problemu na karcie Diagnostyka:
| Poziom ważności problemu z jakością danych (interfejs API) | Nadawanie priorytetów problemom |
|---|---|
critical |
Błąd () |
error |
Ostrzeżenie () |
suggestion |
Powiadomienie () |
W naszym przykładzie (accountstatuses) problem z missing_ad_words_link informuje, że aby wyświetlać reklamy, musisz połączyć konto Google Ads. Nie wpływa to jednak 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 korzystasz z usługi Kup przez Google lub przestrzeni Google albo masz połączone konto Google Ads, błąd critical uniemożliwia natychmiastowe wyświetlanie Twoich produktów w programie 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 będzie zbierać mniej poważne problemy w celu ich rozwiązania. Nie musisz odwiedzać Merchant Center, aby sprawdzać, która opcja jest najważniejsza.