Hesabınızda bulunan ürünler hakkında bilgi edinmek istediğinizi varsayalım. Özellikle, ürünlerinizden herhangi birinde ele alınması gereken sorunlar olup olmadığını öğrenmek istiyorsunuz. Bu bilgileri Merchant Center'dan nasıl alacağınızı biliyorsunuz ancak Content API'yi kullanarak otomatik uyarı sistemi oluşturmak istiyorsunuz. Bu kılavuzda, Content API'deki sorun önem derecesi bilgilerinin Merchant Center'daki Teşhis raporlarında görülen sorun önceliklendirmesiyle nasıl eşleştiği ele alınmaktadır.
Content API ile örnek
Ürünlerinizi etkileyen sorunları görmek için hesabınız için accountstatuses.get çalıştırabilirsiniz. Aşağıda, döndürülen kaynağın kısaltılmış bir örneği verilmiştir:
{
"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 altında, Merchant Center hesap hatalarının önem derecesini görürsünüz. Critical hataları, hesabınızın askıya alınmasına neden olur. Bu da ürünlerinizi yayınlamanızı engeller.
itemLevelIssues bölümünde, ürünlerin reddedilmesine neden olabilecek ürün hatalarını görebilirsiniz. itemLevelIssues[].numItems, hesabınızdaki 2 öğenin bozuk resim bağlantısından, 5 öğenin ise açılış sayfası hatasından etkilendiğini gösterir.
itemLevelIssues[].servability bölümünde, hatanın etkilenen ürünlerin reddedilmesine neden olup olmadığını görebilirsiniz. Hem bozuk resim bağlantısı hem de açılış sayfası hatası, ürünlerin onaylanmaması sonucuna yol açar.
Etkilenen tüm ürünleri bulmak için Productstatuses.list numaralı telefonu arayarak ürün bazında sorunların tam listesini alabilirsiniz. Aşağıdaki gibi girişler döndürür:
{
"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"
}
],
...
},
...
]
}
Artık hesabınızdaki tüm ürünlerle ilgili sorunlar hakkında bilgi sahibisiniz ancak bu sorunların düzeltilmesinin ne kadar önemli olduğu net değil.
productstatuses örneğimizde, bir hatanın ürünü Google ile Satın Al, Alışveriş reklamları veya Google platformlarındaki yüzeylerde yayınlama özelliğinizi devre dışı bırakıp bırakmadığını öğrenmek için itemLevelIssues[].servability değerini kullanabilirsiniz.
itemLevelIssues[].servability, ambiguous_gtin hatası gibi unaffected ise hata, ürününüzün yayınlanmasını engellemez.
Ancak itemLevelIssues[].servability, mobile_landing_page_crawling_not_allowed hatası gibi disapproved ise hata düzeltilene kadar ürününüzü yayınlayamadığınız için bu çok daha ciddi bir hatadır.
accountstatuses örneğimizde, accountLevelIssues[].severity altında Merchant Center'daki Teşhis bölümünde sorun öncelikleri ve farklı önceliklerin tam olarak ne anlama geldiği açıklanmaktadır.
Öncelikle rapora göz atın:
Content API for Shopping'den aldığınız tüm bilgiler Teşhis bölümünde gördüklerinizle nasıl ilişkilendirilir? Hangi girişler en kısa sürede düzeltmeniz gereken sorunlar, hangileri düzeltilmesi iyi olur ancak düzeltilmesi zorunlu değildir? Hangi sorunlar giderilmezse ürünlerinizin reklamlarınızda yayınlanması durdurulur?
Bu örneklerde gösterildiği gibi, Teşhis Aracı bölümü hesap ve hesaptaki ürünlerle ilgili sorunlarla ilgili önem düzeyi bilgilerini sağlar. Content API ise (Accountstatuses hizmeti aracılığıyla) yalnızca accountLevel sorunlarıyla ilgili önem düzeyi bilgilerini sağlar.
Her kaynak, sorunların önem derecesine göre üç kategoriye ayırır. Durumla ilgili hizmetlerden döndürülen sorunların önem derecesini nasıl değerlendireceğinizi anlamak, ele alınması en önemli sorunların hangileri olduğunu ve hangi sorunların güvenli bir şekilde göz ardı edilebileceğini hızlı bir şekilde belirlemenize yardımcı olabilir.
Sorunları önceliklendirme
Teşhis bölümündeki sorun önceliği, sorunun önem derecesini üç düzeyden biri olarak açıklar: hatalar, uyarılar ve bildirimler. Yukarıdaki gibi rapor tablolarında bu seviyeler ilk sütunda görünen resimlerle temsil edilir: Hatalar için 
, uyarılar için 
ve bildirimler için 
.
Hatalar, hesabın askıya alınmasına veya öğenin reddedilmesine neden oldu. Öğelerin sonuçlarda tekrar görünmeye uygun olması için bu sorunlar en kısa sürede çözülmelidir.
Uyarılar, reklamlarınızın performansını olumsuz etkileyebilir ve sorunun çözülmemesi halinde gelecekte öğelerin veya hesabın askıya alınmasına neden olabilir.
Bildirimler, veri kalitesini artırmak için önerilen optimizasyonlardır. Bu sorunların çözülmesi önerilir ancak zorunlu değildir.
Ancak hangi hataların hangileri olduğunu öğrenmek için Merchant Center'ı ziyaret etmemiz gerekmez.
Content API'de, accountstatuses kaynak nesnelerindeki accountLevelIssues[].severity alanı aynı sorun önem derecesi bilgilerini sağlar. Bu alanlar üç değerden birini içerebilir:
critical, error ve suggestion.
Bu değerler, Teşhis sekmesindeki sorun önceliklendirmesiyle bire bir ilişkilidir:
| Veri Kalitesi Sorunu Önem Düzeyi (API) | Sorunları önceliklendirme |
|---|---|
critical |
Hata () |
error |
Uyarı () |
suggestion |
Bildirim () |
Bu nedenle, accountstatuses örneğimizdeki missing_ad_words_link sorunu, reklam yayınlamak için bir Google Ads hesabı bağlamanız gerektiğini bildirir ancak ürünün Merchant Center veritabanınızdaki onaylanmasını etkilemez.
Öte yandan, editorial_and_professional_standards_destination_url_down_policy, hesabınızı askıya alan daha ciddi bir hatadır. Google ile Satın Al ve Google'daki Platformlar programlarına katılıyorsanız veya bağlı bir Google Ads hesabınız varsa critical hatası, ürünlerinizin Google ile Satın Al, Google'daki Platformlar ve Alışveriş reklamları programlarında yayınlanmasını hemen durdurur.
Bu bilgilerle artık, hangilerinin önemli hangilerinin daha az önemli olduğunu anlamak için Merchant Center'ı ziyaret etmek zorunda kalmadan, önemli sorunları hemen dikkatinize sunacak ve daha az ciddi sorunları düzeltmek üzere toplayacak uyarı yazılımları yazabilirsiniz.