アカウントで現在購入可能な商品に関する情報を取得するとします。特に、対処が必要な問題があるプロダクトがあるかどうかを確認する必要があります。この情報を Merchant Center から取得する方法は理解しましたが、Content API を使用して自動アラート システムをセットアップしたいと考えています。このガイドでは、Content API に表示される問題の重大度の情報が、Merchant Center の診断レポートに表示される問題の優先順位にどのようにマッピングされるかについて説明します。
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
に、Merchant Center アカウントのエラーの重大度が表示されます。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
の Merchant Center の [診断] セクションで、問題の優先順位付けと、さまざまな優先順位の正確な意味が定義されています。
まず、レポートを見てみましょう。
Content API for Shopping から取得するすべての情報と、[診断] セクションに表示される情報とはどのように関連していますか。どのエントリができるだけ早く修正する必要がある問題で、どのエントリに取り組みたほうがよいが、修正が必須ではないエントリはどれか。対処しない場合、広告で商品の配信が停止する問題はどれですか。
上記の例に示すように、[診断] セクションにはアカウントとアカウント上の商品の問題に関する重大度情報が表示されますが、Content API(Accountstatuses
サービス経由)では accountLevel
の問題のみの重大度情報が表示されます。
各ソースは、問題の重大度に基づいて問題を 3 つのカテゴリに分類します。ステータス関連のサービスから返された問題の重大度を判断する方法を理解することで、対処すべき最も重要な問題と無視しても問題ない問題をすばやく特定できます。
問題の優先順位付け
[診断] セクションでは、問題の重大度がエラー、警告、通知の 3 つのレベルのいずれかとして表示されます。上記のようなレポートの表では、これらのレベルは最初の列に表示される画像で表されます。エラーは 、警告は
、通知は
です。
エラーが発生したため、アカウントが停止されているか、商品アイテムが不承認になりました。項目が再び検索結果に表示されるようにするには、できるだけ早く解決する必要があります。
警告は、広告のパフォーマンスに悪影響を及ぼす可能性があり、問題が解消されなければ、将来的に商品またはアカウントが強制停止される可能性があります。
通知は、データ品質を向上させるために推奨される最適化です。これらの問題の解決が推奨されますが、必須ではありません。
ただし、どのエラーが何であるかを確認するのに Merchant Center にアクセスする必要はありません。Content API では、accountstatuses
リソース オブジェクトの accountLevelIssues[].severity
フィールドに同じ問題の重大度情報が表示されます。これらのフィールドには、critical
、error
、suggestion
の 3 つの値のいずれかを含めることができます。
これらの値は、[診断] タブに表示される問題の優先順位付けと 1 対 1 で対応しています。
データ品質の問題の重大度(API) | 問題の優先順位付け |
---|---|
critical |
エラー( |
error |
警告( |
suggestion |
通知( |
accountstatuses
の例では、missing_ad_words_link
の問題により、広告を配信するために Google 広告アカウントをリンクする必要があることがわかりますが、Merchant Center データベースでの商品の承認には影響しません。一方、editorial_and_professional_standards_destination_url_down_policy
はアカウントを停止するより重大なエラーです。「Google で購入」や「Google に掲載」に参加している場合、またはリンクされた Google 広告アカウントがある場合は、critical
エラーが発生すると、「Google で購入」、「Google 掲載」、「ショッピング広告」の各プログラムで商品が直ちに配信されなくなります。
この情報により、重要な問題をすぐに注意喚起するアラート ソフトウェアを作成でき、最終的にはそれほど深刻でない問題を収集して最終的に修正できます。Merchant Center にアクセスしてどちらなのかを見分ける必要はありません。