পণ্য সংগ্রহ

প্রোডাক্ট কালেকশন আপনাকে শপেবল ইমেজ-এর মতো রিচ ফরম্যাটের সাথে ব্যবহার করার জন্য প্রোডাক্টের গ্রুপ নির্ধারণ করতে দেয়। প্রতিটি কালেকশনে সর্বোচ্চ ১০০টি প্রোডাক্ট থাকতে পারে। আপনি গুগল মার্চেন্ট সেন্টার অথবা কন্টেন্ট এপিআই ব্যবহার করে একটি কালেকশন তৈরি করতে পারেন।

এই নির্দেশিকাটিতে কন্টেন্ট এপিআই (Content API)-এর মাধ্যমে প্রোডাক্ট কালেকশন কীভাবে ব্যবহার করতে হয় তা দেখানো হয়েছে, যার মধ্যে শপেবল ইমেজ (Shippable Images)-এর জন্য কালেকশন তৈরি করা এবং একটি কালেকশনের স্ট্যাটাস চেক করার উদাহরণও রয়েছে।

দ্রষ্টব্য: শপেবল ইমেজ বর্তমানে একমাত্র বিজ্ঞাপন ফরম্যাট যা কালেকশন সমর্থন করে। তবে, অতিরিক্ত ফরম্যাট যোগ করা হতে পারে যাতে আপনি বিভিন্ন বিজ্ঞাপন ফরম্যাটে আপনার কালেকশনগুলো পুনরায় ব্যবহার করতে পারেন।

পণ্য সংগ্রহ ব্যবহার করুন

কন্টেন্ট এপিআই-তে প্রোডাক্ট কালেকশনগুলো পরিচালনা করার জন্য দুটি সার্ভিস অন্তর্ভুক্ত রয়েছে:

• collections : এর মাধ্যমে আপনি প্রোডাক্ট কালেকশন পেতে, তালিকাভুক্ত করতে, যোগ করতে এবং মুছে ফেলতে পারবেন।

• collectionstatuses : এর মাধ্যমে আপনি কালেকশনগুলির স্ট্যাটাস জানতে ও তালিকাভুক্ত করতে পারবেন, যা থেকে বোঝা যায় যে কোনো কালেকশনে এমন কোনো সমস্যা আছে কিনা যার কারণে সেটি শপিং অ্যাডের মতো কোনো নির্দিষ্ট গন্তব্যের জন্য অকার্যকর হয়ে যেতে পারে।

উদাহরণ: কেনাকাটার যোগ্য ছবির জন্য একটি সংগ্রহ তৈরি করুন

শপেবল ইমেজ হলো উচ্চ-মানের ছবি, যেখানে এক বা একাধিক টীকাযুক্ত পণ্য দেখানো হয় এবং এগুলো কালেকশন ব্যবহার করে কনফিগার করা হয়। শপেবল ইমেজ ব্যবহার করার জন্য, সমস্ত কালেকশনের জন্য প্রয়োজনীয় ফিল্ডগুলোর পাশাপাশি আপনাকে imageLink এবং featuredProduct ফিল্ডগুলোর জন্যও ভ্যালু নির্দিষ্ট করতে হবে। প্রয়োজনীয় ফিল্ডগুলো সম্পর্কে আরও তথ্যের জন্য, কন্টেন্ট এপিআই রেফারেন্স ডকুমেন্টেশন দেখুন।

