এপিআই ওয়ার্কফ্লোস,এপিআই ওয়ার্কফ্লোস

এই নির্দেশিকায় ডিল সিঙ্ক এপিআই ব্যবহার করে ডিল তৈরি, বাতিল, পুনরুদ্ধার, হালনাগাদ এবং আলোচনার জন্য প্রচলিত এপিআই কার্যপ্রবাহ বর্ণনা করা হয়েছে।

একটি চুক্তি তৈরি করুন

1. externalDealId ফিল্টার সহ `LIST products` কল করে কোনো প্রোডাক্ট আগে থেকেই তৈরি করা হয়েছে কিনা তা যাচাই করুন। মনে রাখবেন, ফিল্টার স্ট্রিং-এ `camelCase externalDealId এবং `snake_case external_deal_id উভয়ই সমর্থিত। সকল প্রোডাক্টের মধ্যে external_deal_id অবশ্যই অনন্য হতে হবে।

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. অর্ডার তৈরি করুন । অর্ডারের নামটি DV360 দ্বারা তৈরি হয়, এবং ভবিষ্যতে ব্যবহারের জন্য আমরা এই আইডিটি আপনার সিস্টেমে সংরক্ষণ করার পরামর্শ দিই।

3. অর্ডারের অধীনে পণ্য তৈরি করুন । পণ্যের নামটি DV360 দ্বারা তৈরি করা হয়, এবং ভবিষ্যতে ব্যবহারের জন্য আমরা এই আইডিটি আপনার সিস্টেমে সংরক্ষণ করার পরামর্শ দিই।

বিকল্পভাবে, আপনি external_deal_id সহ LIST কল করতে পারেন। রিসোর্সের নামে অর্ডার আইডি এবং প্রোডাক্ট আইডি উভয়ই থাকে, তাই আপনি মূল অর্ডারটি শনাক্ত করতে পারেন।

একটি চুক্তি বাতিল করুন

1. অর্ডারের স্ট্যাটাস 'বাতিল' (CANCELED) হিসেবে আপডেট করুন । বাতিল করা শুধুমাত্র তখনই সম্ভব, যদি অর্ডারটি এখনও গৃহীত না হয়ে থাকে। বাতিল একটি চূড়ান্ত অবস্থা; একবার বাতিল হয়ে গেলে কোনো অর্ডার পুনরায় সক্রিয় করা যায় না। যদি অর্ডারটিতে কোনো পণ্য থাকে, তবে সেগুলোর external_deal_id পুনরায় ব্যবহার করা যাবে না।

একটি ডিলের বিস্তারিত জানুন

1. অর্ডারের বিস্তারিত তথ্য জানুন । ব্যবহারকারী অর্ডারটি গ্রহণ, আর্কাইভ বা বাতিল করলে স্ট্যাটাস আপডেট করা হয়।
2. একটি পণ্যের বিস্তারিত তথ্য জানুন ।

অফারগুলির একটি তালিকা পান

1. গৃহীত বা গ্রহণের অপেক্ষায় থাকা সমস্ত অর্ডার পেতে স্ট্যাটাস ফিল্টার সহ অর্ডারগুলোর তালিকা তৈরি করুন ।
2. external_deal_id ফিল্টার ব্যবহার করে পণ্যগুলোর তালিকা তৈরি করুন ।
3. একটি অর্ডারের অন্তর্ভুক্ত সমস্ত পণ্যের তালিকা দিন ।

একটি চুক্তি আপডেট করুন

1. প্রকাশকের যোগাযোগের তথ্যের জন্য অর্ডার আপডেট করুন ।
   1. name আপডেট করা যাবে না ( updateMask এ সেট করা যায় না)। API ব্যবহার করে স্ট্যাটাস শুধুমাত্র CANCELED এ সেট করা যাবে।
   2. partner_id আপডেট করা যাচ্ছে না।
2. একটি নির্দিষ্ট ডিলের শর্তাবলী আপডেটের জন্য প্রোডাক্ট আপডেট করুন ।
   1. name , externalDealId , transactionType , pricingType এবং updateTime আপডেট করা যাচ্ছে না ।
   2. displayName আপডেট করার জন্য ব্যবহারকারীর পুনরায় অনুমোদনের প্রয়োজন নেই।
   3. rateDetails বা creativeConfig আপডেট করলে মূল অর্ডারের স্ট্যাটাস PENDING_ACCEPTANCE এ পরিবর্তিত হয়। পূর্ববর্তী অর্ডারটি ইতিমধ্যে গৃহীত হয়েছিল কিনা তা নির্বিশেষে, DV360 বিজ্ঞাপনদাতাদের Negotiations পৃষ্ঠায় নতুন শর্তাবলী গ্রহণ করতে বলা হবে।

ব্যবহারকারী চুক্তিটি গ্রহণ করেছেন কিনা তা যাচাই করুন।

1. সংশ্লিষ্ট অর্ডারের নাম জানা থাকলে অর্ডারটি পেয়ে যান । status ফিল্ডটি চেক করুন।
2. যদি অর্ডারের নামটি ট্র্যাক করা না হয়ে থাকে: external_deal_id ফিল্টার ব্যবহার করে প্রোডাক্টগুলোর তালিকা করুন , প্রোডাক্টের নাম থেকে অর্ডারের নাম শনাক্ত করুন , এবং তারপর Get Order কল করুন। status ফিল্ডটি পরীক্ষা করুন।

