현재 계정에서 사용할 수 있는 제품에 관한 정보를 가져오려고 한다고 가정해 보겠습니다. 특히 해결해야 할 문제가 있는 제품이 있는지 알고 싶습니다. 판매자 센터에서 이 정보를 가져오는 방법을 알고 있지만 Content API를 사용하여 자동 알림 시스템을 설정하려고 합니다. 이 가이드에서는 Content API의 문제 심각도 정보가 판매자 센터의 진단 보고서에 표시되는 문제 우선순위 지정에 어떻게 매핑되는지 살펴보겠습니다.
Content API가 포함된 예
제품에 영향을 미치는 문제를 가져오려면 계정에 대해
accountstatuses.get
을 실행하면 됩니다. 다음은 반환되는 리소스의 축소된 예입니다.
{
"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"
}
]
},
...
}
accountLevelIssues[].severity에서 판매자 센터 계정 오류의 심각도를 확인할 수 있습니다. Critical 오류가 발생하면 계정이 정지되어 제품을 게재할 수 없게 됩니다.
itemLevelIssues에서 제품 비승인으로 이어질 수 있는 제품 오류를 확인할 수 있습니다. itemLevelIssues[].numItems를 사용하면 계정의 상품 2개가 깨진 이미지 링크의 영향을 받고 상품 5개에 방문 페이지 오류가 있음을 알 수 있습니다.
itemLevelIssues[].servability에서 오류로 인해 영향을 받는 제품이 비승인되는지 확인할 수 있습니다. 깨진 이미지 링크와 방문 페이지 오류로 인해 제품이 비승인됩니다.
영향을 받는 모든 제품을 찾으려면
Productstatuses.list
를 호출하여 제품별 문제의 전체 목록을 가져옵니다. 다음과 같은 항목을 반환합니다.
{
"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"
}
],
...
},
...
]
}
이제 계정의 모든 제품에 관한 문제 정보가 있지만 이러한 문제를 해결하는 것이 얼마나 중요한지는 알 수 없습니다.
productstatuses 예에서는 itemLevelIssues[].servability를 사용하여 오류로 인해 Google에서 구매, 쇼핑 광고 또는 Google 전반의 서피스에서 제품을 게재할 수 없게 되는지 확인할 수 있습니다.
ambiguous_gtin 오류와 같이 itemLevelIssues[].servability가 unaffected인 경우 오류로 인해 제품이 게재되지 않습니다.
하지만 mobile_landing_page_crawling_not_allowed 오류와 같이 itemLevelIssues[].servability가 disapproved인 경우 오류가 해결될 때까지 제품을 게재할 수 없으므로 훨씬 더 심각한 오류입니다.
accountstatuses 예에서 accountLevelIssues[].severity에 따라 판매자 센터의 진단 섹션은 문제 우선순위를 지정하고 다양한 우선순위의 의미를 정확하게 정의합니다.
먼저 보고서를 살펴보세요.
Content API for Shopping에서 가져오는 모든 정보는 진단 섹션에 표시되는 정보와 어떻게 관련이 있나요? 어떤 항목을 최대한 빨리 해결해야 하고, 어떤 항목을 해결하는 것이 좋지만 필수는 아닌가요? 해결하지 않으면 광고에서 제품이 게재되지 않는 문제는 무엇인가요?
이러한 예에서 볼 수 있듯이 진단 섹션은 계정 및 해당 계정의 제품에 관한 문제의 심각도 정보를 제공하는 반면 Content API(Accountstatuses 서비스를 통해)는 accountLevel 문제에 관한 심각도 정보만 제공합니다.
각 소스는 문제의 심각도에 따라 문제를 세 가지 카테고리로 나눕니다. 상태 관련 서비스에서 반환된 문제의 심각도를 판단하는 방법을 이해하면 해결해야 할 가장 중요한 문제와 무시해도 되는 문제를 빠르게 파악하는 데 도움이 됩니다.
문제 우선순위 지정
진단 섹션에서 문제 우선순위 지정은 문제 심각도를 오류, 경고, 알림의 세 가지 수준 중 하나로 설명합니다. 위와 같은 보고서 표에서 이러한 수준은 첫 번째 열에 표시되는 이미지로 표시됩니다. 오류의 경우 
, 경고의 경우 
, 알림의 경우 
입니다.
오류로 인해 계정이 정지되거나 상품이 비승인되었습니다. 상품이 결과에 다시 표시될 수 있도록 최대한 빨리 해결해야 합니다.
경고는 광고의 실적에 부정적인 영향을 미칠 수 있으며 문제를 해결하지 않을 경우 향후 상품 또는 계정 정지로 이어질 가능성이 높습니다.
알림은 데이터 품질을 높이기 위해 제안되는 최적화입니다. 이러한 문제를 해결하는 것이 좋지만 필수는 아닙니다.
하지만 판매자 센터를 방문하여 오류를 확인할 필요는 없습니다.
Content API에서 accountstatuses 리소스 객체의 accountLevelIssues[].severity 필드는 동일한 문제 심각도 정보를 제공합니다. 이러한 필드에는 critical, error, suggestion의 세 가지 값 중 하나가 포함될 수 있습니다.
이러한 값은 진단 탭의 문제 우선순위 지정 과 일대일로 대응됩니다.
| 데이터 품질 문제 심각도 (API) | 문제 우선순위 지정 |
|---|---|
critical |
오류 () |
error |
경고 () |
suggestion |
알림 () |
따라서 accountstatuses 예에서 missing_ad_words_link 문제는 광고를 게재하려면 Google Ads 계정을 연결해야 하지만 판매자 센터 데이터베이스에서 제품 승인에는 영향을 미치지 않는다는 것을 알려줍니다.
반면에 editorial_and_professional_standards_destination_url_down_policy는 계정을 정지시키는 더 심각한 오류입니다. Google에서 구매, Google 전반의 서피스에 참여하고 있거나 연결된 Google Ads 계정이 있는 경우 critical 오류로 인해 Google에서 구매, Google 전반의 서피스, 쇼핑 광고 프로그램에서 제품이 즉시 게재되지 않습니다.
이 정보를 바탕으로 이제 판매자 센터를 방문하여 문제를 구분할 필요 없이 중요한 문제를 즉시 파악하고 덜 심각한 문제를 수집하여 최종적으로 해결할 수 있는 알림 소프트웨어를 작성할 수 있습니다.