মার্কেটপ্লেস API

ওভারভিউ

অনুমোদিত ক্রেতাদের মার্কেটপ্লেস এপিআই হল সম্পদের একটি সংগ্রহ যা ক্রেতারা নিম্নলিখিতগুলিকে প্রোগ্রাম্যাটিকভাবে পরিচালনা করতে ব্যবহার করতে পারে:

  • প্রকাশকদের সাথে আলোচনা
  • নিলাম প্যাকেজ
  • অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI-তে ক্লায়েন্ট অ্যাক্সেস

এই নির্দেশিকাটি মার্কেটপ্লেস API-এর সাথে পরিচয় করিয়ে দেয়, এবং ব্যাখ্যা করে কিভাবে মার্কেটপ্লেস API সংস্থানগুলি অনুমোদিত ক্রেতাদের UI- তে মার্কেটপ্লেস বৈশিষ্ট্যগুলির সাথে মানচিত্র তৈরি করে৷

দরদাতা এবং ক্রেতা

মার্কেটপ্লেস API রিয়েল-টাইম বিডিং API- এর কাঠামোর সাথে সামঞ্জস্যপূর্ণ। উভয় APIই bidders এবং buyers ক্রিয়াকলাপের জন্য রুট-স্তরের সংস্থান হিসাবে ব্যবহার করে। আপনি রিয়েল-টাইম বিডিং এবং মার্কেটপ্লেস API-এর জন্য রিসোর্স পাথগুলিতে একই বিডার এবং ক্রেতার নাম ব্যবহার করতে পারেন।

ক্লায়েন্ট এবং ক্লায়েন্ট ব্যবহারকারী

আপনি ক্লায়েন্ট এবং ক্লায়েন্ট ব্যবহারকারীদের তৈরি এবং পরিচালনা করতে এবং অনুমোদিত ক্রেতা UI-তে আপনার মার্কেটপ্লেস ট্যাবে প্রোগ্রাম্যাটিকভাবে এজেন্সি বা বিজ্ঞাপনদাতাদের অ্যাক্সেস দেওয়ার জন্য মার্কেটপ্লেস API ব্যবহার করতে পারেন।

একজন Client আপনার অনুমোদিত ক্রেতা অ্যাকাউন্টের সাথে যুক্ত একটি ক্লায়েন্ট, এজেন্সি বা বিজ্ঞাপনদাতাকে প্রতিনিধিত্ব করে।

একটি ClientUser একটি নির্দিষ্ট ব্যক্তির প্রতিনিধিত্ব করে যার একটি Client অধীনে UI অ্যাক্সেস রয়েছে। ক্লায়েন্ট ব্যবহারকারীরা মার্কেটপ্লেস API অ্যাক্সেস করতে পারে না। ক্লায়েন্ট ব্যবহারকারীদের আপনার অ্যাকাউন্টের মার্কেটপ্লেস ট্যাবে সীমিত অ্যাক্সেস রয়েছে। ক্লায়েন্ট ব্যবহারকারীর অনুমতিগুলি তাদের মূল Client নির্দিষ্ট role দ্বারা নির্ধারিত হয়।

মার্কেটপ্লেস এপিআই-এর অন্যান্য সংস্থানগুলি Clients রিসোর্সে উল্লেখিত নাম দ্বারা ক্লায়েন্টদের উল্লেখ করে।

অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI-তে ক্লায়েন্ট এবং ক্লায়েন্ট ব্যবহারকারীদের সম্পর্কে আরও জানতে, নিম্নলিখিত সহায়তা কেন্দ্র নিবন্ধগুলি দেখুন:

মিডিয়া পরিকল্পনাকারী

একটি মিডিয়া প্ল্যানার হল একটি এজেন্সি বা অন্য সত্তা যা স্বাধীনভাবে প্রকাশকদের সাথে আলোচনা করে এবং এক বা একাধিক দরদাতাকে তাদের চূড়ান্ত চুক্তির পক্ষে বিড স্থাপন করার অনুমতি দেয়। এই ডিলগুলি হয় ব্যক্তিগত নিলাম বা পছন্দের ডিল, এবং সেগুলি চূড়ান্ত না হওয়া পর্যন্ত আপনি সেগুলি দেখতে বা তাদের সাথে ইন্টারঅ্যাক্ট করতে পারবেন না–এর পরে, সেগুলি bidders.finalizedDeals.list প্রতিক্রিয়াতে উপস্থিত হবে৷

একটি প্রদত্ত চূড়ান্ত চুক্তি একটি মিডিয়া পরিকল্পনাকারী দ্বারা আলোচনা করা হয়েছে কিনা তা নির্ধারণ করতে, আপনি চুক্তির mediaPlanner ক্ষেত্র জনবহুল হয়েছে কিনা তা পরীক্ষা করতে পারেন৷ মিডিয়া পরিকল্পনাকারীরা ডিএসপি-নির্দিষ্ট সিট আইডিগুলির একটি তালিকা সেট করে যা চুক্তিতে লেনদেনের জন্য যোগ্য, যা eligibleSeatIds ক্ষেত্রে দেখা যেতে পারে। রিয়েল-টাইম বিডিং বিড অনুরোধে, এই আসন আইডিগুলি প্রকাশকের দ্বারা সেট করা অনুমোদিত তালিকা বা ব্লকলিস্টে প্রদর্শিত হতে পারে, যা নিলাম থেকে বিড ফিল্টার করা হয়েছে কিনা তা নির্ধারণ করবে। তারা নিম্নলিখিত BidRequest ক্ষেত্রে উপস্থিত হতে পারে:

  • OpenRTB প্রোটোকল
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Google RTB প্রোটোকল
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