শপেবল ইমেজ ব্যবহার করতে হলে, আপনাকে পণ্যের একটি কালেকশন তৈরি করতে হবে এবং ` imageLink ফিল্ড ব্যবহার করে এমন একটি ছবি নির্দিষ্ট করতে হবে যাতে সর্বোচ্চ দশটি পণ্য অন্তর্ভুক্ত থাকে। আমরা বর্গাকার ছবি (১:১ অ্যাসপেক্ট রেশিও সহ) ব্যবহারের পরামর্শ দিই।

মূল বিষয়: কালেকশনের imageLink ফিল্ডটি ইমেজ লিঙ্ক ভ্যালুগুলোর একটি অ্যারে গ্রহণ করে। তবে, `Shoppable Images` ফরম্যাটের জন্য অ্যারের শুধুমাত্র প্রথম ভ্যালুটি ব্যবহৃত হয়।

আপনাকে অবশ্যই featuredProduct ফিল্ড ব্যবহার করে ছবিতে প্রদর্শিত পণ্যগুলি নির্দিষ্ট করতে হবে এবং x ও y ফিল্ড ব্যবহার করে ছবিতে পণ্যগুলির স্থানাঙ্কও উল্লেখ করতে হবে। এই ফিল্ডগুলি শুধুমাত্র `Shoppable Images`-এর সাথে ব্যবহৃত কালেকশনগুলির জন্য আবশ্যক। ` x এবং y মান অবশ্যই ০ থেকে ১-এর মধ্যে হতে হবে।

প্রতিটি সংগ্রহে সর্বোচ্চ ১০০টি পণ্য অন্তর্ভুক্ত থাকতে পারে। তবে, শপেবল ইমেজের ক্ষেত্রে, আমরা সুপারিশ করি যে আপনি প্রতি ইমেজে ১০টির বেশি পণ্যের স্থানাঙ্ক নির্দিষ্ট করবেন না, যাতে ইমেজে প্রোডাক্ট কলআউটগুলো দেখানোর জন্য পর্যাপ্ত জায়গা থাকে। featuredProduct অবজেক্টের অংশ offerId ফিল্ডটি অবশ্যই products রিসোর্সের offerId মানের সাথে মিলতে হবে, যা products রিসোর্সের id মান থেকে ভিন্ন।

শপেবল ইমেজের জন্য আবশ্যক imageLink এবং featuredProduct ফিল্ডগুলো ছাড়াও, আপনি ঐচ্ছিক headline ফিল্ডটি ব্যবহার করে একটি কালেকশন হেডলাইনও নির্দিষ্ট করতে পারেন। গ্রাহকদের কালেকশনটি সম্পর্কে অতিরিক্ত বিবরণ দেওয়ার জন্য আমরা একটি হেডলাইন অন্তর্ভুক্ত করার পরামর্শ দিই।

মূল বিষয়: কালেকশনের headline ফিল্ডটি হেডলাইন ভ্যালুগুলোর একটি অ্যারে গ্রহণ করে। তবে, শপেবল ইমেজ ফরম্যাটের জন্য অ্যারের শুধুমাত্র প্রথম ভ্যালুটি ব্যবহৃত হয়।

Shoppable Images-এর জন্য একটি নতুন কালেকশন তৈরি করতে, নিম্নলিখিত URL এবং রিকোয়েস্ট বডি ব্যবহার করে collections.insert এন্ডপয়েন্টে একটি POST রিকোয়েস্ট পাঠান:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

সতর্কীকরণ: যদি একই id সহ কোনো কালেকশন বিদ্যমান থাকে, তাহলে collections.insert এ অনুরোধ করলে রিসোর্সটি সম্পূর্ণরূপে প্রতিস্থাপিত হয়ে যায়।

উদাহরণ: কোনো সংগ্রহের অবস্থা যাচাই করুন

আপনি উপরে যে কালেকশনটি তৈরি করেছেন, সেটিতে বিজ্ঞাপন দেখানোর ক্ষেত্রে কোনো সমস্যা আছে কিনা তা জানতে, নিম্নলিখিত URL ব্যবহার করে collectionsstatuses.get এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠান এবং যে কালেকশনের স্ট্যাটাস জানতে চান তার id অন্তর্ভুক্ত করুন। আপনাকে কোনো রিকোয়েস্ট বডি দিতে হবে না।

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

সংগ্রহের স্থিতির প্রতিক্রিয়ার উদাহরণ

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}