ব্যবহারকারী ডিলটি কনফিগার করেছেন কিনা তা পরীক্ষা করুন (শুধুমাত্র প্রোগ্রাম্যাটিক গ্যারান্টিড এর ক্ষেত্রে প্রযোজ্য)

1. ইনভেন্টরি উৎস খুঁজুন । রিসোর্সের নাম হলো exchanges/{exchangeId}/inventorysources/{external_deal_id} । ক্রেতার অবস্থা যাচাই করুন।
   1. রিজার্ভেশন ডিল:
      1. BUYER_STATUS_ACTIVE : ডিলটি গৃহীত এবং কনফিগার করা হয়েছে। যখন DV360 ডিলের শর্তাবলীর সাথে মেলে এমন দরপত্রের অনুরোধ পাবে, তখন ডিলটির ব্যয় শুরু হবে। ডিল কনফিগারেশনের সময় একটি লাইন আইটেম স্বয়ংক্রিয়ভাবে তৈরি হয়। বিস্তারিত জানতে ডিল কনফিগারেশন দেখুন।
      2. BUYER_STATUS_PENDING ): অর্ডারটি গৃহীত হয়েছে, কিন্তু ডিলটি এখনও কনফিগার করা হয়নি। এই অবস্থায় কোনো খরচ সংঘটিত হয় না।
      3. BUYER_STATUS_PAUSED : বিজ্ঞাপনদাতা কর্তৃক লেনদেনটি স্থগিত করা হয়েছে। এই অবস্থায় কোনো ব্যয় সংঘটিত হয় না।
   2. রিজার্ভেশন ছাড়া ডিল:
      1. BUYER_STATUS_ACTIVE : ডিলটি গৃহীত হয়েছে। যখন DV360 মিলে যাওয়া বিড অনুরোধ পাবে, একটি সক্রিয় লাইন আইটেম ডিলটিকে টার্গেট করবে, এবং বিড অনুরোধগুলো লাইন আইটেমের টার্গেটিং মানদণ্ডের সাথে মিলবে, তখন ডিলটির জন্য অর্থ ব্যয় শুরু হবে। বিস্তারিত জানতে লাইন আইটেম দেখুন। (দ্রষ্টব্য: কোনো ডিল লাইন আইটেম দ্বারা টার্গেট করা হয়েছে কিনা তা জানার জন্য কোনো সেলার এপিআই নেই)।
      2. BUYER_STATUS_PENDING : রিজার্ভেশন ছাড়া ডিলের ক্ষেত্রে প্রযোজ্য নয়।
      3. BUYER_STATUS_PAUSED : বিজ্ঞাপনদাতার পক্ষ থেকে ডিলটি স্পষ্টভাবে স্থগিত করা হয়েছে। এই অবস্থায় কোনো খরচ হয় না।

অনুমোদনের পর চুক্তিটি থামানো এবং পুনরায় চালু করা।

1. ইনভেন্টরি সোর্স বিক্রেতার স্ট্যাটাস আপডেট করুন ।
   1. পজ বা আনপজ করলেও ডিল পরিবেশন বন্ধ হয় না। কোনো বিক্রেতা যখন একটি ডিল পজ করেন, তখন তিনি DV360 UI-তে বিজ্ঞাপনদাতাদের জন্য একটি তথ্যমূলক বার্তা প্রদর্শন করেন, যা খরচ না হওয়া ডিলগুলোর সমস্যা সমাধানে সাহায্য করে।

পুনর্আলোচনা (চুক্তি গৃহীত হওয়ার পর তা হালনাগাদ করা)

পুনঃআলোচনা বলতে ক্রেতা কর্তৃক কোনো চুক্তি গৃহীত হওয়ার পর তাতে করা হালনাগাদকে বোঝায়। এটি এক্সচেঞ্জ এবং ক্রেতাদের বিদ্যমান চুক্তির শর্তাবলী সমন্বয় করার সুযোগ দেয়। উদাহরণস্বরূপ, কোনো এক্সচেঞ্জ দেখতে পারে যে গৃহীত চুক্তির ফ্লাইট শেষ হওয়ার সময়টি ভুল; সেক্ষেত্রে, চুক্তিটি কার্যকর হওয়ার আগেই এক্সচেঞ্জটি প্রোডাক্ট প্যাচ ব্যবহার করে DV360 ক্রেতাদের কাছে হালনাগাদ তথ্য পাঠিয়ে দিতে পারে।

অনুমোদিত এবং অননুমোদিত পরিবর্তন

চুক্তি আলোচনা এবং পুনঃআলোচনার নিয়মাবলীর পূর্ণাঙ্গ বিশ্লেষণের জন্য ডিসপ্লে ও ভিডিও ৩৬০ হেল্প সেন্টারের আর্টিকেলগুলো দেখুন:

• প্রোগ্রাম্যাটিক গ্যারান্টিযুক্ত চুক্তি পুনর্আলোচনা করুন
• ডিসপ্লে অ্যান্ড ভিডিও ৩৬০-এ একটি চুক্তি নিয়ে আলোচনা করুন