নিলাম প্যাকেজ

আপনি নিলাম প্যাকেজগুলি থেকে ক্রেতা এবং ক্লায়েন্টদের সদস্যতা নিতে এবং আনসাবস্ক্রাইব করতে এবং আপনি যে নিলাম প্যাকেজগুলিতে সদস্যতা নিয়েছেন তা দেখতে আপনি Marketplace API ব্যবহার করতে পারেন৷

একটি AuctionPackage ইনভেন্টরির জন্য লক্ষ্যমাত্রার একটি বান্ডিলের অনুরূপ। উদাহরণস্বরূপ, একটি নিলাম প্যাকেজ একটি ক্রেতার ব্যবসায়িক স্বার্থের সাথে প্রাসঙ্গিক URL এবং মোবাইল অ্যাপ্লিকেশন আইডিগুলির একটি সংগ্রহকে লক্ষ্য করতে পারে৷

আপনি মার্কেটপ্লেস API দিয়ে নতুন নিলাম প্যাকেজ তৈরি করতে পারবেন না। নিলাম প্যাকেজ তৈরি করতে আপনি অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI ব্যবহার করতে পারেন। মার্কেটপ্লেস এপিআই নিলাম প্যাকেজের সাথে সম্পর্কিত নির্দিষ্ট টার্গেটিং তথ্য অন্তর্ভুক্ত করে না।

আপনি অন্যান্য ক্রেতা এবং ক্লায়েন্টদের সাথে নিলাম প্যাকেজ শেয়ার করতে পারেন এবং Google বা অন্য ক্রেতাদের দ্বারা আপনার সাথে শেয়ার করা নিলাম প্যাকেজ থাকতে পারে।

আরো তথ্যের জন্য নিলাম প্যাকেজ দেখুন.

প্রকাশকের প্রোফাইল

আপনি যে প্রকাশকদের সাথে আলোচনা করতে পারেন তাদের প্রোফাইল দেখতে আপনি মার্কেটপ্লেস API ব্যবহার করতে পারেন৷

একটি PublisherProfile মার্কেটপ্লেস API-এ একজন প্রকাশককে প্রতিনিধিত্ব করে। মার্কেটপ্লেস এপিআই-এর অন্যান্য সংস্থানগুলি প্রকাশকদের তাদের PublisherProfile নির্দিষ্ট নাম দিয়ে উল্লেখ করে।

অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI-এর ডিসকভারি ট্যাবে প্রকাশক প্রোফাইলে প্রকাশকদের অনুরূপ তথ্য রয়েছে।

আরও তথ্যের জন্য কীভাবে প্রকাশকদের আবিষ্কার করবেন দেখুন।

প্রস্তাব এবং চুক্তি

আপনি প্রকাশকদের সাথে চুক্তির জন্য মার্কেটপ্লেস API ব্যবহার করতে পারেন। ডিলগুলি পরিচালনা করতে আপনি মার্কেটপ্লেস API ব্যবহার করতে পারেন এমন কিছু উপায় এখানে রয়েছে:

প্রস্তাবগুলি একজন ক্রেতা বা ক্লায়েন্ট এবং একজন প্রকাশকের মধ্যে এক বা একাধিক ডিলের সর্বশেষ আলোচনার স্থিতির প্রতিনিধিত্ব করে এবং অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI এর আলোচনা ট্যাবের মতো।

ডিলগুলি একটি প্রদত্ত প্রস্তাবের অধীনে আলোচনা করা একটি চুক্তির সর্বশেষ শর্তগুলির প্রতিনিধিত্ব করে এবং একটি প্রদত্ত প্রস্তাবের জন্য বর্তমান আলোচনা লেবেলযুক্ত ডিলের অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI এর তালিকার সাথে তুলনীয়৷

চূড়ান্ত চুক্তিগুলি সেই চুক্তিগুলিকে প্রতিনিধিত্ব করে যেগুলি আলোচনার পর্যায় সম্পূর্ণ করেছে এবং পরিবেশন করার জন্য প্রস্তুত৷ এর মধ্যে এমন ডিল রয়েছে যা ইতিমধ্যেই পরিবেশন করছে। চূড়ান্ত ডিলগুলি অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI এর ডিল ট্যাবের মতো।

আপনি যে ধরণের চুক্তির বিষয়ে আলোচনা করছেন তার উপর নির্ভর করে, মার্কেটপ্লেস API সংস্থানগুলির মধ্যে আচরণের পার্থক্য হতে পারে। উদাহরণস্বরূপ, ক্রেতারা সব ধরনের চুক্তির জন্য আলোচনা শুরু করতে পারে না। আলোচনার জন্য মার্কেটপ্লেস API বাস্তবায়ন সম্পর্কে আরও জানতে, নিম্নলিখিত সংস্থানগুলি দেখুন:

অনুমোদিত ক্রেতাদের মার্কেটপ্লেস UI-তে আলোচনা সম্পর্কে আরও জানতে, নিম্নলিখিতগুলি দেখুন: