ধরুন, আপনি আপনার অ্যাকাউন্টে বর্তমানে উপলব্ধ পণ্যগুলির তথ্য পেতে চান। বিশেষ করে, আপনি জানতে আগ্রহী যে আপনার কোনো পণ্যে এমন কোনো সমস্যা আছে কিনা যার সমাধান প্রয়োজন। আপনি জানেন মার্চেন্ট সেন্টার থেকে কীভাবে এই তথ্য পাওয়া যায়, কিন্তু আপনি বরং কন্টেন্ট এপিআই (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 আপনাকে জানায় যে আপনার অ্যাকাউন্টের ২টি আইটেম একটি ভাঙা ইমেজ লিঙ্কের কারণে প্রভাবিত হয়েছে এবং ৫টি আইটেমের ল্যান্ডিং পেজে ত্রুটি রয়েছে।
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 উদাহরণে, কোনো ত্রুটির কারণে Buy on Google, Shopping Ads, বা Surfaces across Google-এ পণ্যটি পরিবেশন করার ক্ষমতা নিষ্ক্রিয় হয়ে যায় কিনা, তা জানতে আপনি itemLevelIssues[].servability ব্যবহার করতে পারেন।
যদি ambiguous_gtin ত্রুটির মতো itemLevelIssues[].servability unaffected থাকে, তাহলে এই ত্রুটি আপনার পণ্য পরিবেশনে বাধা দেবে না।
তবে, যদি ` mobile_landing_page_crawling_not_allowed ত্রুটির মতো itemLevelIssues[].servability disapproved হয়, তবে এটি একটি অনেক বেশি গুরুতর ত্রুটি, কারণ ত্রুটিটি সমাধান না করা পর্যন্ত আপনি আপনার পণ্যটি পরিবেশন করতে পারবেন না।
আমাদের accountstatuses উদাহরণে, accountLevelIssues[].severity এর অধীনে, মার্চেন্ট সেন্টারের ডায়াগনস্টিকস সেকশনটি ইস্যুর অগ্রাধিকার এবং বিভিন্ন অগ্রাধিকারের সুনির্দিষ্ট অর্থ ব্যাখ্যা করে।
প্রথমে, প্রতিবেদনটি দেখুন:

শপিং-এর জন্য কন্টেন্ট এপিআই থেকে আপনি যে সমস্ত তথ্য পাচ্ছেন, তা ডায়াগনস্টিকস বিভাগে আপনি যা দেখছেন তার সাথে কীভাবে সম্পর্কিত? কোন এন্ট্রিগুলো এমন সমস্যা যা আপনার অবিলম্বে সমাধান করা প্রয়োজন, এবং কোনগুলো সমাধান করা ভালো, কিন্তু অপরিহার্য নয়? কোন সমস্যাগুলোর সমাধান না করা হলে আপনার বিজ্ঞাপনে পণ্যগুলো দেখানো বন্ধ হয়ে যাবে?
এই উদাহরণগুলিতে যেমন দেখানো হয়েছে, ডায়াগনস্টিকস বিভাগটি কোনো অ্যাকাউন্ট এবং সেই অ্যাকাউন্টের পণ্যগুলির সমস্যাগুলির তীব্রতার তথ্য প্রদান করে, অপরদিকে কন্টেন্ট এপিআই ( Accountstatuses পরিষেবার মাধ্যমে) শুধুমাত্র accountLevel সমস্যাগুলির তীব্রতার তথ্য প্রদান করে।
প্রতিটি উৎস সমস্যার তীব্রতার উপর ভিত্তি করে সেগুলোকে তিনটি শ্রেণীতে ভাগ করে। স্ট্যাটাস-সম্পর্কিত পরিষেবাগুলো থেকে প্রাপ্ত সমস্যাগুলোর তীব্রতা কীভাবে বিচার করতে হয় তা বুঝতে পারলে, কোন সমস্যাগুলো সমাধান করা সবচেয়ে জরুরি এবং কোনগুলোকে নিরাপদে উপেক্ষা করা যায়, তা দ্রুত চিহ্নিত করা সম্ভব হয়।
সমস্যা অগ্রাধিকার
ডায়াগনস্টিকস বিভাগে, ইস্যুর অগ্রাধিকার নির্ধারণে ইস্যুর তীব্রতাকে তিনটি স্তরের একটি হিসাবে বর্ণনা করা হয়: ত্রুটি, সতর্কতা এবং বিজ্ঞপ্তি। উপরেরটির মতো রিপোর্ট টেবিলে, এই স্তরগুলি প্রথম কলামে প্রদর্শিত ছবির মাধ্যমে উপস্থাপন করা হয়: ত্রুটির জন্য,
সতর্কীকরণ এবং
বিজ্ঞপ্তির জন্য।
ত্রুটির কারণে অ্যাকাউন্ট স্থগিত করা হয়েছে অথবা আইটেমটি অনুমোদন পায়নি। আইটেমগুলো যাতে পুনরায় ফলাফলে প্রদর্শিত হওয়ার যোগ্য হয়, তা নিশ্চিত করার জন্য যত দ্রুত সম্ভব এগুলোর সমাধান করা উচিত।
সতর্কবার্তাগুলো আপনার বিজ্ঞাপনের পারফরম্যান্সের ওপর নেতিবাচক প্রভাব ফেলতে পারে এবং সমস্যাটির সমাধান না করা হলে ভবিষ্যতে আইটেম বা অ্যাকাউন্ট সাসপেন্ড হওয়ার সম্ভাবনা রয়েছে।
নোটিফিকেশনগুলো হলো ডেটার গুণমান বাড়ানোর জন্য প্রস্তাবিত অপ্টিমাইজেশন। এই সমস্যাগুলো সমাধান করার পরামর্শ দেওয়া হয়, তবে তা বাধ্যতামূলক নয়।
তবে, কোন ত্রুটিটি কী তা জানতে আমাদের মার্চেন্ট সেন্টারে যাওয়ার প্রয়োজন নেই। কন্টেন্ট এপিআই-তে, 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 হলো একটি আরও গুরুতর ত্রুটি যা আপনার অ্যাকাউন্ট স্থগিত করে দেয়। আপনি যদি Buy on Google, Surfaces across Google-এ অংশগ্রহণ করে থাকেন, অথবা আপনার যদি একটি লিঙ্ক করা Google Ads অ্যাকাউন্ট থাকে, তাহলে একটি critical ত্রুটি অবিলম্বে Buy on Google, Surfaces across Google, এবং Shopping Ads প্রোগ্রামগুলিতে আপনার পণ্যগুলির প্রদর্শন বন্ধ করে দেয়।
এই তথ্যের সাহায্যে, আপনি এখন এমন অ্যালার্টিং সফটওয়্যার লিখতে পারবেন যা গুরুত্বপূর্ণ সমস্যাগুলো অবিলম্বে আপনার নজরে আনবে এবং পরবর্তীতে সমাধানের জন্য কম গুরুতর সমস্যাগুলো সংগ্রহ করবে; এর জন্য কোনটি কী তা বোঝার জন্য মার্চেন্ট সেন্টারে যাওয়ার প্রয়োজন হবে না।